carltongibson/django-filter

Features

• Query Parameter Filters - Translates URL query parameters into valid database query clauses using a declarative mapping system.
• Declarative Query Mappings - Translates URL parameters into database lookups using a class-based declarative syntax.
• Database Lookup Extensions - Provides a mechanism for implementing complex database filtering via custom lookups and relationship paths.
• Custom Database Lookups - Handles specialized lookups like relative time windows, magic values, or empty strings through custom methods.
• Content API Query Filters - Provides a system for refining API results by translating request parameters into database queries.
• Schema-Driven Filter Generation - Automatically creates filtering options by inspecting model field types and metadata at runtime.
• Model-Based Filter Generators - Automatically creates search filters and user-facing forms based on Django model field definitions.
• Custom Filter Callables - Executes custom methods to determine how a specific filter parameter modifies the resulting data set.
• Complex Querying Techniques - Supports advanced data retrieval logic through custom lookup methods and relationship paths beyond simple matches.
• Model-Based Filter Generation - Creates search filters automatically based on model field types while allowing specific field inclusions or exclusions.
• Model-Driven Filter Generation - Automatically generates a suite of search filters by inspecting model field types and metadata.
• Queryset Filtering Backends - Implements pluggable backends that constrain Django QuerySets based on parameters passed through the request URL.
• Queryset Filtering Tools - Modifies database query objects incrementally by applying lookup filters based on validated user input.
• Complex Query Filtering Logic - Uses custom callables or methods to filter data sets using complex lookups beyond simple field matches.
• Custom Filtering Methods - Allows the definition of custom callable methods to handle complex filtering logic beyond standard database lookups.
• API Query Filtering - Adds powerful search and filter capabilities to REST API endpoints for refined data retrieval.
• Dynamic Filtering - Injects dynamic arguments or custom behavior into the filtering process by overriding filter set initialization.
• Filter Form Customization - Allows customization of the filter interface and input validation by subclassing a dedicated form class.
• Data - Provides specialized filters that validate and match URL parameters against specific data types like booleans, UUIDs, and timestamps.
• Full Text Search - Integrates full-text search capabilities to scan multiple text fields for a specific term via a single filter input.
• Metadata Filtering - Extracts attributes from model field definitions to automatically populate descriptive labels and help text for filters.
• Null Value Filtering in Queries - Checks if a field is empty or null using boolean toggles or dedicated menu labels within database queries.
• Result Sorting - Orders the resulting data set based on specified fields, including computed values or non-model properties.
• Active Record Search Forms - Implements form-driven query building that allows users to interactively filter records via UI inputs.
• Filter Selection Interfaces - Creates a user interface for selecting specific filter criteria to refine and narrow down list results.
• Multi-Selection Filters - Restricts results to a predefined list of valid options supporting single or multiple selections and null matching.
• Table View Filtering - Provides generic views that apply model filters and render the resulting data through a template.
• Request Context Filtering - Enables filtering of results based on properties of the incoming request, including the authenticated user's identity.
• Factory Functions - Provides factory functions to dynamically instantiate filter sets, decoupling the logic from static class declarations.
• Request Context Injection - Integrates data from the current HTTP request object into filtering logic to restrict results by user identity.
• Filter Input Generation - Generates appropriate UI elements, such as range inputs and toggles, to capture user filtering criteria.
• Interactive Data Filter Forms - Automatically generates user-facing forms from model field definitions to enable interactive data filtering.
• Dynamic Filter Generators - Django Filter creates a filter set for a model using a factory function instead of a class declaration.
• Form Validation Engines - Uses a form layer to sanitize and validate URL parameters before passing them to the database engine.
• General Utilities - Filters QuerySets based on user-provided criteria.

Star history