Skip to main content

Simple source code validator with file reformatting option (remove trailing WS, pretty print XML, ..)

Project description

Simple source code validator with file reformatting option (remove trailing WS, pretty print XML, ..).

For Python code formatting it can either use autopep8 or the builtin copy of PythonTidy.

Requirements

  • Python 2.7+

  • lxml (for XML formatting)

  • pep8 (for Python checking)

  • autopep8 (for Python formatting)

  • pyflakes (for static Python code checking)

  • Jalopy (for Java code formatting)

  • coffeelint (for CoffeeScript validation)

  • PHP_CodeSniffer (for PHP style checking)

  • Puppet (for Puppet manifest validation)

  • sqlparse

  • jshint (for JavaScript checking)

  • PyYAML (for YAML checking)

  • Ruby (for Ruby code checking)

  • Rubygems (for Ruby code checking with rubocop)

  • erb and ruby (for ERB template checking)

On Ubuntu you can install most packages easily:

sudo apt-get install python-lxml pep8 pyflakes nodejs npm python-sqlparse python-yaml ruby rubygems
sudo npm install -g jshint
sudo gem i rubocop

If you are using Jalopy, for better performance also install Nailgun:

sudo apt-get install nailgun

And start the nailgun server with:

java -cp /usr/share/java/nailgun-0.9.0.jar:/opt/jalopy/lib/jalopy-1.9.4.jar -server com.martiansoftware.nailgun.NGServer

Installation

There are at least two ways of installing codevalidator:

  • Alternative 1: Use the codevalidator source tree directly (i.e. clone the GIT repo and put codevalidator.py in your PATH):

    git clone https://github.com/hjacobs/codevalidator.git
    sudo ln -s codevalidator/codevalidator.py /usr/local/bin/codevalidator.py
  • Alternative 2: Install codevalidator from PyPI using PIP:

    sudo pip install codevalidator
  • Alternative 3: Use Docker to get all dependencies and to run codevalidator without messing with your local system:

    docker build -t codevalidator .
    # we can mount the current directory into "workdir" volume to validate the local directory recursively
    docker run -v `pwd`:/workdir -t codevalidator -rvv /workdir/

Getting Started

Validating test files with builtin default configuration:

./codevalidator.py test/*

Fixing test files (removing trailing whitespace, XML format):

./codevalidator.py -f test/*

Using custom configuration file:

./codevalidator.py -c test/config.json test/*

Validate and fix a whole directory tree:

./codevalidator.py -c myconfig.json -rf /path/to/mydirectory

Validate a single PHP file and print detailed error messages (needs PHP_CodeSniffer with PSR standards installed!):

./codevalidator.py -v test/test.php

Running in very verbose (debug) mode to see what is validated:

./codevalidator.py -vvrc test/config.json test

Using the filter mode to “fix” stdin and write to stdout:

echo 'print 1' | ./codevalidator.py --fix --filter foobar.py && echo success

If you are annoyed by the .XX.pre-cvfix backup files you can disable them either on the command line (--no-backup) or in the config file.

Configuration

Codevalidator uses a mapping of file name patterns to “rules” in order to know which validation rules should be applied for a certain file. The script contains a more-or-less sane default configuration (see DEFAULT_CONFIG at the top of codevalidator.py). You can overwrite the configuration by putting a .codevalidatorrc file in your home directory. The file must be JSON and must have the same structure as DEFAULT_CONFIG.

Advanced Usages

You can use the --fix --filter combination to directly filter your current buffer in VIM:

:%!codevalidator.py --fix --filter %

The --fix --filter was also designed to be used with GIT filters.

To apply a formatting rule once without changing you configuration file, you can use the -a option. Formatting a Python file once with the pythontidy rule looks like:

./codevalidator.py -a pythontidy myfile.py

Known Issues

  • PythonTidy cannot parse dict comprehensions. As a workaround you can use list comprehensions and wrap it with dict.

Project details


Download files

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

Source Distribution

codevalidator-0.8.2.tar.gz (38.2 kB view details)

Uploaded Source

File details

Details for the file codevalidator-0.8.2.tar.gz.

File metadata

File hashes

Hashes for codevalidator-0.8.2.tar.gz
Algorithm Hash digest
SHA256 82fffaf0637bf691a8f896d9c66cf7c2d94eb03e7bcb46850aff2e082fd6d415
MD5 8f5b9e90f4d168c089f082711a98b1ba
BLAKE2b-256 b95f71cfe7cae87ffea2ace6e1c24c681ad2ab9a66c172bdf1f39e6a391ca61b

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page