Fields

Commonly used fields
Django documentation

• BooleanField: This field stores a boolean value (True or False).

  species_is_archived = models.BooleanField("Species archived", default=False)

• CharField: This field stores a string of up to a specified length. There is no need to specify null=True for CharField and TextField as if left empty in a form, they will have an empty string.

  species_name = models.CharField("Species name", max_length=150)

• DateField: This field stores a date.

  fossil_date_acquired = models.DateField(default=timezone.now, blank=True, null=True)

• DateTimeField: This field stores a date and time.

  fossil_entry_created = models.DateTimeField(auto_now_add=True)

• DecimalField: This field stores a decimal number with a specified precision and scale.

  ossil_location_latitude = models.DecimalField("Latitude", max_digits=9, decimal_places=6, blank=True, null=True)

• DurationField: This field stores a duration of time.

  gathering_duration = models.DurationField("Duration", null=True, blank=True)

• EmailField: This field stores a valid email address.

  fossil_collector_email = models.EmailField("Collector email", max_length=254, blank=True, null=True)

• FileField: This field stores a file uploaded by the user.

  gathering_pdf = models.FileField("Upload PDF", upload_to='dosuments', null=True, blank=True, validators=[FileExtensionValidator(['pdf'])])

• ForeignKey: This field creates a many-to-one relationship between two models.

  event_owner = models.ForeignKey(User, on_delete=models.CASCADE, related_name='event_owner')

• ImageField: This field stores an image uploaded by the user.

  fossil_image = models.ImageField("Image", upload_to="images/", null=True, blank=True)

• ManyToManyField: This field creates a many-to-many relationship between two models.

  associated_fossils = models.ManyToManyField('self', verbose_name="Associated fossils", blank=True)

• SlugField: This field stores a short label for a URL.

  gathering_slug = models.SlugField("Your unique URL", unique=True)

• TextField: This field stores a large text value.

  fossil_lending_notes = models.TextField("Notes", blank=True)

• URLField: This field stores a valid URL.

  user_website = models.URLField("Website", max_length=200, blank=True, null=True)

• AutoField: This field automatically generates a unique integer ID for each record in the database.
• BigAutoField: This field automatically generates a unique 64-bit integer ID for each record in the database.
• FloatField: This field stores a floating-point number.
• IntegerField: This field stores an integer value.
• PositiveIntegerField: This field stores a positive integer value.
• PositiveSmallIntegerField: This field stores a positive small integer value.
• SmallIntegerField: This field stores a small integer value.
• TimeField: This field stores a time.

Commonly used field options

• null: If True, the field is allowed to have a NULL value in the database. If False, the field must have a value.
• blank: If True, the field is allowed to be left blank in forms. If False, the field must be filled out in forms.
• default: The default value for the field. This can be a constant value or a callable object that returns a value.
• primary_key: If True, the field is the primary key for the model. Only one field can be designated as the primary key.
• unique: If True, the field value must be unique for all instances of the model in the database. If False, duplicate values are allowed.
• editable: If False, the field is not editable in forms or the admin interface.
• choices: A list of choices for the field. Each choice is a tuple containing a value and a human-readable name.
• verbose_name: The human-readable name for the field. By default, Django will use the attribute name as the verbose name.
• help_text: Additional help text for the field, displayed in forms and the admin interface.
• db_index: If True, an index will be created on the field in the database for faster querying.
• db_column: The name of the database column to use for the field. By default, Django will use the attribute name as the column name.
• db_tablespace: The name of the database tablespace to use for the field.
• db_collation: The collation to use for the field in the database.
• db_constraint: If False, no database constraint will be created for the field.
• validators: A list of validators to apply to the field. Each validator is a callable object that takes a value and raises a ValidationError if the value is invalid.