Provide a testing interface for the external docker tools.
The test files should be placed in /docs/tests on the docker of the tool being tested.
Definition
//#Patterns: <PATTERN_NAME> : { "<PARAMETER_NAME>": "<PARAMETER_VALUE>" }
var people = {};
//#<PATTERN_LEVEL>: <PATTERN_NAME>
for (var i = 0, person; (person = people[i]); i++) {}
var variable;
function test() {
//#<PATTERN_LEVEL>: <PATTERN_NAME>
return (variable = "test");
}Example:
//#Patterns: boss
var people = {};
//#Warn: boss
for (var i = 0, person; (person = people[i]); i++) {}
var variable;
function test() {
//#Warn: boss
return (variable = "test");
}You can also look for multiple patterns in the same file, just separate them with a comma:
Example:
//#Patterns: big, boss
var people = {};
//#Warn: big
for (var i = 0, person; (person = people[i]); i++) {}
var variable;
function test() {
//#Warn: boss
return (variable = "test");
}Instead of commenting in the line before the error, you can alternatively specify the line of the warning with this syntax:
<LANGUAGE_COMMENT>#Issue: {"severity": "<ERROR_LEVEL>", "line": <LINE_NUMBER_WITH_ISSUE>, "patternId": "PATTERN_ID"}
Example:
//#Patterns: design_tag_todo
//#Issue: {"severity": "Info", "line": 3, "patternId": "design_tag_todo"}
var people = {};
//TODO: remove empty for
for (var i = 0, person; (person = people[i]); i++) {}
var variable;The multiple tests are defined inside the /docs/tests/multiple-tests/ directory of the tool's docker image being tested.
You can have a subdirectory of /docs/tests/multiple-tests/ for every run of the tool.
For example, you can add two subdirectories like these:
with-config-filewithout-config-file
To check that the tool works with native configuration file (for example .eslintrc.json) and with Codacy configuration.
Each test folder should have a src directory (containining the source files to test and the tool's native
configuration (if it exists)), two files named patterns.xml and results.xml with the following structure:
<?xml version="1.0" encoding="UTF-8"?>
<module name="root">
<property name="tool-extra-parameter-name" value="tool-extra-parameter-value" />
<module name="rule-name" />
<module name="rule-with-parameters">
<property name="parameter-key" value="parameter-value" />
</module>
<!-- To ignore config files from analysis -->
<module name="BeforeExecutionExclusionFileFilter">
<!-- value can be a regex matching files to ignore -->
<property name="fileNamePattern" value="config-file\.xml"/>
</module>
</module><?xml version="1.0" encoding="utf-8"?>
<checkstyle version="4.3">
<file name="file-name.ext"> <!-- severity can be one of info, warning or error -->
<error source="rule-name" line="20" message="reported message from the tool" severity="info|warning|error" />
</file>
</checkstyle>Checks if the patterns definitions are in the correct format
sbt "runMain codacy.plugins.DockerTest json <DOCKER_NAME>:<DOCKER_VERSION>"Options:
codacy.tests.ignore.descriptions- if this variable is defined we do not check if all the patterns have descriptions
Check if all the patterns defined in the test files occur in the specified line
sbt "runMain codacy.plugins.DockerTest pattern <DOCKER_NAME>:<DOCKER_VERSION>"Options:
codacy.tests.languages- languages supported by the tool. If this option isn't provided, the languages will be inferred from the test files. Example:-Dcodacy.tests.languages=ruby,java,javascript
Alternatively, you can run a specific test file:
sbt "runMain codacy.plugins.DockerTest pattern <DOCKER_NAME>:<DOCKER_VERSION> no-curly-brackets"Check if the metrics defined in the test files match with same complexieties in the specified lines
sbt "runMain codacy.plugins.DockerTest metrics <DOCKER_NAME>:<DOCKER_VERSION>"Check if the tool runs with multiple patterns and test files at the same time and configuration file behavior as well
sbt "runMain codacy.plugins.DockerTest multiple <DOCKER_NAME>:<DOCKER_VERSION>"Options:
--onlyby adding this flag, followed by the folder name, you can run a single test of the multiple foldersbt "runMain codacy.plugins.DockerTest multiple <DOCKER_NAME>:<DOCKER_VERSION>" --only <folderName>
Information about the integration with external analysis tools at Codacy available here.
OSx
Change the java tmp dir to your home so that boot2docker can access the tmp files
-Djava.io.tmpdir=$HOME/tmpCodacy 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.
- 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.
Codacy is free for Open Source projects.
Licensed under the MIT License terms.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent