Django-MOJO

The Lightweight, Secure, and Extensible REST and Auth Framework for Django

Django-MOJO helps you rapidly build secure APIs and manage authentication in Django projects—without the usual boilerplate or complexity. It brings clarity and maintainability to your codebase, all while providing robust object-level security and powerful helper utilities for real-world development.

Why Django-MOJO?

Minimal Setup, Maximum Power: Expose Django models as RESTful APIs with a few lines of code. Add new features without touching central registries.
Object-Level Permissions: Move beyond Django’s traditional model-level permissions for fine-grained access control.
Secure by Default: Every endpoint and operation is permission-aware, designed to keep your data and users safe.
Simple Patterns & Helpers: Use concise decorators, built-in utilities (cron, crypto, logging, tasks), and keep codebases easy for teams to extend.
Effortless Testing: Built-in lightweight test framework for REST APIs—no external dependencies needed.

Core Workflow

Create Django Models:
Inherit from MojoModel and define a RestMeta inner class to configure permissions, default filters, and output graphs.
Register REST Endpoints:
Use decorators (@md.URL, @md.GET, etc.) to expose catch-all or method-specific API endpoints in your app’s rest/ directory.
Embrace Helpers:
Leverage and extend the extensive helpers in mojo/helpers/ for logging, cron, request parsing, redis, and more.
Test with Confidence:
Write and run tests using MOJO’s integrated “testit” system—both for APIs and backend logic.

Quick Example

models/group.py

from django.db import models
from mojo.models import MojoModel

class Group(models.Model, MojoModel):
    name = models.CharField(max_length=200)
    class RestMeta:
        VIEW_PERMS = ["view_groups"]
        SAVE_PERMS = ["manage_groups"]
        LIST_DEFAULT_FILTERS = {"is_active": True}
        GRAPHS = {
            "default": {"fields": ["id", "name", "created"]},
        }

rest/group.py

from mojo import decorators as md
from .models.group import Group

@md.URL('group')
@md.URL('group/<int:pk>')
def on_group(request, pk=None):
    return Group.on_rest_request(request, pk)

Project Structure

mojo/account/ – Authentication models, JWT middleware, and permissions
mojo/base/ – Core model/REST abstractions
mojo/helpers/ – Logging, crypto, cron, and other utilities
mojo/tasks/ – Redis-backed task scheduling and runner
mojo/testit/ – Lightweight test suite and REST client
docs/ – Area-focused detailed documentation

Documentation

Documentation is organized by audience:

Django Developer Reference

For developers building applications with django-mojo. Covers models, REST framework, helpers, and all built-in apps. Written for both human developers and AI agents (LLM-optimized).

Section	Description
Core	MojoModel, REST framework, decorators, middleware, serialization
Helpers	logit, dates, settings, crypto, request, redis, and other utilities
Account	User, Group, JWT authentication, permissions
Logging	Database logging, security incidents
Files	File upload, storage backends, renditions
Email	AWS SES email, templates, inbound handling
Jobs	Async task queue
Metrics	Redis-backed time-series metrics
Realtime	WebSocket pub/sub
PhoneHub	Phone number management and SMS
FileVault	Encrypted file vault
DocIt	Documentation/wiki system

REST API Reference

For web developers integrating with django-mojo APIs. Covers endpoints, authentication, filtering, and all app APIs.

Section	Description
Core	Authentication, request format, filtering, pagination, graphs
Account	Login, users, groups, API keys
Logging	Log queries, incident management
Files	File uploads, downloads
Email	Templates, mailboxes
Jobs	Job status
Metrics	Time-series metrics
Realtime	WebSocket protocol
PhoneHub	Phone lookup and normalization
FileVault	Encrypted file vault
DocIt	Documentation pages

Contributing

We welcome pull requests and issues! Contributions should follow our Developer Guide and maintain the framework’s philosophy: keep it simple, explicit, and secure.

License

Licensed under the Apache License v2.0. See the LICENSE file for details.

Release files for django-nativemojo 1.0.60

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for django-nativemojo 1.0.60
File	Size	Uploaded
django_nativemojo-1.0.60.tar.gz	576.3 kB	Mar 18, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for django-nativemojo 1.0.60
File	Interpreter	ABI	Platform	Reset
django_nativemojo-1.0.60-py3-none-any.whl 800.6 kB Mar 18, 2026	Python 3	none	any	Details

Total release size: 1.4 MB

Release files / django_nativemojo-1.0.60.tar.gz

Download URL	django_nativemojo-1.0.60.tar.gz
Size	576.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`e07916923c4ef45792797fbddd9c36103f698bed8dfeb95a884bab50ad332865`
BLAKE2b-256 checksum How to use checksums	`dd151d1a10073851b2eda8055cb2b7cee0cbe45009af023008a82660e1b81955`
Upload date	Mar 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.2.1 CPython/3.12.10 Darwin/24.6.0`

Release files / django_nativemojo-1.0.60-py3-none-any.whl

Download URL	django_nativemojo-1.0.60-py3-none-any.whl
Size	800.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3f6b55ae4bb0240b3ecba2df862a01b447f697dcc36ee015d95cd826acfa2d1f`
BLAKE2b-256 checksum How to use checksums	`977abcb3d1859e21ff349fb101b6636aad38aba319451f330cc083bb61d43fef`
Upload date	Mar 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.2.1 CPython/3.12.10 Darwin/24.6.0`