Metadata-Version: 2.1
Name: cvelib
Version: 0.2.0
Summary: A library and command line interface for the CVE Project services.
Home-page: https://github.com/RedHatProductSecurity/cvelib
Author: Red Hat Product Security
Author-email: secalert@redhat.com
License: MIT
Description: # cvelib
        
        A library and command line interface for the CVE Project services.
        
        ## Installation
        
        ```
        pip install --user cvelib
        ```
        
        Python version 3.6 or greater is required.
        
        ## CLI Setup and Configuration
        
        Currently, the only supported CVE Project service is the CVE ID Reservation (IDR) service. Each
        command executed against IDR requires the user to authenticate. You can provide the
        authentication details with the command (using options `-u/--username`, `-o/--org`, and
        `-a/--api-key`) or set them in the following environment variables:
        
        ```
        export CVE_USER=margo
        export CVE_ORG=acme
        export CVE_API_KEY=<api_key>
        ```
        
        Additionial options that have an accompanying environment variable include:
        
        * `-e/--environment` or `CVE_ENVIRONMENT`: allows you to configure the deployment environment
          (that is, the URL at which the service is available) to interface with. Allowed values: `prod`,
          `dev`.
        
        * `--idr-url` or `CVE_IDR_URL`: allows you to override the URL for the IDR service that would
          otherwise be determined by the deployment environment you selected. This is useful for local
          testing to point to an IDR instance running on localhost.
        
        * `-i/--interactive` or `CVE_INTERACTIVE`: every create/update action against the IDR service
          will require confirmation before a request is sent.
        
        ## CLI Usage
        
        Available options and commands can be displayed by running `cve --help`. The following are
        examples of some commonly used operations.
        
        Reserve one CVE ID in the current year (you will be prompted to confirm your action):
        
        ```
        cve --interactive reserve
        ```
        
        Reserve three non-sequential CVE IDs for a specific year:
        
        ```
        cve reserve 3 --year 2021 --random
        ```
        
        List all rejected CVEs for year 2018:
        
        ```
        cve list --year 2018 --state reject
        ```
        
        ---
        
        [CVE](https://cve.mitre.org/) is a trademark of [The MITRE Corporation](https://www.mitre.org/).
        
Platform: UNKNOWN
Classifier: Topic :: Security
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Description-Content-Type: text/markdown
