dzgui/docs/source/venv.rst
2026-02-07 20:05:52 +09:00

44 lines
1.4 KiB
ReStructuredText

After satisfying the dependencies above, create a virtual environment (venv) and install PyGObject:
If you have ``uv`` as your Python version manager, invoke the following:
.. code:: console
uv venv --python 3.13 $HOME/.virtualenvs/dzgui
source $HOME/.virtualenvs/dzgui/bin/activate
uv pip install PyGObject
If you installed the ``python3.13`` package directly instead of ``uv``, use the below:
.. code:: console
python3.13 -m venv $HOME/.virtualenvs/dzgui
source $HOME/.virtualenvs/dzgui/bin/activate
pip install PyGObject
You can now proceed to the :ref:`Installscript`.
After installation, refer to the additional remarks below.
.. important::
Since PyGObject is localized to a venv, it is advisable to create a wrapper script to ensure
the venv is activated on subsequent invocations of DZGUI.
.. code:: console
#!/usr/bin/env bash
source $HOME/.virtualenvs/dzgui/bin/activate
<insert your path to dzgui.sh>
Make sure to update the placeholder path on the last line. For example, if you ran the
installscript from your home directory, the wrapper script would look like:
.. code:: console
#!/usr/bin/env bash
source $HOME/.virtualenvs/dzgui/bin/activate
$HOME/dzgui.sh
Save this wrapper script in a location of your choice, e.g., ``mywrapper.sh`` and set the
executable bit: ``chmod +x mywrapper.sh`` This script will be your entrypoint for
future invocations of DZGUI, so you should launch it, not ``dzgui.sh``