NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io
crates.io, #2401 most downloaded on crates.io
MySql protocol primitives
Latest stable
0.38.2
Last release 4 months ago
24 Jul 2026
Release timing varies
gaps range from 2 weeks to 6 months
Most releases are documented
notes for 48 of the last 60 stable releases
9 versions withdrawn
withdrawn after publishing
9 years old
84 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
Fix AuthSwitchRequest::plugin_data again by @blackbeam in https://github.com/blackbeam/rust_mysql_common/pull/194
AuthSwitchRequest::plugin_data again by @blackbeam in https://github.com/blackbeam/rust_mysql_common/pull/194Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.38.1...v0.38.2
Fix AuthSwitchRequest::plugin_data by @blackbeam in https://github.com/blackbeam/rust_mysql_common/pull/193
AuthSwitchRequest::plugin_data by @blackbeam in https://github.com/blackbeam/rust_mysql_common/pull/193Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.38.0...v0.38.1
new ChallengeResponsePlugin trait was introduced to incapsulate the auth logic for suppoted plugins
Your coding agent can read these notes before it upgrades. Set up the MCP server →
ChallengeResponsePlugin trait was introduced to incapsulate the auth logic for suppoted pluginscrate::auth::pluginsAuthProc enum was introduced as a convenient way for a driver to dispatch auth packets to a pluginAuthPluginData was removed in favor of responses generated by ChallengeResponsePlugin::runCrate-level docs was moved to CRATE_LEVEL_DOCS.md
Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.37.3...v0.38.0
MYSQL_TYPE_NEWDATE support by @blackbeam in #191 (see blackbeam/mysql_async#400)
MYSQL_TYPE_NEWDATE support by @blackbeam in #191 (see blackbeam/mysql_async#400)Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.37.2...v0.37.3
Add MariaDb extended capabilities support to the SslRequest packet by @blackbeam in https://github.com/blackbeam/rust_mysql_common/pull/183
SslRequest packet by @blackbeam in https://github.com/blackbeam/rust_mysql_common/pull/183Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.37.0...v0.37.2
Nothing published for this version
[BREAKING] Add unified GTID_TAGGED_LOG_EVENT support to GtidEvent (MySQL 8.4+) by @altmannmarcelo in https://github.com/blackbeam/rust_mysql_common/pu
Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.36.2...v0.37.0
ComStmtBulkExecuteRequestBuilder::with_results added
ComStmtBulkExecuteRequestBuilder::with_results addedfield getters added for StmtBulkExecuteParamType, StmtBulkExecuteParamValue, ComStmtBulkExecuteRequest
StmtBulkExecuteParamType, StmtBulkExecuteParamValue, ComStmtBulkExecuteRequestComStmtBulkExecuteRequest (a76fcb17)Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.36.0...v0.36.1
Constants and classes MariaDB COM_STMT_BULK_EXECUTE command by @lawrinn in https://github.com/blackbeam/rust_mysql_common/pull/173
InvalidLenghEncodedInteger -> InvalidLengthEncodedInteger, InvalidAuthSwithRequestHeader -> InvalidAuthSwitchRequestHeaderFull Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.35.5...v0.36.0
Issue#401 Adding required definitions for MariaDB metadata skipping by @lawrinn in https://github.com/blackbeam/rust_mysql_common/pull/171
Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.35.4...v0.35.5
Time issue by @altmannmarcelo in https://github.com/blackbeam/rust_mysql_common/pull/170
Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.35.3...v0.35.4
Optional Metadata fix for Minimal Row Based Replication by @altmannmarcelo in https://github.com/blackbeam/rust_mysql_common/pull/167
Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.35.2...v0.35.3
build(deps): gate zstd behind binlog feature by @paolobarbolini in https://github.com/blackbeam/rust_mysql_common/pull/165
zstd behind binlog feature by @paolobarbolini in https://github.com/blackbeam/rust_mysql_common/pull/165cc, cmake and subprocess behind test feature by @paolobarbolini in https://github.com/blackbeam/rust_mysql_common/pull/166Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.35.1...v0.35.2
Rust edition updated to 2024 (fixes build issue)
2024 (fixes build issue)Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.35.0...v0.35.1
thiserror 2 by @serprex in https://github.com/blackbeam/rust_mysql_common/pull/157
v0.35.0 release by @blackbeam in https://github.com/blackbeam/rust_mysql_common/pull/161Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.34.1...v0.35.0
Make bindgen an optional dependency by @blackbeam in https://github.com/blackbeam/rust_mysql_common/pull/156
bindgen an optional dependency by @blackbeam in https://github.com/blackbeam/rust_mysql_common/pull/156Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.34.0...v0.34.1
mysql-common-derive was updated to v0.32.0. See the release notes.
mysql-common-derive was updated to v0.32.0. See the release notes.Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.33.0...v0.34.0
Add vector type added in MySQL 9.0 by @dbussink in https://github.com/blackbeam/rust_mysql_common/pull/142
HlistFromRow helper trait. by @blackbeam in https://github.com/blackbeam/rust_mysql_common/pull/150 (fixes #149)time v0.2.x support droppedbigdecimal.. features are replaced with the bigdecimal feature (see update "Crate features" table)JsonDom type and parsing/conversion by @blackbeam in https://github.com/blackbeam/rust_mysql_common/pull/147 (see #145)Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.32.4...v0.33.0
Read TLV length correctly in optional metadata by @maorsaleh in https://github.com/blackbeam/rust_mysql_common/pull/139
Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.32.3...v0.32.4
added: parse integers to bool by @thed0ct0r in https://github.com/blackbeam/rust_mysql_common/pull/134
Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.32.2...v0.32.3
Respect quoted identifiers in ParsedNamedParams::parse (fix #129) by @blackbeam in https://github.com/blackbeam/rust_mysql_common/pull/130
ParsedNamedParams::parse (fix #129) by @blackbeam in https://github.com/blackbeam/rust_mysql_common/pull/130Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.32.1...v0.32.2
fix: update MariaDB version regex to make the version hack optional by @Jolg42 in https://github.com/blackbeam/rust_mysql_common/pull/125
Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.32.0...v0.32.1
breaking Add SERVER_STATUS_ANSI_QUOTES flag by @blackbeam in https://github.com/blackbeam/rust_mysql_common/pull/117
max_packet_size field in HandshakeResponse packet by @Will-Low in https://github.com/blackbeam/rust_mysql_common/pull/121Box, Arc and Rc of str and [u8] by @blackbeam in https://github.com/blackbeam/rust_mysql_common/pull/116caching_sha2_password public key retrieval by @Will-Low in https://github.com/blackbeam/rust_mysql_common/pull/119Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.31.0...v0.32.0
The bigdecimal feature is now for bigdecimal v0.4 (to migrate use new bigdecimal03 feature)
bigdecimal feature is now for bigdecimal v0.4 (to migrate use new bigdecimal03 feature)binlog feature (enabled by default)ParsedNamedParams structure replaces the old parse_named_params function. Use ParsedNamedParams::parse instead.Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.30.6...v0.31.0
Fix mgf1 panic in 32bit env by @markcty in https://github.com/blackbeam/rust_mysql_common/pull/94
Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.30.5...v0.30.6
Properly handle ? in comments when parsing named parameters (reported by @westy92 in #92)
? in comments when parsing named parameters (reported by @westy92 in #92)Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.30.4...v0.30.5
fix ComChangeUser serialization when CLIENT_CONNECT_ATTRS is set
ComChangeUser serialization when CLIENT_CONNECT_ATTRS is setfix for the time feature by @thed0ct0r in https://github.com/blackbeam/rust_mysql_common/pull/86
time feature by @thed0ct0r in https://github.com/blackbeam/rust_mysql_common/pull/86Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.30.2...v0.30.3
Implement FromValue for chrono NaiveTime by @scsmithr in https://github.com/blackbeam/rust_mysql_common/pull/85
Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.30.1...v0.30.2
@lance6716 did some work improving GTID parsing. Naming was slightly changed (see #74)
ConvIr trait was removed:
FromValue::Intermediate to instead satisfy TryFrom<Value, Error = FromValueError> + Into<Self>FromRow now requires FromValue::Intermediate to also satisfy Into<Value>AuthPluginData::Clear and AuthPlugin::MysqlClearPassword (see #79)bigdecimal -> bigdecimal02bigcedimal03 -> bigcecimaltime -> time02time03 -> timeFromRow and FromValue (see crate-level docs). It is possible to opt-out via derive feature.ComChangeUser packet support.mysql_clear_password authentication plugin support by @blackbeam in https://github.com/blackbeam/rust_mysql_common/pull/79Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.29.2...v0.30.1
Nothing published for this version
Switch from sha-1 to sha1 by @benesch in https://github.com/blackbeam/rust_mysql_common/pull/71
sha-1 to sha1 by @benesch in https://github.com/blackbeam/rust_mysql_common/pull/71Full Changelog: https://github.com/blackbeam/rust_mysql_common/compare/v0.29.1...v0.29.2
Add microsecond precision support for time02 and time03. Reported by @yerke in #68 and implemented by @blackbeam in #69
(breaking) Make named parameter parsing use byte slices by @glittershark in https://github.com/blackbeam/rust_mysql_common/pull/64
1.5.5 by @Dylan-DPC in https://github.com/blackbeam/rust_mysql_common/pull/611@miniliuke fixed a serious bug in the BinlogValue deserializer (see #56)
TryFrom<BinlogValue> for Value and TryFrom<BinlogRow> for Row to partially address #54BinlogValue deserializer (see #56)Nothing published for this version
binlog: add support of column visibility metadata introduced in mysql 8.0.23
OptionalMetadataIterBinlogRow deserializationtime v0.3.x support (see time03 feature in the README.md)
time v0.3.x support (see time03 feature in the README.md)bigdecimal v0.3.x support (see bigdecimal03 feature in the README.md)NULL deserialization for a text protocol value was fixed (thanks to @zirill). Related issue: blackbeam/rust-mysql-simple#284
Fixes:
binlog row MYSQL_TYPE_GEOMETRY and MYSQL_TYPE_SET deserialization was fixed (see blackbeam/rust-mysql-simple#282)
Fixes:
MYSQL_TYPE_GEOMETRY and MYSQL_TYPE_SET deserialization was fixed (see blackbeam/rust-mysql-simple#282)mysql_old_password authentication plugin support
New:
mysql_old_password authentication plugin supportNothing published for this version
Binary logging related structures was added
What's new:
FromRow was implemented for frunk::HList (to support tuples of arbitrary arity)Improvements:
bigdecimal, chrono, frunk, rust_decimal, time and uuid support (see #31)Other:
* bytes bumped to 1.0 * rand bumped to 0.8
Nothing published for this version
Nothing published for this version
the params macro will now emit an instance of the Params structure (see blackbeam/rust-mysql-simple#249).
Changes:
params macro will now emit an instance of the Params structure (see blackbeam/rust-mysql-simple#249).failure dependency was removed by @mguillemot;
failure dependency was removed by @mguillemot;OkPacket::parse.SyncFramed will retry on Interrupted. Thanks to @Elykz (see blackbeam/rust-mysql-simple#244)
SyncFramed will retry on Interrupted. Thanks to @Elykz (see blackbeam/rust-mysql-simple#244)Nothing published for this version
time was updated to 0.2 by @kevinpoitra
Breaking changes:
time was updated to 0.2 by @kevinpoitraStringIr and BytesIr was replaced by a plain Vec<u8>Fixes:
parse_ok_packet now requires OkPacketKind (see [WL#7766][1]) (related issue – blackbeam/mysql_async#107)
Breaking changes:
parse_ok_packet now requires OkPacketKind (see WL#7766) (related issue – blackbeam/mysql_async#107)Value::Float(f64) was split into Value::Float(f32) and Value::Double(f64) by @tomhoule (see #17, this comment)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Into > implementations was added for SslRequest and HandshakeResponse.
Into<Vec<u8>> implementations was added for SslRequest and HandshakeResponse.mysql_common::proto module was introduced (RawPacket and PacketParser were removed) (⚠ breaking):
mysql_common::proto module was introduced (RawPacket and PacketParser were removed) (⚠ breaking):
PacketCodec structure – implementation of the MySql protocol codec (including compression support);MySyncFramed structure – synchronous version of tokio's Framed structure;lenenc_int_len and lenenc_str_len helper functions were added;ComStmtExecuteRequestBuilder – builder for COM_STMT_EXECUTE (serialize_bin_many function was removed) (⚠ breaking);ComStmtSendLongData – builder for COM_STMT_SEND_LONG_DATA;ComStmtClose – builder for COM_STMT_CLOSE;from_row and from_value error messages now using any::type_name;Fix for blackbeam/mysql_async#81 was added.
Changes:
One column per quarter.