{"id":17919360,"url":"https://github.com/zombiezen/sqlite-notebook","last_synced_at":"2025-03-24T00:31:39.183Z","repository":{"id":191471210,"uuid":"683226213","full_name":"zombiezen/sqlite-notebook","owner":"zombiezen","description":"A Jupyter kernel for SQLite","archived":false,"fork":false,"pushed_at":"2023-12-03T04:32:42.000Z","size":431,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-05-01T19:45:01.037Z","etag":null,"topics":["jupyter","jupyter-kernel","jupyter-notebook","sqlite"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zombiezen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-08-25T23:02:15.000Z","updated_at":"2024-03-11T10:50:15.000Z","dependencies_parsed_at":"2023-08-30T03:33:32.972Z","dependency_job_id":null,"html_url":"https://github.com/zombiezen/sqlite-notebook","commit_stats":null,"previous_names":["zombiezen/sqlite-notebook"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zombiezen%2Fsqlite-notebook","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zombiezen%2Fsqlite-notebook/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zombiezen%2Fsqlite-notebook/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zombiezen%2Fsqlite-notebook/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zombiezen","download_url":"https://codeload.github.com/zombiezen/sqlite-notebook/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221925377,"owners_count":16902687,"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":["jupyter","jupyter-kernel","jupyter-notebook","sqlite"],"created_at":"2024-10-28T20:16:19.430Z","updated_at":"2024-10-28T20:16:20.104Z","avatar_url":"https://github.com/zombiezen.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Jupyter kernel for SQLite\n\nA [Jupyter][] [kernel][] for [SQLite][].\nI made this primarily for my personal use, so there may be rough edges.\n\n![A screenshot of the demo notebook in Visual Studio Code](demo/screenshot.png)\n\nCheck out the [demo notebook][] to see it in action.\n\nRun `.help` to see the additional special commands available.\nSee the [SQLite syntax reference][] for help with the SQL language.\n\n[demo notebook]: demo/demo.ipynb\n[Jupyter]: https://jupyter.org/\n[kernel]: https://docs.jupyter.org/en/latest/projects/kernels.html\n[SQLite]: https://www.sqlite.org\n[SQLite syntax reference]: https://www.sqlite.org/lang.html\n\n## Installation\n\nPreferably, use [Nix][] flakes:\n\n```shell\nnix profile install github:zombiezen/sqlite-notebook\n```\n\nMake sure that `$HOME/.nix-profile/share/jupyter` is in the [`JUPYTER_PATH`][].\nOnce installation is complete, SQLite will show up as a kernel that can be used for notebooks.\n\n[`JUPYTER_PATH`]: https://docs.jupyter.org/en/latest/use/jupyter-directories.html#data-files\n[Nix]: https://nixos.org/\n\n### Building from source\n\nI only guarantee that this project will build with Nix\n(since I can guarantee the libraries are set up consistently),\nbut if you want to build in a different way, make sure you have the following installed:\n\n- [Rust](https://www.rust-lang.org/) 1.71.1\n- [SQLite3](https://www.sqlite.org/index.html) 3.42.0\n- [libzmq](https://github.com/zeromq/libzmq) 4.3.4\n- [cre2](https://marcomaggi.github.io/docs/cre2.html/) 0.3.6\n- [jq](https://jqlang.github.io/jq/)\n\nThen run:\n\n```shell\ncargo build --release \u0026\u0026\nmkdir -p ~/.local/share/jupyter/kernels/sqlite-notebook \u0026\u0026\nbash make_kernel_json.sh target/release/sqlite-notebook \u003e \\\n  ~/.local/share/jupyter/kernels/sqlite-notebook/kernel.json\n```\n\n## Using in Jupyter\n\nAssuming you already have [Jupyter][] installed,\nthe kernel will show up in Jupyter Notebook.\nYou can also use `jupyter console --kernel sqlite-notebook` for a CLI REPL.\nSee the [SQLite syntax reference][]\nand run `.help` to see the additional commands available in the notebook.\n\n## Using in Visual Studio Code\n\nYou can use this kernel in [Visual Studio Code][] without installing Jupyter.\n\n1. Open the Command Palette (Ctrl-Shift-P, or ⌘-Shift-P on macOS).\n2. Search for and select \"Create: New Jupyter Notebook\".\n3. [Open the kernel picker](https://code.visualstudio.com/docs/datascience/jupyter-kernel-management#_jupyter-kernels)\n   and select \"Jupyter Kernel...\" → \"SQLite\".\n\n[Visual Studio Code]: https://code.visualstudio.com/\n\n## License\n\n[Apache 2.0](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzombiezen%2Fsqlite-notebook","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzombiezen%2Fsqlite-notebook","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzombiezen%2Fsqlite-notebook/lists"}