Metadata-Version: 2.1
Name: sdss-flicamera
Version: 0.1.2
Summary: A library to control Finger Lakes Instrumentation cameras.
Home-page: https://github.com/sdss/flicamera
License: BSD-3-Clause
Keywords: astronomy,software
Author: José Sánchez-Gallego
Author-email: gallegoj@uw.edu
Requires-Python: >=3.7,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Documentation :: Sphinx
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Provides-Extra: docs
Requires-Dist: Sphinx (>=3.2.0,<3.3.0); extra == "docs"
Requires-Dist: click_default_group (>=1.2.2,<2.0.0)
Requires-Dist: daemonocle (>=1.0.2,<2.0.0)
Requires-Dist: m2r2 (>=0.2.5,<0.3.0); extra == "docs"
Requires-Dist: nest_asyncio (>=1.4.0,<2.0.0)
Requires-Dist: numpy (>=1.17.4,<2.0.0)
Requires-Dist: sdss-basecam (>=0.3.0,<0.4.0)
Requires-Dist: sdsstools (>=0.4.0)
Requires-Dist: sphinx-click (>=2.3.0,<3.0.0); extra == "docs"
Requires-Dist: sphinx-copybutton (>=0.3.1,<0.4.0); extra == "docs"
Project-URL: Documentation, https://sdss-flicamera.readthedocs.io/en/latest/
Project-URL: Repository, https://github.com/sdss/flicamera
Description-Content-Type: text/markdown

# flicamera

![Versions](https://img.shields.io/badge/python->3.7-blue)
[![Documentation Status](https://readthedocs.org/projects/sdss-flicamera/badge/?version=latest)](https://sdss-flicamera.readthedocs.io/en/latest/?badge=latest)
[![Tests Status](https://github.com/sdss/flicamera/workflows/Test/badge.svg)](https://github.com/sdss/flicamera/actions)
[![Build Status](https://github.com/sdss/flicamera/workflows/Build/badge.svg)](https://github.com/sdss/flicamera/actions)
[![codecov](https://codecov.io/gh/sdss/flicamera/branch/master/graph/badge.svg)](https://codecov.io/gh/sdss/flicamera)

A library to control Finger Lakes Instrumentation cameras. It provides the SDSS `gfaCamera` and `fvcCamera` actors to control the Guide, Focus and Acquisition cameras and Field View Camera, respectively.

## Installation

In general you should be able to install ``flicamera`` by doing

```console
pip install sdss-flicamera
```

Although `flicamera` should handle all the compilation of the FLI libraries, you may still need to modify your system to give your user access to the FLI USB devices. See [here](https://github.com/sdss/flicamera/blob/master/cextern/README.md) for more details.

To build from source, use

```console
git clone git@github.com:sdss/flicamera
cd flicamera
pip install .[docs]
```

## Development

`flicamera` uses [poetry](http://poetry.eustace.io/) for dependency management and packaging. To work with an editable install it's recommended that you setup `poetry` and install `flicamera` in a virtual environment by doing

```console
poetry install
```

Pip does not support editable installs with PEP-517 yet. That means that running `pip install -e .` will fail because `poetry` doesn't use a `setup.py` file. As a workaround, you can use the `create_setup.py` file to generate a temporary `setup.py` file. To install `flicamera` in editable mode without `poetry`, do

```console
pip install --pre poetry
python create_setup.py
pip install -e .
```

