taskchampion-rb 0.9.6 → 0.9.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4d630eddac8dfcb822f6e7f09d61f47abf4bc7597cc2d5cc127b53bff7a6a2f2
-  data.tar.gz: 7fbf3649576f7b77114f67fb9ea04c5018d06ba27dc0746b74a35a67c8af1cb5
+  metadata.gz: 42b23c3273d5b9953634be0e881ce7cffbd451f29468f17eb6f9cbcdf236ce0b
+  data.tar.gz: 6dde1f28ba13970fbb850ecfc82bdd07ac4f20a5f7e2fff54e028995043f11fb
 SHA512:
-  metadata.gz: a412f351c3b06ba461ae2404bad35c2944cbd25245e7f7ed7415e8d97647fd21c397c15b538064530481029ce10be0a37d0ad75156f6907cb515ea89fa66382e
-  data.tar.gz: b428ea2050a5286a05a6c73037434874161c7cc4c3df0784c1741b53fffc47918819a88c1aae537ebde2ca5466b46be071905aebffc2995034ad9a3784337996
+  metadata.gz: 69a4c9013c7441a9ce966e096e07ebd41549460f8160027780ce388a4514946260748f75245cc3fed5da2964d6c029a127d2feb9fb5210589b4487f6b13be94a
+  data.tar.gz: e5af336507eb5105250be66e308527ba137ee50124cf24de34793f63d6448e618f2d7f996f0fe777bb88ce17e95c7c151755ce6815eeeac60c0bde44e8188401

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [Unreleased]
+
+- Link the system `libsqlite3` by default again, as 0.9.4 did, so
+  `libsqlite3-dev` is once more a build prerequisite on Linux. Since
+  0.9.5 the extension compiled its own copy of SQLite, which leaves two
+  SQLite copies in any process that also loads the `sqlite3` gem; they
+  do not share POSIX file locks, which can corrupt the database.
+- Add an opt-in switch for bundled SQLite: set
+  `TASKCHAMPION_BUNDLED_SQLITE=1` or pass `--with-bundled-sqlite` at
+  install time. Only use it when nothing else in the process loads
+  SQLite.
+
 ## [0.9.6] - 2026-10-22
 
 - Update `rb-sys` to 0.9.130 (pulling in `bindgen` 0.72.1) in

data/README.md

@@ -20,15 +20,35 @@ This gem supports Ruby 3.3 and later. We follow Ruby's end-of-life (EOL) schedul
    libclang over Ruby's headers to generate FFI bindings during `rake compile`.
    - **Debian/Ubuntu:** `sudo apt install clang libclang-dev`
    - **macOS:** `xcode-select --install`
-3. Rust toolchain (optional — if `cargo` is not found, `rb-sys` bootstraps its
+3. System SQLite development files — the extension links the system
+   `libsqlite3` by default.
+   - **Debian/Ubuntu:** `sudo apt install libsqlite3-dev`
+   - **macOS:** nothing to install; the OS ships `libsqlite3`.
+4. Rust toolchain (optional — if `cargo` is not found, `rb-sys` bootstraps its
    own rustup + toolchain during the build). To install it yourself:
 
 ```bash
 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
 ```
 
-> SQLite is compiled from source into the extension (the `bundled` feature), so
-> no system SQLite / `libsqlite3-dev` is required.
+### Bundled SQLite (opt-in)
+
+To compile SQLite from source into the extension instead of linking the
+system library, set the switch at install time:
+
+```bash
+TASKCHAMPION_BUNDLED_SQLITE=1 gem install taskchampion-rb
+# or
+gem install taskchampion-rb -- --with-bundled-sqlite
+# or, with Bundler
+bundle config build.taskchampion-rb --with-bundled-sqlite
+```
+
+> **Warning:** do not use bundled SQLite in a process that also loads another
+> copy of SQLite, such as the `sqlite3` gem (e.g. a Rails app). Two SQLite
+> copies in one process do not see each other's POSIX file locks, which can
+> corrupt the database. Bundling is only safe when taskchampion-rb is the sole
+> SQLite user in the process.
 
 ### Building from source
 

data/Rakefile

@@ -32,10 +32,17 @@ task :publish, [:version] do |t, args|
   version = args[:version] || "patch"
 
   puts "Bumping version (#{version})..."
-  sh "bump #{version} --tag"
+  # Commit and tag here rather than with bump --tag: bump's "vX.Y.Z"
+  # subject fails the commit-msg hook, and bump tags even when the
+  # commit fails.
+  sh "bump #{version} --no-commit"
+  new_version = `bump current --value-only`.strip
+  sh "git add lib/taskchampion/version.rb Gemfile.lock"
+  sh "git commit -m 'Bump to v#{new_version}'"
+  sh "git tag -a v#{new_version} -m v#{new_version}"
 
   puts "Pushing to git..."
-  sh "git push && git push --tags"
+  sh "git push && git push origin v#{new_version}"
 
   puts "Building and releasing gem..."
   Rake::Task["release"].invoke

data/ext/taskchampion/Cargo.toml

@@ -12,11 +12,15 @@ crate-type = ["cdylib"]
 [dependencies]
 magnus = { version = "0.7", features = ["rb-sys"] }
 rb-sys = "0.9.103"
-# `bundled` compiles SQLite from source into the extension so the build does not
-# depend on the host having libsqlite3-dev / a compatible system SQLite.
-taskchampion = { version = "2.0", default-features = false, features = ["bundled", "server-sync", "server-gcp"] }
+# SQLite is linked from the system by default. See the bundled-sqlite feature.
+taskchampion = { version = "2.0", default-features = false, features = ["server-sync", "server-gcp"] }
 chrono = "0.4"
 uuid = "1.0"
 
 [features]
 default = ["rb-sys/stable-api-compiled-fallback"]
+# Compile a private copy of SQLite into the extension instead of linking the
+# system libsqlite3. Do not enable this in a process that also loads another
+# SQLite (e.g. the sqlite3 gem): two copies do not share POSIX file locks,
+# which can corrupt the database. Enabled through extconf.rb.
+bundled-sqlite = ["taskchampion/bundled"]

data/ext/taskchampion/extconf.rb

@@ -3,4 +3,14 @@
 require "mkmf"
 require "rb_sys/mkmf"
 
-create_rust_makefile("taskchampion/taskchampion")
+# Opt in to compiling SQLite into the extension with either
+#   TASKCHAMPION_BUNDLED_SQLITE=1
+# or
+#   gem install taskchampion-rb -- --with-bundled-sqlite
+#   bundle config build.taskchampion-rb --with-bundled-sqlite
+bundled_sqlite = with_config("bundled-sqlite") ||
+                 %w[1 true yes].include?(ENV["TASKCHAMPION_BUNDLED_SQLITE"])
+
+create_rust_makefile("taskchampion/taskchampion") do |r|
+  r.features = ["bundled-sqlite"] if bundled_sqlite
+end

data/lib/taskchampion/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Taskchampion
-  VERSION = "0.9.6"
+  VERSION = "0.9.7"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: taskchampion-rb
 version: !ruby/object:Gem::Version
-  version: 0.9.6
+  version: 0.9.7
 platform: ruby
 authors:
 - Tim Case