From 60fecd1d445224fa00385f5f1fde75999da7bec8 Mon Sep 17 00:00:00 2001 From: JaeHyuck Sa Date: Fri, 19 Dec 2025 10:15:45 +0900 Subject: Fixed #36781 -- Added Granian to deployment documentation. Signed-off-by: JaeHyuck Sa --- docs/howto/deployment/asgi/granian.txt | 37 ++++++++++++++++++++++++++++++++++ docs/howto/deployment/asgi/index.txt | 1 + docs/howto/deployment/wsgi/granian.txt | 37 ++++++++++++++++++++++++++++++++++ docs/howto/deployment/wsgi/index.txt | 1 + docs/spelling_wordlist | 1 + 5 files changed, 77 insertions(+) create mode 100644 docs/howto/deployment/asgi/granian.txt create mode 100644 docs/howto/deployment/wsgi/granian.txt (limited to 'docs') diff --git a/docs/howto/deployment/asgi/granian.txt b/docs/howto/deployment/asgi/granian.txt new file mode 100644 index 0000000000..e16e9d8103 --- /dev/null +++ b/docs/howto/deployment/asgi/granian.txt @@ -0,0 +1,37 @@ +============================== +How to use Django with Granian +============================== + +Granian_ is a Rust-based high-performance HTTP server for Python applications, +supporting ASGI and WSGI interfaces. + +.. _Granian: https://github.com/emmett-framework/granian + +Installing Granian +================== + +You can install Granian with ``pip``: + +.. code-block:: shell + + python -m pip install granian + +Running Django in Granian +========================= + +When Granian is installed, a ``granian`` command is available which runs ASGI +applications. Granian needs to be called with the location of a module +containing an ASGI application object, followed by what the application is +called (separated by a colon), using the ``--interface asgi`` option. + +For a typical Django project, invoking Granian would look like: + +.. code-block:: shell + + granian myproject.asgi:application --interface asgi + +This will start one process listening on ``127.0.0.1:8000``. It requires that +your project be on the Python path; to ensure that, run this command from the +same directory as your ``manage.py`` file. + +For more advanced usage, please read the `Granian documentation `_. diff --git a/docs/howto/deployment/asgi/index.txt b/docs/howto/deployment/asgi/index.txt index 6015554350..9bead6cc3b 100644 --- a/docs/howto/deployment/asgi/index.txt +++ b/docs/howto/deployment/asgi/index.txt @@ -17,6 +17,7 @@ Django includes getting-started documentation for the following ASGI servers: :maxdepth: 1 daphne + granian hypercorn uvicorn diff --git a/docs/howto/deployment/wsgi/granian.txt b/docs/howto/deployment/wsgi/granian.txt new file mode 100644 index 0000000000..2252ed0109 --- /dev/null +++ b/docs/howto/deployment/wsgi/granian.txt @@ -0,0 +1,37 @@ +============================== +How to use Django with Granian +============================== + +Granian_ is a Rust-based high-performance HTTP server for Python applications, +supporting ASGI and WSGI interfaces. + +.. _Granian: https://github.com/emmett-framework/granian + +Installing Granian +================== + +You can install Granian with ``pip``: + +.. code-block:: shell + + python -m pip install granian + +Running Django in Granian +========================= + +When Granian is installed, a ``granian`` command is available which runs WSGI +applications. Granian needs to be called with the location of a module +containing a WSGI application object named ``application``, using the +``--interface wsgi`` option. + +For a typical Django project, invoking Granian would look like: + +.. code-block:: shell + + granian myproject.wsgi:application --interface wsgi + +This will start one process listening on ``127.0.0.1:8000``. It requires that +your project be on the Python path; to ensure that, run this command from the +same directory as your ``manage.py`` file. + +For more advanced usage, please read the `Granian documentation `_. diff --git a/docs/howto/deployment/wsgi/index.txt b/docs/howto/deployment/wsgi/index.txt index 0d3b0cd220..5284400fbd 100644 --- a/docs/howto/deployment/wsgi/index.txt +++ b/docs/howto/deployment/wsgi/index.txt @@ -16,6 +16,7 @@ Django includes getting-started documentation for the following WSGI servers: .. toctree:: :maxdepth: 1 + granian gunicorn uwsgi modwsgi diff --git a/docs/spelling_wordlist b/docs/spelling_wordlist index b35c94fc10..7e1b147d01 100644 --- a/docs/spelling_wordlist +++ b/docs/spelling_wordlist @@ -191,6 +191,7 @@ gis GiST Googol Greenhill +Granian gunicorn GZip gzipped -- cgit v1.3