httk.core.project.cli

The core-owned httk project command.

httk project owns the anchor: init creates one (like git init), show describes it, seal creates a signed redistribution, verify-seal checks one, and import-v1 migrates a legacy project.

Attributes

Handler

Functions

describe_project([root])	Describe one project's anchor.
build_parser(program)	Build the core-owned project command tree.
command(argv, context)	Handle the registered top-level project command.

Module Contents

httk.core.project.cli.Handler

httk.core.project.cli.describe_project(root=None)

Describe one project’s anchor.

Parameters:

root (str | pathlib.Path | None) – Project root, or None to discover the nearest project.

Returns:

JSON-ready description of project metadata and trust keys.

Raises:

ValueError – If no project exists or its metadata is invalid.

Return type:

dict[str, object]

httk.core.project.cli.build_parser(program)

Build the core-owned project command tree.

Parameters:

program (str) – Program name used by the parser in help and errors.

Returns:

Configured project command parser.

Return type:

argparse.ArgumentParser

httk.core.project.cli.command(argv, context)

Handle the registered top-level project command.

Parameters:

• argv (collections.abc.Sequence[str]) – Arguments following the project command name.

• context (httk.core.cli.CLIContext) – Root CLI invocation context.

Returns:

Command exit status.

Return type:

int