ejpm

ejpm stands for e^JANA packet ~~manager~~ helper

The goal of ejpm is to provide easy experience of:

installing e^JANA reconstruction framework and supporting packages
uify installation in different environments: various operating systems, docker images, etc.

The secondary goal is to help users with e^JANA plugin development cycle.

The reason

why ejpm is here (and a pain, it tries to resolve) - is that there is no standard convention in our field of how all dependent packages are installed. Some packages (like eigen, xerces, etc.) are usually supported by OS maintainers, while others (Cern ROOT, Geant4) are usually built by users or other packet managers and could be located anywhere.

It should be as easy as:

> ejpm find all            # try to automatically find dependent packets
> ejpm --top-dir=/opt/eic  # set where to install missing packets
> ejpm install all         # build and install missing packets

It also gives a possibility to fine control over dependencies

> ejpm set root /opt/root6_04_16  # manually add cern ROOT location to use
> ejpm rebuild jana && ejpm rebuild ejana  # rebuild packets after it

What ejpm is not:

It is not a real package manager, which automatically solves dependencies
ejpm is not a requirment for e^JANA. It is not a part of e^JANA build system and one can compile and install e^JANA without ejpm

A database stores the current state of installation and location of stored packets.
Package installation contexts holds information of configuration and steps needed to install a package
CLI (command line interface)- provides users with commands to manipulate packets

Users are pretty much encouraged to change the code and everything is done here to be user-change-friendly

Installation

Regular:

pip install ejpm

Regular + JLab certs problems:

There could be problems on JLab machines (details are in the end):

python -m pip install --trusted-host pypi.python.org --trusted-host files.pythonhosted.org --trusted-host pypi.org --install ejpm

Manual:

TL;DR; Get EJPM, install requirements, ready:

git clone https://gitlab.com/eic/ejpm.git
pip install -r ejpm/requirements.txt
python ejpm/run_ejpm.py

'ejpm' command:

Calling python <path to ejpm>/run_ejpm.py is inconvenient! It is easy to add alias to your .bashrc (or whatever)

alias ejpm='python <path to ejpm>/run_ejpm.py'

So if you just cloned it copy/paste:

echo "alias='python `pwd`/ejpm/run_ejpm.py'" >> ~/.bashrc

requirments:

Click and appdirs are the only requirements. If you have pip do:

pip install Click appdirs

If for some reason you don't have pip, you don't know python well enough and don't want to mess with it, pips, shmips and doh... Just download and add to PYTHONPATH: this 'click' folder and some folder with appdirs.py

Environment

EJPM_DATA_PATH - sets the path where the configuration db.json and env.sh, env.csh are located

JLab certificate problems

If you get errors like:

Retrying (...) after connection broken by 'SSLError(SSLError(1, u'[SSL: CERTIFICATE_VERIFY_FAILED]...

The problem is that pip is trustworthy enough to use secure connection to get packages. And JLab is helpful enough to put its root level certificates in the middle.

The easiest solution is to continue use pip declaring PiPy sites as trusted:

python -m pip install --trusted-host pypi.python.org --trusted-host files.pythonhosted.org --trusted-host pypi.org --install ejpm

Or to permanently add those sites as trusted in pip.config
```
[global]
trusted-host=
    pypi.python.org
    pypi.org
    files.pythonhosted.org
```
(The link where to find pip.config on your system)
You may want to be a hero and kill the dragon. The quest is to take JLab certs. Then Convert them to pem. Then add certs to pip. Then check it really works on JLab machines. And bring the dragon's head back (i.e. please, add the exact instruction to this file)

Release files for ejpm 0.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ejpm 0.0.1
File	Size	Uploaded
ejpm-0.0.1.tar.gz	21.3 kB	Mar 8, 2019	Details

Built distribution (wheel)

Table of built distributions (wheels) for ejpm 0.0.1
File	Interpreter	ABI	Platform	Reset
ejpm-0.0.1-py2-none-any.whl 33.0 kB Mar 8, 2019	Python 2	none	any	Details

Total release size: 54.3 kB

Release files / ejpm-0.0.1.tar.gz

Download URL	ejpm-0.0.1.tar.gz
Size	21.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`48c3d409c490cb60631137841e0ef846dfc3fc5f6deb2bfee4bbd35cb958d9cd`
BLAKE2b-256 checksum How to use checksums	`15537d7282acb098d264da1fd2a29bce1f2eb17b299324f3aa22586f69277bd5`
Upload date	Mar 8, 2019
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/2.7.5`

Release files / ejpm-0.0.1-py2-none-any.whl

Download URL	ejpm-0.0.1-py2-none-any.whl
Size	33.0 kB
Tags	Python 2
SHA-256 checksum How to use checksums	`604e97f0e6146cb2d8abdb9513baf95a841551b42dd8ee4ce3070bb667c67abc`
BLAKE2b-256 checksum How to use checksums	`179b0929eac8799e661dfde4438aac443ab1cb09c77fbf427ac1284041a06023`
Upload date	Mar 8, 2019
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/2.7.5`