Python CLI utility and library for manipulating SQLite databases https://sqlite-utils.datasette.io
  • Python 99.7%
  • C 0.2%
Find a file
Simon Willison 8e91de8e4e
Python 3.9 (#184)
* Test against Python 3.9
* Programming Language :: Python :: 3.9 classifier
* Python versions badge
2020-10-07 18:44:05 -07:00
.github/workflows Python 3.9 (#184) 2020-10-07 18:44:05 -07:00
docs Include --column-order in combined example, refs #176 2020-09-24 13:33:19 -07:00
sqlite_utils Simplify drop-foreign-key, and drop_foreign_keys, closes #177 2020-09-24 09:19:07 -07:00
tests Demonstrate extract= creates correct foreign keys 2020-09-24 15:46:46 -07:00
.gitignore More things to .gitignore 2020-05-10 18:29:29 -07:00
LICENSE Added LICENSE file 2019-02-23 09:16:57 -08:00
MANIFEST.in Explicitly include tests and docs in sdist (#75) 2020-01-30 16:21:26 -08:00
README.md Python 3.9 (#184) 2020-10-07 18:44:05 -07:00
setup.py Python 3.9 (#184) 2020-10-07 18:44:05 -07:00

sqlite-utils

PyPI Changelog Python 3.x Tests Documentation Status License

Python CLI utility and library for manipulating SQLite databases.

Read more on my blog: sqlite-utils: a Python library and CLI tool for building SQLite databases

Installation

pip install sqlite-utils

Using as a CLI tool

Now you can do things with the CLI utility like this:

$ sqlite-utils tables dogs.db --counts
[{"table": "dogs", "count": 2}]

$ sqlite-utils dogs.db "select * from dogs"
[{"id": 1, "age": 4, "name": "Cleo"},
 {"id": 2, "age": 2, "name": "Pancakes"}]

$ sqlite-utils dogs.db "select * from dogs" --csv
id,age,name
1,4,Cleo
2,2,Pancakes

$ sqlite-utils dogs.db "select * from dogs" --table
  id    age  name
----  -----  --------
   1      4  Cleo
   2      2  Pancakes

You can even import data into a new database table like this:

$ curl https://api.github.com/repos/simonw/sqlite-utils/releases \
    | sqlite-utils insert releases.db releases - --pk id

Full CLI documentation: https://sqlite-utils.readthedocs.io/en/stable/cli.html

Using as a library

You can also import sqlite_utils and use it as a Python library like this:

import sqlite_utils
db = sqlite_utils.Database("demo_database.db")
# This line creates a "dogs" table if one does not already exist:
db["dogs"].insert_all([
    {"id": 1, "age": 4, "name": "Cleo"},
    {"id": 2, "age": 2, "name": "Pancakes"}
], pk="id")

Full library documentation: https://sqlite-utils.readthedocs.io/en/stable/python-api.html

  • Datasette: A tool for exploring and publishing data
  • csvs-to-sqlite: Convert CSV files into a SQLite database
  • db-to-sqlite: CLI tool for exporting a MySQL or PostgreSQL database as a SQLite file
  • dogsheep: A family of tools for personal analytics, built on top of sqlite-utils