1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
|
# Contributing to sqlite3-ruby
**This document is a work-in-progress.**
This doc is a short introduction on how to modify and maintain the sqlite3-ruby gem.
## Architecture notes
### Decision record
As of 2024-09, we're starting to keep some architecture decisions in the subdirectory `/adr`, so
please look there for additional information.
### Garbage collection
All statements keep pointers back to their respective database connections.
The `@connection` instance variable on the `Statement` handle keeps the database
connection alive.
We use `sqlite3_close_v2` in `Database#close` since v2.1.0 which defers _actually_ closing the
connection and freeing the underlying memory until all open statements are closed; though the
`Database` object will immediately behave as though it's been fully closed. If a Database is not
explicitly closed, it will be closed when it is GCed.
`Statement#close` finalizes the underlying statement. If a Statement is not explicitly closed, it
will be closed/finalized when it is GCed.
## Building gems
As a prerequisite please make sure you have `docker` correctly installed, so that you're able to cross-compile the native gems.
Run `bin/build-gems` which will package gems for all supported platforms, and run some basic sanity tests on those packages using `bin/test-gem-set` and `bin/test-gem-file-contents`.
## Updating the version of libsqlite3
Update `/dependencies.yml` to reflect:
- the version of libsqlite3
- the URL from which to download
- the checksum of the file, which will need to be verified manually (see comments in that file)
## Making a release
A quick checklist to cutting a release of the sqlite3 gem:
- [ ] make sure CI is green!
- bump the version
- [ ] update `CHANGELOG.md` and `lib/sqlite3/version.rb`
- [ ] create a git tag using a format that matches the pattern `v\d+\.\d+\.\d+`, e.g. `v1.3.13`
- build the native gems
- [ ] run `bin/build-gems` and make sure it completes and all the tests pass
- push
- [ ] `git push && git push --tags`
- [ ] `for g in gems/*.gem ; do gem push $g ; done`
- announce
- [ ] create a release at https://github.com/sparklemotion/sqlite3-ruby/releases and include sha2 checksums
|
