Tool to check the completeness of for Python packages
Go to file
Marius Gedminas 190ffe0e68 Fix tests under Python 3.12
The error was in Tests.test_build_sdist_pep517_no_isolation:

    E           check_manifest.CommandFailed: ['/home/mg/src/check-manifest/.tox/py312/bin/python', '-m', 'build', '--sdist', '.', '--outdir', '/tmp/test-5rhghuor-check-manifest', '--no-isolation'] failed (status 1):
    E           * Getting build dependencies for sdist...
    E           running egg_info
    E           creating UNKNOWN.egg-info
    E           writing UNKNOWN.egg-info/PKG-INFO
    E           writing dependency_links to UNKNOWN.egg-info/dependency_links.txt
    E           writing top-level names to UNKNOWN.egg-info/top_level.txt
    E           writing manifest file 'UNKNOWN.egg-info/SOURCES.txt'
    E           reading manifest file 'UNKNOWN.egg-info/SOURCES.txt'
    E           writing manifest file 'UNKNOWN.egg-info/SOURCES.txt'
    E           ERROR Missing dependencies:
    E               wheel CommandFailed
2023-09-07 13:26:00 +03:00
.github Ignore coveralls upload failures 2023-05-02 17:06:24 +03:00
.coveragerc Refactor UI code to avoid global state 2020-05-02 20:12:31 +03:00
.gitignore Rewrite the IgnoreList logic to be more distutils-like 2020-05-03 15:38:08 +03:00
.pre-commit-hooks.yaml Add 'language_version: python3' to .pre-commit-hooks.yaml 2020-12-20 16:48:01 -08:00
CHANGES.rst Back to development: 0.50 2022-12-05 10:15:12 +02:00
LICENSE.rst Rename LICENCE to LICENSE 2016-09-22 11:34:34 +03:00 Remove unused .travis.yml 2020-12-20 16:25:52 -08:00
Makefile Automate the version update in the README 2020-11-30 08:53:41 +02:00
README.rst Preparing release 0.49 2022-12-05 10:11:53 +02:00
appveyor.yml Support Python 3.11 2022-10-27 10:10:03 +03:00 Back to development: 0.50 2022-12-05 10:15:12 +02:00 Update to newer 2021-04-22 22:51:21 +03:00
setup.cfg Workaround for mypy 0.800 ignoring setup.cfg 2021-01-27 12:19:52 +02:00 Fix tests under Python 3.12 2023-09-07 13:26:00 +03:00 Use type annotations on class attributes 2022-11-24 13:01:11 +02:00
tox.ini tox 4 requires passenv to be newline (or comma) separated 2022-12-11 19:58:01 +02:00



buildstatus_ appveyor_ coverage_

Are you a Python developer? Have you uploaded packages to the Python Package Index? Have you accidentally uploaded broken packages with some files missing? If so, check-manifest is for you.

Quick start

$ pip install check-manifest

$ cd ~/src/mygreatpackage
$ check-manifest

You can ask the script to help you update your

$ check-manifest -u -v
listing source files under version control: 6 files and directories
building an sdist: check-manifest-0.7.tar.gz: 4 files and directories
lists of files in version control and sdist do not match!
missing from sdist:
suggested rules:
  include *.py
  include tox.ini

$ cat
include *.rst

# added by
include *.py
include tox.ini

Command-line reference

$ check-manifest --help
usage: check-manifest [-h] [--version] [-v] [-c] [-u] [-p PYTHON]
                      [--ignore patterns]

Check a Python file for completeness

positional arguments:
  source_tree           location for the source tree (default: .)

optional arguments:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  -v, --verbose         more verbose output (default: False)
  -c, --create          create a if missing (default: False)
  -u, --update          append suggestions to (implies --create)
                        (default: False)
  -p PYTHON, --python PYTHON
                        use this Python interpreter for running sdist
                        (default: /home/mg/.venv/bin/python)
  --ignore patterns     ignore files/directories matching these comma-
                        separated patterns (default: None)
  --ignore-bad-ideas patterns
                        ignore bad idea files/directories matching these
                        comma-separated patterns (default: [])


You can configure check-manifest to ignore certain file patterns using a [tool.check-manifest] section in your pyproject.toml file or a [check-manifest] section in either setup.cfg or tox.ini. Examples:

# pyproject.toml
ignore = [".travis.yml"]

# setup.cfg or tox.ini
ignore =

Note that lists are newline separated in the setup.cfg and tox.ini files.

The following options are recognized:


A list of filename patterns that will be ignored by check-manifest. Use this if you want to keep files in your version control system that shouldn't be included in your source distributions. The default ignore list is :


If set to true, your ignore patterns will replace the default ignore list instead of adding to it.


A list of filename patterns that will be ignored by check-manifest's generated files check. Use this if you want to keep generated files in your version control system, even though it is generally a bad idea.

Version control integration

With pre-commit, check-manifest can be part of your git-workflow. Add the following to your .pre-commit-config.yaml.

-   repo:
    rev: "0.49"
    -   id: check-manifest

If you are running pre-commit without a network, you can utilize args: [--no-build-isolation] to prevent a pip install reaching out to PyPI. If you have additional build-system.requires outside of pip / setuptools / wheel you will want to list those in additional_dependencies.

-   repo:
    rev: ...  # pick a valid tag / revision
    -   id: check-manifest
        args: [--no-build-isolation]
        additional_dependencies: [setuptools-scm]