Metadata-Version: 2.1
Name: djaodjin-multitier
Version: 0.2.1
Summary: Django application that implements shared tenancy
Author-email: The DjaoDjin Team <help@djaodjin.com>
Maintainer-email: The DjaoDjin Team <help@djaodjin.com>
License: BSD-2-Clause
Project-URL: repository, https://github.com/djaodjin/djaodjin-multitier
Project-URL: documentation, https://djaodjin-multitier.readthedocs.io/
Project-URL: changelog, https://github.com/djaodjin/djaodjin-multitier/changelog
Keywords: django,multitier,databases,routers
Classifier: Framework :: Django
Classifier: Environment :: Web Environment
Classifier: Programming Language :: Python
Classifier: License :: OSI Approved :: BSD License
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: Django>=1.11
Requires-Dist: djaodjin-deployutils>=0.5.23

djaodjin-multitier is a Django application that implements shared tenancy.

Major Features:

  - Dynamically select the following based on subdomain or path prefix:
      * Database connection
      * SMTP connection
      * Templates
  - URL resolvers: Dynamic path prefix (as a hack in i18n module)

The [notes](http://djaodjin.com/blog/multi-tier-implementation-in-django.blog.html)
of the presentation at a SF Django Meetup are useful to understand how
middlewares, thread locals and template loaders were used to implement
multi-tier applications here.

Development
===========

After cloning the repository, create a virtualenv environment, install
the prerequisites, create and load initial data into the database, then
run the testsite webapp.

    $ python -m venv .venv
    $ source .venv/bin/activate
    $ pip install -r testsite/requirements.txt

    # Create the fixtures databases and run the server
    $ make initdb
    $ python manage.py runserver

Release Notes
=============

Tested with

- **Python:** 3.7, **Django:** 3.2 ([LTS](https://www.djangoproject.com/download/))
- **Python:** 3.10, **Django:** 4.2 (latest)
- **Python:** 2.7, **Django:** 1.11 (legacy) - use testsite/requirements-legacy.txt

0.2.1

 * hotfix extra field can be None
 * replaces field `tag` by `extra` to match coding conventions
 * returns `multitier.Site` when `settings.MULTITIER_SITE_MODEL is None`.

 -- Sebastien Mirolo <smirolo@djaodjin.com>  Tue, 10 Oct 2023 14:00:00 -0700

[previous release notes](changelog)
