hubvault.server.launch

Quick-start launcher for hubvault.server.

This module exposes the import-friendly launch(...) helper and the python -m hubvault.server argument parser. All startup modes still flow through the shared hubvault.server.config.ServerConfig.

The module contains:

• launch() - Start a local uvicorn server

• build_argument_parser() - Build the module CLI parser

• main() - Module entry point

launch

hubvault.server.launch.launch(config: ServerConfig | None = None, **kwargs)

Create and run the embedded ASGI server.

Parameters:

• config (Optional[ServerConfig]) – Optional pre-built server configuration

• kwargs (dict) – Keyword arguments used to build ServerConfig when config is omitted

Returns:

Return value from uvicorn.run()

Return type:

Any

Raises:

• hubvault.optional.MissingOptionalDependencyError – Raised when the API extra is not installed.

• ValueError – Raised when the server configuration is invalid.

build_argument_parser

hubvault.server.launch.build_argument_parser() → ArgumentParser

Build the command-line parser for python -m hubvault.server.

Returns:

Configured argument parser

Return type:

argparse.ArgumentParser

main

hubvault.server.launch.main(argv: Sequence[str] | None = None) → int

Run the module-level quick-start entry point.

Parameters:

argv (Optional[Sequence[str]]) – Optional argument vector overriding sys.argv[1:]

Returns:

Process-style exit status

Return type:

int