# django-treebeard

django-treebeard is a library that implements efficient tree implementations for the Django Web Framework 1.7+, written by Gustavo Picón and licensed under the Apache License 2.0.

`django-treebeard` is:

- Flexible: Includes 3 different tree implementations with the same API:
  1. Adjacency List
  2. Materialized Path
  3. Nested Sets
- Fast: Optimized non-naive tree operations
- Easy: Uses Django’s model-inheritance with abstract-base-classes. to define your own models.
- Clean: Testable and well tested code base. Code/branch test coverage is above 96%.

## Overview

- Installation
  - Prerequisites
  - Installing
    - pip (or easy_install)
    - setup.py
    - .deb packages
  - Configuration
- Tutorial
- Known Caveats
  - Raw Queries
  - Overriding the default manager
  - Custom Managers

- Changelog

## Reference

- API
- Materialized Path trees
- Nested Sets trees
- Adjacency List trees
- Exceptions

## Additional features

- Admin
  - API
  - Interface
    - Advanced Interface
    - Basic Interface
    - Model Detail Pages
- Forms

## Development

- Running the Test Suite
  - py.test
  - tox

# Indices and tables

- Index
- Module Index
- Search Page