process

The one command type: an external process to start, as an executable and its arguments.

A command is declared once so that it passes from whatever produced it to whatever runs it as itself. A repo adapter answers a verb with one, and anything that starts a process takes one.

Obtaining it

Name the coordinate process:process among the libraries your repository vendors. It arrives with type:type, the base every generated model has, and depends on nothing else.

Public API

Import from the package root, process. The surface is what the package root exports, and nothing deeper.

from process import Command, argv, from_argv

command = Command(executable="ruff", args=["check", "--fix"])
argv(command=command)                    # ["ruff", "check", "--fix"]
from_argv(argv=["ruff", "format"])       # Command(executable="ruff", args=["format"])

The document format

process:command is the one schema this package defines, command.schema.yml. A schema document that holds a command references it by coordinate:

externalSchemas:
  process:
    id: process:command
    target: process
definitions:
  launch:
    fields:
      command:
        type: process.command

Responsibilities

What this package owns:

What it leaves to others: