diff options
| author | JaeHyuck Sa <wogur981208@gmail.com> | 2025-12-19 10:15:45 +0900 |
|---|---|---|
| committer | Jacob Walls <jacobtylerwalls@gmail.com> | 2025-12-19 10:09:30 -0500 |
| commit | 60fecd1d445224fa00385f5f1fde75999da7bec8 (patch) | |
| tree | 6ad103434b776e29f5d5a3be8dc40ffb6a25df43 /docs | |
| parent | b172cbdf33c3eaea6a5c4a53da2ed0e46306a625 (diff) | |
Fixed #36781 -- Added Granian to deployment documentation.
Signed-off-by: JaeHyuck Sa <wogur981208@gmail.com>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/howto/deployment/asgi/granian.txt | 37 | ||||
| -rw-r--r-- | docs/howto/deployment/asgi/index.txt | 1 | ||||
| -rw-r--r-- | docs/howto/deployment/wsgi/granian.txt | 37 | ||||
| -rw-r--r-- | docs/howto/deployment/wsgi/index.txt | 1 | ||||
| -rw-r--r-- | docs/spelling_wordlist | 1 |
5 files changed, 77 insertions, 0 deletions
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 <Granian_>`_. 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 <Granian_>`_. 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 |
