Difference between revisions of "Platform Team/Sugar Lint"

From Sugar Labs
Jump to navigation Jump to search
Line 15: Line 15:
 
Clone sugar-lint repository:
 
Clone sugar-lint repository:
  
  git clone git://git.sugarlabs.org/sugar-lint/mainline.git ''<install-path>''
+
  git clone git://git.sugarlabs.org/sdk/sugar-lint.git ''<install-path>''
  
 
Add sugar-lint command to PATH e.g. to ~/.bashrc (you need to relogin):
 
Add sugar-lint command to PATH e.g. to ~/.bashrc (you need to relogin):

Revision as of 07:00, 24 February 2011

Summary

A set of configuration files and scripts to lint various sugar related code.

During execution, sugar-lint will lint:

  • python files by pylint (should be installed before) with custom configuration file and pep8.py (comes with sugar-lint sources),
  • vala files by vala-indent (should be installed from http://git.sugarlabs.org/projects/vala-indent).
  • C/C++ files by indent command (should be installed)

Install

Clone sugar-lint repository:

git clone git://git.sugarlabs.org/sdk/sugar-lint.git <install-path>

Add sugar-lint command to PATH e.g. to ~/.bashrc (you need to relogin):

echo PATH=<full-install-path>:$PATH >> ~/.bashrc

Usage

Direct invocation

To lint files:

sugar-lint <file>

To lint all files recursively:

sugar-lint -r .

If fails were detected, call diff command (by default vimdiff or DIFFER environment variable value) to diff the source file and temporary file with comments in problematic places:

sugar-lint -d <file>

Lint files before commiting

To add pre-commit git hook to lint files before commiting to arbitrary project:

ln -s <full-install-path>/sugar_lint/git-pre-commit-hook <project-root>/.git/hooks/pre-commit

Additional syntax in source files

Various sugar-lint related hints that could be used in source files.

Disable sugar-lint

To disable checks entirely for source file.

Python syntax:

# sugar-lint: disable

Vala syntax:

// sugar-lint: disable
/* sugar-lint: disable */

Ignore pep8.py checks in Python sources

# pep8: ignore=code[,code]

Resources