Music and media repository for your NAS, written in Python

acrewstic is implemented as a RESTful API using Python3 with Flask library (http://flask.pocoo.org/). A JS frontend will be provided in the future.

The API is implemented for POST, PUT, GET, DELETE methods. It can be triggered as follows using curl:

PyPI requirements for the application are listed in requirements.txt file:

• flask provides the web service library
• redis is the redis-py package which allows interfacing the key-value store
• py.test is the reference test engine

A strong requirement is to install the Redis service on the system. If Docker is installed on the system (see next section), it is possible to deploy a container of the official Redis image with a single command:

$ docker run -d redis

This command will download (if it is the first launch) and activate detached (parameter -d) the service on the background, listening on default port 6379/tcp. Run docker ps -a to double check.

In the codebase a Dockerfile is available for also packaging the acrewstic application. To create an image, and then run a container of it, run:

$ docker build -t acrewstic .
$ docker run -d -p 5000:5000 acrewstic

In addition to the Dockerfile, a docker-compose.yml script is also available for turning on and off both images in an orchestrated way when docker-compose is installed on the system (see https://github.com/docker/compose):

$ docker-compose up -d
$ docker-compose down

To verify that the the app is working correctly, including the bridge to Redis, launch:

$ curl -i http://localhost:5000/acrewstic/version

TBD

• Initial release (to be released)