cli Package

cli Package

composer.cli.main(opts)

Main program execution

Parameters:opts (argparse.Namespace) – Cmdline arguments

blueprints Module

composer.cli.blueprints.blueprints_changes(socket_path, api_version, args, show_json=False)

Display the changes for each of the blueprints

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output

blueprints changes <blueprint,...> Display the changes for each blueprint.

composer.cli.blueprints.blueprints_cmd(opts)

Process blueprints commands

Parameters:opts (argparse.Namespace) – Cmdline arguments Returns:Value to return from sys.exit() Return type:int

This dispatches the blueprints commands to a function

composer.cli.blueprints.blueprints_delete(socket_path, api_version, args, show_json=False)

Delete a blueprint from the server

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output

delete <blueprint> Delete a blueprint from the server

composer.cli.blueprints.blueprints_depsolve(socket_path, api_version, args, show_json=False)

Display the packages needed to install the blueprint

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output

blueprints depsolve <blueprint,...> Display the packages needed to install the blueprint.

composer.cli.blueprints.blueprints_diff(socket_path, api_version, args, show_json=False)

Display the differences between 2 versions of a blueprint

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output

blueprints diff <blueprint-name> Display the differences between 2 versions of a blueprint.

<from-commit> Commit hash or NEWEST <to-commit> Commit hash, NEWEST, or WORKSPACE

composer.cli.blueprints.blueprints_freeze(socket_path, api_version, args, show_json=False)

Handle the blueprints freeze commands

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output

blueprints freeze <blueprint,...> Display the frozen blueprint’s modules and packages. blueprints freeze show <blueprint,...> Display the frozen blueprint in TOML format. blueprints freeze save <blueprint,...> Save the frozen blueprint to a file, <blueprint-name>.frozen.toml.

composer.cli.blueprints.blueprints_freeze_save(socket_path, api_version, args, show_json=False)

Save the frozen blueprint to a TOML file

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output

blueprints freeze save <blueprint,...> Save the frozen blueprint to a file, <blueprint-name>.frozen.toml.

composer.cli.blueprints.blueprints_freeze_show(socket_path, api_version, args, show_json=False)

Show the frozen blueprint in TOML format

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output

blueprints freeze show <blueprint,...> Display the frozen blueprint in TOML format.

composer.cli.blueprints.blueprints_list(socket_path, api_version, args, show_json=False)

Output the list of available blueprints

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output

blueprints list

composer.cli.blueprints.blueprints_push(socket_path, api_version, args, show_json=False)

Push a blueprint TOML file to the server, updating the blueprint

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output

push <blueprint> Push a blueprint TOML file to the server.

composer.cli.blueprints.blueprints_save(socket_path, api_version, args, show_json=False)

Save the blueprint to a TOML file

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output

blueprints save <blueprint,...> Save the blueprint to a file, <blueprint-name>.toml

composer.cli.blueprints.blueprints_show(socket_path, api_version, args, show_json=False)

Show the blueprints, in TOML format

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output

blueprints show <blueprint,...> Display the blueprint in TOML format.

Multiple blueprints will be separated by

composer.cli.blueprints.blueprints_tag(socket_path, api_version, args, show_json=False)

Tag the most recent blueprint commit as a release

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output

blueprints tag <blueprint> Tag the most recent blueprint commit as a release.

composer.cli.blueprints.blueprints_undo(socket_path, api_version, args, show_json=False)

Undo changes to a blueprint

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output

blueprints undo <blueprint> <commit> Undo changes to a blueprint by reverting to the selected commit.

composer.cli.blueprints.blueprints_workspace(socket_path, api_version, args, show_json=False)

Push the blueprint TOML to the temporary workspace storage

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output

blueprints workspace <blueprint> Push the blueprint TOML to the temporary workspace storage.

composer.cli.blueprints.dict_names(lst)

Return comma-separated list of the dict’s name/user fields

Parameters:d (dict) – key/values Returns:String of the dict’s keys and values Return type:str

root, norm

composer.cli.blueprints.prettyCommitDetails(change, indent=4)

Print the blueprint’s change in a nice way

Parameters:

• change (dict) – The individual blueprint change dict
• indent (int) – Number of spaces to indent

composer.cli.blueprints.pretty_dict(d)

Return the dict as a human readable single line

Parameters:d (dict) – key/values Returns:String of the dict’s keys and values Return type:str

key=”str”, key=”str1,str2”, ...

composer.cli.blueprints.pretty_diff_entry(diff)

Generate nice diff entry string.

Parameters:diff (dict) – Difference entry dict Returns:Nice string

compose Module

composer.cli.compose.compose_cancel(socket_path, api_version, args, show_json=False, testmode=0)

Cancel a running compose

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output
• testmode (int) – unused in this function

compose cancel <uuid>

This will cancel a running compose. It does nothing if the compose has finished.

composer.cli.compose.compose_cmd(opts)

Process compose commands

Parameters:opts (argparse.Namespace) – Cmdline arguments Returns:Value to return from sys.exit() Return type:int

This dispatches the compose commands to a function

composer.cli.compose.compose_delete(socket_path, api_version, args, show_json=False, testmode=0)

Delete a finished compose’s results

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output
• testmode (int) – unused in this function

compose delete <uuid,...>

Delete the listed compose results. It will only delete results for composes that have finished or failed, not a running compose.

composer.cli.compose.compose_details(socket_path, api_version, args, show_json=False, testmode=0)

Return detailed information about the compose

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output
• testmode (int) – unused in this function

compose details <uuid>

This returns information about the compose, including the blueprint and the dependencies.

composer.cli.compose.compose_image(socket_path, api_version, args, show_json=False, testmode=0)

Download the compose’s output image

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output
• testmode (int) – unused in this function

compose image <uuid>

This downloads only the result image, saving it as the image name, which depends on the type of compose that was selected.

composer.cli.compose.compose_list(socket_path, api_version, args, show_json=False, testmode=0)

Return a simple list of compose identifiers

composer.cli.compose.compose_log(socket_path, api_version, args, show_json=False, testmode=0)

Show the last part of the compose log

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output
• testmode (int) – unused in this function

compose log <uuid> [<size>kB]

This will display the last 1kB of the compose’s log file. Can be used to follow progress during the build.

composer.cli.compose.compose_logs(socket_path, api_version, args, show_json=False, testmode=0)

Download a tar of the compose’s logs

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output
• testmode (int) – unused in this function

compose logs <uuid>

Saves the logs as uuid-logs.tar

composer.cli.compose.compose_metadata(socket_path, api_version, args, show_json=False, testmode=0)

Download a tar file of the compose’s metadata

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output
• testmode (int) – unused in this function

compose metadata <uuid>

Saves the metadata as uuid-metadata.tar

composer.cli.compose.compose_results(socket_path, api_version, args, show_json=False, testmode=0)

Download a tar file of the compose’s results

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output
• testmode (int) – unused in this function

compose results <uuid>

The results includes the metadata, output image, and logs. It is saved as uuid.tar

composer.cli.compose.compose_start(socket_path, api_version, args, show_json=False, testmode=0)

Start a new compose using the selected blueprint and type

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output
• testmode (int) – Set to 1 to simulate a failed compose, set to 2 to simulate a finished one.

compose start <blueprint-name> <compose-type>

composer.cli.compose.compose_status(socket_path, api_version, args, show_json=False, testmode=0)

Return the status of all known composes

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output
• testmode (int) – unused in this function

This doesn’t map directly to an API command, it combines the results from queue, finished, and failed so raw JSON output is not available.

composer.cli.compose.compose_types(socket_path, api_version, args, show_json=False, testmode=0)

Return information about the supported compose types

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output
• testmode (int) – unused in this function

Add additional details to types that are known to composer-cli. Raw JSON output does not include this extra information.

help Module

modules Module

composer.cli.modules.modules_cmd(opts)

Process modules commands

Parameters:opts (argparse.Namespace) – Cmdline arguments Returns:Value to return from sys.exit() Return type:int

projects Module

composer.cli.projects.projects_cmd(opts)

Process projects commands

Parameters:opts (argparse.Namespace) – Cmdline arguments Returns:Value to return from sys.exit() Return type:int

composer.cli.projects.projects_info(socket_path, api_version, args, show_json=False)

Output info on a list of projects

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output

projects info <project,...>

composer.cli.projects.projects_list(socket_path, api_version, args, show_json=False)

Output the list of available projects

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output

projects list

sources Module

composer.cli.sources.sources_add(socket_path, api_version, args, show_json=False)

Add or change a source

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output

sources add <source.toml>

composer.cli.sources.sources_cmd(opts)

Process sources commands

Parameters:opts (argparse.Namespace) – Cmdline arguments Returns:Value to return from sys.exit() Return type:int

composer.cli.sources.sources_delete(socket_path, api_version, args, show_json=False)

Delete a source

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output

sources delete <source-name>

composer.cli.sources.sources_info(socket_path, api_version, args, show_json=False)

Output info on a list of projects

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output

sources info <source-name>

composer.cli.sources.sources_list(socket_path, api_version, args, show_json=False)

Output the list of available sources

Parameters:

• socket_path (str) – Path to the Unix socket to use for API communication
• api_version (str) – Version of the API to talk to. eg. “0”
• args (list of str) – List of remaining arguments from the cmdline
• show_json (bool) – Set to True to show the JSON output instead of the human readable output

sources list

status Module

composer.cli.status.status_cmd(opts)

Process status commands

Parameters:opts (argparse.Namespace) – Cmdline arguments Returns:Value to return from sys.exit() Return type:int

utilities Module

composer.cli.utilities.argify(args)

Take a list of human args and return a list with each item

Parameters:args (list of str) – list of strings with possible commas and spaces Returns:List of all the items Return type:list of str

Examples:

[“one,two”, “three”, ”,four”, ”,five,”] returns [“one”, “two”, “three”, “four”, “five”]

composer.cli.utilities.frozen_toml_filename(blueprint_name)

Convert a blueprint name into a filename.toml

Parameters:blueprint_name (str) – The blueprint’s name Returns:The blueprint name with ‘ ‘ converted to - and .toml appended Return type:str

composer.cli.utilities.handle_api_result(result, show_json=False)

Log any errors, return the correct value

Parameters:result (dict) – JSON result from the http query Return type:tuple Returns:(rc, should_exit_now)

Return the correct rc for the program (0 or 1), and whether or not to continue processing the results.

composer.cli.utilities.packageNEVRA(pkg)

Return the package info as a NEVRA

Parameters:pkg (dict) – The package details Returns:name-[epoch:]version-release-arch Return type:str

composer.cli.utilities.toml_filename(blueprint_name)

Convert a blueprint name into a filename.toml

Parameters:blueprint_name (str) – The blueprint’s name Returns:The blueprint name with ‘ ‘ converted to - and .toml appended Return type:str