Metadata-Version: 2.1
Name: shinobi-client
Version: 0.2.1
Summary: A Python client for controlling Shinobi (an open-source video management solution)
Home-page: https://github.com/colin-nolan/python-shinobi-client
Keywords: shinobi,client,cli
Author: Colin Nolan
Author-email: cn580@alumni.york.ac.uk
Requires-Python: >=3.6,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Provides-Extra: cli
Provides-Extra: shinobi-controller
Requires-Dist: dataclasses (>=0.7,<0.8); python_version >= "3.6" and python_version < "3.7"
Requires-Dist: docker-compose (>=1.25,<2.0); extra == "shinobi-controller"
Requires-Dist: fire (>=0.3.0,<0.4.0); extra == "cli"
Requires-Dist: get-port (>=0.0.5,<0.0.6); extra == "shinobi-controller"
Requires-Dist: gitpython (>=3,<4); extra == "shinobi-controller"
Requires-Dist: logzero (>=1.5.0,<2.0.0)
Requires-Dist: requests (>=2.23,<3.0)
Requires-Dist: toml (>=0.9,<0.10)
Project-URL: Repository, https://github.com/colin-nolan/python-shinobi-client
Description-Content-Type: text/markdown

[![Build Status](https://travis-ci.com/colin-nolan/python-shinobi-client.svg?branch=master)](https://travis-ci.com/colin-nolan/python-shinobi-client)
[![Code Coverage](https://codecov.io/gh/colin-nolan/python-shinobi-client/branch/master/graph/badge.svg)](https://codecov.io/gh/colin-nolan/python-shinobi-client)

# Shinobi Python Client
_A Python client for controlling [Shinobi](https://gitlab.com/Shinobi-Systems/Shinobi) (an open-source video management 
solution)._


## About
This package contains an (very incomplete) set of tools for interacting with Shinobi using Python.

This library tries to use the (rather unique) [documented API](https://shinobi.video/docs/api) but it also uses 
undocumented endpoints (which may not be stable).


## Installation
Install from [PyPi](https://pypi.org/project/shinobi-client/):
```
pip install shinobi-client
```

Install with ability to start a Shinobi installation:
```
pip install shinobi-client[shinobi-controller]
```

Install with CLI:
```
pip install shinobi-client[cli]
```

## Usage
### Python
#### User ORM
```python
from shinobi_client import ShinobiUserOrm

user_orm = ShinobiUserOrm(host, port, super_user_token)

user = user_orm.get(email)

users = user_orm.get_all()

user = user_orm.create(email, password)

modified = user_orm.modify(email, password=new_password)

deleted = user_orm.delete(email)
```

#### Shinobi Controller
Starts/Stops a temporary [containerised installation of Shinboi](https://github.com/colin-nolan/docker-shinobi). Written
for the purpose of testing but it is also installable as an extra. Requires Docker.
```python
from shinobi_client import start_shinobi

with start_shinobi() as shinobi:
    print(shinobi.url)
    # Do things with a temporary Shinobi installation
```
or
```python
from shinobi_client import ShinobiController

controller = ShinobiController()
shinobi = controller.start()
print(shinobi.url)
# Do things with a temporary Shinobi installation
controller.stop()
```

### CLI
A basic auto-generated CLI is available if the package is installed with the `cli` extra: 
```
PYTHONPATH=. python shinobi_client/user.py --host=HOST --port=PORT --super_user_token=SUPER_USER_TOKEN get example@
```
e.g.
```
$ PYTHONPATH=. python shinobi_client/user.py \
        --host='0.0.0.0' --port=50694 --super_user_token='26dd3352-73c4-4bbd-8b09-17f2aacbd7b9' \
    create 'user@example.com' 'password123'
```


## Development
Install with dev-dependencies:
```
poetry install --no-root --extras "shinobi-controller"
```

Run tests with:
```
python -m unittest discover -v -s shinobi/tests
```


## Legal
[AGPL v3.0](LICENSE.txt). Copyright 2020 Colin Nolan.

I am not affiliated to the development of Shinobi project in any way. This work is in no way related to the company that
I work for.

