Metadata-Version: 2.1
Name: statina
Version: 1.2.4
Summary: NIPT data storage and visualisation
Home-page: https://github.com/Clinical-Genomics/statina
Author: Maya Brandi
Author-email: maya.brandi@scilifelab.se
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: click
Requires-Dist: bump2version
Requires-Dist: pymongo
Requires-Dist: mongo-adapter
Requires-Dist: coloredlogs
Requires-Dist: pyyaml
Requires-Dist: cerberus
Requires-Dist: python-multipart
Requires-Dist: python-dotenv
Requires-Dist: email-validator
Requires-Dist: jinja2
Requires-Dist: passlib
Requires-Dist: fastapi
Requires-Dist: uvicorn
Requires-Dist: uvloop
Requires-Dist: httptools
Requires-Dist: gunicorn
Requires-Dist: python-jose
Requires-Dist: bcrypt
Requires-Dist: numpy
Requires-Dist: aiofiles

# Statina  [![Coverage Status](https://coveralls.io/repos/github/Clinical-Genomics/statina/badge.svg?branch=master)](https://coveralls.io/github/Clinical-Genomics/statina?branch=master) [![Build Status](https://travis-ci.org/Clinical-Genomics/statina.svg?branch=master)](https://travis-ci.org/Clinical-Genomics/statina) ![Latest Release](https://img.shields.io/github/v/release/clinical-genomics/statina)


Statina is a visualisation tool for the data produced by the [Fluffy] pipeline running [WisecondorX] to analyze NIPT.

## Installation

```bash
git clone https://github.com/Clinical-Genomics/statina
cd statina
pip install -r requirements.txt -e .
```

## Usage

### Demo

**The CLI is intended for development/testing purpose only. To run in a production setting please refer to documentation
for suggestions how.**

Once installed, you can set up Statina by running a few commands using the included command line interface. 
Given you have a MongoDB server listening on the default port (27017), this is how you would set up a fully working 
Statina demo:

```bash
statina load batch --result-file statina/tests/fixtures/valid_fluffy.csv
```

Settings can be used by exporting the environment variables: `DB_NAME`, `DB_URI`, `HOST`, `PORT`
This will set up an instance of Statina with a database called `statina-demo`. Now run

```bash
statina serve --reload
```
 and play around with the interface.

### Docker image

Statina can also run as a container. The image is available [on Docker Hub][docker-hub] or can be build using the 
Dockerfile provided in this repository.

To build a new image from the Dockerfile use the commands: `docker build -t statina .`

To run the image use the following command: `docker run --name statina statina statina `

To remove the container, type: `docker rm statina`

## Release model
Statina development is organised on a flexible Git "Release Flow" branching system. This more or less means that we 
make releases in release branches which corresponds to stable versions of Statina.

### Steps to make a new release:

2) Update change log with the new version.
3) Update statina/__init__.py with the new version.
4) Make a PR to master,
	- Justify if its a patch/minor/major version bump
	- Paste the latest changelog to the text body
	- get it approved and merge to master.
5) Make a [new release](https://github.com/Clinical-Genomics/statina/releases/new).
	- `git checkout master`
	- `git tag "vX.X.X"`
	- `git push --tag`
	- got to the new release on [releases](https://github.com/Clinical-Genomics/statina/releases) and click 'Create Release'

### Deploying to staging

Opening pull requests in Statina repository will enable a Github Action to build containers and publish to 
[statina-stage dockerhub](https://hub.docker.com/repository/docker/clinicalgenomics/statina-stage) with each commit.

Two tags will be published: one with the name of the branch and another tagged "latest".


Steps to test current branch on staging:

`ssh firstname.lastname@cg-vm1.scilifelab.se`

`sudo -iu hiseq.clinical`

`ssh localhost`

If you made changes to internal app : `systemctl --user restart statina.target` 

Your branch should be deployed to staging at https://statina-stage.scilifelab.se 

If for some reason you cannot access the application at given address, check status of the container: `systemctl --user status statinaApp.service`

### Deploying to production

Use `update-statina.sh` script to update production both on Hasta and CGVS. 
**Please follow the development guide and `servers` repo when doing so. It is also important to keep those involved informed.**

## Back End
The Statina database is a Mongo database consisting of following collections:

- **batch** - holds batch level information.
- **sample** - holds sample level information.
- **user** - holds user names, emails and roles.

The database is loaded through the CLI with data generated by the [FluFFyPipe][Fluffy]


[Fluffy]: https://github.com/Clinical-Genomics/fluffy
[WisecondorX]: https://github.com/CenterForMedicalGeneticsGhent/WisecondorX
[docker-hub]: https://hub.docker.com/repository/docker/clinicalgenomics/statina


