Metadata-Version: 2.1
Name: scarab
Version: 0.1.3
Summary: A FreBSD Bugzilla CLI client.
Home-page: https://github.com/gonzoua/scarab
Author: Oleksandr Tymoshenko
Author-email: gonzo@bluezbox.com
License: BSD 3-clause "New" or "Revised License"
Description: # Overview
        scarab is a CLI tool to automate some of the Bugzilla-related workflows in the FreeBSD project.
        
        # Installation
        ```
        # Install python3 and pip 
        sudo pkg install python3 py36-pip
        
        # Install latest release of scarab
        pip-3.6 install --user scarab
        # .. or current WIP
        git clone https://github.com/gonzoua/scarab.git
        cd scarab
        pip-3.6 install --user -e .
        
        # Add ~/.local/bin to PATH
        # for bash:
        export PATH=$PATH:~/.local/bin
        # for tcsh/csh:
        setenv PATH $PATH\:$HOME/.local/bin
        
        # test setup
        scarab products
        ```
        
        # Settings
        scarab config file has a generic section-based INI format. A section starts with [sectionname]  and consists of key/value pairs separated by "=". Value is the part of the line after "=" with leading and trailing spaces removed.  If there are spaces in the middle of the string, they're treated as a part of the value.
        
        ## [default] section
        
        ### url
        
        Base URL  for Bugzilla setup. By default, it's FreeBSD's Bugzilla instance https://bugs.freebsd.org/bugzilla/
        
        ### api_key
        
        API key for the operations. Normally commands that do not modify Bugzilla's state like `fetch`, `fetchall`, `file` do not require it, unless you're trying to access PRs with restricted access. To generate new API key login to your Bugzilla instance, click on "Preferences" link then select "API keys" tab, check "Generate a new API key ..." checkbox, provide an optional description and click "Submit Changes"
        
        ## [template:NNN] sections
        
        Templates are sets of fields that you can use when submitting new PRs instead of specifying them individually as command-line arguments. Valid keys for this kind of section are: `product`, `component`, `version`, `platform`, `severity`. Possible values depend on the actual Bugzilla instance configuration. Some of them can be inspected using `products` command. The part of the section name after the colon is used as an argument to `-t` switch of the `submit` command as a shorthand for multiple switches. For more examples of template usage see [scarabrc](examples/scarabrc).
        
        # Commands
        ## addaflag
        addaflag [-h] attachment_id name [requestee]
        
        Add new flag named name to attachment attachment_id. If flag can be requested from specific user they can be specified by an optional requestee argument.
        
        ## addflag
        addflag [-h] bug_id name [requestee]
        
        Add new flag named name to bug bug_id. If flag can be requested from specific user they can be specified by an optional requestee argument.
        
        ## aflags
        aflags [-h] attachment_id
        
        Display flags for bug bug_id.
        
        ## attach
        attach [-h] [-s SUMMARY] [-c COMMENT | -F COMMENT_FILE] [-t CONTENT_TYPE] attachment pr
        
        Attach file specified by the path `attachment` to the bug with id `pr`. If no summary provided the file name is used as a summary. If neither `-c` nor `-F` is specified tool will invoke editor so a user can enter the comment text. File content type is detecting automatically using libmagic and can be overridden by `-t` command-line switch.
        
        ## fetch
        fetch [-h] [-o OUTPUT] attachment_id
        
        Download attachment with the id `attachment_id` to the file specified by `-o` command-line switch or to the file in the current directory with the same name as an attachment.
        
        ## fetchall
        fetchall [-h] bug_id
        
        Download all non-obsolete attachments of the bug with id `bug_id` to the current directory.
        
        ## files
        files [-h] [-a] [-s] bug_id
        
        Show list of the files attached to the bug with id `bug_id`. Unless `-a` is specified only non-obsolete attachments are displayed. When `-s` is used, the summary of the attachment is displayed instead of the file name.
        
        ## info
        info [-h] bug_id
        
        Display information for bug bug_id including bug description
        
        ## flags
        flags [-h] bug_id
        
        Display flags for bug bug_id.
        
        ## products
        products [-h]
        
        Display list of products, their components and versions
        
        ## rmaflags
        rmaflags [-h] attachment_id name [name ...]
        
        Remove one or more flags from attachment attachment_id. Name can be either flag name or numeric flag id, if there are more than one flag with the same name.
        
        ## rmflags
        rmflags [-h] bug_id name [name ...]
        
        Remove one or more flags from bug bug_id. Name can be either flag name or numeric flag id, if there are more than one flag with the same name.
        
        ## setaflag
        setaflag [-h] attachment_id name {+,-}
        
        Change attachment's flag value to either + or -. name can be either flag name or number flag id.
        
        ## setflag
        setflag [-h] bug_id name {+,-}
        
        Change bug's flag value to either + or -. name can be either flag name or number flag id.
        
        ## submit
        submit [-h] [-t TEMPLATES] [-p PRODUCT] [-m COMPONENT] [-v VERSION] [-c COMMENT | -F COMMENT_FILE] -s SUMMARY [-C CC] [-P PLATFORM] [-S SEVERITY]
        
        Submit new bug with the summary specified by `-s` command-line switch. Mandatory fields `product`, `component`, `version` should be specified either by command-line switches or as values in templates sections. If multiple templates are specified in one invocation, they are merged with fields each following template overriding values present in the previous ones. Values for the fields provided as a command-line switch override the values in the templates.
        
        ## update
        update [-h] [-s STATUS] [-r RESOLUTION] [-a ASSIGNED_TO] [-C ADD_CC] [-X REMOVE_CC] [-c COMMENT | -F COMMENT_FILE] bug_id
        
        Update fields in existing PR. If neither `-c` nor `-F` specified no comment is posted with the change. `-C` and `-X` can be specified multiple times to add/remove more than one user.
        
        # Development
        To run the scarab command using checked out version of the repo use `python3 -m scarab.cli ...` command
        
Keywords: bugzilla cli freebsd
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown
Provides-Extra: test
