Apollo is a Discord bot for the University of Warwick Computing Society. It is designed to augment our Discord server with a few of the user services available on our website.
Apollo is based loosely on the development of artemis, another Discord bot produced by a member of UWCS.
Two dependency files are included with this project.
The first, requirements.txt
, only includes top-level dependencies.
The second, requirements.lock
, contains a pinned list of all dependencies.
If installing the top-level dependencies does not work, try installing the pinned dependencies.
- Create a new virtual environment
python -m venv .venv
. - Activate the virtual environment
- On Linux and macOS:
source .venv/bin/activate
. - On Windows:
.\venv\Scripts\activate
- On Linux and macOS:
- Check that the virtual environment has been activated.
- On Linux and macOS:
which python
Expected output:.../.venv/bin/python
. - On Windows:
where python
(NB on PowerShell usewhere.exe
orGet-Command
instead ofwhere
)
Expected output:...\.venv\Scripts\python.exe
.
- On Linux and macOS:
- Install dependencies.
Now that we've activated the environment,pip
will install packages locally.- Installing top-level dependencies via
pip install -r requirements.txt
should work. - If it doesn't, you may need to install the pinned requirements via
pip install -r requirements.lock
- Installing top-level dependencies via
- Copy
config.example.yaml
toconfig.yaml
and configure the fields. - Copy
alembic.example.ini
toalembic.ini
. - Set up the database by running migrations with
alembic upgrade head
.- The default database location is
sqlite:///:memory:
(in bothconfig.example.py
andalembic.example.ini
). For testing purposes, you may wish to change it to a locally stored file such assqlite:///local.sqlite3
.
- The default database location is
- On the Discord developer portal, make sure that your bot has the required intents.
- Currently, only the Members intent is necessary.
Run apollo.py
- either with python apollo.py
or just by executing the file.
-
When writing anything that needs to reply back to a specific username, please do
from utils import get_name_string
and get the display string using this function, with the discordMessage
object as the argument (e.g.display_name = get_name_string(ctx.message)
). This will return either a discord username, formatted correctly, or an irc nickname depending on the source of the message. Finally, this can be used as normal in a format string e.g.await ctx.send(f'Sorry {display_name}, that won't work.')
. -
When writing a new command, please read in the rest of the message using
*args: clean_content
(seecogs/commands/flip.py
as an example), and if you need it as one large string, use" ".join(args)
. This is instead of reading the whole message content, which will likely break the irc bridging (unless you know what you're doing). -
This project uses the Black Python formatter. Before submitting your code for a PR, run
black .
on the root directory of this project to bring all of your up to spec for the code style guide.
This project is distributed under the MIT license.
Copyright © 2018 David Richardson
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.