summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/howto/deployment/asgi/granian.txt37
-rw-r--r--docs/howto/deployment/asgi/index.txt1
-rw-r--r--docs/howto/deployment/wsgi/granian.txt37
-rw-r--r--docs/howto/deployment/wsgi/index.txt1
-rw-r--r--docs/spelling_wordlist1
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