Django styleguide used in HackSoft projects.

Expect often updates as we discuss & decide upon different things.

If you want to check an existing project showing most of the styleguide, check the Styleguide-Example

Table of contents:

• Overview
• Cookie Cutter
• Models
  • Custom validation
  • Properties
  • Methods
  • Testing
• Services
  • Naming convention
• Selectors
  • Naming convention
• APIs & Serializers
  • Naming convention
  • An example list API
  • An example detail API
  • An example create API
  • An example update API
  • Nested serializers
• Urls
• Exception Handling
  • Raising Exceptions in Services / Selectors
  • Handle Exceptions in APIs
  • Error formatting
• Testing
  • Naming conventions
  • Example
    • Example models
    • Example selectors
    • Example services
  • Testing services
  • Testing selectors
• Celery
  • Structure
    • Configuration
    • Tasks
  • Periodic Tasks
  • Configuration
• Misc
  • mypy / type annotations
• Inspiration

Overview

In Django, business logic should live in:

• Model properties (with some exceptions).
• Model clean method for additional validations (with some exceptions).
• Services - functions, that take care of writing to the database.
• Selectors…

DRF-EXTRA-FIELDS

Extra Fields for Django Rest Framework

Usage

Install the package

pip install django-extra-fields

Note:

• Install version 0.1 for Django Rest Framework 2.*
• Install version 0.3 or greater for Django Rest Framework 3.*

Fields:

Base64ImageField

An image representation for Base64ImageField

Inherited from ImageField

Signature: Base64ImageField()

• It takes a base64 image as a string.
• A base64 image: data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7
• Base64ImageField accepts the entire string or just the part after base64, R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7
• It takes the optional parameter represent_in_base64 (False by default), if set to True it will allow for base64-encoded downloads of an ImageField.
• You can inherit the Base64ImageField class and set allowed extensions (ALLOWED_TYPES list), or customize the validation messages (INVALID_FILE_MESSAGE, INVALID_TYPE_MESSAGE)

Example:

# serializer
from drf_extra_fields.fields import Base64ImageField
class UploadedBase64ImageSerializer(serializers.Serializer)
    file = Base64ImageField(required=False)
    created = serializers.DateTimeField()
# use the serializer

django-shapeshifter

A common problem in Django is how to have a view, especially a class-based view that can display and process multiple forms at once. django-shapeshifter aims to make this problem much more trivial.

Right now, django-shapeshifter can handle any (well, theoretically) number of forms in a single view. A view class is provided for multiple standard forms or model forms. To mix and match these form types, you'll need to do a little extra work. Here's how to use the package:

Installation

$ pip install django-shapeshifter

You should not need to add shapeshifter to your INSTALLED_APPS.

Usage

You use django-shapeshifter just like you use Django's built-in class-based views. You should be able to use the provided views with most mixins you're already using in your project, such as LoginRequiredMixin. Certain mixins may have to be refactored, such as SuccessMessageMixin, which is trigged on the form_valid() method.

…