Skip to main content

A Django app with new form fields for handling foreign relationships.

Project description

Django Foreign Fields

PyPI

Django Foreign Fields is a Django app that offers two new form fields that help handling foreign relationships in a easier way.

Quick start

bash pip install django-foreign-fields

Usage

Django-foreign-fields adds two new form fields ForeignField and TextAreaToManyField.

Fields

Both form fields need two new arguments: to and selector.

  • to: the target model of the relationship. Declaring the target model as the first parameter will automatically be detected as the to argument.

  • selector: the model field where the given value will be searched on.

ForeignField

Receives data and searches for an object in database that has that unique value on the given field. The object is stored as a ForeignKey.

TextAreaToManyField

Breaks all lines in a Textarea and use each one to find objects that correspond to each search. Each search must return a unique object, then, all objects are stored in a ManyToMany relationship.

Examples

ForeignField

Given you already have two models, one Target that holds some information and one Referrer that will make a foreign relationship to a particular field:

   class Target(models.Model):
      name = models.TextField()

   class Referrer(models.Model):
      foreign = models.ForeignKey()

It will be needed a new form for the Referrer.

The original form field that holds the foreign key relation on the Referrer will be substituted for the ForeignField:

   import foreign_fields.ForeignField

   class ReferrerForm(forms.ModelForm):
      foreign = foreign_fields.ForeignField(to=Target, selector='name')
      
      class Meta:
         model = Referrer

Now you can use the form on your View. The default widget is TextInput, so when you enter a string in the field and save the form, the ForeignField will search for a Target that has the given string in it's name field that must be unique. If the field is not unique, it will be given a ValidationError.

It's possible to change the foreign widget into others such as NumberInput or DateInput.

TextAreaToManyField

Given you already have two models, one Target that holds some information and one Referrer that will make a many to many relationship to a particular field:

   class Target(models.Model):
      name = models.TextField()

   class Referrer(models.Model):
      many_to_many = models.ManyToManyField()

It will be needed a new form for the Referrer.

The original form field that holds the many to many relation on the Referrer will be substituted for the TextAreaToManyField:

   import foreign_fields.TextAreaToManyField

   class ReferrerForm(forms.ModelForm):
      many_to_many = foreign_fields.TextAreaToManyField(to=Target, selector='name')
      
      class Meta:
           model = Referrer

Now you can use the form on your View. The default widget is Textarea, so when you enter a text in the field and save the form, the TextAreaToManyField will split each line and search for a unique Target by line that has the given string in it's name field. If the field is not unique, it will be given a ValidationError.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django_foreign_fields-0.3.2.tar.gz (5.6 kB view details)

Uploaded Source

Built Distribution

django_foreign_fields-0.3.2-py3-none-any.whl (6.8 kB view details)

Uploaded Python 3

File details

Details for the file django_foreign_fields-0.3.2.tar.gz.

File metadata

  • Download URL: django_foreign_fields-0.3.2.tar.gz
  • Upload date:
  • Size: 5.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.9.19

File hashes

Hashes for django_foreign_fields-0.3.2.tar.gz
Algorithm Hash digest
SHA256 710f36bfcbfd7fb2a807dae830978d0fe56416c9f13c5c10caf4413f6ff639ca
MD5 e35d59c2425f210b12bea426da474d48
BLAKE2b-256 5c97c43722d02472b17897451bee424844f123a4b57265946aaa42c4d19e439d

See more details on using hashes here.

File details

Details for the file django_foreign_fields-0.3.2-py3-none-any.whl.

File metadata

File hashes

Hashes for django_foreign_fields-0.3.2-py3-none-any.whl
Algorithm Hash digest
SHA256 f1880aafc897f1ccc7d1ac79ed0c7184fb50069fdd416fef8c694e42bf694ae1
MD5 db6b16d7e507129350504179bd8acb69
BLAKE2b-256 bd0be637d1cdd5e9234897baebf3b4ccbc287393ad4a52e88e2eac03c3998980

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page