2020-04-22 21:58:06 +00:00
|
|
|
# Butter Robot
|
|
|
|
|
2022-02-05 12:00:20 +00:00
|
|
|
| Stable | Master |
|
|
|
|
| --- | --- |
|
|
|
|
| ![Build stable tag docker image](https://github.com/fmartingr/butterrobot/workflows/Build%20stable%20tag%20docker%20image/badge.svg?branch=stable) | ![Build latest tag docker image](https://github.com/fmartingr/butterrobot/workflows/Build%20latest%20tag%20docker%20image/badge.svg?branch=master) |
|
|
|
|
| ![Pytest](https://github.com/fmartingr/butterrobot/workflows/Pytest/badge.svg?branch=stable) | ![Pytest](https://github.com/fmartingr/butterrobot/workflows/Pytest/badge.svg?branch=master) |
|
2020-04-22 21:58:06 +00:00
|
|
|
|
|
|
|
Python framework to create bots for several platforms.
|
|
|
|
|
|
|
|
![Butter Robot](./assets/icon@120.png)
|
|
|
|
|
|
|
|
> What is my purpose?
|
|
|
|
|
2022-02-05 12:00:20 +00:00
|
|
|
## Documentation
|
2020-04-22 21:58:06 +00:00
|
|
|
|
2022-02-05 12:00:20 +00:00
|
|
|
[Go to documentation](./docs)
|
2020-04-22 21:58:06 +00:00
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
|
|
### PyPi
|
|
|
|
|
|
|
|
You can run it directly by installing the package and calling it
|
|
|
|
with `python` though this is not recommended and only intended for
|
|
|
|
development purposes.
|
|
|
|
|
|
|
|
```
|
|
|
|
$ pip install --user butterrobot
|
|
|
|
$ python -m butterrobot
|
|
|
|
```
|
|
|
|
|
|
|
|
### Containers
|
|
|
|
|
2022-02-05 12:00:20 +00:00
|
|
|
The `fmartingr/butterrobot/butterrobot` container image is published on Github packages to use with your favourite tool:
|
2020-04-22 21:58:06 +00:00
|
|
|
|
|
|
|
```
|
2020-07-21 14:32:11 +00:00
|
|
|
docker pull docker.pkg.github.com/fmartingr/butterrobot/butterrobot:latest
|
2022-02-05 12:00:20 +00:00
|
|
|
podman run -d --name fmartingr/butterrobot/butterrobot -p 8080:8080
|
2020-04-22 21:58:06 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
## Contributing
|
|
|
|
|
|
|
|
To run the project locally you will need [poetry](https://python-poetry.org/).
|
|
|
|
|
|
|
|
```
|
|
|
|
git clone git@github.com:fmartingr/butterrobot.git
|
|
|
|
cd butterrobot
|
|
|
|
poetry install
|
|
|
|
```
|
|
|
|
|
2022-02-05 12:00:20 +00:00
|
|
|
Create a `.env-local` file with the required environment variables, you have [an example file](.env-example).
|
2020-04-22 21:58:06 +00:00
|
|
|
|
|
|
|
```
|
|
|
|
SLACK_TOKEN=xxx
|
|
|
|
TELEGRAM_TOKEN=xxx
|
|
|
|
...
|
|
|
|
```
|
|
|
|
|
|
|
|
And then you can run it directly with poetry
|
|
|
|
|
|
|
|
```
|
|
|
|
docker run -it --rm --env-file .env-local -p 5000:5000 -v $PWD/butterrobot:/etc/app/butterrobot local/butterrobot python -m butterrobot
|
|
|
|
```
|