Metadata-Version: 2.1
Name: dep_license
Version: 0.1
Summary: Report licenses information for dependencies in use by a Python project
Home-page: https://github.com/abduhbm/dep-license
Author: Abdulelah Bin Mahfoodh
License: MIT
Description: 
        # dep_license
        
        **dep_lic**: a simple utility to report licenses information for dependencies in use by a Python project. It supports parsing contents from `requirements.txt` and `Pipfile` files from the project directory or its GitHub repo. 
        
        ### Installation
        
        ```
        $ pip install dep_license
        ```
        
        ### Command-Line Options
        
        ```
        $ deplic --help
        usage: deplic [-h] [-p PROCESSES] [-f FORMAT] [-o OUTPUT] [-d] [-n NAME]
                      PROJECT
        
        positional arguments:
          PROJECT               path or URL to the project repo
        
        optional arguments:
          -h, --help            show this help message and exit
          -p PROCESSES, --processes PROCESSES
                                number of processes to run in parallel (default: MAX)
          -f FORMAT, --format FORMAT
                                define how result is formatted (default: github)
          -o OUTPUT, --output OUTPUT
                                path for output file (default: None)
          -d, --dev             include dev packages from Pipfile (default: False)
          -n NAME, --name NAME  name for pip-requirements file (default: None)
        ```
        
        ### Usage
        
        Report a list of dependency licenses used in a local project: 
        ```
        $ deplic /path/to/python/project 
        Total number of dependencies: 3
        Running with 3 processes...
        licenses:
        
        | Name       | Meta   | Classifier                                       |
        |------------|--------|--------------------------------------------------|
        | pandas     | BSD    |                                                  |
        | matplotlib | PSF    | OSI Approved::Python Software Foundation License |
        | numpy      | BSD    | OSI Approved                                     |
        ```
        
        Specify the file to be parsed:
        
        ```
        $ deplic /path/to/python/project/requirements.txt 
        Total number of dependencies: 1
        Running with 1 processes...
        licenses:
        
        | Name   | Meta   | Classifier   |
        |--------|--------|--------------|
        | numpy  | BSD    | OSI Approved |
        
        ```
        
        Support for Pipfile:
        ```
        $ deplic /path/to/python/project/Pipfile
        Total number of dependencies: 3
        Running with 3 processes...
        licenses:
        
        | Name       | Meta   | Classifier                                       |
        |------------|--------|--------------------------------------------------|
        | numpy      | BSD    | OSI Approved                                     |
        | pandas     | BSD    |                                                  |
        | matplotlib | PSF    | OSI Approved::Python Software Foundation License |
        ```
        
        Format and store output as JSON file:
        ```
        deplic /path/to/python/project -f json -o dep-licenses.json
        Total number of dependencies: 3
        Running with 3 processes...
        licenses:
        
        [
            {
                "Name": "matplotlib",
                "Meta": "PSF",
                "Classifier": "OSI Approved::Python Software Foundation License"
            },
            {
                "Name": "pandas",
                "Meta": "BSD",
                "Classifier": ""
            },
            {
                "Name": "numpy",
                "Meta": "BSD",
                "Classifier": "OSI Approved"
            }
        ]
        ```
        
        Get the list dev-packages from the project's GitHub repo:
        ```
        $ deplic https://github.com/kennethreitz/requests -p 16 -d -f md
        Total number of dependencies: 16
        Running with 16 processes...
        licenses:
        
        Name             Meta                                                          Classifier
        ---------------  ------------------------------------------------------------  -------------------------------------
        pytest           MIT license                                                   OSI Approved::MIT License
        codecov          http://www.apache.org/licenses/LICENSE-2.0                    OSI Approved::Apache Software License
        pytest-mock      MIT                                                           OSI Approved::MIT License
        sphinx           BSD                                                           OSI Approved::BSD License
        tox              MIT                                                           OSI Approved::MIT License
        pytest-httpbin   MIT                                                           OSI Approved::MIT License
        docutils         public domain, Python, 2-Clause BSD, GPL 3 (see COPYING.txt)  Public Domain
        pytest-cov       MIT                                                           OSI Approved::BSD License
        pytest-xdist     MIT                                                           OSI Approved::MIT License
        pysocks          BSD
        httpbin          MIT                                                           OSI Approved::MIT License
        alabaster                                                                      OSI Approved::BSD License
        readme-renderer  Apache License, Version 2.0                                   OSI Approved::Apache Software License
        detox            MIT                                                           OSI Approved::MIT License
         
        ```
        
        Specify which requirements file to parse:
        ```
        $ deplic https://github.com/pandas-dev/pandas -n requirements-dev.txt -f csv -p 16 -o pandas_dev.csv
        ```
        
        ### Output Formats:
        
        Supported table formats are (thanks to python-tabulate package):
        
        - "plain"
        - "simple"
        - "github"
        - "grid"
        - "fancy_grid"
        - "pipe"
        - "orgtbl"
        - "jira"
        - "presto"
        - "psql"
        - "rst"
        - "mediawiki"
        - "moinmoin"
        - "youtrack"
        - "html"
        - "latex"
        - "latex_raw"
        - "latex_booktabs"
        - "textile"
        
        
Keywords: license check dependency package report
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Utilities
Classifier: Topic :: System :: System Shells
Description-Content-Type: text/markdown
