pip-licenses

Dump the software license list of Python packages installed with pip.

These details have not been verified by PyPI

Project links

Project description

Dump the software license list of Python packages installed with pip.

Description

pip-licenses is a CLI tool for checking the software license of installed Python packages with pip.

Implemented with the idea inspired by composer licenses command in Composer (a.k.a PHP package management tool).

https://getcomposer.org/doc/03-cli.md#licenses

Installation

Install it via PyPI using pip command.

# Install or Upgrade to newest available version
$ pip install -U pip-licenses

# If upgrading from pip-licenses 3.x, remove PTable
$ pip uninstall -y PTable

Note for Python 3.7 users: pip-licenses 4.x discontinued support earlier than the Python 3.7 EOL schedule. If you want to use it with Python 3.7, install pip-licenses 3.x.

# Using old version for the Python 3.7 environment
$ pip install 'pip-licenses<4.0'

Note: If you are still using Python 2.7, install version less than 2.0. No new features will be provided for version 1.x.

$ pip install 'pip-licenses<2.0'

Usage

Execute the command with your venv (or virtualenv) environment.

# Install packages in your venv environment
(venv) $ pip install Django pip-licenses

# Check the licenses with your venv environment
(venv) $ pip-licenses
 Name    Version  License
 Django  2.0.2    BSD
 pytz    2017.3   MIT

Command-Line Options

Common options

Option: from

By default, this tool finds the license from Trove Classifiers or package Metadata. Some Python packages declare their license only in Trove Classifiers.

For example, even if you check with the pip show command, the license is displayed as UNKNOWN.

(venv) $ pip show setuptools
Name: setuptools
Version: 38.5.0
Summary: Easily download, build, install, upgrade, and uninstall Python packages
Home-page: https://github.com/pypa/setuptools
Author: Python Packaging Authority
Author-email: distutils-sig@python.org
License: UNKNOWN

The mixed mode (--from=mixed) of this tool works well and looks for licenses.

(venv) $ pip-licenses --from=mixed --with-system | grep setuptools
 setuptools    38.5.0   MIT License

In mixed mode, it first tries to look for licenses in the Trove Classifiers. When not found in the Trove Classifiers, the license declared in Metadata is displayed.

If you want to look only in metadata, use --from=meta. If you want to look only in Trove Classifiers, use --from=classifier.

To list license information from both metadata and classifier, use --from=all.

Note: If neither can find license information, please check with the with-authors and with-urls options and contact the software author.

The m keyword is prepared as alias of meta.
The c keyword is prepared as alias of classifier.
The mix keyword is prepared as alias of mixed.
- Default behavior in this tool

Option: order

By default, it is ordered by package name.

If you give arguments to the --order option, you can output in other sorted order.

(venv) $ pip-licenses --order=license

Option: format

By default, it is output to the plain format.

Markdown

When executed with the --format=markdown option, you can output list in markdown format. The m md keyword is prepared as alias of markdown.

(venv) $ pip-licenses --format=markdown
| Name   | Version | License |
|--------|---------|---------|
| Django | 2.0.2   | BSD     |
| pytz   | 2017.3  | MIT     |

When inserted in a markdown document, it is rendered as follows:

Name	Version	License
Django	2.0.2	BSD
pytz	2017.3	MIT

reST

When executed with the --format=rst option, you can output list in “Grid tables” of reStructuredText format. The r rest keyword is prepared as alias of rst.

(venv) $ pip-licenses --format=rst
+--------+---------+---------+
| Name   | Version | License |
+--------+---------+---------+
| Django | 2.0.2   | BSD     |
+--------+---------+---------+
| pytz   | 2017.3  | MIT     |
+--------+---------+---------+

Confluence

When executed with the --format=confluence option, you can output list in Confluence (or JIRA) Wiki markup format. The c keyword is prepared as alias of confluence.

(venv) $ pip-licenses --format=confluence
| Name   | Version | License |
| Django | 2.0.2   | BSD     |
| pytz   | 2017.3  | MIT     |

HTML

When executed with the --format=html option, you can output list in HTML table format. The h keyword is prepared as alias of html.

(venv) $ pip-licenses --format=html
<table>
    <tr>
        <th>Name</th>
        <th>Version</th>
        <th>License</th>
    </tr>
    <tr>
        <td>Django</td>
        <td>2.0.2</td>
        <td>BSD</td>
    </tr>
    <tr>
        <td>pytz</td>
        <td>2017.3</td>
        <td>MIT</td>
    </tr>
</table>

JSON

When executed with the --format=json option, you can output list in JSON format easily allowing post-processing. The j keyword is prepared as alias of json.

[
  {
    "Author": "Django Software Foundation",
    "License": "BSD",
    "Name": "Django",
    "URL": "https://www.djangoproject.com/",
    "Version": "2.0.2"
  },
  {
    "Author": "Stuart Bishop",
    "License": "MIT",
    "Name": "pytz",
    "URL": "http://pythonhosted.org/pytz",
    "Version": "2017.3"
  }
]

JSON LicenseFinder

When executed with the --format=json-license-finder option, you can output list in JSON format that is identical to LicenseFinder. The jlf keyword is prepared as alias of jlf. This makes pip-licenses a drop-in replacement for LicenseFinder.

[
  {
    "licenses": ["BSD"],
    "name": "Django",
    "version": "2.0.2"
  },
  {
    "licenses": ["MIT"],
    "name": "pytz",
    "version": "2017.3"
  }
]

CSV

When executed with the --format=csv option, you can output list in quoted CSV format. Useful when you want to copy/paste the output to an Excel sheet.

(venv) $ pip-licenses --format=csv
"Name","Version","License"
"Django","2.0.2","BSD"
"pytz","2017.3","MIT"

Plain Vertical

When executed with the --format=plain-vertical option, you can output a simple plain vertical output that is similar to Angular CLI’s –extractLicenses flag. This format minimizes rightward drift.

(venv) $ pip-licenses --format=plain-vertical --with-license-file --no-license-path
pytest
5.3.4
MIT license
The MIT License (MIT)

Copyright (c) 2004-2020 Holger Krekel and others

Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
of the Software, and to permit persons to whom the Software is furnished to do
so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Option: summary

When executed with the --summary option, you can output a summary of each license.

(venv) $ pip-licenses --summary --from=classifier --with-system
 Count  License
 2      BSD License
 4      MIT License

Note: When using this option, only --order=count or --order=license has an effect for the --order option. And using --with-authors and --with-urls will be ignored.

Option: output-file

When executed with the --output-file option, write the result to the path specified by the argument.

(venv) $ pip-licenses --format=rst --output-file=/tmp/output.rst
created path: /tmp/output.rst

Option: ignore-packages

When executed with the --ignore-packages option, ignore the package specified by argument from list output.

(venv) $ pip-licenses --ignore-packages django
 Name  Version  License
 pytz  2017.3   MIT

Package names of arguments can be separated by spaces.

(venv) $ pip-licenses --with-system --ignore-packages django pip pip-licenses
 Name        Version  License
 prettytable 3.5.0    BSD License
 pytz        2017.3   MIT
 setuptools  38.5.0   UNKNOWN
 wcwidth     0.2.5    MIT License

Option: packages

When executed with the packages option, look at the package specified by argument from list output.

(venv) $ pip-licenses --packages django
 Name   Version  License
 Django 2.0.2    BSD

Package names of arguments can be separated by spaces.

(venv) $ pip-licenses --with-system --packages prettytable pytz
 Name        Version  License
 prettytable 3.5.0    BSD License
 pytz        2017.3   MIT

Format options

Option: with-system

By default, system packages such as pip and setuptools are ignored.

And pip-licenses and the implicit dependency prettytable and wcwidth will also be ignored.

If you want to output all including system package, use the --with-system option.

(venv) $ pip-licenses --with-system
 Name          Version  License
 Django        2.0.2    BSD
 pip           9.0.1    MIT
 pip-licenses  1.0.0    MIT License
 prettytable   3.5.0    BSD License
 pytz          2017.3   MIT
 setuptools    38.5.0   UNKNOWN
 wcwidth       0.2.5    MIT License

Option: with-authors

When executed with the --with-authors option, output with author of the package.

(venv) $ pip-licenses --with-authors
 Name    Version  License  Author
 Django  2.0.2    BSD      Django Software Foundation
 pytz    2017.3   MIT      Stuart Bishop

Option: with-urls

For packages without Metadata, the license is output as UNKNOWN. To get more package information, use the --with-urls option.

(venv) $ pip-licenses --with-urls
 Name    Version  License  URL
 Django  2.0.2    BSD      https://www.djangoproject.com/
 pytz    2017.3   MIT      http://pythonhosted.org/pytz

Option: with-description

When executed with the --with-description option, output with short description of the package.

(venv) $ pip-licenses --with-description
 Name    Version  License  Description
 Django  2.0.2    BSD      A high-level Python Web framework that encourages rapid development and clean, pragmatic design.
 pytz    2017.3   MIT      World timezone definitions, modern and historical

Option: with-license-file

When executed with the --with-license-file option, output the location of the package’s license file on disk and the full contents of that file. Due to the length of these fields, this option is best paired with --format=json.

If you also want to output the file NOTICE distributed under Apache License etc., specify the --with-notice-file option additionally.

Note: If you want to keep the license file path secret, specify --no-license-path option together.

Option: filter-strings

Some package data contains Unicode characters which might cause problems for certain output formats (in particular ReST tables). If this filter is enabled, all characters which cannot be encoded with a given code page (see --filter-code-page) will be removed from any input strings (e.g. package name, description).

Option: filter-code-page

If the input strings are filtered (see --filter-strings), you can specify the applied code page (default latin-1). A list of all available code pages can be found codecs module document.

Verify options

Option: fail-on

Fail (exit with code 1) on the first occurrence of the licenses of the semicolon-separated list

If --from=all, the option will apply to the metadata license field.

(venv) $ pip-licenses --fail-on="MIT License;BSD License"

Note: Packages with multiple licenses will fail if at least one license is included in the fail-on list. For example:

# keyring library has 2 licenses
$ pip-licenses | grep keyring
 keyring             21.4.0     Python Software Foundation License, MIT License

# If just "Python Software Foundation License" is specified, it will fail.
$ pip-licenses --fail-on="Python Software Foundation License;"
$ echo $?
1

Option: allow-only

Fail (exit with code 1) if none of the package licenses are in the semicolon-separated list

If --from=all, the option will apply to the metadata license field.

(venv) $ pip-licenses --allow-only="MIT License;BSD License"

Note: Packages with multiple licenses will only be allowed if at least one license is included in the allow-only list. For example:

# keyring library has 2 licenses
$ pip-licenses --package keyring
 Name     Version  License
 keyring  23.0.1   MIT License; Python Software Foundation License

# One or both licenses must be specified (order does not matter). Following checks will pass:
$ pip-licenses --package keyring --allow-only="MIT License"
$ pip-licenses --package keyring --allow-only="BSD License;MIT License"
$ pip-licenses --package keyring --allow-only="Python Software Foundation License"
$ pip-licenses --package keyring --allow-only="Python Software Foundation License;MIT License"

# If none of the license in the allow list match, the check will fail.
$ pip-licenses --package keyring  --allow-only="BSD License"
$ echo $?
1

More Information

Other, please make sure to execute the --help option.

Dockerfile

You can check the package license used by your app in the isolated Docker environment.

# Clone this repository to local
$ git clone https://github.com/raimon49/pip-licenses.git
$ cd pip-licenses

# Create your app's requirements.txt file
# Other ways, pip freeze > docker/requirements.txt
$ echo "Flask" > docker/requirements.txt

# Build docker image
$ docker build . -t myapp-licenses

# Check the package license in container
$ docker run --rm myapp-licenses
 Name          Version  License
 Click         7.0      BSD License
 Flask         1.0.2    BSD License
 Jinja2        2.10     BSD License
 MarkupSafe    1.1.1    BSD License
 Werkzeug      0.15.2   BSD License
 itsdangerous  1.1.0    BSD License

# Check with options
$ docker run --rm myapp-licenses --summary
 Count  License
 4      BSD
 2      BSD-3-Clause

# When you need help
$ docker run --rm myapp-licenses --help

Note: This Docker image can not check package licenses with C and C ++ Extensions. It only works with pure Python package dependencies.

If you want to resolve build environment issues, try using not slim image and more.

diff --git a/Dockerfile b/Dockerfile
index bfc4edc..175e968 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -1,4 +1,4 @@
-FROM python:3.11-slim-bullseye
+FROM python:3.11-bullseye

About UnicodeEncodeError

If a UnicodeEncodeError occurs, check your environment variables LANG and LC_TYPE.

Often occurs in isolated environments such as Docker and tox.

See useful reports:

License

MIT License

Dependencies

prettytable by Luke Maurits and maintainer of fork version Jazzband team under the BSD-3-Clause License
- Note: This package implicitly requires wcwidth.

pip-licenses has been implemented in the policy to minimize the dependence on external package.

Uninstallation

Uninstall package and dependent package with pip command.

$ pip uninstall pip-licenses prettytable wcwidth

Contributing

See contribution guidelines.

CHANGELOG

4.0.2

Add type annotations and code formatter

4.0.1

Fix “pip-licenses” is missing in output of pip-licenses --with-system option

4.0.0

Support for Python 3.11
Dropped support Python 3.7
Migrate Docker base image from Alpine to Debian 11-slim
Breaking changes
- Does not work with PTable and depends on prettytable
- Depend on importlib_metadata rather than pip

3.5.5

Search for path defined in PEP 639 with --with-license-file option
Dropped support Python 3.6

3.5.4

Skip directories when detecting license files

3.5.3

Support pip 21.3 or later

3.5.2

Ignore spaces around --fail-on and --allow-only parameters

3.5.1

Fix the order in which multiple licenses are output

3.5.0

Handle multiple licenses better with options --fail-on and --allow-only
Small change in output method for multiple licenses, change the separator from comma to semicolon
- Up to 3.4.0: Python Software Foundation License, MIT License
- 3.5.0 or later: Python Software Foundation License; MIT License

3.4.0

Implement new option --packages

3.3.1

Fix license summary refer to --from option

3.3.0

Improves the readability of the help command

3.2.0

Implement new option --from=all
Change license notation under SPDX license identifier style

3.1.0

Implement new option for use in continuous integration
- --fail-on
- --allow-only

3.0.0

Dropped support Python 3.5
Clarified support for Python 3.9
Migrate package metadata to setup.cfg
Breaking changes
- Change default behavior to --from=mixed

2.3.0

Implement new option for manage unicode characters
- --filter-strings
- --filter-code-page

2.2.1

Fixed the file that is selected when multiple matches are made with LICENSE* with run --with-license-file

2.2.0

Implement new option --with-notice-file
Added to find British style file name LICENCE with run --with-license-file

2.1.1

Suppress errors when opening license files

2.1.0

Implement new option --format=plain-vertical
Support for outputting license file named COPYING *

2.0.1

Better license file open handling in Python 3

2.0.0

Dropped support Python 2.7
Breaking changes
- Removed migration path to obsolete options
  - --from-classifier
  - --format-markdown
  - --format-rst
  - --format-confluence
  - --format-html
  - --format-json
Implement new option --no-license-path

1.18.0

Supports compatibility to work with either PTable or prettytable

1.17.0

Implement new option --output-file
Clarified support for Python 3.8

1.16.1

Add a help text for --format=json-license-finder option

1.16.0

Implement new option --format=json-license-finder

1.15.2

Read license file works well with Windows

1.15.1

Skip parsing of license file for packages specified with --ignore-packages option

1.15.0

Implement new option --format=csv

1.14.0

Implement new option --from=mixed as a mixed mode

1.13.0

Implement new option --from=meta, from=classifier
Dropped support Python 3.4

1.12.1

Fix bug
- Change warning output to standard error

1.12.0

Supports execution within Docker container
Warning of deprecated options
Fix bug
- Ignore OSI Approved string with multiple licenses

1.11.0

Implement new option --with-license-file

1.10.0

Implement new option --with-description

1.9.0

Implement new option --summary

1.8.0

Implement new option --format-json
Dropped support Python 3.3

1.7.1

Fix bug
- Support pip 10.x

1.7.0

Implement new option --format-confluence

1.6.1

Fix bug
- Support display multiple license with --from-classifier option
Improve document
- Add section of ‘Uninstallation’ in README

1.6.0

Implement new option --format-html

1.5.0

Implement new option --format-rst

1.4.0

Implement new option --format-markdown
Include LICENSE file in distribution package

1.3.0

Implement new option --ignore-packages

1.2.0

Implement new option --from-classifier

1.1.0

Improve document
- Add ToC to README document
- Add a information of dependencies

1.0.0

First stable release version

0.2.0

Implement new option --order
- Default behavior is --order=name

0.1.0

First implementation version
- Support options
  - --with-system
  - --with-authors
  - --with-urls

Project details

These details have not been verified by PyPI

Project links

Release history Release notifications | RSS feed

5.0.0

Jul 23, 2024

4.5.1

Jul 13, 2024

4.5.0

Jul 11, 2024

4.4.0

Mar 28, 2024

4.3.4

Jan 20, 2024

4.3.3

Sep 20, 2023

4.3.2

May 21, 2023

4.3.1

May 4, 2023

4.3.0

Apr 25, 2023

4.2.0

Apr 12, 2023

4.2.0rc3 pre-release

Apr 12, 2023

4.2.0rc2 pre-release

Apr 8, 2023

4.2.0rc1 pre-release

Apr 2, 2023

4.1.0

Mar 2, 2023

4.0.3

Dec 8, 2022

This version

4.0.2

Dec 4, 2022

4.0.1

Nov 14, 2022

4.0.0

Nov 6, 2022

4.0.0rc4 pre-release

Nov 4, 2022

4.0.0rc3 pre-release

Oct 31, 2022

4.0.0rc2 pre-release

Oct 29, 2022

4.0.0rc1 pre-release

Oct 27, 2022

3.5.5

Oct 20, 2022

3.5.4

May 1, 2022

3.5.3

Oct 12, 2021

3.5.2

Aug 27, 2021

3.5.1

Jul 6, 2021

3.5.0

Jul 3, 2021

3.4.0

Jun 4, 2021

3.3.2rc1 pre-release

Mar 28, 2021

3.3.1

Feb 28, 2021

3.3.0

Jan 23, 2021

3.2.0

Dec 28, 2020

3.1.0

Nov 25, 2020

3.0.0

Oct 25, 2020

2.3.0

Aug 2, 2020

2.2.1

Jun 24, 2020

2.2.0

Apr 29, 2020

2.1.1

Feb 16, 2020

2.1.0

Jan 28, 2020

2.0.1

Jan 6, 2020

2.0.0

Jan 3, 2020

1.18.0

Dec 22, 2019

1.17.0

Dec 14, 2019

1.16.1

Nov 14, 2019

1.16.0

Nov 13, 2019

1.15.2

Jul 25, 2019

1.15.1

Jul 24, 2019

1.15.0

May 11, 2019

1.14.0

May 10, 2019

1.13.0

May 6, 2019

1.12.1

Mar 7, 2019

1.12.0

Feb 27, 2019

1.11.0

Feb 18, 2019

1.10.0

Dec 23, 2018

1.9.0

Nov 16, 2018

1.8.0

Oct 12, 2018

1.7.1

Apr 19, 2018

1.7.0

Mar 19, 2018

1.6.1

Mar 5, 2018

1.6.0

Feb 11, 2018

1.5.0

Feb 10, 2018

1.4.0

Feb 9, 2018

1.3.0

Feb 9, 2018

1.2.0

Feb 7, 2018

1.1.0

Feb 6, 2018

1.0.0

Feb 5, 2018

0.2.0

Feb 5, 2018

0.1.0

Feb 5, 2018

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pip-licenses-4.0.2.tar.gz (30.4 kB view hashes)

Uploaded Dec 4, 2022 Source

Built Distribution

pip_licenses-4.0.2-py3-none-any.whl (17.8 kB view hashes)

Uploaded Dec 4, 2022 Python 3

Hashes for pip-licenses-4.0.2.tar.gz

Hashes for pip-licenses-4.0.2.tar.gz
Algorithm	Hash digest
SHA256	`099911b9bf4709053f1fea2f5421c6692a82bb8885054043ae9222b07bf29b4e`
MD5	`0b31a8963c42a6fe671f11cf91988c83`
BLAKE2b-256	`434c7c08dc4dae209f7e6bd96fe0211a2eba5fb863153a1b66b168abdb2badec`

Hashes for pip_licenses-4.0.2-py3-none-any.whl

Hashes for pip_licenses-4.0.2-py3-none-any.whl
Algorithm	Hash digest
SHA256	`bcd89e9832dfad79e35bce0fe8ebc20706b50eea6fb43f70395ec927b800f367`
MD5	`2e7009d80ab28bcfedafa3211d18fbf6`
BLAKE2b-256	`a1f6191b5a9620bb77394be21a39a98c20d9ed5783a31b11591627ce69397d9f`

pip-licenses 4.0.2

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

Table of Contents

Description

Installation

Usage

Command-Line Options

Common options

Option: from

Option: order

Option: format

Markdown

reST

Confluence

HTML

JSON

JSON LicenseFinder

CSV

Plain Vertical

Option: summary

Option: output-file

Option: ignore-packages

Option: packages

Format options

Option: with-system

Option: with-authors

Option: with-urls

Option: with-description

Option: with-license-file

Option: filter-strings

Option: filter-code-page

Verify options

Option: fail-on

Option: allow-only

More Information

Dockerfile

About UnicodeEncodeError

License

Dependencies

Uninstallation

Contributing

CHANGELOG

4.0.2

4.0.1

4.0.0

3.5.5

3.5.4

3.5.3

3.5.2

3.5.1

3.5.0

3.4.0

3.3.1

3.3.0

3.2.0

3.1.0

3.0.0

2.3.0

2.2.1

2.2.0

2.1.1

2.1.0

2.0.1

2.0.0

1.18.0

1.17.0

1.16.1

1.16.0

1.15.2

1.15.1

1.15.0

1.14.0

1.13.0