Metadata-Version: 2.1
Name: django-discord-py
Version: 2023.1.28.1
Summary: Add a short description here!
Home-page: https://github.com/MrSage/django_discord.py
Author: Collin Sage
Author-email: 3229549+MrSage@users.noreply.github.com
License: MIT
Project-URL: Documentation, https://github.com/MrSage/django_discord.py
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Description-Content-Type: text/x-rst; charset=UTF-8
Provides-Extra: testing
License-File: LICENSE.txt

.. These are examples of badges you might want to add to your README:
   please update the URLs accordingly

    .. image:: https://api.cirrus-ci.com/github/<USER>/django-discord-py.svg?branch=main
        :alt: Built Status
        :target: https://cirrus-ci.com/github/<USER>/django-discord-py
    .. image:: https://readthedocs.org/projects/django-discord-py/badge/?version=latest
        :alt: ReadTheDocs
        :target: https://django-discord-py.readthedocs.io/en/stable/
    .. image:: https://img.shields.io/coveralls/github/<USER>/django-discord-py/main.svg
        :alt: Coveralls
        :target: https://coveralls.io/r/<USER>/django-discord-py
    .. image:: https://img.shields.io/pypi/v/django-discord-py.svg
        :alt: PyPI-Server
        :target: https://pypi.org/project/django-discord-py/
    .. image:: https://img.shields.io/conda/vn/conda-forge/django-discord-py.svg
        :alt: Conda-Forge
        :target: https://anaconda.org/conda-forge/django-discord-py
    .. image:: https://pepy.tech/badge/django-discord-py/month
        :alt: Monthly Downloads
        :target: https://pepy.tech/project/django-discord-py
    .. image:: https://img.shields.io/twitter/url/http/shields.io.svg?style=social&label=Twitter
        :alt: Twitter
        :target: https://twitter.com/django-discord-py

.. image:: https://img.shields.io/badge/-PyScaffold-005CA0?logo=pyscaffold
    :alt: Project generated with PyScaffold
    :target: https://pyscaffold.org/

|

=================
django-discord-py
=================


    An easy-to-use, easy-to-start with Discord.py bot with Django built right in.


Discord bots are really cool, and Django provides a lot of functionality for free. For a lot of developers
this project may be too heavy weight to make sense. However, if you're used to Django and want to start
writing Discord bots then this should be a great place for you to start.


Important Notes Before We Get Started
=====================================

If you're new to developing django or have never installed a django server as a package before
you may be used to running `python manage.py <command>`. For this project you will instead run

::

  python -m django_discord.py <command>

If you don't want this you can also install this package as normal and import the parts you want
to use in your django project.


Prerequisites
=============

By default this project requires Redis. Find installation instructions for you system at their site: https://redis.com


Installation
============

We recommend installing from PIP

::

  pip install --upgrade django_discord_py

If you want to install from source

::

  git clone <this_repo>
  cd <this_repo>
  pip install -e "."


Basic Bot Usage
===============

Using the console_scripts entrypoint

::

  python3 -m venv your_venv
  source your_venv/bin/activate
  pip install --upgrade django_discord_py
  discord_bot

Using the module directly

::

  python3 -m venv your_venv
  source your_venv/bin/activate
  pip install --upgrade django_discord_py
  python -m django_discord.py.entrypoints.channels_entrypoint


Basic Django Server Usage
=========================

Using the console_scripts entrypoint

::

  python3 -m venv your_venv
  source your_venv/bin/activate
  pip install --upgrade django_discord_py
  django_server

Using the module directly

::

  python3 -m venv your_venv
  source your_venv/bin/activate
  pip install --upgrade django_discord_py
  python -m django_discord.py.entrypoints.http_entrypoint


.. _pyscaffold-notes:

Making Changes & Contributing
=============================

This project uses `pre-commit`_, please make sure to install it before making any
changes::

    pip install pre-commit
    cd django-discord-py
    pre-commit install

It is a good idea to update the hooks to the latest version::

    pre-commit autoupdate

Don't forget to tell your contributors to also install and use pre-commit.

.. _pre-commit: https://pre-commit.com/


Extending The Server For Your Own Needs
=======================================

Obviously, you will want your bot to do more than just respond to `?hi`. To extend this bot
you can set **DJANGO_SETTINGS_MODULE** in your environment to your own settings file. From
there you will have all the normal controls over Django that you're used to.

For ease-of-use you can see **.env.example** for a list of import environment variables.

Note
====

This project has been set up using PyScaffold 4.3.1. For details and usage
information on PyScaffold see https://pyscaffold.org/.
