mirror of
				https://github.com/django/django.git
				synced 2025-10-31 09:41:08 +00:00 
			
		
		
		
	[3.1.x] Added Hypercorn to ASGI deployment guide.
Backport of 1bd1264f2e from master
			
			
This commit is contained in:
		
				
					committed by
					
						 Carlton Gibson
						Carlton Gibson
					
				
			
			
				
	
			
			
			
						parent
						
							b81cdaf20d
						
					
				
				
					commit
					20ec568e46
				
			
							
								
								
									
										36
									
								
								docs/howto/deployment/asgi/hypercorn.txt
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										36
									
								
								docs/howto/deployment/asgi/hypercorn.txt
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,36 @@ | ||||
| ================================ | ||||
| How to use Django with Hypercorn | ||||
| ================================ | ||||
|  | ||||
| .. highlight:: bash | ||||
|  | ||||
| Hypercorn_ is an ASGI server that supports HTTP/1, HTTP/2, and HTTP/3 | ||||
| with an emphasis on protocol support. | ||||
|  | ||||
| Installing Hypercorn | ||||
| ==================== | ||||
|  | ||||
| You can install Hypercorn with ``pip``:: | ||||
|  | ||||
|     python -m pip install hypercorn | ||||
|  | ||||
| Running Django in Hypercorn | ||||
| =========================== | ||||
|  | ||||
| When Hypercorn is installed, a ``hypercorn`` command is available | ||||
| which runs ASGI applications. Hypercorn 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). | ||||
|  | ||||
| For a typical Django project, invoking Hypercorn would look like:: | ||||
|  | ||||
|     hypercorn myproject.asgi:application | ||||
|  | ||||
| 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 `Hypercorn documentation | ||||
| <Hypercorn_>`_. | ||||
|  | ||||
| .. _Hypercorn: https://pgjones.gitlab.io/hypercorn/ | ||||
| @@ -17,6 +17,7 @@ Django includes getting-started documentation for the following ASGI servers: | ||||
|    :maxdepth: 1 | ||||
|  | ||||
|    daphne | ||||
|    hypercorn | ||||
|    uvicorn | ||||
|  | ||||
| The ``application`` object | ||||
|   | ||||
		Reference in New Issue
	
	Block a user