mpt-tool is the migration toolkit used by SoftwareOne extensions to scaffold, validate, and execute schema and data migrations through the mpt-service-cli entry point.
Start here:
- AGENTS.md: entry point for AI agents
- docs/architecture.md: package structure, execution flow, and storage model
- docs/contributing.md: repository-specific workflow and validation commands
- docs/testing.md: test scope and quality checks
- docs/migrations.md: migration lifecycle and repository-specific migration rules
- docs/documentation.md: repository documentation rules
- docs/usage.md: end-user CLI usage guide and installation instructions
Prerequisites:
- Docker with the
docker composeplugin make
Recommended local setup:
cp .env.sample .env
make build
make runmake run opens the container with mpt-service-cli available. Use mpt-service-cli migrate --help there to inspect supported commands.
mpt_tool/: CLI, command layer, migration base classes, managers, and use casesmigrations/: generated migration scripts for local development and examplestests/: pytest suitemake/: modular make targetsdocs/: repository documentation