Install Caproto

You can install caproto using pip or from source.

First verify that you have Python 3.6+.

python3 --version

If necessary, install it by your method of choice (apt, Homebrew, conda, etc.).

Installation Using Pip

python3 -m pip install -U "caproto[complete]"

Minimal Installation Using Pip

The complete installation includes several optional dependences. For an extremely lightweight installation, install caproto alone:

python3 -m pip install -U caproto

Caproto’s command-line, synchronous, and threading clients will work in this mode, as will its asyncio server, because these rely only on built-in Python modules. Caproto’s trio and curio servers will not work unless trio and curio are installed.

If numpy is not installed, caproto falls back on Python’s built-in array module. This choice can be manually controlled via caproto.select_backend('numpy') and caproto.select_backend('array').

Other, intermediate combinations are also conveniently available:

python3 -m pip install -U "caproto[standard]"  # includes numpy, netifaces
python3 -m pip install -U "caproto[async]"  # includes the async libs

Development Installation

git clone https://github.com/NSLS-II/caproto
cd caproto
pip install -e .

To install all the optional dependencies as well, use:

pip install -e .[complete]

Development

For development, you will also want the dependencies for running the tests and building the documentation:

pip install -Ur test-requirements.txt
pip install -Ur docs-requirements.txt

To run the tests:

python run_tests.py

Any argument will be passed through to pytest. These are arguments are commonly useful:

  • -v verbose
  • -s Do not capture stdout/err per test.
  • -k EXPRESSION Filter tests by pattern-matching test name.

Many of the tests test caproto against EPICS’ reference implementation. They expect caget, caput, and softIoc executables to be available and for EPICS_BASE to be set.

A small number of the tests test caproto against motorsim. To skip these tests, set the environment variable CAPROTO_SKIP_MOTORSIM_TESTS=1.

To build the documentation:

make -C doc html