This release is a pre-release and may not be stable for production use.
django-modern-rpc
Embed an XML-RPC and/or JSON-RPC server in your Django project!
Main features
- XML-RPC and JSON-RPC 2.0 support (JSON-RPC 1.0 is NOT supported)
- Custom authentication
- Error handling
- Sync and async procedures
- Multiple entry-points
Requirements
The following Django / Python versions are supported, according to Django Installation FAQ
| Python ➞ | 3.8 | 3.9 | 3.10 | 3.11 | 3.12 | 3.13 | 3.14 |
|---|---|---|---|---|---|---|---|
| Django 3.2 | 🟢 | 🟢 | 🟢 | 🔴 | 🔴 | 🔴 | 🔴 |
| Django 4.0 | 🟢 | 🟢 | 🟢 | 🔴 | 🔴 | 🔴 | 🔴 |
| Django 4.1 | 🟢 | 🟢 | 🟢 | 🟢 | 🔴 | 🔴 | 🔴 |
| Django 4.2 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🔴 | 🔴 |
| Django 5.0 | 🔴 | 🔴 | 🟢 | 🟢 | 🟢 | 🔴 | 🔴 |
| Django 5.1 | 🔴 | 🔴 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
| Django 5.2 | 🔴 | 🔴 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
To enforce security, defusedxml will be installed as a dependency.
Quickstart
Install django-modern-rpc in your environment
pip install django-modern-rpc
Create an RpcServer instance and register your first procedure, in myapp/rpc.py
from modernrpc.server import RpcServer
server = RpcServer()
@server.register_procedure
def add(a: int, b: int) -> int:
"""Add two numbers and return the result.
:param a: First number
:param b: Second number
:return: Sum of a and b
"""
return a + b
Configure a path to allow RPC clients calling your procedures, in urls.py
from django.urls import path
from myapp.rpc import server
urlpatterns = [
# ... other url patterns
path('rpc/', server.view), # Synchronous view
]
The server's view is already configured with CSRF exemption and POST-only restrictions.
Code quality
The project uses nox as a task runner to launch tests suite against all supported Python / Django combinations and generate a coverage report file. Ruff is used to lint and format the codebase, and mypy is used to perform type checking.
All these tools are automatically run in various GitHub Actions workflows, and external tools are used to perform static code analysis and collect coverage results.
SonarQube
Codacy
Coveralls
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file django_modern_rpc-2.0a1.tar.gz.
File metadata
- Download URL: django_modern_rpc-2.0a1.tar.gz
- Upload date:
- Size: 28.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.8.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
efa73c4ba29bbd5824b3f7d19c2450f81a0dd1c94ef0072dea070dd74a43876e
|
|
| MD5 |
94aa3245b6cc4483c929c1a111f1af76
|
|
| BLAKE2b-256 |
1813fbaaeab3778f374ef9ac8a82872cff25b1a42e11780b8aac84816d6fd769
|
File details
Details for the file django_modern_rpc-2.0a1-py3-none-any.whl.
File metadata
- Download URL: django_modern_rpc-2.0a1-py3-none-any.whl
- Upload date:
- Size: 41.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.8.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1015200f17f96bd4bd4926a17d5e28f94fddd3137086744c77809b85d5fdde65
|
|
| MD5 |
37d981a1aa4647be14dadf59af01fd1e
|
|
| BLAKE2b-256 |
70332aa5b7ced4b07c35ed86d73170b78afd6427abd07275ba945db88591739c
|
