Skip to main content

Handle django models drafts and published states

Project description

Django-brouillons

Handle "draft" and "public" versions of your models in Django ORM.

This module is still in a WIP version and should not be used in production if you don't know what you're doing. This modules aims to handle with a quite complex subject that requires that you add unit tests to your project to be absolutely sure that it does what you're expect in your specific cases. For now, we're aware that the module doesn't covers all of the cases of duplications of models tree, but we're hopping to increase them over the time.

It uses django-clone on the inside to duplicates django ORM models. We recommend that you start with understanding how django-clone works before diving into django-brouillons.

Pipeline badge Coverage badge Release badge

How it is working ?

Schema

Django-brouillons duplicates objects of a given model that aims to be moderated in two versions public and draft.

The draft version can then be published so that its values are updated in the public version.


Contributing

Feel free to send feedbacks on the module using it's Home page.

See CONTRIBUTING.md for contributions.


Install

  1. Install the module from PyPI:

    python3 -m pip install django-brouillons
    

    Or, if you're using poetry :

    poetry add django-brouillons
    
  2. Add it in your INSTALLED_APPS:

      "django_brouillons",
    

Config

In your models

  1. To handle draft and public status in a django model, inherit from the DraftModel class:

    from django_brouillons.models import DraftModel
    
    class DraftableObject(DraftModel):
      ...
    
  2. Then you need to configure the django-clone settings for the model, and that will describe what strategy should be adopted regarding model related fields (for Many to many, ForeignKey, OneToOne, ...)

    from django_brouillons.models import DraftModel
    
    class DraftableObject(DraftModel):
      _clone_m2o_or_o2m_fields = ["draftable_object_many_to_many2_through"]
      _clone_linked_m2m_fields = ["many_to_many_objects"]
    
    ...
    many_to_many_objects = models.ManyToManyField("DraftableObjectManyToMany")
    many_to_many_2_objects_through = models.ManyToManyField(
        "DraftableObjectManyToMany2",
        through="DraftableObjectManyToMany2Through",
        through_fields=("draftable_object", "draftable_object_many_to_many_2"),
    )
    
    

As an example, you can have a look at the test app models.

In this example, the following will be applied:

  • many_to_many_objects field : The m2m fields will reference the same related objects without duplicated the related objects
  • draftable_object_many_to_many2_through field : The related objects of the table designed as draftable_object_many_to_many2_through related name will be duplicated
  1. If your model contains some CharFields fields having unique=True they must be prefixed in the Draft version of the model, so that they remains unique between Public and Draft versions.

    This can be done filling the _draft_prefixed_fields attribute's of your model inheriting from the DraftModel abstract model :

    from django_brouillons.models import DraftModel
    
    class DraftableObject(DraftModel):
      _clone_m2o_or_o2m_fields = ["draftable_object_many_to_many2_through"]
      _clone_linked_m2m_fields = ["many_to_many_objects"]
      _draft_prefixed_fields = ["slug"]
    
      slug = models.SlugField(max_length=255, unique=True)
    

In this example, the DraftableObject contains a field slug that's unique.

Listing it in the _draft_prefixed_fields attribute indicates django-brouillons that the value must be prefixed with the value of the _draft_prefix attribute upon duplication in a draft.

In the admin

Django-brouillon provides admin integrations.

  1. Model admin can inherit from the DraftModelAdminMixin or the DraftModelAdmin :

      from django_brouillons.admin import DraftModelAdminMixin
      @admin.register(DraftableObject)  # Must be referenced to allow autocomplete
      class DraftableObjectAdmin(
          DraftModelAdmin
      ):
        pass
    

    Doing so, several buttons will be added to your admin model change's view :

    • Navigate between the Public and Draft versions of the objects in the admin
    • Publish a draft version of an object into a public version
    • Create a draft version of an object having only a public
  2. The DraftModelAdminMixin contains a PublishedChangesListFilter filter in its list_filter attribute that adds the the capability to filter objects having unpublished changes or not.

    This filter can manually be set in the list_filter if needed :

      from django_brouillons.admin import DraftModelAdminMixin, PublishedChangesListFilter
      @admin.register(DraftableObject)  # Must be referenced to allow autocomplete
      class DraftableObjectAdmin(
          DraftModelAdmin
      ):
        list_filter = (PublishedChangesListFilter,)
    

Model API

Django-brouillons provides the following in it's model attributes :

  • DraftableObject.is_public : Indicates if the current instance is public
  • DraftableObject.is_draft : Indicates if the current instance is draft
  • DraftableObject.has_public_version : Indicates if the current instance has a public version
  • DraftableObject.has_draft_version : Indicates if the current instance has a draft version
  • DraftableObject.has_unpublished_changes : Indicates if the current instance has pending unpublished changes
  • DraftableObject.create_draft() : Creates a draft from a public version
  • DraftableObject.publish_draft() : Publish changes of a draft version in a public version :
    • Creates and returns a new public_version if didn't exists
    • Updates and returns the public_version if already exists

Tests

Tests are located in the tests packages.

Tests are written with pytest. They are based on a testapp models :

Test app models schema

To run the tests, you must launch the command ./launch_tests.sh

A coverage report can be generated using the command ./run_coverage.sh

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_brouillons-0.0.4.tar.gz (25.6 kB view details)

Uploaded Source

Built Distribution

django_brouillons-0.0.4-py3-none-any.whl (26.5 kB view details)

Uploaded Python 3

File details

Details for the file django_brouillons-0.0.4.tar.gz.

File metadata

  • Download URL: django_brouillons-0.0.4.tar.gz
  • Upload date:
  • Size: 25.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.11.8

File hashes

Hashes for django_brouillons-0.0.4.tar.gz
Algorithm Hash digest
SHA256 38abbc4e1a76bf644ece5184ca6268b18fa970dda790928c8c54a24ba28b3f87
MD5 bc93652dbbe91416029c50f3117cafb5
BLAKE2b-256 e791c44e06171bb71d4cf956ec386dcd42102485b37767725d83232a142bb437

See more details on using hashes here.

File details

Details for the file django_brouillons-0.0.4-py3-none-any.whl.

File metadata

File hashes

Hashes for django_brouillons-0.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 6e147363af59c0ee908db910f9ceace04c1ac38c61e1b5c95655e7b1f3275494
MD5 8bdadd5a185fa67c451e127a8a2124a6
BLAKE2b-256 a27bbe2233eac1c0e00c2c443d42c6964a7ac3d5331beb541dab9096dfabaa0f

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