Cedit

This extension is not distributed with Mercurial.

Author: Paul Lambert

Repository: http://bitbucket.org/paulitex/cedit/

Tested with: Mercurial >= 1.4.3

Overview

Command Line editor for Mercurial configuration files. Features both an interactive editor and an options parsing mode. Simplifies Mercurial configuration so that users never have to manually edit their hgrc / Mercurial.ini files, if they so choose.

Cedit does have a bootstrapping feature - you don't have to manually touch your configuration files to install this extension (unlike almost every other Mercurial extension). Simply run "python start.py" and you should be good to go.

Configuration

If you have just installed mercurial, this will get you going:

hg clone http://bitbucket.org/paulitex/cedit/
cd cedit
python start.py

Now you should be able to run 'hg setuser' to set your username and 'hg cedit' to launch the interactive configuration editor.

NOTE TO WINDOWS USERS: To run the bootstrapping script it is required that you have Python installed and in your path. It is not sufficient to have Mercurial installed. If you have Mercurial installed but not Python, you can still use the extension by manually adding it to your Mercurial.ini file. Using something like

[extensions]
config = /path/to/cedit/directory/

for example, mine is

[extensions]
config = /Users/paulrl/cedit

IMPORTANT: the extension should point to the extension's containing folder, not the .py (config.py) - unlike almost every other extension.

Again this is all only necessary if you don't have Python in your path, otherwise a simple "python start.py" will take care of all of this for you.

Usage

So you've just installed Mercurial, created a new repository, and are all ready to commit your first changes, but 'hg commit -m "Hello World!"' instead gives you something like 'abort: no username supplied (see "hg help config")'. You need to set your username.

You could do this by manually editing your configuration file, but new users may find it easier to use the CeditExtension that provides a 'hg setuser' command to do this. To set your username, navigate to a directory where you can store extensions and grab that extension like so (Make sure you have python installed and in your path. This is not the case by default in Windows):

hg clone http://bitbucket.org/paulitex/cedit/
cd cedit
python start.py
hg setuser

Now you should be able to commit without error.


CategoryExtensionsByOthers

CeditExtension (last edited 2011-04-02 00:22:37 by GregWard)