robotframework-sherlock 0.2.0

Robot Framework code analysis tool

Sherlock

The tool for analyzing Robot Framework code in terms of not used code, code complexity or performance issues.

Note

The tool is in the Alpha state, which means it may be unstable and should be used at your own risk. Some features may be broken and there are still many things to be developed. If you find anything unexpected, or you have ideas for improvements not listed in GitHub issues, please open an new issue.

Installation

Currently, you need to install Sherlock from the source code. In order to do so, first clone the repository, and run following command inside robotframework-sherlock directory:

pip install .

Install or update directly from sources

pip install -U git+https://github.com/bhirsz/robotframework-sherlock.git

Add -e flag after installation if you want Sherlock to reload installed version after each code update (performed via git pull).

Usage

Sherlock can prepare analysis based on your source code alone. However, it's currently highly recommended to also include output of test execution.

Run Sherlock with:

sherlock --output <path to output.xml file> <path to source code repository>

To analyze external library/resource use --resource option:

sherlock --output output.xml --resource SeleniumLibrary src/

sherlock --output output.xml --resource external_repository_used_in_tests/ src/

Reports

Sherlock by default prints the output. You can configure what reports are produced by sherlock using --report option:

sherlock --report print

sherlock --report html

--report accepts comma separated list of reports:

sherlock --report print,html,json

BuiltIn library

To show analysis of BuiltIn libraries use --include-builtin flag:

sherlock --include-builtin src/