DESCRIPTION

usage: mini-buildd-tool [-h] [--version] [-v] [-q] [-O {plain,html,python}]

[-R] [-P {http,https}]

HOST {status,start,stop,printuploaders,meta,getkey,getdputconf,getsourceslist,logcat,list,show,migrate,remove,port,portext,retry,setuserkey,subscription} ...

Command line tool to run API calls.

positional arguments:

HOST

target host, either '[user@]host:port', or '[user@]DPUT_TARGET'

optional arguments:

-h, --help

show this help message and exit

--version

show program's version number and exit

-v, --verbose

lower log level. Give twice for max logs (default: 0)

-q, --quiet

tighten log level. Give twice for min logs (default: 0)

-O {plain,html,python}, --output {plain,html,python}

output type (default: plain)

-R, --reset-save-policy

reset save policy of used keyring (to 'ask') (default: False)

-P {http,https}, --protocol {http,https}

protocol to use. Note: mini-buildd 1.0.x only speaks http -- you may use this in case you have manually set up a https proxy, though. (default: http)

API commands:

{status,start,stop,printuploaders,meta,getkey,getdputconf,getsourceslist,logcat,list,show,migrate,remove,port,portext,retry,setuserkey,subscription}

status

Show the status of the mini-buildd instance. [auth level 0: anonymous]

start

Start the Daemon (engine). [auth level 3: super user login]

stop

Stop the Daemon (engine). [auth level 3: super user login]

printuploaders

Print all GPG ids allowed to upload to repositories. [auth level 3: super user login]

meta

Call arbitrary meta functions for models; usually for internal use only. [auth level 3: super user login]

getkey

Get GnuPG public key. [auth level 0: anonymous]

getdputconf

Get recommended dput config snippet. Usually, this is for integration in your personal ~/.dput.cf. [auth level 0: anonymous]

getsourceslist

Get sources.list (apt lines). Usually, this output is put to a file like '/etc/sources.list.d/mini-builddxyz.list'. [auth level 0: anonymous]

logcat

Cat last n lines of the mini-buildd's log. [auth level 2: staff user login]

list

List packages matching a shell-like glob pattern; matches both source and binary package names. [auth level 1: any user login]

show

Show a source package. [auth level 0: anonymous]

migrate

Migrate a source package (along with all binary packages). [auth level 2: staff user login]

remove

Remove a source package (along with all binary packages). [auth level 3: super user login]

port

Port an internal package. An internal 'port' is a nochanges (i.e., only the changelog will be adapted) rebuild of the given locally-installed package. [auth level 2: staff user login]

portext

Port an external package. An external 'port' is a nochanges (i.e., only the changelog will be adapted) rebuild of any given source package. [auth level 2: staff user login]

retry

Retry a previously failed package. [auth level 2: staff user login]

setuserkey

Set a user's GnuPG public key. [auth level 1: any user login]

subscription

Manage subscriptions to package notifications. A package subscription is a tuple 'PACKAGE:DISTRIBUTION', where both PACKAGE or DISTRIBUTION may be empty to denote all resp. items. [auth level 1: any user login]

Note: Uses 'python-keyring' to persist passwords (see '~/.local/share/python_keyring/')