Diff for "ColorExtension"

Differences between revisions 8 and 12 (spanning 4 versions)

Color Extension

This extension is distributed with Mercurial (source)

Author: Kevin Christen

Overview

This extension modifies the status command to add color to its output to reflect file status, the qseries command to add color to reflect patch status (applied, unapplied, missing), and to diff-related commands to highlight additions, removals, diff headers, and trailing whitespace.

Other effects in addition to color, like bold and underlined text, are also available. Effects are rendered with the ECMA-48 SGR control function (aka ANSI escape codes). This module also provides the render_text function, which can be used to add effects to any text.

Configuration

Configure your .hgrc to enable the extension by adding the following lines:

[extensions]
color =

The color extension supports both ANSI consoles and Windows consoles. It will use Windows console mode automatically on Windows platforms unless it finds TERM defined in the environment, in which case it assumes you are using an ANSI shell on Windows. If this auto-detection fails, you can explicitly set the mode by:

[color]
# valid modes are win32, ansi, auto, off
mode = win32

Default effects may be overriden from the .hgrc file:

[color]
status.modified = blue bold underline red_background
status.added = green bold
status.removed = red bold blue_background
status.deleted = cyan bold underline
status.unknown = magenta bold underline
status.ignored = black bold

'none' turns off all effects:

status.clean = none
status.copied = none

qseries can be customized in a similar way:

qseries.applied = blue bold underline
qseries.unapplied = black bold
qseries.missing = red bold

as can diff, and any commands that output diffs:

diff.diffline = bold
diff.extended = cyan bold
diff.file_a = red bold
diff.file_b = green bold
diff.hunk = magenta
diff.deleted = red
diff.inserted = green
diff.changed = white
diff.trailingwhitespace = bold red_background

Discussion

The default colors are a bit painful to read for me, so I modified them to the following:

[color]
status.modified = magenta bold
status.added = green bold
status.removed = red bold
status.deleted = cyan bold
status.unknown = blue bold
status.ignored = black bold

Mainly I removed the color backgrounds and made the info which is most important for me stand out the most:

modified
deleted
removed

I normally have temporary files in my dirs, so "unknown" shouldn't stand out for me (as it does in magenta), I don't know if that applies to most people.

Besides: "black bold" is in grey for me (which is good).

CategoryBundledExtension

-  ⇤ ← Revision 8 as of 2010-08-28 15:06:31 → 
  Size: 2383
  Editor: abuehl
  Comment:
+   ← Revision 12 as of 2017-01-02 08:36:50 → ⇥
  Size: 2839
  Editor: techtonik
  Comment: add link to sources
-Deletions are marked like this.
+Additions are marked like this.
 Line 1:
-== Color Extension ==
+Color Extension
 Line 3:
-'''This extension is distributed with Mercurial.'''
+'''This extension is distributed with Mercurial''' ([[https://www.mercurial-scm.org/repo/hg/file/tip/hgext/color.py|source]])
 Line 8:
-This extension modifies the status command to add color to its output to
reflect file status, the qseries command to add color to reflect patch status
(applied, unapplied, missing), and to diff-related commands to highlight
additions, removals, diff headers, and trailing whitespace.
+This extension modifies the status command to add color to its output to reflect file status, the qseries command to add color to reflect patch status (applied, unapplied, missing), and to diff-related commands to highlight additions, removals, diff headers, and trailing whitespace.
-Line 13:
+Line 10:
-Other effects in addition to color, like bold and underlined text, are also
available.  Effects are rendered with the ECMA-48 SGR control function (aka
ANSI escape codes).  This module also provides the render_text function,
which can be used to add effects to any text.
+Other effects in addition to color, like bold and underlined text, are also available.  Effects are rendered with the ECMA-48 SGR control function (aka ANSI escape codes).  This module also provides the render_text function, which can be used to add effects to any text.
-Line 25:
+Line 19:
+The color extension supports both ANSI consoles and Windows consoles.  It will use Windows console mode automatically on Windows platforms unless it finds TERM defined in the environment, in which case it assumes you are using an ANSI shell on Windows.  If this auto-detection fails, you can explicitly set the mode by:
-Line 26:
+Line 21:
-Default effects my be overriden from the .hgrc file:
+{{{
[color]
# valid modes are win32, ansi, auto, off
mode = win32
}}}
Default effects may be overriden from the .hgrc file:
-Line 36:
+Line 37:
+'none' turns off all effects:
-Line 37:
+Line 39:
-'none' turns off all effects:
-Line 42:
+Line 43:
+qseries can be customized in a similar way:
-Line 43:
+Line 45:
-qseries can be customized in a similar way:
-Line 49:
+Line 50:
+as can diff, and any commands that output diffs:
-Line 50:
+Line 52:
-as can diff, and any commands that output diffs:
 Line 63:
+=== Discussion ===
The default colors are a bit painful to read for me, so I modified them to the following:
-Line 64:
+Line 66:
-=== Discussion ===
The default colors are a bit painful to read for me, so I modified them to the following:
 Line 75:
 Mainly I removed the color backgrounds and made the info which is most important for me stand out the most:
-Line 79:
+Line 78:
-. deleted
 3. removed
+. deleted
 1. removed
-Line 82:
+Line 81:
 I normally have temporary files in my dirs, so "unknown" shouldn't stand out for me (as it does in magenta), I don't know if that applies to most people.
-Line 85:
+Line 84: