|
Size: 1595
Comment: Added issue tracker link
|
← Revision 20 as of 2012-02-15 19:25:33 ⇥
Size: 3277
Comment: Download location is a repository.
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 4: | Line 4: |
| This extension installs a commit hook to prevent tabs and trailing whitespaces locally. It also provides a command to check the working directory files and optionally to fix problems found. | This extension provides two hooks and two commands to detect, report and prevent trailing whitespace and/or unify usage of tabs/spaces. (Default behaviour prefers spaces.) The hooks must be explicitly enabled in the hgrc/mercurial.ini file. |
| Line 10: | Line 12: |
| '''This extension is/is not distributed with Mercurial.''' | '''This extension is not distributed with Mercurial.''' |
| Line 12: | Line 14: |
| ''Author: MarcusLindblom '' | ''Author: MarcusLindblom '' (Additional help: JesseGlick & VsevolodParfenov) |
| Line 14: | Line 16: |
| * Download site: https://bitbucket.org/marcusl/ml-hgext/src/tip/checkfiles.py | * Repository: https://bitbucket.org/marcusl/ml-hgext |
| Line 16: | Line 18: |
| * If you like it, drop a note here: https://www.ohloh.net/p/ml-hgext | |
| Line 19: | Line 22: |
| === Configuration === | By avoiding commits with tab characters or trailing whitespace on lines, there is less noise in the diffs and the actual code changes are clearer. The extensions adds a command {{{checkfiles}}} which reports issues in the working directory. Using --fixup will instead fix these files by replacing tabs with spaces and There is also two hooks: * {{{check_hook}}} - checks and blocks commits with issues, useable in {{{pretxncommit}}} or {{{pretxnchangegroup}}} * {{{fixup_hook}}} - automatically fixes issues in files on commit, useable in {{{pre-commit}}} == Configuration == |
| Line 24: | Line 35: |
| checkfiles = /path/to/checkfiles.py | checkfiles = /path/to/checkfiles.py # enable command [hooks] pretxnchangegroup.checkfiles = python:/path/to/checkfiles.py:check_hook # enables hook to check incoming changeset pretxncommit.checkfiles = python:/path/to/checkfiles.py:check_hook # enables hook to stop bad commits precommit.checkfiles = python:/path/to/checkfiles.py:fixup_hook # enables hook to fix files before creating commit |
| Line 27: | Line 43: |
| # default is any text file | |
| Line 28: | Line 45: |
# default are these (common autogenerated files) ignored_exts = .sln .suo .vcproj .csproj .ui |
|
| Line 30: | Line 50: |
# to examine only modified lines from check_hook (no effect on fixup_hook or command), use: # check_diffs = True # to replace spaces with tabs (instead of the default: tabs -> spaces), set use_spaces = False use_spaces = True |
|
| Line 32: | Line 58: |
| === Usage === | == Usage == |
| Line 43: | Line 69: |
| If problems are found, the command returns 1, otherwise 0. | If problems are found, the command returns 1, otherwise 0. |
| Line 47: | Line 73: |
| -f --fixup fix files by replacing tabs and removing trailing whitespace -t --tabsize set the tab length (default: 8 or checkfiles.tab_size) |
-t --tabsize VALUE set the tab length (default: 4) --all consider all tracked files, not just modified use "hg -v help checkfiles" to show global options }}} {{{ hg fixwhitespace [options] replaces tabs with spaces and removes trailing whitespace options: -t --tabsize VALUE set the tab length (default: 4) --all consider all tracked files, not just modified |
| Line 54: | Line 93: |
| CategoryExtension CategoryExtensionsByOthers | CategoryExtensionsByOthers |
CheckFilesExtension
This extension provides two hooks and two commands to detect, report and prevent trailing whitespace and/or unify usage of tabs/spaces. (Default behaviour prefers spaces.)
The hooks must be explicitly enabled in the hgrc/mercurial.ini file.
Contents
1. Status
This extension is not distributed with Mercurial.
Author: MarcusLindblom (Additional help: JesseGlick & VsevolodParfenov)
Repository: https://bitbucket.org/marcusl/ml-hgext
Issue tracker: https://bitbucket.org/marcusl/ml-hgext/issues
If you like it, drop a note here: https://www.ohloh.net/p/ml-hgext
2. Overview
By avoiding commits with tab characters or trailing whitespace on lines, there is less noise in the diffs and the actual code changes are clearer.
The extensions adds a command checkfiles which reports issues in the working directory. Using --fixup will instead fix these files by replacing tabs with spaces and
There is also two hooks:
check_hook - checks and blocks commits with issues, useable in pretxncommit or pretxnchangegroup
fixup_hook - automatically fixes issues in files on commit, useable in pre-commit
3. Configuration
Configure your .hgrc to enable the extension by adding following lines:
[extensions] checkfiles = /path/to/checkfiles.py # enable command [hooks] pretxnchangegroup.checkfiles = python:/path/to/checkfiles.py:check_hook # enables hook to check incoming changeset pretxncommit.checkfiles = python:/path/to/checkfiles.py:check_hook # enables hook to stop bad commits precommit.checkfiles = python:/path/to/checkfiles.py:fixup_hook # enables hook to fix files before creating commit [checkfiles] # default is any text file checked_exts = .c .h .cpp .xml .cs .html .js .css .txt .py .nsi .java .aspx .asp .bat .cmd .glsl # default are these (common autogenerated files) ignored_exts = .sln .suo .vcproj .csproj .ui ignored_files = foo/contains_tabs.txt bar/contains_trailing_ws.txt tab_size = 4 # to examine only modified lines from check_hook (no effect on fixup_hook or command), use: # check_diffs = True # to replace spaces with tabs (instead of the default: tabs -> spaces), set use_spaces = False use_spaces = True
4. Usage
hg checkfiles [options]
checks changed files in the working directory for tabs or trailing whitespace
- --verbose shows the location of offending characters in each line
- --quiet hides filenames and only reports summary information
- --debug shows settings and details about each file considered for checking
If problems are found, the command returns 1, otherwise 0.
options:
-t --tabsize VALUE set the tab length (default: 4)
--all consider all tracked files, not just modified
use "hg -v help checkfiles" to show global optionshg fixwhitespace [options]
replaces tabs with spaces and removes trailing whitespace
options:
-t --tabsize VALUE set the tab length (default: 4)
--all consider all tracked files, not just modified
use "hg -v help checkfiles" to show global options