No description or website provided.
Clone or download
Chi-teck and OwlyCode Add JUnit reporter (#55)
* Issue #54: Add JUnit reporter

* Create testsuite per file

* Set vialation severity
Latest commit b9151d4 Oct 3, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
src Add JUnit reporter (#55) Oct 3, 2018
tests Fixed variable declaration as block breaking unused vars detection (#52) Sep 10, 2018
.gitignore Moved twigcs to right folder Oct 22, 2015
.travis.yml
LICENSE Initial commit Oct 22, 2015
README.md Implement twigcs as a single command application (#40) Jul 16, 2018
composer.json Upgraded PHPUnit (#41) Jul 16, 2018
phpunit.xml.dist Moved tests outside of src, reduced src folder depth and fixed regres… Jul 7, 2017

README.md

Twigcs

The missing checkstyle for twig !

Twigcs aims to be what phpcs is to php. It checks your codebase for violations on coding standards.

Please note that the project is still in early development stage and is subject to heavy changes.

How to install

composer global require allocine/twigcs

How to run

Basically, just run :

twigcs /path/to/views

On Symfony projects, you can run, for instance :

twigcs /project/dir/app/Resources/views

You will get a summary of the violations in the console. The exit code of the command is based on the severity of any violation found. By default, twigcs won't even tolerate a notice, this can be changed at run time :

twigcs /path/to/views --severity warning # Allow notices

With the example above, notices are still displayed but not altering the exit code.

Continuous Integration

Twigcs can be used with your favorite CI server. The command itself will return a consistent exit code telling the CI job if it failed or succeeded. You can also have a nice xml report (checkstyle format) :

twigcs /path/to/views --reporter checkstyle > /path/to/report.xml

Coding standard

At the moment the only available standard is the official one from twig.

Custom coding standard

You can create a class implementing RulesetInterface and supply it as a --ruleset option to the CLI script:

twigcs /path/to/views --ruleset \MyApp\TwigCsRuleset

Note: twigcs needs to be used via composer and the ruleset class must be reachable via composer's autoloader for this feature to work.

Coming features

  • Indentation checking
  • Configurable coding standards

Contributing

The master is the development branch, if you find any bug or false positive during style checking, please open an issue or submit a pull request.

When creating or changing a class, don't forget to add you as an @author at the top of the file.