Monitor and manage deeply customizable metrics about your python code using ASTs
Project description
This project is currently deprecated and may be archived. If you're looking for something similar, you could try bellybutton or writing a custom checker in pylint instead.
Overview
Monitor and manage deeply customizable metrics about your python code using ASTs.
Codewatch lets you write simple python code to track statistics about the state of your codebase and write lint-like assertions on those statistics. Use this to incrementally improve and evolve the quality of your code base, increase the visibility of problematic code, to encourage use of new patterns while discouraging old ones, to enforce coding style guides, or to prevent certain kinds of regression errors.
What codewatch does:
- Traverses your project directory
- Parses your code into AST nodes and calls your visitor functions
- Your visitor functions run and populate a stats dictionary
- After all visitor functions are called, your assertion functions are called
- Your assertion functions can assert on data in the stats dictionary, save metrics to a dashboard, or anything you can think of
Installation
Python: 2.7, 3.6, 3.7
Execute the following in your terminal:
pip install codewatch
Usage
codewatch codewatch_config_module
codewatch_config_module
is a module that should contain your visitors, assertions and filters (if required)
Visitors
You should use the @visit
decorator.
The passed in node is an astroid node which follows a similar API to ast.Node
from codewatch import visit
def _count_import(stats):
stats.increment('total_imports_num')
@visit('import')
def count_import(node, stats, _rel_file_path):
_count_import(stats)
@visit('importFrom')
def count_import_from(node, stats, _rel_file_path):
_count_import(stats)
This will build a stats dictionary that contains something like the following:
{
"total_imports_num": 763
}
Assertions
Once again in the codewatch_config_module
you can add assertions against this stat dictionary using the @assertion
decorator
from codewatch import assertion
@assertion()
def number_of_imports_not_too_high(stats):
threshold = 700
actual = stats.get('total_imports_num')
err = 'There were {} total imports detected which exceeds threshold of {}'.format(actual, threshold)
assert actual <= threshold, err
In this case, the assertion would fail since 763 is the newStat
and the message:
There were 763 total imports detected which exceeds threshold of 700
would be printed
Filters
You can add the following optional filters:
- directory_filter (defaults to skip test and migration directories)
# visit all directories
def directory_filter(_dir_name):
return True
- file_filter (defaults to only include python files, and skips test files)
# visit all files
def file_filter(_file_name):
return True
Tune these filters to suit your needs.
Contributing
Contributors
Thanks goes to these wonderful people emoji key:
We welcome contributions from the community, Top Hatters and non-Top Hatters alike. Check out our contributing guidelines for more details.
Credits
Special thanks to Carol Skelly for donating the 'tophat' GitHub organization.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file codewatch-1.0.0.tar.gz
.
File metadata
- Download URL: codewatch-1.0.0.tar.gz
- Upload date:
- Size: 21.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.7.1 requests/2.26.0 setuptools/40.6.2 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.6.15
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | a5e9157de9df1184fd2fa8e4a82e17c9751617309fb497ee1171f61d5674a0b1 |
|
MD5 | 390f8c2767bcb3a514602717fead9998 |
|
BLAKE2b-256 | fc9bbf53d3a7fc4e22367b3e5d5828aeac6f3b6f1b6dc0f9ac902d7d772d5879 |
File details
Details for the file codewatch-1.0.0-py2.py3-none-any.whl
.
File metadata
- Download URL: codewatch-1.0.0-py2.py3-none-any.whl
- Upload date:
- Size: 31.5 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.7.1 requests/2.26.0 setuptools/40.6.2 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.6.15
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | cb1800dcf817d7be18ae6455d51028d3cdc11f3957570978fe35453ce3db4924 |
|
MD5 | d3d2649039960fbbd0ca98e347e38f53 |
|
BLAKE2b-256 | ddfb04d55b56ededdf8f5450737ebb2431490518ba848451e026fd5e82c4df2d |