How manatunga/repopy works
repopy is a Python CLI workspace manager. Users select a subcommand, which routes to a command handler and then a supervisor: init scaffolds themed projects, clone fetches a repository and provisions its environment, link pushes a local repository upstream, clean removes artifacts, and info reports workspace metadata. The README documents these capabilities and the four layout presets. The graph includes the shared engines, templates, prompts, and validation layer; unsampled command and engine details are represented only where the README or SOURCE INDEX supports them.
Main entry points: orchestrators.py Workflow supervisors · __init__.py Command registry · init.py Init command · clone.py Clone command
Components 19
CLI and commands
- Application entry
src/repopy/__main__.py - Argument parser
src/repopy/ui/cli.py - Command registry
src/repopy/commands/__init__.py - Init command
src/repopy/commands/init.py - Clone command
src/repopy/commands/clone.py - Link command
src/repopy/commands/link.py - Clean command
src/repopy/commands/clean.py - Info command
src/repopy/commands/info.py - Command contract
src/repopy/commands/base.py
Workflow supervision
- Workflow supervisors
src/repopy/orchestrators.py
Workspace engines
- Filesystem and venv
src/repopy/engines/file_system.py - Git operations
src/repopy/engines/git_engine.py - Workspace inspection
src/repopy/engines/info.py - Scaffold templates
src/repopy/templates.py
Prompts and validation
- Interactive prompts
src/repopy/ui/prompts.py - Input validation
src/repopy/validators/validators.py - Host checks
src/repopy/validators/dependencies.py - OS detection
src/repopy/validators/os_detector.py
Other components
- CLI user
Connections 27
- CLI user → Application entry: runs CLI
README.md - Application entry → Argument parser: parses arguments
src/repopy/__main__.py - Argument parser → Command registry: loads commands
src/repopy/ui/cli.py - Command registry → Init command: registers
src/repopy/commands/__init__.py - Command registry → Clone command: registers
src/repopy/commands/__init__.py - Command registry → Link command: registers
src/repopy/commands/__init__.py - Command registry → Clean command: registers
src/repopy/commands/__init__.py - Command registry → Info command: registers
src/repopy/commands/__init__.py - Init command → Command contract: implements
src/repopy/commands/init.py - Clone command → Command contract: implements
src/repopy/commands/clone.py - Init command → Workflow supervisors: starts workflow
src/repopy/commands/init.py - Clone command → Workflow supervisors: starts workflow
src/repopy/commands/clone.py - Link command → Workflow supervisors: starts workflow
src/repopy/commands/link.py - Clean command → Workflow supervisors: starts workflow
src/repopy/commands/clean.py - Info command → Workflow supervisors: starts workflow
src/repopy/commands/info.py - Init command → Interactive prompts: captures manifest
src/repopy/commands/init.py - Workflow supervisors → Filesystem and venv: provisions and cleans
src/repopy/orchestrators.py - Workflow supervisors → Git operations: clones or links
src/repopy/orchestrators.py - Workflow supervisors → Workspace inspection: reads metadata
src/repopy/orchestrators.py - Workflow supervisors → Interactive prompts: requests confirmation
src/repopy/orchestrators.py - Workflow supervisors → Input validation: validates input
src/repopy/orchestrators.py - Workflow supervisors → Host checks: checks host tools
src/repopy/orchestrators.py - Workflow supervisors → Scaffold templates: formats info
src/repopy/orchestrators.py - Filesystem and venv → Scaffold templates: writes generated files
src/repopy/engines/file_system.py - Filesystem and venv → OS detection: selects venv tools
src/repopy/engines/file_system.py - Interactive prompts → Input validation: checks project name
src/repopy/ui/prompts.py - Workspace inspection → OS detection: detects platform
src/repopy/engines/info.py