Handle multi-tenancy in Django with no additional global state using schemas.
Project description
Handle multi-tenancy in Django with no additional global state using schemas.
Installation
Assuming you have django installed, the first step is to install django-tenancy:
pip install django-tenancy
Now you can import the tenancy module in your Django project.
Using django-tenancy
Define a Tenant Model
The tenant model must be a subclass of tenancy.models.AbstractTenant.
For instance, your myapp/models.py might look like:
from tenancy.models import AbstractTenant
class MyTenantModel(AbstractTenant):
name = models.CharField(max_length=50)
# other fields
def natural_key(self):
return (self.name, )
Important note: the natural_key method must return a tuple that will be used to prefix the model and its database table. This prefix must be unique to the tenant.
Declare the Tenant Model
Now that you have your tenant model, let’s declare in your project in settings.py:
TENANCY_TENANT_MODEL = 'myapp.MyTenantModel'
Run a database synchronization to create the corresponding table:
python manage.py syncdb
Define the tenant-specific models
The tenant-specific models must subclass tenancy.models.TenantModel.
For instance, each tenant will have projects and reports. Here is how myapp/models.py might look like:
from tenancy.models import AbstractTenant, TenantModel
class MyTenantModel(AbstractTenant):
name = models.CharField(max_length=50)
# other fields
def natural_key(self):
return (self.name, )
class Project(TenantModel):
name = models.CharField(max_length=50)
description = models.CharField(max_length=300, blank=True, null=True)
class Report(TenantModel):
name = models.CharField(max_length=50)
content = models.CharField(max_length=300, blank=True, null=True)
Playing with the defined models
You can manipulate the tenant and tenant-specific models as any other Django models.
Create a tenant instance
tenant = MyTenantModel.objects.create("myfirsttenant")
Get a tenant-specific model: for_tenant()
<TenantModel>.for_tenant(<AbtractTenantConcreteSubclass instance>)
TenantModel comes with a method that allows you to get the specific AbstractTenantModel for a given Tenant instance. For instance:
tenant_project = Project.for_tenant(tenant)
Create a tenant-specific model instance
tenant_project.objects.create("myfirsttenant_project")
Python 3.5
An issue with circular references between Model objects prevent garbage collection of tenant specific models on tenant deletion.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file django-tenancy-0.2.2.tar.gz.
File metadata
- Download URL: django-tenancy-0.2.2.tar.gz
- Upload date:
- Size: 40.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | e9f95b9450fb000b4ecf14894b998fea437df36e3492b7d20db6301756a70689 |
|
| MD5 | 2229fdb686e8dd7ec943b0d417723b77 |
|
| BLAKE2b-256 | 5f4528e183b481c6b0395a928bfc4c9296fc53ca3c7d8bc89a1d433339e61b42 |
File details
Details for the file django_tenancy-0.2.2-py2.py3-none-any.whl.
File metadata
- Download URL: django_tenancy-0.2.2-py2.py3-none-any.whl
- Upload date:
- Size: 27.8 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 7a3f626eecc0070f8f6817accec1e56d601b3081f8d7728693d4c8b958e20eec |
|
| MD5 | 4ec45891fc36bdc2f1bfc410fa878e97 |
|
| BLAKE2b-256 | 057ea5bf5fe2e0480d65f48d57a993a351dd0d715a64c12b02f68bcaa32413f1 |
