No project description provided
Project description
Django Reverse Admin
Module that makes django admin handle OneToOneFields in a better way. A common use case for one-to-one relationships is to "embed" a model inside another one. For example, a Person may have multiple foreign keys pointing to an Address entity, one home address, one business address and so on. Django admin displays those relations using select boxes, letting the user choose which address entity to connect to a person. A more natural way to handle the relationship is using inlines. However, since the foreign key is placed on the owning entity, django admins standard inline classes can't be used. Which is why I created this module that implements "reverse inlines" for this use case.
Fix/extension of:
Requirements
- Python: 3.4, 3.5, 3.6, 3.7
- Django: 2.0+
From version 2.0 onwards Django Reverse Admin is Python 3 only. If you need to support Python 2.7 use the version 1.0 release.
Installation
Install using pip:
pip install django_reverse_admin
Testing
Use tox
for testing.
tox
Testing Manually Using Django Admin
Run the following commands to make sure that db.sqlite3 has all the data that you need
cd tests
python manage.py makemigrations
python manage.py makemigrations polls
python manage.py migrate
python manage.py loaddata fixtures/init_data.json
python manage.py runserver
Admin user username is reverse
and password is reverseadmin
Usage
models.py
file
from django.db import models
class Address(models.Model):
street = models.CharField(max_length=255)
zipcode = models.CharField(max_length=10)
city = models.CharField(max_length=255)
state = models.CharField(max_length=2)
class Person(models.Model):
name = models.CharField(max_length=255)
business_addr = models.ForeignKey(Address,
related_name='business_addr')
home_addr = models.OneToOneField(Address, related_name='home_addr')
other_addr = models.OneToOneField(Address, related_name='other_addr')
admin.py
file
from django.contrib import admin
from django.db import models
from models import Person
from django_reverse_admin import ReverseModelAdmin
class PersonAdmin(ReverseModelAdmin):
inline_type = 'tabular'
inline_reverse = ['business_addr',
('home_addr', {'fields': ['street', 'city', 'state', 'zipcode']}),
]
admin.site.register(Person, PersonAdmin)
inline_type can be either "tabular" or "stacked" for tabular and stacked inlines respectively.
The module is designed to work with Django 2+ Since it hooks into the internals of the admin package, it may not work with later Django versions.
Demo
Below is what an admin change_view with reverse inline looks like
Below is what the same change_view would look like WITHOUT reverse inline
Contribtion
- Make sure that the tests are passing before opening up the PR
- Create a PR for feature enhancements
- Once a PR is merged, update version with the following commands:
bumpversion patch
git push origin master --tags
Packaging
tox
creates a package in .tox/dist
. Use twine to upload it to pypi:
twine upload .tox/dist/django_reverse_admin-*.zip
Project details
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.