McCabe complexity checker
=========================
Ned's script to check McCabe complexity.
This module provides a plugin for ``flake8``, the Python code checker.
Installation
------------
You can install, upgrade, or uninstall ``mccabe`` with these commands::
$ pip install mccabe
$ pip install --upgrade mccabe
$ pip uninstall mccabe
Standalone script
-----------------
The complexity checker can be used directly::
$ python -m mccabe --min 5 mccabe.py
("185:1: 'PathGraphingAstVisitor.visitIf'", 5)
("71:1: 'PathGraph.to_dot'", 5)
("245:1: 'McCabeChecker.run'", 5)
("283:1: 'main'", 7)
("203:1: 'PathGraphingAstVisitor.visitTryExcept'", 5)
("257:1: 'get_code_complexity'", 5)
Plugin for Flake8
-----------------
When both ``flake8 2+`` and ``mccabe`` are installed, the plugin is
available in ``flake8``::
$ flake8 --version
2.0 (pep8: 1.4.2, pyflakes: 0.6.1, mccabe: 0.2)
By default the plugin is disabled. Use the ``--max-complexity`` switch to
enable it. It will emit a warning if the McCabe complexity of a function is
higher than the provided value::
$ flake8 --max-complexity 10 coolproject
...
coolproject/mod.py:1204:1: C901 'CoolFactory.prepare' is too complex (14)
This feature is quite useful for detecting over-complex code. According to McCabe,
anything that goes beyond 10 is too complex.
Flake8 has many features that mccabe does not provide. Flake8 allows users to
ignore violations reported by plugins with ``# noqa``. Read more about this in
`their documentation
<http://flake8.pycqa.org/en/latest/user/violations.html#in-line-ignoring-errors>`__.
To silence violations reported by ``mccabe``, place your ``# noqa: C901`` on
the function definition line, where the error is reported for (possibly a
decorator).
Links
-----
* Feedback and ideas: http://mail.python.org/mailman/listinfo/code-quality
* Cyclomatic complexity: http://en.wikipedia.org/wiki/Cyclomatic_complexity
* Ned Batchelder's script:
http://nedbatchelder.com/blog/200803/python_code_complexity_microtool.html
* McCabe complexity: http://en.wikipedia.org/wiki/Cyclomatic_complexity
Changes
-------
0.7.0 - 2021-01-23
``````````````````
* Drop support for all versions of Python lower than 3.6
* Add support for Python 3.8, 3.9, and 3.10
* Fix option declaration for Flake8
0.6.1 - 2017-01-26
``````````````````
* Fix signature for ``PathGraphingAstVisitor.default`` to match the signature
for ``ASTVisitor``
0.6.0 - 2017-01-23
``````````````````
* Add support for Python 3.6
* Fix handling for missing statement types
0.5.3 - 2016-12-14
``````````````````
* Report actual column number of violation instead of the start of the line
0.5.2 - 2016-07-31
``````````````````
* When opening files ourselves, make sure we always name the file variable
0.5.1 - 2016-07-28
``````````````````
* Set default maximum complexity to -1 on the class itself
0.5.0 - 2016-05-30
``````````````````
* PyCon 2016 PDX release
* Add support for Flake8 3.0
0.4.0 - 2016-01-27
``````````````````
* Stop testing on Python 3.2
* Add support for async/await keywords on Python 3.5 from PEP 0492
0.3.1 - 2015-06-14
``````````````````
* Include ``test_mccabe.py`` in releases.
* Always coerce the ``max_complexity`` value from Flake8's entry-point to an
integer.
0.3 - 2014-12-17
````````````````
* Computation was wrong: the mccabe complexity starts at 1, not 2.
* The ``max-complexity`` value is now inclusive. E.g.: if the
value is 10 and the reported complexity is 10, then it passes.
* Add tests.
0.2.1 - 2013-04-03
``````````````````
* Do not require ``setuptools`` in setup.py. It works around an issue
with ``pip`` and Python 3.
0.2 - 2013-02-22
````````````````
* Rename project to ``mccabe``.
* Provide ``flake8.extension`` setuptools entry point.
* Read ``max-complexity`` from the configuration file.
* Rename argument ``min_complexity`` to ``threshold``.
0.1 - 2013-02-11
````````````````
* First release
Raw data
{
"_id": null,
"home_page": "https://github.com/pycqa/mccabe",
"name": "mccabe",
"maintainer": "Ian Stapleton Cordasco",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "graffatcolmingov@gmail.com",
"keywords": "flake8 mccabe",
"author": "Tarek Ziade",
"author_email": "tarek@ziade.org",
"download_url": "https://files.pythonhosted.org/packages/e7/ff/0ffefdcac38932a54d2b5eed4e0ba8a408f215002cd178ad1df0f2806ff8/mccabe-0.7.0.tar.gz",
"platform": "",
"description": "McCabe complexity checker\n=========================\n\nNed's script to check McCabe complexity.\n\nThis module provides a plugin for ``flake8``, the Python code checker.\n\n\nInstallation\n------------\n\nYou can install, upgrade, or uninstall ``mccabe`` with these commands::\n\n $ pip install mccabe\n $ pip install --upgrade mccabe\n $ pip uninstall mccabe\n\n\nStandalone script\n-----------------\n\nThe complexity checker can be used directly::\n\n $ python -m mccabe --min 5 mccabe.py\n (\"185:1: 'PathGraphingAstVisitor.visitIf'\", 5)\n (\"71:1: 'PathGraph.to_dot'\", 5)\n (\"245:1: 'McCabeChecker.run'\", 5)\n (\"283:1: 'main'\", 7)\n (\"203:1: 'PathGraphingAstVisitor.visitTryExcept'\", 5)\n (\"257:1: 'get_code_complexity'\", 5)\n\n\nPlugin for Flake8\n-----------------\n\nWhen both ``flake8 2+`` and ``mccabe`` are installed, the plugin is\navailable in ``flake8``::\n\n $ flake8 --version\n 2.0 (pep8: 1.4.2, pyflakes: 0.6.1, mccabe: 0.2)\n\nBy default the plugin is disabled. Use the ``--max-complexity`` switch to\nenable it. It will emit a warning if the McCabe complexity of a function is\nhigher than the provided value::\n\n $ flake8 --max-complexity 10 coolproject\n ...\n coolproject/mod.py:1204:1: C901 'CoolFactory.prepare' is too complex (14)\n\nThis feature is quite useful for detecting over-complex code. According to McCabe,\nanything that goes beyond 10 is too complex.\n\nFlake8 has many features that mccabe does not provide. Flake8 allows users to\nignore violations reported by plugins with ``# noqa``. Read more about this in\n`their documentation\n<http://flake8.pycqa.org/en/latest/user/violations.html#in-line-ignoring-errors>`__.\nTo silence violations reported by ``mccabe``, place your ``# noqa: C901`` on\nthe function definition line, where the error is reported for (possibly a\ndecorator).\n\n\nLinks\n-----\n\n* Feedback and ideas: http://mail.python.org/mailman/listinfo/code-quality\n\n* Cyclomatic complexity: http://en.wikipedia.org/wiki/Cyclomatic_complexity\n\n* Ned Batchelder's script:\n http://nedbatchelder.com/blog/200803/python_code_complexity_microtool.html\n\n* McCabe complexity: http://en.wikipedia.org/wiki/Cyclomatic_complexity\n\n\nChanges\n-------\n\n0.7.0 - 2021-01-23\n``````````````````\n\n* Drop support for all versions of Python lower than 3.6\n\n* Add support for Python 3.8, 3.9, and 3.10\n\n* Fix option declaration for Flake8\n\n0.6.1 - 2017-01-26\n``````````````````\n\n* Fix signature for ``PathGraphingAstVisitor.default`` to match the signature\n for ``ASTVisitor``\n\n0.6.0 - 2017-01-23\n``````````````````\n\n* Add support for Python 3.6\n\n* Fix handling for missing statement types\n\n0.5.3 - 2016-12-14\n``````````````````\n\n* Report actual column number of violation instead of the start of the line\n\n0.5.2 - 2016-07-31\n``````````````````\n\n* When opening files ourselves, make sure we always name the file variable\n\n0.5.1 - 2016-07-28\n``````````````````\n\n* Set default maximum complexity to -1 on the class itself\n\n0.5.0 - 2016-05-30\n``````````````````\n\n* PyCon 2016 PDX release\n\n* Add support for Flake8 3.0\n\n0.4.0 - 2016-01-27\n``````````````````\n\n* Stop testing on Python 3.2\n\n* Add support for async/await keywords on Python 3.5 from PEP 0492\n\n0.3.1 - 2015-06-14\n``````````````````\n\n* Include ``test_mccabe.py`` in releases.\n\n* Always coerce the ``max_complexity`` value from Flake8's entry-point to an\n integer.\n\n0.3 - 2014-12-17\n````````````````\n\n* Computation was wrong: the mccabe complexity starts at 1, not 2.\n\n* The ``max-complexity`` value is now inclusive. E.g.: if the\n value is 10 and the reported complexity is 10, then it passes.\n\n* Add tests.\n\n\n0.2.1 - 2013-04-03\n``````````````````\n\n* Do not require ``setuptools`` in setup.py. It works around an issue\n with ``pip`` and Python 3.\n\n\n0.2 - 2013-02-22\n````````````````\n\n* Rename project to ``mccabe``.\n\n* Provide ``flake8.extension`` setuptools entry point.\n\n* Read ``max-complexity`` from the configuration file.\n\n* Rename argument ``min_complexity`` to ``threshold``.\n\n\n0.1 - 2013-02-11\n````````````````\n* First release\n\n\n",
"bugtrack_url": null,
"license": "Expat license",
"summary": "McCabe checker, plugin for flake8",
"version": "0.7.0",
"split_keywords": [
"flake8",
"mccabe"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "9e5647aa3a016a0e27b50403efc5d8e7",
"sha256": "6c2d30ab6be0e4a46919781807b4f0d834ebdd6c6e3dca0bda5a15f863427b6e"
},
"downloads": -1,
"filename": "mccabe-0.7.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "9e5647aa3a016a0e27b50403efc5d8e7",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.6",
"size": 7350,
"upload_time": "2022-01-24T01:14:49",
"upload_time_iso_8601": "2022-01-24T01:14:49.620723Z",
"url": "https://files.pythonhosted.org/packages/27/1a/1f68f9ba0c207934b35b86a8ca3aad8395a3d6dd7921c0686e23853ff5a9/mccabe-0.7.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "374ee2b9407546bb41d195e7436e5f62",
"sha256": "348e0240c33b60bbdf4e523192ef919f28cb2c3d7d5c7794f74009290f236325"
},
"downloads": -1,
"filename": "mccabe-0.7.0.tar.gz",
"has_sig": false,
"md5_digest": "374ee2b9407546bb41d195e7436e5f62",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 9658,
"upload_time": "2022-01-24T01:14:51",
"upload_time_iso_8601": "2022-01-24T01:14:51.113403Z",
"url": "https://files.pythonhosted.org/packages/e7/ff/0ffefdcac38932a54d2b5eed4e0ba8a408f215002cd178ad1df0f2806ff8/mccabe-0.7.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-01-24 01:14:51",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "pycqa",
"github_project": "mccabe",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"tox": true,
"lcname": "mccabe"
}
JSON
