65
edits
Changes
From Gramps
Gramps 6.0, a maintenance branch and Python virtual environment
* [[Brief_introduction_to_Git#Obtaining_a_copy_of_the_Gramps_repository|Clone the Gramps repository]]
== Gramps 6.0, a maintenance branch and Python virtual environment ==
{{man note|Note|The steps in this section have been tested with fresh Debian 13}}
Suppose that you'd like to install Gramps to fix some bug in the current release. According to [[Committing policies]] you must do the changes in the most recent maintenance branch. You clone Gramps source code repository and switch to the maintenance branch as described [[Brief_introduction_to_Git |here]] into <code>~/Gramps</code>. Then you install the software as follows:
1. Install Debian packages:
sudo apt install python3-venv pkg-config libgtk-3-dev python3-dev libgirepository-2.0-dev gettext gir1.2-gexiv2
2. Create Python virtual environment:
python3 -m venv ~/.venvs/gramps
source ~/.venvs/gramps/bin/activate
python3 -m pip install pip --upgrade
3. Install Python packages into the created virtual environment :
python3 -m pip install setuptools # required to invoke the custom 'build' command - see below
python3 -m pip install pycairo pygobject pyicu # optional but recommended packages
4. Install Gramps in the [[https://setuptools.pypa.io/en/latest/userguide/development_mode.html| Development mode]] into the created virtual environment:
cd ~/Gramps
python3 setup.py build # a workaround to invoke the custom 'build' command in setup.py
python3 -m pip install -e .
Now everything is ready to run Gramps from source. Open new terminal window and enter the following commands:
source ~/.venvs/gramps/bin/activate
python3 -m gramps
Changes made in the Python source code will immediately take place without requiring a new installation.
== Gramps 4.0 and the master branch ==
