Two package management systems are currently supported: pip
and conda
.
All the packages, including the documentation package, are available in the Fichiers area of the valjean Tuleap page.
A source distribution can be created with the command:
$ poetry build
This will produce a :samp:`valjean-{x.y.z}.tar.gz` source archive and a :samp:`valjean-{x.y.z}-py3-none-any.whl` in the :file:`dist` folder. These files are suitable for the distribution of :mod:`valjean` to users and for installing it.
The source distribution may be installed with:
$ pip install /path/to/valjean-{x.y.z}.tar.gz
You can also install the wheel:
$ pip install /path/to/valjean-{x.y.z}-py3-none-any.whl
Both commands should work.
Note
If the archives are built from an untagged commit, the archive name will contain the hash of the commit, like :samp:`valjean-{x.y}.dev{z}+g{hash}.tar.gz`.
It is possible to create a conda package of :mod:`valjean` following these steps:
Setup your conda workspace (
source MY/CONDA/PATH/bin/activate
)Create the
conda
package:$ cd /path/to/valjean $ conda build conda.recipe --python=PY_VERSION
The conda package should appear in the conda installation at the path: :samp:`MY/CONDA/PATH/conda-bld/linux-64/valjean-v{VERSION}-{NUMBER}_{HASH}_py{PY_VERSION}.tar.bz2` with:
VERSION
: last tag from valjean in the branch used to build the archiveNUMBER
: number of commits since this tagHASH
: short hash of the commit usedPY_VERSION
: Python version.
The option --python
is needed in the command to get the correct python
version in the archive name (else it uses the default version of conda).
If the build corresponds to the tag and the hash seems useless, it is possible to modify or comment the string. Without the string the default name would be :samp:`valjean-v{VERSION}-py{PY_VERSION}_{NUMBER}.tar.bz2`.
To install the conda package:
Setup your favorite conda workspace
Install the package:
$ conda install -c file://PATH/TO/valjean-DETAILS.tar.bz2 --use-local valjean
with :samp:`DETAILS=v{VERSION}-{NUMBER}_{HASH}_py{PY_VERSION}`.
Offline installation can be done adding the --offline
option.
Follow the documentation build steps in :ref:`building-documentation-dvpers`, then archive the html folder:
$ cd doc/build
$ tar czf valjean-doc-XXX.tar.gz --transform 's,^,valjean-doc-XXX/,' html
To install the documentation:
$ tar xzf valjean-doc-XXX.tar.gz