Mccabe

Introduction

Calculate the cyclomatic complexity of the source code.

Current supported languages:

• Go
• JavaScript
• Python
• C++
• C

Installation

The tool is not published to Pypi, you can install it directly from source code.

pip install git+https://github.com/frite/mccabe.git

Usage

You can use mccabe both as a CLI program and as a module in your program.

CLI

> mcc --help
Usage: mcc [OPTIONS]
Calculate the cyclomatic complexity of the source code
Options:
-V, --version Show the version and exit.
-d, --directory TEXT The source code directory
-f, --file TEXT The source code file
-m, --min INTEGER The min threshold value
-l, --language [py|go|js] The source code language [required]
--help Show this message and exit.

For a single file

You can calculate the cyclomatic complexity for a single source file.

> mcc -l py -f tests/test_languages.py
{
"tests/test_languages.py": 9
}

For multiple files under a directory.

You can also calculate the cyclomatic complexity for all files inside a directory, which leverages parallel computing.

> mcc -l py -d tests
{
"tests/test_languages.py": 9,
"tests/__init__.py": 0,
"tests/test_provider.py": 4,
"tests/test_cyclomaticc_complexity.py": 8,
"tests/sources/py.py": 24
}

Set threshold value

You can set a minimun threshold value by using the -m flag.

> mcc -l py -d tests -m 5
{
"tests/test_languages.py": 9,
"tests/test_cyclomaticc_complexity.py": 8,
"tests/sources/py.py": 24
}

Use in program

Also, you can load it as a module in your programs.

frommccimportget_provider_classfrommcc.languagesimportLangcls=get_provider_class(Lang.py)
ret=cls(file="test.py").run()
print(ret)

Develop

Clone

First, you need to clone the repo.

git clone https://github.com/long2ice/mccabe.git

Install deps

Then install the requirements.

make deps

Check CI

Before commiting your code, you should check the code style and syntax.

make style ci

Extend language support

If you want to add other language support by tree-sitter like c++, just follow the steps:

1. Run git submodule add https://github.com/tree-sitter/tree-sitter-cpp.git vendor/tree-sitter-cpp

2. Update build.py to add cpp support.

   Language.build_library(
   'languages.so',
   [
   'vendor/tree-sitter-go',
   'vendor/tree-sitter-javascript',
   'vendor/tree-sitter-python',
   'vendor/tree-sitter-cpp'
   ]
   )

3. Update languages.py add cpp enum.

   classLang(str, Enum):
   py="py"go="go"js="js"cpp="cpp"

4. Create new file cpp.py and write a class which inherit Mccabe.

   frommcc.providersimportMccabefrommcc.languagesimportLangclassMccabeCpp(Mccabe):
   suffix=".cpp"language=Lang.cppjudge_nodes= [...]

That's all! You can now calculate the cyclomatic complexity of cpp source files!

License

This project is licensed under the Apache-2.0 License.