Metadata-Version: 2.1
Name: django-coturn
Version: 0.2.0
Summary: Django Coturn is a Django app to synchronize django admins/users with Coturn's user database.         Coturn is an open-source STUN/TURN/ICE server.
Home-page: http://github.com/bitsy-ai/django-coturn
Author: Leigh Johnson
Author-email: leigh@bitsy.ai
License: GNU AGPLv3
Keywords: django stun turn ice coturn webrtc
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Framework :: Django
Classifier: Framework :: Django :: 3.1
Classifier: Framework :: Django :: 3.2
Requires-Python: >3.6.9
Requires-Dist: django (>=3.2)
Requires-Dist: psycopg2


==============
Django Coturn
==============

.. image:: https://img.shields.io/pypi/v/django-coturn
    :target: https://pypi.org/project/django-coturn/
.. image:: https://img.shields.io/pypi/pyversions/django-coturn
    :target: https://pypi.org/project/django-coturn/
.. image:: https://img.shields.io/pypi/djversions/django-coturn
    :target: https://pypi.org/project/django-coturn/
.. image:: https://img.shields.io/pypi/wheel/django-coturn
    :target: https://pypi.org/project/django-coturn/
.. image:: https://img.shields.io/discord/773452324692688956
    :target: https://discord.gg/Y848Hq9xKh
.. image:: https://img.shields.io/github/workflow/status/bitsy-ai/django-coturn/Test
    :target: https://github.com/bitsy-ai/django-coturn
.. image:: https://img.shields.io/codecov/c/github/bitsy-ai/django-coturn
    :target: https://github.com/bitsy-ai/django-coturn
.. image:: https://img.shields.io/github/release-date-pre/bitsy-ai/django-coturn
    :target: https://github.com/bitsy-ai/django-coturn

Django Coturn is a Django app to synchronize django admins/users with Coturn's user database. Coturn is an open-source STUN/TURN/ICE server. 

https://github.com/coturn/coturn

Quick start
-----------

1. Add "coturn" to your INSTALLED_APPS setting like this::

    INSTALLED_APPS = [
        ...
        "django_coturn",
    ]

2. Create an empty `coturn` database

3. Configure the following in your settings.py::

    DATABASES = {
        ... your default and auxilary database configs
        "coturn": env.db("COTURN_DATABASE_URL")
    }

    COTURN_REALM = "turn.example-domain.com"
    COTURN_SECRET_KEY = "127 character secret"

4. Run ``python manage.py migrate`` to create the coturn models.

5. Run ``python manage.py sync_coturn {turn_secret,turn_admin,turn_user}`` to sync users/admin data to coturn tables. You only need to do this once per table - subsequent updates will be handled by Django signals.

Contributor's Guide
--------------------

1. Create a development environment (requires docker & docker-compose)::

    make dev

2. Run tests and generate a coverage report::

    make tests

3. Run `black` linter::

    make lint



