Skip to main content

Utilities for implementing Modified Preorder Tree Traversal with your Django Models and working with trees of Model instances.

Project description

Utilities for implementing Modified Preorder Tree Traversal with your Django Models and working with trees of Model instances.

Build Status

Project home: http://github.com/django-mptt/django-mptt/

Documentation: http://django-mptt.github.io/django-mptt/

Discussion group: http://groups.google.com/group/django-mptt-dev

What is Modified Preorder Tree Traversal?

MPTT is a technique for storing hierarchical data in a database. The aim is to make retrieval operations very efficient.

The trade-off for this efficiency is that performing inserts and moving items around the tree is more involved, as there’s some extra work required to keep the tree structure in a good state at all times.

Here are a few articles about MPTT to whet your appetite and provide details about how the technique itself works:

What is django-mptt?

django-mptt is a reusable Django app which aims to make it easy for you to use MPTT with your own Django models.

It takes care of the details of managing a database table as a tree structure and provides tools for working with trees of model instances.

Requirements

  • Python 2.7 or 3.2+

  • A supported version of Django (currently 1.8+)

Feature overview

  • Simple registration of models - fields required for tree structure will be added automatically.

  • The tree structure is automatically updated when you create or delete model instances, or change an instance’s parent.

  • Each level of the tree is automatically sorted by a field (or fields) of your choice.

  • New model methods are added to each registered model for:

    • changing position in the tree

    • retrieving ancestors, siblings, descendants

    • counting descendants

    • other tree-related operations

  • A TreeManager manager is added to all registered models. This provides methods to:

    • move nodes around a tree, or into a different tree

    • insert a node anywhere in a tree

    • rebuild the MPTT fields for the tree (useful when you do bulk updates outside of django)

  • Form fields for tree models.

  • Utility functions for tree models.

  • Template tags and filters for rendering trees.

  • Admin classes for visualizing and modifying trees in Django’s administration interface.

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-mptt-0.8.6.tar.gz (122.6 kB view details)

Uploaded Source

Built Distribution

django_mptt-0.8.6-py2.py3-none-any.whl (221.0 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file django-mptt-0.8.6.tar.gz.

File metadata

  • Download URL: django-mptt-0.8.6.tar.gz
  • Upload date:
  • Size: 122.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for django-mptt-0.8.6.tar.gz
Algorithm Hash digest
SHA256 30c0dd01e99e9c399c1d9857879c5c4a26e37c06a740e9824b965c3fc7ad45c5
MD5 a8f17fb2f4ac7d1bb119661e874bd758
BLAKE2b-256 c83d46fe58f62a0655628f85cb7c9e13518995459deb6cb515849ee59ab7e55e

See more details on using hashes here.

File details

Details for the file django_mptt-0.8.6-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for django_mptt-0.8.6-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 b4d6b50e036c0a6353f124406d3dbcbc42f449a2d5753c51c94bdd04feb9f7b2
MD5 d5ee94ca58b04fb7ae56272bb7e773f2
BLAKE2b-256 a0539753adb3ca98595e19c234905918b9167b08107fed5458802e68c77255d6

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