Bridgekeeper

Who would cross the Bridge of Death

must answer me these questions three,

ere the other side he see.

—The Bridgekeeper, Monty Python and the Holy Grail

Bridgekeeper is a permissions library for Django projects, where permissions are defined in your code, rather than in your database.

It’s heavily inspired by django-rules, but with one important difference: it works on QuerySets as well as individual model instances.

This means that you can efficiently show a list of all of the model instances that your user is allowed to edit, for instance, without having your permission-checking code in two different places.

Bridgekeeper is tested on Django 2.2 and 3.0 on all Python versions Django supports, and is licensed under the MIT License.

Tutorial

• Installing Bridgekeeper
• Defining permissions
  • Defining our first permission
  • Blanket rules
  • Matching against model instances
  • Traversing relationships
  • Combining rules together
• Using Permissions In Views
  • Filtering QuerySets
  • Class-Based Views
  • What next?

Guides

• Writing Rules and Permissions
  • Blanket Rules
• Checking Permissions
  • Checking Permissions on an Object
  • Checking Permissions on a QuerySet
  • Checking Permissions For All Possible Instances
  • Checking Permissions For Any Possible Instances
  • Permission Check Summary
  • Using permissions in views
• Django REST Framework integration
  • Installation
  • Permission Naming

Reference

• Rules
  • The Rule API
  • Built-in Blanket Rules
  • Rule Classes
  • Deprecated rule classes
  • Built-in rule instances
  • Extension Points (For Writing Your Own Rule Subclasses)
• Convenience Helpers
  • QuerySet and Manager Classes
  • View Mixins
• Django REST Framework integration
• Changelog
  • 0.9
  • 0.7
  • 0.5
  • 0.4
  • 0.3
  • 0.2

Indices and tables

• Index

• Module Index

• Search Page