rusqlite/Changelog.md
Yuri Astrakhan 2e62b031bf Spelling and a few more nits
* fix some simple spelling mistakes
* a few other minor prof-reading nits
2023-07-26 19:59:51 -04:00

16 KiB

For version 0.15.0 and above, see Releases page.

Version 0.14.0 (2018-08-17)

  • BREAKING CHANGE: ToSql implementation for time::Timespec uses RFC 3339 (%Y-%m-%dT%H:%M:%S.%fZ). Previous format was %Y-%m-%d %H:%M:%S:%f %Z.
  • BREAKING CHANGE: Remove potentially conflicting impl of ToSqlOutput (#313).
  • BREAKING CHANGE: Replace column index/count type (i32) with usize.
  • BREAKING CHANGE: Replace parameter index/count type (i32) with usize.
  • BREAKING CHANGE: Replace row changes/count type (i32) with usize.
  • BREAKING CHANGE: Scalar functions must be Sendable and 'static.
  • Bugfix: Commit failure unhandled, database left in unusable state (#366).
  • Bugfix: free_boxed_hook does not work for fn.
  • Update the bundled SQLite version to 3.24.0 (#326).
  • Add DropBehavior::Panic to enforce intentional commit or rollback.
  • Implement sqlite3_update_hook (#260, #328), sqlite3_commit_hook and sqlite3_rollback_hook.
  • Add support to unlock notification behind unlock_notify feature (#294, #331).
  • Make Statement::column_index case-insensitive (#330).
  • Add comment to justify &mut Connection in Transaction.
  • Fix tyvar_behind_raw_pointer warnings.
  • Fix handful of clippy warnings.
  • Fix Connection::open documentation (#332)
  • Add binding to sqlite3_get_autocommit and sqlite3_stmt_busy.
  • Add binding to sqlite3_busy_timeout and sqlite3_busy_handler.
  • Add binding to sqlite3_expanded_sql.
  • Use rerun-if-env-changed in libsqlite3-sys (#329).
  • Return an InvalidQuery error when SQL is not read only.

Version 0.13.0 (2017-11-13)

  • Added ToSqlConversionFailure case to Error enum.
  • Now depends on chrono 0.4, bitflags 1.0, and (optionally) cc 1.0 / bindgen 0.31.
  • The ToSql/FromSql implementations for time::Timespec now include and expect fractional seconds and timezone in the serialized string.
  • The RowIndex type used in Row::get is now publicly exported.
  • New sqlcipher feature allows linking against SQLCipher instead of SQLite.
  • Doc link in README now point to docs.rs.

Version 0.12.0 (2017-05-29)

  • Defines HAVE_USLEEP when building with a bundled SQLite (#263).
  • Updates dependencies to their latest versions, particularly serde to 1.0.
  • Adds support for vcpkg on Windows.
  • Adds ToSql impls for str and [u8].

Version 0.11.0 (2017-04-06)

  • Avoid publicly exporting SQLite constants multiple times from libsqlite3-sys.
  • Adds FromSql and ToSql impls for isize. Documents why usize and u64 are not included.

Version 0.10.1 (2017-03-03)

  • Updates the bundled SQLite version to 3.17.0.
  • Changes the build process to no longer require bindgen. This should improve build times and no longer require a new-ish Clang. See the README for more details.

Version 0.10.0 (2017-02-28)

  • Re-export the ErrorCode enum from libsqlite3-sys.
  • Adds version() and version_number() functions for querying the version of SQLite in use.
  • Adds the limits feature, exposing limit() and set_limit() methods on Connection.
  • Updates to libsqlite3-sys 0.7.0, which runs rust-bindgen at build-time instead of assuming the presence of all expected SQLite constants and functions.
  • Clarifies supported SQLite versions. Running with SQLite older than 3.6.8 now panics, and some features will not compile unless a sufficiently-recent SQLite version is used. See the README for requirements of particular features.
  • When running with SQLite 3.6.x, rusqlite attempts to perform SQLite initialization. If it fails, rusqlite will panic since it cannot ensure the threading mode for SQLite. This check can be skipped by calling the unsafe function rusqlite::bypass_sqlite_initialization(). This is technically a breaking change but is unlikely to affect anyone in practice, since prior to this version the check that rusqlite was using would cause a segfault if linked against a SQLite older than 3.7.0.
  • rusqlite now performs a one-time check (prior to the first connection attempt) that the runtime SQLite version is at least as new as the SQLite version found at buildtime. This check can be skipped by calling the unsafe function rusqlite::bypass_sqlite_version_check().
  • Removes the libc dependency in favor of using std::os::raw

Version 0.9.5 (2017-01-26)

  • Add impls of Clone, Debug, and PartialEq to ToSqlOutput.

Version 0.9.4 (2017-01-25)

  • Update dependencies.

Version 0.9.3 (2017-01-23)

  • Make ToSqlOutput itself implement ToSql.

Version 0.9.2 (2017-01-22)

  • Bugfix: The FromSql impl for i32 now returns an error instead of truncating if the underlying SQLite value is out of i32's range.
  • Added FromSql and ToSql impls for i8, i16, u8, u16, and u32. i32 and i64 already had impls. u64 is omitted because their range cannot be represented by i64, which is the type we use to communicate with SQLite.

Version 0.9.1 (2017-01-20)

  • BREAKING CHANGE: Connection::close() now returns a Result<(), (Connection, Error)> instead of a Result<(), Error> so callers get the still-open connection back on failure.

Version 0.8.0 (2016-12-31)

  • BREAKING CHANGE: The FromSql trait has been redesigned. It now requires a single, safe method instead of the previous definition which required implementing one or two unsafe methods.
  • BREAKING CHANGE: The ToSql trait has been redesigned. It can now be implemented without unsafe, and implementors can choose to return either borrowed or owned results.
  • BREAKING CHANGE: The closure passed to query_row, query_row_and_then, query_row_safe, and query_row_named now expects a &Row instead of a Row. The vast majority of calls to these functions will probably not need to change; see https://github.com/jgallagher/rusqlite/pull/184.
  • BREAKING CHANGE: A few cases of the Error enum have sprouted additional information (e.g., FromSqlConversionFailure now also includes the column index and the type returned by SQLite).
  • Added #[deprecated(since = "...", note = "...")] flags (new in Rust 1.9 for libraries) to all deprecated APIs.
  • Added query_row convenience function to Statement.
  • Added bundled feature which will build SQLite from source instead of attempting to link against a SQLite that already exists on the system.
  • Fixed a bug where using cached prepared statements resulted in attempting to close a connection failing with DatabaseBusy; see https://github.com/jgallagher/rusqlite/issues/186.

Version 0.7.3 (2016-06-01)

  • Fixes an incorrect failure from the insert() convenience function when back-to-back inserts to different tables both returned the same row ID (#171).

Version 0.7.2 (2016-05-19)

  • BREAKING CHANGE: Rows no longer implements Iterator. It still has a next() method, but the lifetime of the returned Row is now tied to the lifetime of the vending Rows object. This behavior is more correct. Previously there were runtime checks to prevent misuse, but other changes in this release to reset statements as soon as possible introduced yet another hazard related to the lack of these lifetime connections. We were already recommending the use of query_map and query_and_then over raw query; both of those still return handles that implement Iterator.
  • BREAKING CHANGE: Transaction::savepoint() now returns a Savepoint instead of another Transaction. Unlike Transaction, Savepoints can be rolled back while keeping the current savepoint active.
  • BREAKING CHANGE: Creating transactions from a Connection or savepoints from a Transaction now take &mut self instead of &self to correctly represent that transactions within a connection are inherently nested. While a transaction is alive, the parent connection or transaction is unusable, so Transaction now implements Deref<Target=Connection>, giving access to Connection's methods via the Transaction itself.
  • BREAKING CHANGE: Transaction::set_commit and Transaction::set_rollback have been replaced by Transaction::set_drop_behavior.
  • Adds Connection::prepare_cached. Connection now keeps an internal cache of any statements prepared via this method. The size of this cache defaults to 16 (prepare_cached will always work but may re-prepare statements if more are prepared than the cache holds), and can be controlled via Connection::set_prepared_statement_cache_capacity.
  • Adds query_map_named and query_and_then_named to Statement.
  • Adds insert convenience method to Statement which returns the row ID of an inserted row.
  • Adds exists convenience method returning whether a query finds one or more rows.
  • Adds support for serializing types from the serde_json crate. Requires the serde_json feature.
  • Adds support for serializing types from the chrono crate. Requires the chrono feature.
  • Removes load_extension feature from libsqlite3-sys. load_extension is still available on rusqlite itself.
  • Fixes crash on nightly Rust when using the trace feature.
  • Adds optional clippy feature and addresses issues it found.
  • Adds column_count() method to Statement and Row.
  • Adds types::Value for dynamic column types.
  • Adds support for user-defined aggregate functions (behind the existing functions Cargo feature).
  • Introduces a RowIndex trait allowing columns to be fetched via index (as before) or name (new).
  • Introduces ZeroBlob type under the blob module/feature exposing SQLite's zeroblob API.
  • Adds CI testing for Windows via AppVeyor.
  • Fixes a warning building libsqlite3-sys under Rust 1.6.
  • Adds an unsafe handle() method to Connection. Please file an issue if you actually use it.

Version 0.6.0 (2015-12-17)

  • BREAKING CHANGE: SqliteError is now an enum instead of a struct. Previously, we were (ab)using the error code and message to send back both underlying SQLite errors and errors that occurred at the Rust level. Now those have been separated out; SQLite errors are returned as SqliteFailure cases (which still include the error code but also include a Rust-friendlier enum as well), and rusqlite-level errors are captured in other cases. Because of this change, SqliteError no longer implements PartialEq.
  • BREAKING CHANGE: When opening a new detection, rusqlite now detects if SQLite was compiled or configured for single-threaded use only; if it was, connection attempts will fail. If this affects you, please open an issue.
  • BREAKING CHANGE: SqliteTransactionDeferred, SqliteTransactionImmediate, and SqliteTransactionExclusive are no longer exported. Instead, use TransactionBehavior::Deferred, TransactionBehavior::Immediate, and TransactionBehavior::Exclusive.
  • Removed Sqlite prefix on many types:
    • SqliteConnection is now Connection
    • SqliteError is now Error
    • SqliteResult is now Result
    • SqliteStatement is now Statement
    • SqliteRows is now Rows
    • SqliteRow is now Row
    • SqliteOpenFlags is now OpenFlags
    • SqliteTransaction is now Transaction.
    • SqliteTransactionBehavior is now TransactionBehavior.
    • SqliteLoadExtensionGuard is now LoadExtensionGuard. The old, prefixed names are still exported but are deprecated.
  • Adds a variety of ..._named methods for executing queries using named placeholder parameters.
  • Adds backup feature that exposes SQLite's online backup API.
  • Adds blob feature that exposes SQLite's Incremental I/O for BLOB API.
  • Adds functions feature that allows user-defined scalar functions to be added to open SqliteConnections.

Version 0.5.0 (2015-12-08)

  • Adds trace feature that allows the use of SQLite's logging, tracing, and profiling hooks.
  • Slight change to the closure types passed to query_map and query_and_then:
    • Remove the 'static requirement on the closure's output type.
    • Give the closure a &SqliteRow instead of a SqliteRow.
  • When building, the environment variable SQLITE3_LIB_DIR now takes precedence over pkg-config.
  • If pkg-config is not available, we will try to find libsqlite3 in /usr/lib.
  • Add more documentation for failure modes of functions that return SqliteResults.
  • Updates libc dependency to 0.2, fixing builds on ARM for Rust 1.6 or newer.

Version 0.4.0 (2015-11-03)

  • Adds Sized bound to FromSql trait as required by RFC 1214.

Version 0.3.1 (2015-09-22)

Version 0.3.0 (2015-09-21)

  • Removes get_opt. Use get_checked instead.
  • Add query_row_and_then and query_and_then convenience functions. These are analogous to query_row and query_map but allow functions that can fail by returning Results.
  • Relax uses of P: AsRef<...> from &P to P.
  • Add additional error check for calling execute when query was intended.
  • Improve debug formatting of SqliteStatement and SqliteConnection.
  • Changes documentation of get_checked to correctly indicate that it returns errors (not panics) when given invalid types or column indices.

Version 0.2.0 (2015-07-26)

  • Add column_names() to SqliteStatement.
  • By default, include SQLITE_OPEN_NO_MUTEX and SQLITE_OPEN_URI flags when opening a new connection.
  • Fix generated bindings (e.g., sqlite3_exec was wrong).
  • Use now-generated sqlite3_destructor_type to define SQLITE_STATIC and SQLITE_TRANSIENT.

Version 0.1.0 (2015-05-11)

  • [breaking-change] Modify query_row to return a Result instead of unwrapping.
  • Deprecate query_row_safe (use query_row instead).
  • Add query_map.
  • Add get_checked, which asks SQLite to do some basic type-checking of columns.

Version 0.0.17 (2015-04-03)

  • Publish version that builds on stable rust (beta). This version lives on the stable branch. Development continues on master and still requires a nightly version of Rust.

Version 0.0.16

  • Updates to track rustc nightly.

Version 0.0.15

  • Make SqliteConnection Send.

Version 0.0.14

  • Remove unneeded features (also involves switching to libc crate).

Version 0.0.13 (2015-03-26)

  • Updates to track rustc nightly.

Version 0.0.12 (2015-03-24)

  • Updates to track rustc stabilization.

Version 0.0.11 (2015-03-12)

  • Reexport sqlite3_stmt from libsqlite3-sys for easier impl-ing of ToSql and FromSql.
  • Updates to track latest rustc changes.
  • Update dependency versions.

Version 0.0.10 (2015-02-23)

  • BREAKING CHANGE: open now expects a Path rather than a str. There is a separate open_in_memory constructor for opening in-memory databases.
  • Added the ability to load SQLite extensions. This is behind the load_extension Cargo feature, because not all builds of sqlite3 include this ability. Notably the default libsqlite3 that ships with OS X 10.10 does not support extensions.

Version 0.0.9 (2015-02-13)

  • Updates to track latest rustc changes.
  • Implement standard Error trait for SqliteError.

Version 0.0.8 (2015-02-04)

  • Updates to track latest rustc changes.

Version 0.0.7 (2015-01-20)

  • Use external bitflags from crates.io.

Version 0.0.6 (2015-01-10)

  • Updates to track latest rustc changes (1.0.0-alpha).
  • Add query_row_safe, a SqliteResult-returning variant of query_row.

Version 0.0.5 (2015-01-07)

  • Updates to track latest rustc changes (closure syntax).
  • Updates to track latest rust stdlib changes (std::c_str -> std::ffi).

Version 0.0.4 (2015-01-05)

  • Updates to track latest rustc changes.

Version 0.0.3 (2014-12-23)

  • Updates to track latest rustc changes.
  • Add call to sqlite3_busy_timeout.

Version 0.0.2 (2014-12-04)

  • Remove use of now-deprecated std::vec::raw::from_buf.
  • Update to latest version of time crate.

Version 0.0.1 (2014-11-21)

  • Initial release