SAService Architect Back to designer
SAService ArchitectDocumentation
Code GenerationMake commands
Code generation make python-*

Python commands

Python targets use uv for reproducible package setup, generation, testing, linting, images, integration checks, and standalone packaging.

When to use

Use this reference when generating, reviewing or operating a Service Architect project.

Behavior

  • Generic workspace targets include these commands whenever Python services or Modules exist.
  • Service and Module Makefiles remain independently usable after packaging.

Python workspace commands

Language-specific root targets.

CommandScopeDescription
make python-toolsWorkspace

Verify or install the pinned Python and uv toolchain.

make python-initWorkspace

Create/synchronize environments and generate required bindings.

make python-buildWorkspace

Build every generated Python service and Module package.

make python-testWorkspace

Run generated Python test suites.

make python-lintWorkspace

Run configured Python lint and type checks.

make python-formatWorkspace

Format generated and preserved Python sources.

make python-genWorkspace

Generate schema and transport bindings.

make python-docker-buildWorkspace

Build production Python service images.

make python-docker-dev-buildWorkspace

Build source-oriented development images.

make python-integration-testWorkspace

Run the generated cross-service Python scenario.

make python-packageWorkspace

Package all Python services as standalone repositories.

make python-package-<service-name>Service

Package one service; the target suffix is derived from Service.name.

make python-cleanWorkspace

Remove Python build, cache, and environment artifacts.

Standalone Python service commands

Targets inside a generated Python service.

CommandScopeDescription
make init / buildService

Synchronize the environment, generate bindings, and build the package.

make testService

Run the service test suite.

make lint / fmtService

Run configured lint/type checks or format sources.

make cleanService

Remove generated Python build and cache artifacts.

make docker-build / docker-upService

Build and start the standalone production image.

make docker-build-dev / docker-up-devService

Build and start the development image.

make debugService

Start the service with the generated Python debugger configuration.

make docker-down / docker-down-dev / docker-cleanService

Stop production/development Compose or remove volumes.

make helpService

Print the standalone command list.

Python Module commands

Targets inside a generated user-defined Module package.

CommandScopeDescription
make generateModule

Generate owned protobuf or OpenAPI bindings when present.

make buildModule

Generate bindings and build the Python package.

make testModule

Run Module tests.

make lint / fmtModule

Check or format Module sources.

make cleanModule

Remove package build and cache artifacts.

make helpModule

Print the Module command list.

Python workflow

make python-init
make python-lint
make python-test
make python-docker-build
make python-package-<service-name>