3.9. MongoDB Template

The MongoDB Template provides a DatabasePort adapter backed by MongoDB (via pymongo), giving your project document storage instead of the zero-dependency, in-memory storage every fresh project starts with.

It’s an interchangeable template: install it on its own to replace the in-memory default, or alongside SQLAlchemy — config/app.toml’s default_database_adapter picks which one backs the generic default when both are installed, and code that specifically wants document storage can use MongoDB directly regardless of that setting.

3.9.1. What it adds

• A MongoDB connection, configured through its own config/mongodb.toml.

• Filter translation so the domain’s engine-agnostic filters (EqualFilter, LikeFilter, …) work against MongoDB queries.

• A demo domain model (Programmer), separate from the generic User model the base template ships, with its own runner (below).

3.9.2. Runners

The MongoDB Template ships one tool runner, in runners/tools/programmers.py, to see document storage in action:

• python tools programmers seed replaces the demo collection with the sample programmers and then lists them.

• python tools programmers list lists the programmers already stored. If none exist yet, it tells you to run seed first.