Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Kraust authored Feb 24, 2024
1 parent 6339115 commit 90042fe
Showing 1 changed file with 42 additions and 8 deletions.
50 changes: 42 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,50 @@
# OSCR-UI

[![PyPI version](https://badge.fury.io/py/OSCR-UI.svg)](https://badge.fury.io/py/OSCR-UI)

User Interface for the OSCR parser.

## Connection to OSCR
Currently the parser source code files will be placed in the `/OSCRUI/OSCR/` folder to simplify development. At some point in the future the parser will be made available as package on PyPI and added as requirement to this project.
# Windows Users

For Windows users we have pre-compiled standalone binaries available on the [Releases](https://github.com/STOCD/OSCR-UI/releases) page.
# Installation

## PyPI

```bash
python3 -m pip install OSCR-UI
```

## Github

```bash
python3 -m pip install git+https://github.com/STOCD/OSCR-UI.git
```

# Running

```bash
oscr
```

# Development

## Installation
*It is recommended to use a python virtual environment to house this app.*

This app requires Python 3.
```bash
# Clone the repository
git clone https://github.com/STOCD/OSCR-UI.git
cd OSCR-UI

# Set up the virtual environment
virtualenv venv

# Windows
.\venv\Scripts\activate

Clone the repository. Download the contents of [this folder](https://github.com/STOCD/OSCR/tree/main/OSCR) and place them into the `/OSCRUI/OSCR/` folder.
Install requirements with: `python -m pip install -r requirements.txt`
Run the app with: `python main.py`
# Linux
source ./venv/bin/activate

On Linux use `python3` instead of `python`.
# Install OSCR + Requirements.
python3 -m pip install .
```

0 comments on commit 90042fe

Please sign in to comment.