You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
gopackgo90 95171d85ca
Fix #515 Update mccabe to fix pip-compile (#516)
2 days ago
.github Added twine check to ensure packages are valid and can be uploaded to PyPI 6 months ago
docs docs: fix simple typo, compatile -> compatible (#512) 1 month ago
prospector Merge pull request #497 from michaeltinsley/develop 5 months ago
tests Removed some flaky tests 6 months ago
.coveragerc Adding coveralls.io and coverage generation 9 years ago
.flake8 Remove flake8 excludes and codespell in pre-commit 12 months ago
.gitignore Properly deprecating pep8 and pep257 as tool names, but adding legacy compatibilty 6 months ago
.pre-commit-config.yaml Fix #515 Update mccabe to fix pip-compile (#516) 2 days ago
.pre-commit-hooks.yaml Fixing up pre-commit configuration 6 months ago
.prospector.yml Cleaning up more moans 6 months ago
.readthedocs.yaml Apply pre-commit automated fixes 12 months ago
CHANGELOG.rst Bumping version for 1.7.7 release 5 months ago
CONTRIBUTING.rst Merge pull request #497 from michaeltinsley/develop 5 months ago
CONTRIBUTORS.rst Merge pull request #497 from michaeltinsley/develop 5 months ago
LICENSE Run pre-commit on all files 2 years ago
README.rst Fixing documentation about additional_requirements 5 months ago
poetry.lock Fix #515 Update mccabe to fix pip-compile (#516) 2 days ago
pyproject.toml Fix #515 Update mccabe to fix pip-compile (#516) 2 days ago
tox.ini Added a --quiet flag, mostly so that the tox tests can run prospector just to validate that it can run successfully without caring what its output is 8 months ago

README.rst

prospector

Latest Version of Prospector

Build Status

Test Coverage

Documentation

About

Prospector is a tool to analyse Python code and output information about errors, potential problems, convention violations and complexity.

It brings together the functionality of other Python analysis tools such as Pylint, pycodestyle, and McCabe complexity. See the Supported Tools documentation section for a complete list.

The primary aim of Prospector is to be useful 'out of the box'. A common complaint of other Python analysis tools is that it takes a long time to filter through which errors are relevant or interesting to your own coding style. Prospector provides some default profiles, which hopefully will provide a good starting point and will be useful straight away, and adapts the output depending on the libraries your project uses.

Installation

Prospector can be installed from PyPI using pip by running the following command:

pip install prospector

Optional dependencies for Prospector, such as pyroma can also be installed by running:

pip install prospector[with_pyroma]

Some shells (such as Zsh, the default shell of macOS Catalina) require brackets to be escaped:

pip install prospector\[with_pyroma\]

For a list of all of the optional dependencies, see the optional extras section on the ReadTheDocs page on Supported Tools Extras.

For local development, poetry is used. Check out the code, then run:

poetry install

And for extras:

poetry install -E with_everything

For more detailed information on installing the tool, see the installation section of the tool's main page on ReadTheDocs.

Documentation

Full documentation is available at ReadTheDocs.

Usage

Simply run prospector from the root of your project:

prospector

This will output a list of messages pointing out potential problems or errors, for example:

prospector.tools.base (prospector/tools/base.py):
    L5:0 ToolBase: pylint - R0922
    Abstract class is only referenced 1 times

Options

Run prospector --help for a full list of options and their effects.

Output Format

The default output format of prospector is designed to be human readable. For parsing (for example, for reporting), you can use the --output-format json flag to get JSON-formatted output.

Profiles

Prospector is configurable using "profiles". These are composable YAML files with directives to disable or enable tools or messages. For more information, read the documentation about profiles.

If your code uses frameworks and libraries

Often tools such as pylint find errors in code which is not an error, for example due to attributes of classes being created at run time by a library or framework used by your project. For example, by default, pylint will generate an error for Django models when accessing objects, as the objects attribute is not part of the Model class definition.

Prospector mitigates this by providing an understanding of these frameworks to the underlying tools.

Prospector will try to intuit which libraries your project uses by detecting dependencies and automatically turning on support for the requisite libraries. You can see which adaptors were run in the metadata section of the report.

If Prospector does not correctly detect your project's dependencies, you can specify them manually from the commandline:

prospector --uses django celery

Additionally, if Prospector is automatically detecting a library that you do not in fact use, you can turn off autodetection completely:

prospector --no-autodetect

Note that as far as possible, these adaptors have been written as plugins or augmentations for the underlying tools so that they can be used without requiring Prospector. For example, the Django support is available as a pylint plugin.

Strictness

Prospector has a configurable 'strictness' level which will determine how harshly it searches for errors:

prospector --strictness high

Possible values are verylow, low, medium, high, veryhigh.

Prospector does not include documentation warnings by default, but you can turn this on using the --doc-warnings flag.

pre-commit

If you'd like Prospector to be run automatically when making changes to files in your Git repository, you can install pre-commit and add the following text to your repositories' .pre-commit-config.yaml:

repos:
-   repo: https://github.com/PyCQA/prospector
    rev: 1.7.5 # The version of Prospector to use, if not 'master' for latest
    hooks:
    -   id: prospector

This only installs base prospector - if you also use optional tools, for example bandit or mypy, then you can add them to the hook configuration like so:

repos:
-   repo: https://github.com/PyCQA/prospector
    rev: 1.7.5
    hooks:
    -   id: prospector
        additional_dependencies:
        - ".[with_mypy,with_bandit]"

For prospector options which affect display only - those which are not configurable using a profile - these can be added as command line arguments to the hook. For example:

repos:
-   repo: https://github.com/PyCQA/prospector
    rev: 1.7.5
    hooks:
    -   id: prospector
        additional_dependencies:
        -   ".[with_mypy,with_bandit]"
        args:
        -   --summary-only
        -   --zero-exit

License

Prospector is available under the GPLv2 License.