Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Trigger new code analysis on

Project description

Code Grade Build Status

Code-Inspector Continuous Integration Tool

These are various Python tools used to use the code-inspector engine in a continuous integration pipeline and compare analysis.

The following programs are being included:

  • code-inspector-project: get metrics about a project
  • code-inspector-compare: compare a project metrics against another projects or branches


You can build and try the program using the following command:

python install --user

You will then find binaries in $HOME/.local/bin, for example $HOME/.local/bin/code-inspector-compare.


You need to set your API keys with environment variables:

  • CODE_INSPECTOR_ACCESS_KEY: your access key API generated from your project preferences
  • CODE_INSPECTOR_SECRET_KEY: your secret key API generated from your project preferences

On a terminal, you would set them up like this:


Project information tool

Get general information about a project.

Invoke the tool as follow:

code-inspector-project -p <PROJECT_NAME>

For example:

code-inspector-project -p "mergify integration"

This is an example of the execution results:

    "lastAnalysis": {
        "status": "Done", 
        "summary": {
            "duplicates": 0, 
            "duplicated_lines": 0, 
            "violations": 2
    "id": 173, 
    "name": "mergify integration"

Compare tool

The compare tool is used to compare a project with another repository. Invoke the tool as follow:

code-inspector-compare -p "mergify integration" --kind <REPOSITORY_KIND> --url <URL_TO_OTHER_REPOSITORY> --target-branch=<BRANCH> --target-revision=<REVISION>

This command will compare the project mergify integration on code inspector with the project located at the URL <URL_TO_OTHER_REPOSITORY>.

When the tool successfully executes, it reports the execution in a JSON object. This object shows you the number of violations, duplicates so that developers can reuse this later. There is an example of the JSON object - as follow:

    "status": "Done", 
    "targetAnalysis": {
        "status": "Done", 
        "summary": {
            "duplicates": 0, 
            "violations": 2
    "id": 53, 
    "sourceAnalysis": {
        "status": "Done", 
        "summary": {
            "duplicates": 0, 
            "violations": 2

These are the explanation for the other parameters:

  • kind: kind of repository used for the target. Can be Git, Github, Gitlab or Bitbucket. Values are explained below. This parameter is REQUIRED.
  • URL: URL of the repository. This parameter is REQUIRED.
  • target-revision: revision of the target repository. This parameter is OPTIONAL
  • target-branch: branch of the target repository. This parameter is OPTIONAL

The kind argument is used to define how the target repository will be fetched. Based on the value, we use credentials from the authenticated user to clone the repository. For example, if you specify Github, the target repository will be cloned using the github credentials of the authenticated user. If the user does not have any registered credentials on Code Inspector, analysis will fail.

These are the valid values for the kind argument:

  • Github: use the Github credentials of the user making the compare request to clone the target repository
  • Git: do not use any credentials to clone the target repository. Used to clone public repository that does not need authentication.
  • Gitlab: use the Gitlab credentials of the user making the compare request to clone the target repository
  • Bitbucket: use the Bitbucket credentials of the user making the compare request to clone the target repository

These are the potential return code:

  • 0: everything is great and the target analysis does not have more violations or duplicates
  • 1: error during the analysis
  • 2: cannot find the project (specified with the -p option)
  • 3: cannot start a new comparison
  • 5: the target analysis has more violations than the source
  • 6: the target analysis has more duplicates than the source

About Code Inspector

Code Inspector is a software analysis platform to manage and mitigate technical debt. It offers plans that caters to all developers. From our basic free plan for your personal project to the gold plan (for companies with multiples private projects), code-inspector detects coding issues and helps you keep your project afloat.

Download files

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

Files for code-inspector, version 0.0.10
Filename, size File type Python version Upload date Hashes
Filename, size code-inspector-0.0.10.tar.gz (10.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page