How allcode-1/pyarch works
PyArch is a CLI for creating and extending layered FastAPI projects. Users initialize a project, then use manifest-aware commands to add CRUD modules or JWT authentication, inspect project configuration, and manage PostgreSQL database lifecycle. The generation path runs from CLI commands through application services and generators to rendered templates and files; module and auth generation also update registration markers. The README documents these layers, while sampled source confirms several concrete calls. Some service and CLI relationships rely on the SOURCE INDEX rather than inspected implementations.
Main entry points: app.py Command router · create_project.py Project service · auth.py Auth generator · renderer.py Template renderer
Components 23
CLI
- Command router
src/pyarch/cli/app.py - Init command
src/pyarch/cli/init.py - Module command
src/pyarch/cli/generate.py - Integration command
src/pyarch/cli/add.py - Database commands
src/pyarch/cli/db.py - Info command
src/pyarch/cli/info.py
Application services
- Project manifest
src/pyarch/config/manifest.py - Project settings
src/pyarch/config/models.py - Project service
src/pyarch/services/create_project.py - Module service
src/pyarch/services/create_module.py - Integration service
src/pyarch/services/add_integration.py - Database service
src/pyarch/services/database.py
Project generation
- Base scaffold
src/pyarch/generators/project/base.py - Layered scaffold
src/pyarch/generators/project/layered.py - CRUD generator
src/pyarch/generators/module/layered.py - Auth generator
src/pyarch/generators/integration/auth.py - Project templates
src/pyarch/templates
Generation support
- File operations
src/pyarch/generators/common/filesystem.py - Template renderer
src/pyarch/generators/common/renderer.py - Command runner
src/pyarch/generators/common/commands.py - Ignore updates
src/pyarch/generators/common/gitignore.py
Other components
- CLI user
- Generated FastAPI project
Connections 35
- CLI user → Command router: runs commands
README.md - Command router → Init command: registers
src/pyarch/cli/app.py - Command router → Module command: registers
src/pyarch/cli/app.py - Command router → Integration command: registers
src/pyarch/cli/app.py - Command router → Database commands: registers
src/pyarch/cli/app.py - Command router → Info command: registers
src/pyarch/cli/app.py - Init command → Project service: delegates
src/pyarch/cli/init.py - Module command → Module service: delegates
src/pyarch/cli/generate.py - Integration command → Integration service: delegates
src/pyarch/cli/add.py - Database commands → Database service: delegates
src/pyarch/cli/db.py - Info command → Project manifest: reads
src/pyarch/cli/info.py - Project service → Project manifest: writes
src/pyarch/services/create_project.py - Project service → Project settings: uses settings
src/pyarch/services/create_project.py - Project service → Base scaffold: creates scaffold
src/pyarch/services/create_project.py - Project service → Layered scaffold: creates layers
src/pyarch/services/create_project.py - Module service → Project manifest: updates state
src/pyarch/services/create_module.py - Module service → CRUD generator: generates module
src/pyarch/services/create_module.py - Integration service → Project manifest: updates state
src/pyarch/services/add_integration.py - Integration service → Auth generator: generates auth
src/pyarch/services/add_integration.py - Database service → Project manifest: loads project
src/pyarch/services/database.py - Database service → Command runner: runs lifecycle
src/pyarch/services/database.py - Base scaffold → Template renderer: renders files
src/pyarch/generators/project/base.py - Base scaffold → Command runner: initializes project
src/pyarch/generators/project/base.py - Base scaffold → Ignore updates: updates ignores
src/pyarch/generators/project/base.py - Layered scaffold → Template renderer: renders layers
src/pyarch/generators/project/layered.py - Layered scaffold → Command runner: installs dependencies
src/pyarch/generators/project/layered.py - Layered scaffold → File operations: creates packages
src/pyarch/generators/project/layered.py - CRUD generator → Template renderer: renders CRUD
src/pyarch/generators/module/layered.py - CRUD generator → File operations: registers routes
src/pyarch/generators/module/layered.py - Auth generator → Template renderer: renders auth
src/pyarch/generators/integration/auth.py - Auth generator → File operations: registers auth
src/pyarch/generators/integration/auth.py - Auth generator → Command runner: installs dependencies
src/pyarch/generators/integration/auth.py - Auth generator → Ignore updates: updates ignores
src/pyarch/generators/integration/auth.py - Template renderer → Project templates: loads
src/pyarch/generators/common/renderer.py - Project templates → Generated FastAPI project: render into
README.md