|
Size: 2481
Comment: Added ohloh.net link
|
Size: 3129
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 4: | Line 4: |
| This extension provides two hooks and a command to prevent committing tabs and trailing whitespaces. | This extension provides two hooks and two commands to detect, report, prevent and remove tabs and trailing whitespaces. |
| Line 13: | Line 14: |
| ''Author: MarcusLindblom '' | ''Author: MarcusLindblom '' (Additional help: JesseGlick & VsevolodParfenov) |
| Line 17: | Line 18: |
| * If you like it, drop a note here: https://www.ohloh.net/p/ml-hgext | |
| Line 28: | Line 30: |
| If you like it, drop a note here: https://www.ohloh.net/p/ml-hgext |
|
| Line 35: | Line 35: |
| checkfiles = /path/to/checkfiles.py | checkfiles = /path/to/checkfiles.py # enable command |
| Line 38: | Line 38: |
| pretxnchangegroup.checkfiles = python:/path/to/checkfiles.py:check_hook pretxncommit.checkfiles = python:/path/to/checkfiles.py:check_hook pre-commit.checkfiles = python:/path/to/checkfiles.py:fixup_hook |
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 43: | Line 43: |
| # default is any text file | |
| Line 44: | Line 45: |
| # default are these (common autogenerated files) ignored_exts = .sln .suo .vcproj .csproj .ui |
|
| Line 46: | Line 49: |
| # to examine only modified lines from check_hook (no effect on fixup_hook or command), use: # check_diffs = True |
|
| Line 48: | Line 53: |
| === Usage === | == Usage == |
| Line 60: | Line 65: |
| If --fixup is given, the return value is always 0 (unless an error occurs). | |
| Line 64: | Line 68: |
| -f --fixup fix files by replacing tabs and removing trailing whitespace | |
| Line 66: | Line 69: |
| --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 |
CheckFilesExtension
This extension provides two hooks and two commands to detect, report, prevent and remove tabs and trailing whitespaces.
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)
Download site: https://bitbucket.org/marcusl/ml-hgext/src/tip/checkfiles.py
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
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