Skip to content

Latest commit

 

History

History
70 lines (43 loc) · 2.16 KB

CONTRIBUTING.md

File metadata and controls

70 lines (43 loc) · 2.16 KB

Contributing

Setup Discord Application

Refer to the official discord.py documentation to create a bot.

Also, please make sure that the scope application.commands is enabled.

Make sure to enable intents as well—check the official guide for detailed instructions here.

Screenshot 2023-11-14 at 12 51 00 PM

Project Setup & Installation

  1. Fork the repository to your own profile.

  2. Set up a local PostgreSQL database or use Docker.

    postgresql://username:password@localhost/db_name

    Replace username, password, db_name with appropriate values.

  3. To install packages, run:

    pip install poetry
    poetry install
  4. Once all the packages are installed, run migrations using:

    python cli.py migrate up

  5. Create a .env file and copy the contents of example.env, setting up the environment variables.

  6. Once the above steps are done, run the bot using the command:

    python cli.py
  7. Feel free to join the server in case of any issues.

Docker-Setup

  1. Ensure you have Docker installed and set up on your system. Refer to the Docker's official guide if needed.

  2. To run a PostgreSQL instance, execute:

    docker compose up -d postgres

    The -d flag runs the instance in detached mode.

  3. Run migrations.

    python cli.py migrate up

Guidelines

Please adhere to the following guidelines when contributing:

  • Follow the coding style and conventions used in the project.
  • Write clear and concise commit messages.
  • Test your changes thoroughly before submitting a pull request.
  • Be respectful and constructive in all interactions with other contributors.

Code Quality and Testing

  • Ensure your code follows best practices and is well-documented.
  • Write unit tests for new features and ensure existing tests pass.
  • Perform code reviews and address feedback from other contributors.