mongodol
Access MongoDB through a Mapping (dict-like) interface.
mongodol wraps pymongo collections as Mapping/MutableMapping objects (readers and
persisters), so you can read and write mongo data with normal dict-like syntax, and
compose your own key/value transforms with dol wrappers
instead of writing backend-specific boilerplate.
To install:
pip install mongodol
And of course, you need a running MongoDB -- see the installation instructions.
For AI agents
mongodol publishes its documentation in forms made for coding agents. If you are one, start here.
The documentation, machine-readable: llms.txt indexes every page; mongodol.md is the whole documentation in one file; every page has a .md twin; objects.inv maps symbols to URLs.
If you are a control freak, the rest of this README is written for you, starting at Quick start.
Quick start
from mongodol import MongoCollectionPersister, mk_dflt_mgc
# mk_dflt_mgc() gives you a pymongo collection to play with (mongodol/mongodol_test by default)
mgc = mk_dflt_mgc()
mgc.delete_many(
{}
) # start from an empty collection (skip this to keep what's already there)
s = MongoCollectionPersister(mgc, getitem_projection={"_id": False})
len(s)
# 0
k = {"_id": "my_id"}
s[k] = {"mongo": "uses", "json": "data"}
list(s)
# [{'_id': 'my_id'}]
Since the base reader is a thin, low-level wrapper, s[k] returns a pymongo.cursor.Cursor
(a key may match zero, one, or many docs), so you fetch the value(s) explicitly:
next(s[k])
# {'mongo': 'uses', 'json': 'data'}
del s[k]
len(s)
# 0
Beyond the base classes
The base MongoCollectionReader/MongoCollectionPersister classes always return cursors
and never validate uniqueness. For the common case of "one key maps to one doc", use one
of the *UniqueDoc*/*FirstDoc* reader and persister classes instead:
from mongodol import MongoCollectionUniqueDocReader
MongoCollectionUniqueDocReader gives you s[k] as a plain dict (not a cursor), and
raises KeyNotUniqueError if more than one doc matches k. See its docstring for a
runnable example.
For custom key/value shapes, business logic, or connecting mongodol stores to the rest
of the dol ecosystem (caching, serialization,
key transforms, etc.), wrap a mongodol store with dol.wrap_kvs like you would any
other dol store.
More
See the package documentation and the flat
mongodol.md aggregate for the full API.
Metadata
Release files for mongodol 0.1.11
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mongodol-0.1.11.tar.gz | 62.4 kB | Without provenance | Details for mongodol-0.1.11.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mongodol-0.1.11-py3-none-any.whl | Python 3 | none | any | Details for mongodol-0.1.11-py3-none-any.whl |
Total release size: 132.2 kB
Release files / mongodol-0.1.11.tar.gz
| Download URL | mongodol-0.1.11.tar.gz |
|---|---|
| Size | 62.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
711ed90a4ca7c315681d27eafeeb8055246792b26f1070c6d394b99eea2c25a4
|
|
BLAKE2b-256 checksum How to use checksums |
458cbeb76416de77d2f771d86e05dc60235b41ff417bc0b6ebac9d39dba0ffdc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.3 {"installer":{"name":"uv","version":"0.13.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mongodol-0.1.11-py3-none-any.whl
| Download URL | mongodol-0.1.11-py3-none-any.whl |
|---|---|
| Size | 69.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2f4b486ff247eddb59e86e6088420e7e44ed17edf505ac1a2a6a515fad070dde
|
|
BLAKE2b-256 checksum How to use checksums |
83ff3f4759537c60967583515ce567f784b2b46fc0b195b25e263bc6357b7e7e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.3 {"installer":{"name":"uv","version":"0.13.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for mongodol 0.1.11
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.