Metadata-Version: 2.1
Name: edx-organizations
Version: 7.0.0
Summary: Organization management module for Open edX
Home-page: https://github.com/openedx/edx-organizations
Author: edX
License: AGPL
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 4.2
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
License-File: LICENSE
Requires-Dist: Pillow
Requires-Dist: django
Requires-Dist: django-model-utils
Requires-Dist: django-simple-history<=3.1.1
Requires-Dist: djangorestframework
Requires-Dist: edx-drf-extensions
Requires-Dist: edx-opaque-keys>=0.1.2
Requires-Dist: setuptools

edx-organizations |Build Status| |Coverage Status|
==================================================

edx-organizations (``organizations``) is a Django application
responsible for managing the concept of Organizations in the Open edX
platform. Organizations represent the entities responsible for creating
and publishing Courses. In the future the scope and responsibilty of the
Organization may evolve to include other aspects, such as related
learners.

.. |Build Status| image:: https://github.com/openedx/edx-organizations/workflows/Python%20CI/badge.svg?branch=master
   :target: https://github.com/openedx/edx-organizations/actions?query=workflow%3A%22Python+CI%22
.. |Coverage Status| image:: https://coveralls.io/repos/github/edx/edx-organizations/badge.svg?branch=master
   :target: https://coveralls.io/github/edx/edx-organizations?branch=master

Usage
-----
Organizations is designed to centralize metadata about course publishers, such as their title, logo URL,
and information included in certificates.

Local Development
-----------------

.. code-block:: bash

    $ make requirements
    $ make test
    $ make quality

Open edX Platform Integration
-----------------------------

1. Update the version of ``edx-organizations`` in the appropriate requirements file (e.g. ``requirements/edx/base.txt``).
2. Add ‘organizations’ to the list of installed apps in ``common.py``.
3. Install all requirements:

.. code-block:: bash

   $ pip install -r requirements

4. (Optional) Run tests:

.. code-block:: bash

   $ paver test_system -s lms

How to Contribute
-----------------
Contributions are very welcome, but please note that edx-organizations is currently an early stage
work-in-progress and is changing frequently at this time.

See our `CONTRIBUTING`_ file for more information – it also contains guidelines for how to
maintain high code quality, which will make your contribution more likely to be accepted.

.. _CONTRIBUTING: https://github.com/openedx/.github/blob/master/CONTRIBUTING.md

Reporting Security Issues
-------------------------
Please do not report security issues in public. Please email security@openedx.org.

Mailing List and IRC Channel
----------------------------

You can discuss this code on the `edx-code Google Group`_ or in the
``edx-code`` IRC channel on Freenode.

.. _edx-code Google Group: https://groups.google.com/forum/#!forum/edx-code
