hg-easy

A collection of tools to make Mercurial (even more) user friendly


Keywords
Mercurial
License
BSD-3-Clause
Install
pip install hg-easy==0.9.4

Documentation

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<title>Mercurial-easy</title>
<style><!-- 
body {
	margin-left: 10%;
	margin-right: 10%;
	padding: 20pt;
	padding-top: 10pt;
	background: rgb(255,255,255);
	font:  10.5pt/15pt "Helvetica",Helvetica,sans-serif;
	color: rgb(80,80,80);
}

h1, h2, h3, h4 {
	font-family: "Trebuchet MS",Helvetica,sans-serif;
	color: rgb(22, 130, 178);
	font-weight: normal;
	padding-top: 0.5em;
	cursor: pointer;
}

hr {
	color: rgb(150, 220, 238);
	background: rgb(150, 220, 238);
	height: 1px;
	border: 0;
}


b {
	color: rgb(22,130,178);
}

strong {
	color: rgb(103,183,0);
}


a:link, a:active, a:visited {
	color: rgb(22,130,178);
	text-decoration: none;
}

a:hover {
	text-decoration: none;
	background-color: #dbecf4;
}

aimg {
	border: 0;
}

#header, #footer {
	font-size: 7pt;
	clear: both;
	width: 100%;
	color: rgb(177,208,223);
}

.kiwiContent {
	text-align: left;
}


#footer {
	padding-top:  30pt;
	text-align: right;
}

/*  Kiwi-specific  */

.title {
	margin-bottom: 0;
}

.kiwiMeta {
	max-width: 700px;
	padding: 5pt;
	margin-bottom:  2em;
	border-top:  1px solid rgb(150, 220, 238);
	background-color: rgb(250,250,250);
}

.kiwiMeta tr td {
	color: rgb(22, 130, 178);
}

.kiwiMeta tr td.name {
	font-weight: bold;
}

.kiwiContent {
	max-width: 700px;
}

.kiwiContent .heading .number {
	padding-right: 8pt;
}

.kiwiContent .heading .number .lastDot {
	display: none;
}


.kiwiContent .heading .number .level0 .lastDot {
	display: inline;
}

.kiwiContent h1 {
	font-size: 1.8em;
	font-weight: bold;
	margin-top: 1.5em;
	padding-bottom: 0.5em;
	border-bottom:  1px dotted rgb(150, 220, 238);
}

.kiwiContent h2 {
	font-size: 1.4em;
	font-weight: bold;
	padding-bottom: 0.5em;
	border-bottom:  1px dotted rgb(150, 220, 238);
}

.kiwiContent h3 {
	font-size: 1.2em;
	font-weight: normal;
}

.kiwiContent pre {
	padding: 5pt;
	border:  1px solid rgb(150, 220, 238);
	padding-left: 20pt;
	background-color: rgb(240,240,250);
	font-size: 8pt;
	color: rgb(22,130,178);
}

.kiwiContent code {
	font-size: 8pt;
	background-color: rgb(240,240,250);
}

.kiwiContent dt {
	color: rgb(22,130,178);
	font-weight: bold;
}

.kiwiContent dd {
	border-left:  1px solid rgb(150, 220, 238);
	padding-left: 20pt;
	margin-bottom: 2em;
}

.kiwiContent dd pre {
}

.kiwiContent ul {
	padding-top: 0em;
	margin-top: 0em;
}

.kiwiContent ul li {
	padding-bottom: 0.2em;
}

.kiwiContent ul li.todo {
	list-style-type: square;
}

.kiwiContent ul li.todo.done {
	text-decoration: line-through;
}

.kiwiContent table {
	border:  1px solid rgb(150, 220, 238);
	padding: 0pt;
}

.kiwiContent table caption {
	font-family: serif;
	padding-top: 1em;
	padding-bottom: 0.5em;
	font-style: italic;
	font-size: 90%;
	color: rgb(22, 130, 178);
}

.kiwiContent table tbody {
}

.kiwiContent table tr {
	margin: 0;
}

.kiwiContent table tr td {
	margin: 0;
	padding: 5pt;
	font-size: 90%;
	min-width: 125px;
	background-color: rgb(250,250,250);
	border-bottom: 1px solid rgb(150, 220, 238);
}

.kiwiContent table tr td.lastRow {
	border-bottom: none;
}

.kiwiContent table tr td.lastCol {
	border-right: none;
}

.kiwiContent table tr.even td {
	background-color: #FEFEFE;

}

.kiwiContent table tr.odd td {
	background-color: rgb(240,240,240);
}

.kiwiContent .term {
	color: rgb(22, 130, 178);
	background: rgb(240, 250, 256);
}

.kiwiContent .quote {
	font-style: italic;
	color: rgb(120, 120, 120);
}

.kiwiContent .citation {
	font-style: italic;
	color: rgb(120, 120, 120);
}

.kiwiContent div[class^="ann"] {
	margin-top: 5pt;
	margin-bottom: 5pt;
	padding: 5pt;
	padding-left: 20pt;
	color: rgb(100, 100, 100);
}

.kiwiContent div[class^="ann"] .title {
	font-weight: bold;
}

.kiwiContent .annNote {
	border:  1px solid rgb(103,183,0);
	margin-top: 5pt;
	margin-bottom: 5pt;
	padding: 5pt;
	padding-left: 20pt;
	background: #fffbe4;
	color: rgb(100, 100, 100);
	border:  1px solid #dedac3;
}

.kiwiContent .annNote .title {
	font-weight: bold;
	display: none;
}

.kiwiReferences {
	font:  8pt/12pt "Lucida Grande",Lucida,sans-serif;
	margin-top: 10pt;
	padding: 5pt;
	border-top:  1px solid rgb(200, 200, 200);
	background-color: rgb(250,250,250);
	color: rgb(200, 200, 200);
	font-size: 8pt;
}
.kiwiReferences a:link, .kiwiReferences a:active, .kiwiReferences a:visited {
	color: rgb(150,150,150);
}

.kiwiReferences .entry {
	padding-top: 5pt;
	clear: both;
}

.kiwiReferences .entry .name {
	float: left;
	font-weight: bold;
	padding-right: 5pt;
}

.kiwiReferences .entry .content {
	text-align: right;
}

 --></style>
</head>
<body>
<div
	class="title"><h1>Mercurial-easy</h1><h2>Ui Love For Hg</h2></div>
<div class="kiwiContent"><div class='content'><div class="section" level="1"><h1 class="heading"><span class="number"><span class="level0">1<span class="lastDot dot">.</span></span></span>What is it ?</h1><div class="level1"><p>Even though it's documented <a href="http://www.selenic.com/mercurial/wiki/index.cgi/EasycommitExtension" class="external">here</a> and <a href="http://www.selenic.com/mercurial/wiki/index.cgi/EasymergeExtension" class="external">here</a> the <span class='term'>Mercurial-Easy</span> project aims at providing a set of cool tools to make your life easier.</p><p>Mercurial Easy provides <em>command-line GUIs</em> for commiting and merging (operations you surely do daily), which provide both instant feedback, useful information and easy of use.</p><p>Also, you can enjoy the fact that these tools are written in Python too and are released under the BSD license.</p><p>We've been enjoying Mercurial-Easy since 2006 !</p></div></div><div class="section" level="1"><h1 class="heading"><span class="number"><span class="level0">2<span class="lastDot dot">.</span></span></span>How does it look like ?</h1><div class="level1"><p>See it for yourself !</p><p><img src='http://www.ivy.fr/mercurial/easy/commit.png'/></p><p><img src='http://www.ivy.fr/mercurial/easy/merge.png'/></p></div></div><div class="section" level="1"><h1 class="heading"><span class="number"><span class="level0">3<span class="lastDot dot">.</span></span></span>How to install ?</h1><div class="level1"><p>First you should get the <a href="http://www.ivy.fr/mercurial/easy/mercurial-easy-latest.tar.gz" class="external">latest tarball</a> if you don't alrady have it. Of course you need <a href="http://www.python.org" class="external">Python</a> and <a href="http://www.selenic.com/mercurial" class="external">Mercurial</a> too (but we don't support 0.9.5 yet).</p><p>Then, you can unpack your tarball, cd into it, and start doing this:</p><pre> python setup.py install</pre><p>or</p><pre> python setup.py intall --prefix=~/where/you/want</pre><p>You will then have the following modules installed:</p><ul><li><code>easyhg</code> the Mercurial-Easy project </li><li><code>urwid</code> a library required by Mercurial-Easy </li><li><code>urwide</code> another library also required by Mercurial-Easy </li><li><code>easymerge.py</code> which is a script that you should use when mergeing</li></ul><p>To know where Mercurial-Easy is installed, simply do:</p><pre>python -c 'import os,easyhg;print os.path.dirname(os.path.abspath(easyhg.__file__))'</pre><p>For me it will tell you that it is installed here:</p><pre>/Users/sebastien/Local/lib/python2.5/site-packages/easyhg</pre><p>You can now edit your <code>~/.hgrc</code> file:</p><pre>[ui]
mergetool = ~/Projects/Mercurial-Easy/Sources/easyhg/easymerge.py

[extensions]
# Mercurial-Easy tools
commit    = ~/Projects/Mercurial-Easy/Sources/easyhg/easycommit.py
changes   = ~/Projects/Mercurial-Easy/Sources/easyhg/easychanges.py
project   = ~/Projects/Mercurial-Easy/Sources/easyhg/easyproject.py</pre><p>And you can disable any of these, of course !</p></div></div></div></div>

</body>
</html>