Metadata-Version: 2.1
Name: siriushlacon
Version: 1.5.7
Summary: Client Applications for Sirius developed in PyDM by CONS
Home-page: https://github.com/lnls-sirius/pydm-opi/
Author: lnls-sirius
License: GNU GPLv3
Download-URL: https://github.com/lnls-sirius/pydm-opi
Description: CONS OPIs
        ===========
        
        This repo should contain every PyDM OPI developed by the CONS group currently in use.
        
        [Read the docs !](https://lnls-sirius.github.io/pydm-opi/)
        ----------------------------------------------------------
        
        Requirements
        ------------
        **Python>=3.6** .<br>
        [PyDM](https://github.com/slaclab/pydm)==**1.10.1**<br>
        [CONS commons](https://github.com/lnls-sirius/cons-common) module.<br>
        Other dependencies are listed at `requirements.txt`.<br>
        
        Install
        -------
        This repository depends on [PyDM](https://github.com/slaclab/pydm),
        [PyEPICS](https://github.com/pyepics/pyepics), [CONS Common](https://github.com/lnls-sirius/cons-common) and Python>=3.6 .
        
        Clone from master or download the latest release.<br>
        Optionally the user may clone recursive in order to pull the module `conscommon`. If so, install the submodule using `cd cons-common && pip install .`.<br>
        
        ### EPICS Base
        Install EPICS and add it to PATH(Windows only)
        ```
        https://epics.anl.gov/download/distributions/EPICSWindowsTools1.44-x64.msi
        ```
        For linux users the recommended way is to compile the latest LTS release of the [EPICS Base (R3.15.8)](https://github.com/epics-base/epics-base/tree/3.15).
        After the compilation is completed, the `bin` folder must be added to the environment `PATH` and the `lib` folder to `LD_LIBRARY_PATH`.
        
        ### Sirius Environment
        To install in a machine managed by [lnls-sirius/lnls-ansible](https://github.com/lnls-sirius/lnls-ansible) clone the repo recursively and make install as sudo.
        ```bash
        cd ~/ && git clone --recursive https://github.com/lnls-sirius/pydm-opi && cd pydm-opi && sudo make install
        ```
        
        ### Using [Conda](https://docs.conda.io/en/latest/miniconda.html)
        This is the recommended way to install ! If you're a Windows user, using `git bash` may simplify the steps as the syntax will be similar.
        
        Create and activate the conda environment:
        ```bash
        conda init <shell name> # Restart shell after ... (bash, powershell, etc...)
        conda create --name pydm python=3.7 # pyqtgraph==0.1.0 does not work with python 3.8
        conda activate pydm
        ```
        
        Install dependencies and OPIs (Will use ~/ as the default path but feel free to change):
        ```bash
        # Install PyDM (If on Windows `wget` and `tar` may not be available, just download the file using a browser and extract it)
        wget https://github.com/slaclab/pydm/archive/v1.10.1.tar.gz
        tar -zxvf v1.10.1.tar.gz && rm -f v1.10.1.tar.gz && cd pydm-1.10.1 && pip install . && cd ..
        
        # Install pydm-opi and cons-common
        cd ~/ && git clone --recursive https://github.com/lnls-sirius/pydm-opi && cd pydm-opi
        cd ~/pydm-opi/cons-common && pip install . && cd ../ && pip install . -r requirements.txt
        ```
        
        ### Desktop
        In order to install the `.desktop` launcher:
        ```bash
        make install-files
        ```
        If using conda, remember to fix the Exec entry at the `.desktop' file accordingly:
        ```bash
        /bin/bash -c 'source ~/miniconda3/etc/profile.d/conda.sh && conda activate pydm && sirius-hla-as-ap-conlauncher.py'
        ```
        
        Run
        ---
        All scripts used to start the applications should be at the `bin` folder relative to the python installation environment, for example:
        ```bash
        ~/.local/bin
        /usr/local/bin
        ...
        ```
        
        To launch the main window use the script: `sirius-hla-as-ap-conlauncher.py`
        
        ### Windows
        There should be no problems running on windows.
Platform: UNKNOWN
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
