Skip to content
Tooling & Docker Definition for running Ameba on Codacy
Branch: master
Clone or download
Pull request Compare This branch is 13 commits ahead, 1 commit behind veelenga:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Codacy Ameba

CircleCI Codacy Badge Docker Version

Tooling & Docker Definition for running Ameba on Codacy

Implements the Tool Developer Guide


Build the docker image

docker build . -t ameba/codacy

Run on a project

docker run -it -v $srcDir:/src ameba/codacy

Regenerate docs folder:

shards install
crystal src/


Run regular unit tests: crystal spec

Run Codacy Plugin Tests against the docker image:

# In codacy-ameba
docker build . -t ameba/codacy:latest

# in codacy-plugins-test
sbt "runMain codacy.plugins.DockerTest all ameba/codacy:latest"

Bump versions

  • Crystal version should be updated in Dockerfile file (version of the image).
  • Ameba version should be updated in shard.yml/shard.lock files.

What is Codacy

Codacy is an Automated Code Review Tool that monitors your technical debt, helps you improve your code quality, teaches best practices to your developers, and helps you save time in Code Reviews.

Among Codacy’s features

  • Identify new Static Analysis issues
  • Commit and Pull Request Analysis with GitHub, BitBucket/Stash, GitLab (and also direct git repositories)
  • Auto-comments on Commits and Pull Requests
  • Integrations with Slack, HipChat, Jira, YouTrack
  • Track issues in Code Style, Security, Error Proneness, Performance, Unused Code and other categories

Codacy also helps keep track of Code Coverage, Code Duplication, and Code Complexity.

Codacy supports PHP, Python, Ruby, Java, JavaScript, and Scala, among others.


  1. Fork it (
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request


You can’t perform that action at this time.