IN PROGRESS: Simple web application to view task orders from Django Coleman, built with Tornado Framework.
This is just a PoC using Tornado web framework and Python 3+ async programming, and Django Coleman as API, it's not a full featured, production ready application.
- Python 3.6+
- Tornado framework installed (tested with version 6 and 6.1)
- Django Coleman running at the URL pointed
by the
DCOLEMAN_ENDPOINT
environment variable (by default it useshttp://localhost:8000/api/v1
)
Install tornado
with:
$ pip3 install tornado
(use virtual environments!)
Run with:
$ ./app.py
Run changing the Django Coleman endpoint with:
$ DCOLEMAN_ENDPOINT=http://HOSTNAME/api/v1 ./app.py
If the order number is 123, the URL to access it is: http://localhost:8888/123?t=porgs
The argument t
is the master token, by default porgs
...
... but each time Django Coleman creates an order, it sends an email with the order URL signed with a unique token so users cannot reuse the token to see other orders.
Environment variable | Default value | Description | |
DCOLEMAN_ENDPOINT |
http://localhost:8000/api/v1 |
Django Coleman API URL | |
DCOLEMAN_MASTER_TOKEN |
porgs |
Master token (CHANGE IT in production) | |
DCOLEMAN_TASKS_VIEWER_HASH_SALT |
1two3 |
Same value than TASKS_VIEWER_HASH_SALT in Django Coleman |
A reference Dockerfile is provided, that's is going to be published in Docker Hub (in progress).
Also a docker-compose.yml is provided, you can build and run the the app with Docker Compose with:
$ docker-compose up
Although when using Docker Compose, it's recommended to use the compose file from the Django Coleman project instead of the local here, that allows to run all: Django Coleman, this Viewer app and Postgres at once.
Project: https://github.com/mrsarm/tornado-dcoleman-mtasks-viewer
Authors: (2019-2022) Mariano Ruiz <[email protected]>
License: AGPL-v3