{"id":15648048,"url":"https://github.com/psanford/sqlite3vfs","last_synced_at":"2025-04-28T15:54:44.013Z","repository":{"id":38423891,"uuid":"391490944","full_name":"psanford/sqlite3vfs","owner":"psanford","description":"Go sqlite3 vfs","archived":false,"fork":false,"pushed_at":"2024-03-15T23:06:25.000Z","size":196,"stargazers_count":46,"open_issues_count":4,"forks_count":8,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-04-28T15:54:35.971Z","etag":null,"topics":["go","golang","sqlite"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/psanford.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-08-01T00:52:04.000Z","updated_at":"2025-04-20T05:28:09.000Z","dependencies_parsed_at":"2023-12-01T20:29:10.667Z","dependency_job_id":"b740fe34-74c9-41e5-b243-4d60abe1bbe8","html_url":"https://github.com/psanford/sqlite3vfs","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/psanford%2Fsqlite3vfs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/psanford%2Fsqlite3vfs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/psanford%2Fsqlite3vfs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/psanford%2Fsqlite3vfs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/psanford","download_url":"https://codeload.github.com/psanford/sqlite3vfs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251342718,"owners_count":21574243,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["go","golang","sqlite"],"created_at":"2024-10-03T12:22:58.532Z","updated_at":"2025-04-28T15:54:43.987Z","avatar_url":"https://github.com/psanford.png","language":"Go","readme":"# sqlite3vfs: Go sqlite3 VFS API\n\nsqlite3vfs is a Cgo API that allows you to create custom sqlite Virtual File Systems (VFS) in Go. You can use this with the `sqlite3` https://github.com/mattn/go-sqlite3 SQL driver.\n\n\n## Basic usage\n\nTo use, simply implement the [VFS](https://pkg.go.dev/github.com/psanford/sqlite3vfs?utm_source=godoc#VFS) and [File](https://pkg.go.dev/github.com/psanford/sqlite3vfs?utm_source=godoc#File) interfaces. Then register your VFS with sqlite3vfs and include the vfs name when opening the database connection:\n\n```\n\t// create your VFS\n\tvfs := newTempVFS()\n\n\tvfsName := \"tmpfs\"\n\terr := sqlite3vfs.RegisterVFS(vfsName, vfs)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tdb, err := sql.Open(\"sqlite3\", fmt.Sprintf(\"foo.db?vfs=%s\", vfsName))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n```\n\nA full example can be found in [sqlite3vfs_test.go](sqlite3vfs_test.go).\n\n## Loadable SQLite3 module\n\nsqlite3vfs can also be built as a SQLite3 loadable module. This allows you to load your vfs at runtime into applications that support SQLite3 modules, including the SQLite3 cli tool.\n\nTo build as a loadable module, set the `-tags SQLITE3VFS_LOADABLE_EXT` build tag. Both [DonutDB](https://github.com/psanford/donutdb/tree/main/donutdb-loadable) and [sqlite3vfshttp](https://github.com/psanford/sqlite3vfshttp/tree/main/sqlite3http-ext) have working examples of building a SQLite3 loadable module.\n\n## Users\n\n- [DonutDB](https://github.com/psanford/donutdb): SQLite on top of DynamoDB (read/write)\n- [sqlite3vfshttp](https://github.com/psanford/sqlite3vfshttp): Query a SQLite database over HTTP using range requests\n- [sqlitezstd](https://github.com/jtarchie/sqlitezstd): Query a SQLite database that had been compressed with zstd seekable\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpsanford%2Fsqlite3vfs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpsanford%2Fsqlite3vfs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpsanford%2Fsqlite3vfs/lists"}