docker run -d -e DISCOURSE_API_KEY=fefe flipdot/forumbot
# if you want to run on another discourse instance:
docker run -d -e DISCOURSE_API_KEY=fefe -e DISCOURSE_USERNAME=hello -e DISCOURSE_HOST=https://forum.example.com flipdot/forumbot
Changes on the master branch are automatically build into a docker image and published at docker hub. After it is published, you need to adjust this ansible playbook
Checkout if a change to the ansible playbook is automatically deployed yet - at the time of writing this, you need to run the playbook manually. See details over at the other repository.
If you are not able to get an API key for forum.flipdot.org, try the compose setup:
docker compose up
Go to http://localhost:3000/ and login with user user@example.com and password bitnami123
Clone this repo, make your changes, build a new container:
./build_docker.sh
DISCOURSE_API_KEY=fefe ./run_docker.sh
# or with the test user
DISCOURSE_API_KEY=fefe DISCOURSE_USERNAME=flipbot_test ./run_docker.sh
Or, if you want to develop without docker:
poetry install
DISCOURSE_API_KEY=fefe python src/app.py
# or with the test user
DISCOURSE_API_KEY=fefe DISCOURSE_USERNAME=flipbot_test python src/app.py
You can get the credentials of flipdot_test in our forum: https://forum.flipdot.org/t/api-key-fuer-flipbot-test/3755
Execute tests:
# an API key needs to be set, but you can use an invalid value
DISCOURSE_API_KEY=_ pipenv run nosetests
Start by copying src/tasks/hello_world.py. You can run your new task directly:
python src/app.py --dry --run_task hello_world
...where "hello_world" is the name of the python file.
Modify the main() function:
def main(client: DiscourseClient) -> None:
# Do your stuff here.
# You can use the client object to interact with discourse
pass
Next, open src/app.py. Add an import tasks.my_awesome_task to the top of the file.
Schedule your task inside the function schedule_jobs:
schedule.every().day.at('13:37').do(tasks.my_awesome_task.main, client)
Take a look at schedule to see how to specify when to run your task.