A guided tour of the millipds codebase#

The source is in src/millipds/.

The entrypoint for the main millipds command is __main__.py. CLI arg parsing happens here.

If you choose to launch the server, it calls out to service.py, which sets up an aiohttp application.

General-purpose routes are implemented right there in service.py, but others are handled in:

• auth_oauth.py - oauth stuff
• atproto_repo.py - com.atproto.repo.* endpoints
• atproto_sync.py - com.atproto.sync.* endpoints

repo_ops.py implements core repo commit logic - it's quite complex, even though atmst takes care of the actual MST operations.

database.py handles Database Stuff™, using apsw as an SQLite driver. There are also SQL queries littered throughout the rest of the codebase (no ORM...) The application is quite tightly coupled to SQLite-specific features (I've lost track of which ones).

crypto.py depends on pyca/cryptography and provides utilities for basic crypto stuff, including generating "low-S" signatures.