composer.cli package

Submodules

composer.cli.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

composer.cli.cmdline module

composer.cli.cmdline.composer_cli_parser()

Return the ArgumentParser for composer-cli

composer.cli.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_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_info(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 info <uuid>

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

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.

composer.cli.help module

composer.cli.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

composer.cli.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

composer.cli.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

composer.cli.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

composer.cli.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

Module contents

composer.cli.main(opts)

Main program execution

Parameters

opts (argparse.Namespace) -- Cmdline arguments