NAME

       mini-buildd-tool - mini-buildd-tool - User/client tool box for mini-buildd instances.

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

       -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/')