https://github.com/miohtama/vvv

VVV provides easy to integrate validation and linting tools to prevent bad stuff committed in your software project
https://github.com/miohtama/vvv

Last synced: 3 months ago
JSON representation

VVV provides easy to integrate validation and linting tools to prevent bad stuff committed in your software project

• Host: GitHub
• URL: https://github.com/miohtama/vvv
• Owner: miohtama
• Created: 2012-04-06T20:35:37.000Z (almost 13 years ago)
• Default Branch: master
• Last Pushed: 2016-08-10T10:42:55.000Z (over 8 years ago)
• Last Synced: 2024-10-04T06:38:32.227Z (4 months ago)
• Language: Python
• Homepage:
• Size: 2.06 MB
• Stars: 37
• Watchers: 5
• Forks: 7
• Open Issues: 6
• Metadata Files:
  • Readme: README.rst

Awesome Lists containing this project

README

        
========================================

VVV - validation and linting integrator

========================================

VVV is a tool for easy validation and linting integration for your software project

containing multiple kinds of files. It integrates with version control and

prevents committing files containing bad formatting or syntax errors.

An example use case would be a web project containing HTML, CSS, Javascript

and backend programming language files: with VVV you can check with a single command

all files conform the policy you set.

.. contents :: :local:

Usage

==============

Example output from validating the demo repository where we find errors in a Python and a CSS file.

You enter the folder and run ``vvv`` against the current folder (``.``) ::

    $ vvv .

    Running vvv against .

    /Users/moo/code/vvv/demo/demo.py validation output:

    ************* Module demo

    E0602:  1,9: Undefined variable 'get_magic'

    W3C CSS Validator results for file:/Users/moo/code/vvv/demo/foobar.css

    Line : 2 .foo

           Property backgrnd doesn't exist :

           yellow

Installation

==============

VVV is written in `Python `_ programming language and is compatible with

**Python interpreter 2.7 or later, including 3.x series**.

Installation instructions for `Windows `_ -

`Linux `_ -

`OSX `_.

Benefits

=========

* Enforce coding conventions across multiple developers

* Enable linting and validators support for your software project with a single command

* Automatically guide committers to policy guidelines and let them fix errors themselves, instead of having

  post-commit personal coaching.

* Provide sane default validation and linting options for all popular programming languages and file formats

* Run VVV as continuous integration service with systems like Travis CI or Jenkins and shoot down bad code push-ins

What VVV doesn't do

* This is not automated testing tool. We just scan files against a **policy**, not for

  programming errors. Linting tools tend to pick up programming errors, too though,

  like mistyped names.

Features

=========

* Set-up for your software repository with two files ``validation-options.yaml`` (configuration) and ``validation-files.yaml`` (whitelist/blacklist)

* VVV automatically downloads and locally installs required software - you don't need to spend time hunting downloads or distribution packages

* Check file against hard tabs and whitespace policies - no more different tab width ever

* Prevent committing hard source code breakpoints, like Python's ``import pdb ; pdb.set_trace()``

* Support (on its way) for Subversion, Git, Github, Travis CI, Jenkins and other popular version control and continuous integration

  systems

Documentation and code

=========================

Please see the `VVV documentation `_.

`Source code is available on Github `_. Please use Github issue tracker

to contact the authors.

Explore different `linting and validators available `_.

Continuous integration status

================================

Current trunk continuous integration status with Travis CI

.. image :: https://secure.travis-ci.org/miohtama/vvv.png

Author

===============

Mikko Ohtamaa (`blog `_, `Twitter `_)

Please use Github issue tracker to contact the authors in the project related matters.