shatteredbeam / shatteredbeam.github.io Goto Github PK

SPARK is the all-in-one wonderbot written and utilized by The Fuel Rat for rescue management. This project is under active development. As such, features may be added or removed without notice.

As this project is under heavy development, we cannot offer support at this time. However, please do report bugs or issues on our project here.

SPARK is currently incomplete.

• Python 3.6.5
• PostgreSQL
• Pydle, asyncio branch git://github.com/Shizmob/pydle.git@asyncio#egg=pydle

This script can be run as a Docker image or run locally.

To run as a docker image, you may use the provided docker-compose.

If you would prefer to run the service locally, bear in mind you may need to run a local PostgreSQL Database for the fact module.

We have provided a docker-compose.yml suitably configured for building and running Mecha as a Alpine Linux multi-container service.

To build Mecha via docker, run the following command:

docker-compose build mechasqueak

To verify the build completed successfully and you have a clean copy of the project, please run the test suites.

docker-compose run tests

To run the bot, after creating your configuration file (see Configuration below), run the following command:

docker-compose run mechasqueak

If you are not using pip, please see requirements.txt for the list of required libraries. You will need to install these manually.

1. Clone the repository from the master branch, or for bleeding edge, use develop. Please keep in mind, Develop changes frequently and may be broken.
2. Build your configuration file. Please see the Configuration section.
3. Execute Mecha with python main.py --config <your configuration file> (You may need to use the python3 alias)

Configuration settings are stored in the config/ subfolder as JSON files.

By default, Mecha will attempt to load configuration.json (file not provided) from this subdirectory.

To configure Mecha locally, please copy the provided config.template.json to a new file. configuration.json and fill in the appropriate fields, see config/configuration.md for details.

When run via docker, it is not necessary to rebuild the image after changing configuration options as that directory is shared with the container (see config/configuration.md)