Metadata-Version: 2.1
Name: mo-sqlite
Version: 1.525.24033
Summary: Multithreading for Sqlite, plus expression composition
Home-page: https://github.com/klahnakoski/mo-sqlite
Author: Kyle Lahnakoski
Author-email: kyle@lahnakoski.com
License: MPL 2.0
Classifier: Development Status :: 4 - Beta
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: jx-python ==4.525.24033
Requires-Dist: mo-dots ==9.520.24032
Requires-Dist: mo-files ==6.522.24033
Requires-Dist: mo-future ==7.520.24032
Requires-Dist: mo-imports ==5.520.24032
Requires-Dist: mo-json ==6.522.24033
Requires-Dist: mo-kwargs ==7.520.24032
Requires-Dist: mo-logs ==8.522.24033
Requires-Dist: mo-math ==7.521.24032
Requires-Dist: mo-sql ==4.524.24033
Requires-Dist: mo-threads ==6.522.24033
Requires-Dist: mo-times ==5.522.24033
Provides-Extra: tests
Requires-Dist: mo-testing ; extra == 'tests'

# More SQLite!

Multithreading for Sqlite, plus expression composition

## Multi-threaded Sqlite

This module wraps the `sqlite3.connection` with thread-safe traffic manager.  Here is typical usage: 

    from mo_sqlite import Sqlite
    db = Sqlite("mydb.sqlite")
    with db.transaction() as t:
        t.command("insert into mytable values (1, 2, 3)")

While you may have each thread own a `sqlite3.connection` to the same file, you will still get exceptions when another thread has the file locked.

## Pull JSON out of database

This module includes a minimum experimental structure that can describe pulling deeply nested JSON documents out of a normalized database.  The tactic is to shape a single query who's resultset can be easily converted to the desired JSON by Python. Read more on [pulling json from a database](docs/JSON%20in%20Database.md)

There are multiple normal forms, including domain key normal form, and columnar form;  these have a multitude one-to-one relations, all represent the same logical schema, but differ in their access patterns to optimize for particular use cases.  This module intends to hide the particular database schema from the caller; exposing just the logical schema. 



This experiment compliments the [mo-columns](https://github.com/klahnakoski/mo-columns) experiment, which is about pushing JSON into a database. 
   
