Clone the repo of this training

Clone the repo of this training#

The repository of this training uses Mercurial. This choice is discussed in details in a dedicated page on our mail website.

Here, we just present what is necessary to clone the repository of this training and potentially update the code.

Install Mercurial#

For this project, we use modern Mercurial using the topic and evolve extensions. General Mercurial installation instructions are given here https://www.mercurial-scm.org/install, however, except if you really know what you do, I suggest that you just follow the following instructions. Since Mercurial is a Python application, recent versions can be installed with UV or Pipx. However, for Windows it is still better to just download and install TortoiseHG, so for Windows skip the first step.

  • Install Mercurial and its extensions (Unix)

    uv tool install mercurial --with hg-git --with hg-evolve

    pipx install mercurial
pipx inject mercurial hg-git hg-evolve

  • Check that hg corresponds to the Mercurial installed with UV or Pipx

    hg debuginstall
    Not using the right hg?

    Importantly, the directory where UV/Pipx puts the executables has to be before other directories where older Mercurial can be present so that hg really corresponds to the Mercurial install with UV/Pipx. You can check the environment variable $PATH.

  • Setup Mercurial (config file ~/.hgrc and completion) (Unix and Windows)

    uvx hg-setup init
# complete information, save the config file and quit hg-setup

    pipx run hg-setup init
# complete information, save the config file and quit hg-setup

  • Check that everything is fine. Are evolve and topic indeed enabled?

    hg version -v

Clone the repository#

Finally, you should be able to clone the repository with

hg clone https://foss.heptapod.net/py-edu-fr/py-edu-fr

Update the code#

To pull all new commits locally, first run

hg pull

To update the code (you might need to add the option -C, corresponding to --clean):

hg up default

You can also see if there are new topics in the repo and update to a specific topic with:

hg lg
hg up <topic name>
Contents