Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Pordego plugin for code complexity analysis using the Radon library

Project Description

Summary

Pordego plugin that analyzes code using the Radon library.

If the code does not meet a specified threshold, it will print the complex blocks and cause the pordego tool to return an error code.

Configuration

source_paths

There is one required parameter “source_paths”. This parameter should be a list of paths to directories containing Python source code (other types of code are ignored). The paths are searched recursively, so only the top level folder need be specified. The paths can be absolute or relative to the directory where pordego is run.

ignore_paths

Optional. A list of file patterns to ignore, such as “test” which will ignore all files containing “test”

complexity_threshold

Optional (default “B”). The maximum allowable complexity. See https://radon.readthedocs.io/en/latest/api.html#radon.complexity.cc_rank for a description of the ranks.

ignore_block_list

Optional. For lsiting all that legacy code that hasn’t been refactored yet.

Each entry in the list should be a string formatted like so: <path to file> <class name.method name or function name> <Max complexity grade>

<Path to file> should start with one of the paths specified in source_paths, so if the source path is relative, this should be as well Functions are specified with just the function name, methods that are part of a class (including class/staticmethods) are joined to the class name with a ‘.’ <Max complexity grade> specifies the worst grade that is allowed for the block of code. If the calculated grade is at or above the threshold grade, it will pass.

The easiest way to generate the ignore_block_list is to run the complexity plugin without ignore_block_list. The plugin prints the list of complex blocks in the same format as the ignore_block_list.

Example: path/to/my/src/mymodule.py MyClass.some_method D path/to/my/src/mymodule.py some_free_function E

Release History

Release History

This version
History Node

1.0.4

History Node

1.0.3

History Node

1.0.2

History Node

1.0.1

History Node

1.0.0

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
pordego_complexity-1.0.4-py2-none-any.whl (7.7 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Jun 5, 2017
pordego-complexity-1.0.4.tar.gz (5.6 kB) Copy SHA256 Checksum SHA256 Source Jun 5, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting