Skip to content

Commit 4a95083

Browse files
authored
Update documentation (#331)
* Update documentation * remove requirements
1 parent 93baf9c commit 4a95083

File tree

8 files changed

+142
-71
lines changed

8 files changed

+142
-71
lines changed

.codecov.yml

-11
This file was deleted.

README.md

-7
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,6 @@
33
<a href="https://pypi.org/project/mangum/">
44
<img src="https://badge.fury.io/py/mangum.svg" alt="Package version">
55
</a>
6-
<a href="https://travis-ci.org/jordaneremieff/mangum">
7-
<img src="https://travis-ci.org/jordaneremieff/mangum.svg?branch=master" alt="Build Status">
8-
</a>
96
<img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/mangum.svg?style=flat-square">
107

118
Mangum is an adapter for running [ASGI](https://asgi.readthedocs.io/en/latest/) applications in AWS Lambda to handle Function URL, API Gateway, ALB, and Lambda@Edge events.
@@ -24,10 +21,6 @@ Mangum is an adapter for running [ASGI](https://asgi.readthedocs.io/en/latest/)
2421

2522
- Startup and shutdown [lifespan](https://asgi.readthedocs.io/en/latest/specs/lifespan.html) events.
2623

27-
## Requirements
28-
29-
Python 3.7+
30-
3124
## Installation
3225

3326
```shell

docs/asgi-frameworks.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Frameworks
22

3-
Mangum is intended to provide support to any [ASGI](https://asgi.readthedocs.io/en/latest/) (*Asynchronous Server Gateway Interface*) application or framework. The ["turtles all the way down"](https://simonwillison.net/2009/May/19/djng/?#turtles-all-the-way-down) principle of ASGI allows for a great deal of interoperability across many different implementations, so the adapter should "just work"* for any ASGI application or framework.
3+
Mangum is intended to provide support to any [ASGI](https://asgi.readthedocs.io/en/latest/) (*Asynchronous Server Gateway Interface*) application or framework. The ["turtles all the way down"](https://simonwillison.net/2009/May/19/djng/?#turtles-all-the-way-down) principle of ASGI allows for a great deal of interoperability across many different implementations, so the adapter should "just work"* for any ASGI application or framework.
44

55
<small>* if it doesn't, then please open an [issue](https://github.com/erm/mangum/issues). :)</small>
66

@@ -75,7 +75,7 @@ handler = Mangum(app)
7575

7676
### FastAPI
7777

78-
[FastAPI](https://fastapi.tiangolo.com/) is a modern, fast (high-performance), web framework for building APIs with Python based on standard Python type hints.
78+
[FastAPI](https://fastapi.tiangolo.com/) is a modern, fast (high-performance), web framework for building APIs with Python based on standard Python type hints.
7979

8080
```python
8181
from fastapi import FastAPI
@@ -98,7 +98,7 @@ handler = Mangum(app)
9898

9999
### Responder
100100

101-
[Responder](https://responder.readthedocs.io/en/latest) is a familiar HTTP Service Framework for Python, powered by Starlette. The `static_dir` and `templates_dir` parameters must be set to none to disable Responder's automatic directory creation behaviour because AWS Lambda is a read-only file system - see the [limitations](https://mangum.io/asgi-frameworks/#limitations) section for more details.
101+
[Responder](https://responder.readthedocs.io/en/latest) is a familiar HTTP Service Framework for Python, powered by Starlette. The `static_dir` and `templates_dir` parameters must be set to none to disable Responder's automatic directory creation behaviour because AWS Lambda is a read-only file system - see the [limitations](#limitations) section for more details.
102102

103103
```python
104104
from mangum import Mangum
@@ -157,7 +157,7 @@ handler = Mangum(app)
157157

158158
### Django
159159

160-
[Django](https://docs.djangoproject.com/) is a high-level Python Web framework that encourages rapid development and clean, pragmatic design.
160+
[Django](https://docs.djangoproject.com/) is a high-level Python Web framework that encourages rapid development and clean, pragmatic design.
161161

162162
It started introducing ASGI support in version [3.0](https://docs.djangoproject.com/en/3.0/releases/3.0/#asgi-support). Certain async capabilities are not yet implemented and planned for future releases, however it can still be used with Mangum and other ASGI applications at the outer application level.
163163

docs/index.md

+1-8
Original file line numberDiff line numberDiff line change
@@ -3,14 +3,11 @@
33
<a href="https://pypi.org/project/mangum/">
44
<img src="https://badge.fury.io/py/mangum.svg" alt="Package version">
55
</a>
6-
<a href="https://travis-ci.org/jordaneremieff/mangum">
7-
<img src="https://travis-ci.org/jordaneremieff/mangum.svg?branch=master" alt="Build Status">
8-
</a>
96
<img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/mangum.svg?style=flat-square">
107

118
Mangum is an adapter for running [ASGI](https://asgi.readthedocs.io/en/latest/) applications in AWS Lambda to handle Function URL, API Gateway, ALB, and Lambda@Edge events.
129

13-
***Documentation***: https://mangum.fastapiexpert.com/
10+
***Documentation***: [https://mangum.fastapiexpert.com/]()
1411

1512
## Features
1613

@@ -24,10 +21,6 @@ Mangum is an adapter for running [ASGI](https://asgi.readthedocs.io/en/latest/)
2421

2522
- Startup and shutdown [lifespan](https://asgi.readthedocs.io/en/latest/specs/lifespan.html) events.
2623

27-
## Requirements
28-
29-
Python 3.7+
30-
3124
## Installation
3225

3326
```shell

mkdocs.yml

+11-3
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,10 @@ site_description: AWS Lambda & API Gateway support for ASGI
33
site_url: http://mangum.fastapiexpert.com
44

55
theme:
6-
name: "material"
6+
name: material
77
palette:
8-
primary: "brown"
9-
accent: "orange"
8+
primary: brown
9+
accent: orange
1010

1111
repo_name: Kludex/mangum
1212
repo_url: https://github.com/Kludex/mangum
@@ -25,3 +25,11 @@ markdown_extensions:
2525
- mkautodoc
2626
- markdown.extensions.codehilite:
2727
guess_lang: false
28+
- pymdownx.details
29+
- pymdownx.superfences
30+
- pymdownx.snippets
31+
- pymdownx.highlight:
32+
pygments_lang_class: true
33+
34+
plugins:
35+
- search

pyproject.toml

+3-2
Original file line numberDiff line numberDiff line change
@@ -40,8 +40,9 @@ dev-dependencies = [
4040
"mypy",
4141
"brotli",
4242
"brotli-asgi",
43-
"mkdocs",
44-
"mkdocs-material",
43+
"mkautodoc",
44+
"mkdocs>=1.6.0; python_version >= '3.12'",
45+
"mkdocs-material; python_version >= '3.12'",
4546
]
4647

4748
[project.urls]

scripts/docs

+5
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
#!/bin/sh -e
2+
3+
set -x # print executed commands to the terminal
4+
5+
uv run mkdocs serve

0 commit comments

Comments
 (0)