ao-killboard 0.1.2

Description:

aokillboard 0.1.2

ao_killboard.py
A minimalistic Discord bot for Albion Online's killboard.
Getting Started
Prerequisites

Python >= 3.6 or Docker

Built with:

discord.py
httpx

Getting the bot via pip
pip install ao-killboard

Getting the bot via Docker Hub
docker pull unresolvedexternal/ao-killboard

Getting the bot via Git
git clone https://github.com/antze-k/ao-killboard-py
python3 -mpip install -r ao-killboard-py/requirements.txt

Change your working directory to cd ao-killboard-py/src/antze and run the bot with either of those, depending on your system setup:

python3 ao_killboard.py
python ao_killboard.py
ao_killboard.py
./ao_killboard.py

The documentation will refer to ao_killboard.py further for simplicity.
Creating a bot account and setting it up for your server (guild)

https://discordpy.readthedocs.io/en/latest/discord.html
https://discordpy.readthedocs.io/en/latest/discord.html#inviting-your-bot (you don't have to add any specific permissions here, if you choose to add Send Messages permission manually for your channel)
Setting permissions (scroll down to Channel Permissions)

Configure and run
Set up three parameters (guild, token and channel) either using environment variables or using command line arguments.

"guild" is your Albion Online guild identifier (as seen in https://albiononline.com/en/killboard/guild/<ID>)
"token" is your bot token obtained in the previous step
"channel" is the Discord channel ID the bot will post messages into (check this article if you need to know how to obtain it)

You can always run ao_killboard.py --help to check the available options.
Running the bot manually using command line arguments
ao_killboard.py --guild <GUILD-ID> --token <DISCORD-TOKEN> --channel <123456789>

or, to enable debug logging:
ao_killboard.py --guild <GUILD-ID> --token <DISCORD-TOKEN> --channel <123456789> --debug

Replace the with their respective values, omitting angle brackets.
Running the bot using environment values and a batch script (Windows)
Paste the following into a file with a name like "start-bot.cmd":
@echo off
set AO_KILLBOARD_GUILD=<GUILD-ID>
set AO_KILLBOARD_TOKEN=<DISCORD-TOKEN>
set AO_KILLBOARD_CHANNEL=<123456789>
ao_killboard.py %*

Replace the with their respective values, omitting angle brackets. To enable debug logging, add set AO_KILLBOARD_DEBUG=1 before the last line.
Running the bot using environment values and a shell script (POSIX-like OS)
Paste the following into a file with a name like "start-bot.sh":
AO_KILLBOARD_GUILD=<GUILD-ID>
AO_KILLBOARD_TOKEN=<DISCORD-TOKEN>
AO_KILLBOARD_CHANNEL=<123456789>
exec ao_killboard.py "$@"

Replace the with their respective values, omitting angle brackets. Set the execute bit by running chmod +x start-bot.sh. To enable debug logging, add AO_KILLBOARD_DEBUG=1 before the last line.
Running the bot using Docker
docker run --rm -d --env 'AO_KILLBOARD_GUILD=<GUILD-ID>' --env 'AO_KILLBOARD_TOKEN=<DISCORD-TOKEN>' --env 'AO_KILLBOARD_CHANNEL=<123456789>' unresolvedexternal/ao-killboard

or, to enable debug logging:
docker run --rm -d --env 'AO_KILLBOARD_GUILD=<GUILD-ID>' --env 'AO_KILLBOARD_TOKEN=<DISCORD-TOKEN>' --env 'AO_KILLBOARD_CHANNEL=<123456789>' --env 'AO_KILLBOARD_DEBUG=1' unresolvedexternal/ao-killboard

Replace the with their respective values, omitting angle brackets. You might also want to add --name ao-killboard or any other Docker switches you would prefer.