Skip to main content

proposal

Usage: pmc proposal [OPTIONS] COMMAND [ARGS]...

Interact with existing proposals

╭─ Options ───────────────────────────────────────────────────────────────────╮
│ -h, --help Show this message and exit
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ──────────────────────────────────────────────────────────────────╮
│ info Gets information of a given proposal │
│ list List all proposals that you can vote on │
│ revoke Revoke/remove a proposal submitted by you │
│ vote Providers decide if proposed changes should be applied. Use this │
function to vote yes or no to a proposal. │
╰─────────────────────────────────────────────────────────────────────────────╯

The command (pmc proposal) has sub-commands to see and vote on existing proposals in the network.

proposal info

Usage: pmc proposal info [OPTIONS]

Gets information of a given proposal

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│ -cfg, --config=CONFIG Alternate path for client configuration file
│ -s, --settings=SETTINGS Alternate path for project settings file
│ --lookup-brid Ignore any 'brid' property in configuration file, │
│ always perform lookup │
--network=TEXT Target network to make requests to (if chromia.yml│
│ is configured)
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
--id=INT Id of the proposal │
│ -h, --help Show this message and exit
╰─────────────────────────────────────────────────────────────────────────────╯

The info command (pmc proposal info) gets information about a given proposal specified by its id. You can add the -v flag to see the entire proposal content.

Example usage:

pmc proposal info --id 123456

proposal list

Usage: pmc proposal list [OPTIONS]

List all proposals that you can vote on

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│ -cfg, --config=CONFIG Alternate path for client configuration file
│ -s, --settings=SETTINGS Alternate path for project settings file
│ --lookup-brid Ignore any 'brid' property in configuration file, │
│ always perform lookup │
--network=TEXT Target network to make requests to (if chromia.yml│
│ is configured)
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
--from=VALUE List proposals from date (YYYY-MM-DD) (default: │
1970-01-01)
--to=VALUE List proposals to date (YYYY-MM-DD) (default: │
9999-12-31)
--all Include all proposals, including ones you can not vote │
│ on │
--pending Only include proposals that are still pending │
│ -i, --interactive Prompt for item to show details for
--since=INT DEPRECATED: List proposals since proposal id (default: │
0)
│ -h, --help Show this message and exit
╰─────────────────────────────────────────────────────────────────────────────╯

The list command (pmc proposal list) lists all the active proposals since a given index.

proposal revoke

Usage: pmc proposal revoke [OPTIONS]

Revoke/remove a proposal submitted by you

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│ -cfg, --config=CONFIG Alternate path for client configuration file
│ -s, --settings=SETTINGS Alternate path for project settings file
│ --lookup-brid Ignore any 'brid' property in configuration file, │
│ always perform lookup │
--network=TEXT Target network to make requests to (if chromia.yml│
│ is configured)
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│* --id=INT Id of the proposal │
│ -h, --help Show this message and exit
╰─────────────────────────────────────────────────────────────────────────────╯

The revoke command (pmc proposal revoke) removes your proposal.

proposal vote

Usage: pmc proposal vote [OPTIONS]

Providers decide if proposed changes should be applied. Use this function to
vote yes or no to a proposal.

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│ -cfg, --config=CONFIG Alternate path for client configuration file
│ -s, --settings=SETTINGS Alternate path for project settings file
│ --lookup-brid Ignore any 'brid' property in configuration file, │
│ always perform lookup │
--network=TEXT Target network to make requests to (if chromia.yml│
│ is configured)
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│* --id=INT Id of the proposal │
│ -y, --accept / -n, --reject Accept or reject this proposal │
│ -h, --help Show this message and exit
╰─────────────────────────────────────────────────────────────────────────────╯

The vote command (pmc provider vote) enables providers to vote on whether the proposed configuration changes suggested by another provider should be applied.

Example usage:

pmc provider vote --id 12345 --accept