les-louisdelatech 0.6.0

LouisDeLaTech is a discord bot manager for Lyon e-Sport

LouisDeLaTech is a discord bot manager for Lyon e-Sport

Setup

Discord

Create a discord bot and get the token

Google

• Create a google project
• Create a google service account
• Enable Google workspace delegation
• Generate keys and download the file (used by the bot -g)
• Add required scopes for the service account (see config.example for the list of scopes)

You must create user custom attribute

"custom": {
 "pseudo": "",
 "discordId": "",
 "teeShirt": "",
 "birthdate": ""
}

HelloAsso

Documentation

Custom fields (Actually hard-coded)

{
    "name": "Pseudonyme",
    "type": "TextInput",
},
{
    "name": "Date de naissance",
    "type": "Date",
},
{
    "name": "Adresse postale",
    "type": "TextInput",
},
{
    "name": "Numéro de téléphone",
    "type": "TextInput",
},
{
    "name": "Nom d'utilisateur Discord",
    "type": "TextInput",
},
{
    "name": "Taille du tee-shirt",
    "type": "ChoiceList",
},
{
    "name": "Je m'engage à signer l'engagement de confidentialité : https://example.fr",
    "type": "YesNo",
}

To use the commands, please provide the requested form slug.
For exemple, for form at helloasso.com/associations/masuperassociation/adhesions/adhesion-2024-2025/ , the slug is adhesion-2024-2025
Resulting in, for exemple, the following command : /ha_check_update form_slug:adhesion-2024-2025

Install

pip install les_louisdelatech

Configure

Generate a secret_key to encrypt database secrets

>>> from cryptography.fernet import Fernet
>>> Fernet.generate_key()

Fill config.toml with config.example

Run

python3 -m les_louisdelatech.main -c config.toml -g google.json

Note: the bot sends provisioning/reset credentials by email (not Discord DM). Make sure your Google delegated scopes include Gmail send (see config.example).

Dev

Install uv

Install and setup dependencies with uv sync --all-extras

Run ruff

uv run ruff format . 
uv run ruff check .

Licence

The code is under CeCILL license.

You can find all details here: https://cecill.info/licences/Licence_CeCILL_V2.1-en.html

Changelog

See CHANGELOG.md for step-by-step updates.

Docs

• docs/ARCHITECTURE.md: high-level overview of the codebase
• docs/CONFIGURATION.md: config reference and required keys/scopes

Credits

Copyright © Lyon e-Sport, 2021

Contributor(s):

• Ortega Ludovic - [e-mail]
• Etienne "PoPs" G. - [e-mail]
• Pierre "DrumSlayer" Sarret - [e-mail]