Skip to main content

Flexible evolution of Mercurial history.

Project description

Evolve Extension

This package supplies the evolve extension for Mercurial,

The full implementation of the changeset evolution concept is still in progress. Please subscribe to the evolve-testers mailing list to stay up to date with changes.

This extension:

  • enables the “changeset evolution” feature of Mercurial core,

  • provides a set of commands to mutate your history,

  • issues several warning messages when troubles from some mutable appears in your repository,

  • provides an hg evolve command to deal with such “troubles”,

  • improves performance of obsolescence marker exchanges and discovery during push and pull.

Documentation

We recommend reading the documentation first. An online version is available here:

https://www.mercurial-scm.org/doc/evolution/

How to Install

Using Pip

You can install the latest evolution version usin pip:

$ pip install --user hg-evolve

Then just enable it in you hgrc:

$ hg config --edit # adds the two line below:
[extensions]
evolve =

From Source

To install a local version from source:

$ hg clone https://www.mercurial-scm.org/repo/evolve/
$ cd evolve
$ pip install --user .

Then just enable it in you hgrc:

$ hg config --edit # adds the two line below:
[extensions]
evolve =

Documentation lives in doc/.

Server Only Setup

It is possible to enable a smaller subset of the extensions aimed at server serving repository. It skips the additions of the new commands and local UI messages that might add performance overheads. To use the server only extension, install the package and use:

$ hg config --edit # adds the two line below:
[extensions]
evolve.serveronly =

How to Contribute

Discussion happens on the #hg-evolve IRC on freenode.

Bugs are to be reported on the mercurial’s bug tracker (component: evolution):

You can use the patchbomb extension to send email to mercurial devel. Please make sure to use the evolve-ext flag when doing so. You can use a command like this:

$ hg email --to mercurial-devel@mercurial-scm.org --flag evolve-ext --rev '<your patches>'

Some of development happens on a public bitbucket repository (evolve-devel) using the topic extension.

For guidelines on the patch description, see the official Mercurial guideline.

Please don’t forget to update and run the tests when you fix a bug or add a feature. To run the tests, you need a working copy of Mercurial, say in $HGSRC:

$ cd tests
$ python $HGSRC/tests/run-tests.py

Branch policy

The evolve test are highly impacted by changes in core. To deal with this, we use named branches.

There are two main branches: “stable” and “default”. Tests on these branch are supposed to pass with the corresponding “default” and “stable” branch from core Mercurial. The documentation is built from the tip of stable.

In addition, we have compatibility branches to check tests on older version of Mercurial. They are the “mercurial-x.y” branches. They are used to apply expected test change only, no code change should happen there.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hg-evolve-8.1.2.tar.gz (716.7 kB view details)

Uploaded Source

File details

Details for the file hg-evolve-8.1.2.tar.gz.

File metadata

  • Download URL: hg-evolve-8.1.2.tar.gz
  • Upload date:
  • Size: 716.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.18.4 setuptools/39.2.0 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/3.6.6

File hashes

Hashes for hg-evolve-8.1.2.tar.gz
Algorithm Hash digest
SHA256 ccc23c7b9f5a5e459be172f3c69b074a2910323234a86ab5ebfb212cd874e60a
MD5 8458eeac248d2c6f0f433ad718be6e5e
BLAKE2b-256 41d00277aeef6b43c5d424bcf8350a023ca5fa1bcbf4483fea0c7f3922af5eab

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page