Drop support for Python 3.9 and Support for Python 3.14 (#233)

* Use uv

* Drop support for Python 3.9

* Support for Python 3.14

* fix uv sync --upgrade

* fix uv

Author: luolingchun

.github/workflows/docs.yml

@@ -13,11 +13,10 @@ jobs:
 
       - uses: astral-sh/setup-uv@v6
         with:
-          python-version: "3.x"
           enable-cache: true
 
       - name: Install dependencies
-        run: uv sync --group doc --all-extras
+        run: uv sync --upgrade --group doc --all-extras
 
       - name: Build docs
         run: |

.github/workflows/publish.yml

@@ -13,11 +13,10 @@ jobs:
 
       - uses: astral-sh/setup-uv@v6
         with:
-          python-version: "3.x"
           enable-cache: true
 
       - name: Install dependencies
-        run: uv sync --group build --all-extras
+        run: uv sync --upgrade --group build --all-extras
 
       - name: Build and publish
         env:

.github/workflows/tests.yml

@@ -22,7 +22,7 @@ jobs:
     strategy:
       max-parallel: 5
       matrix:
-        python-version: [ "3.9", "3.10", "3.11", "3.12", "3.13" ]
+        python-version: [ "3.10", "3.11", "3.12", "3.13", "3.14" ]
         flask-version: [ "Flask>=2.0,<3.0", "Flask>=3.0" ]
     env:
       PYTHONPATH: .
@@ -37,7 +37,7 @@ jobs:
 
       - name: Install dependencies
         run: |
-          uv sync --all-extras --all-groups
+          uv sync --upgrade --all-extras --all-groups
           uv add "${{ matrix.flask-version }}"
 
       - name: Test with pytest

CONTRIBUTING.md

@@ -10,7 +10,7 @@ Before submitting pr, you need to complete the following steps:
 1. Install requirements
 
     ```bash
-    uv sync --all-extras --all-groups
+    uv sync --upgrade --all-extras --all-groups
     ```
 
 2. Running the tests

README.md

@@ -37,7 +37,7 @@ The key features are:
 
 ## Requirements
 
-Python 3.9+
+Python 3.10+
 
 flask-openapi3 is dependent on the following libraries:
 
@@ -131,14 +131,12 @@ if __name__ == "__main__":
 <summary>Class-based API View Example</summary>
 
 ```python
-from typing import Optional
-
 from pydantic import BaseModel, Field
 
 from flask_openapi3 import OpenAPI, Tag, Info, APIView
 
 
-info = Info(title='book API', version='1.0.0')
+info = Info(title="book API", version="1.0.0")
 app = OpenAPI(__name__, info=info)
 
 api_view = APIView(url_prefix="/api/v1", view_tags=[Tag(name="book")])
@@ -149,12 +147,12 @@ class BookPath(BaseModel):
 
 
 class BookQuery(BaseModel):
-    age: Optional[int] = Field(None, description='Age')
+    age: int | None = Field(None, description="Age")
 
 
 class BookBody(BaseModel):
-    age: Optional[int] = Field(..., ge=2, le=4, description='Age')
-    author: str = Field(None, min_length=2, max_length=4, description='Author')
+    age: int | None = Field(..., ge=2, le=4, description="Age")
+    author: str = Field(None, min_length=2, max_length=4, description="Author")
 
 
 @api_view.route("/book")

docs/Example.md

@@ -6,18 +6,18 @@ from pydantic import BaseModel
 from flask_openapi3 import Info, Tag
 from flask_openapi3 import OpenAPI
 
-info = Info(title='book API', version='1.0.0')
+info = Info(title="book API", version="1.0.0")
 app = OpenAPI(__name__, info=info)
 
-book_tag = Tag(name='book', description='Some Book')
+book_tag = Tag(name="book", description="Some Book")
 
 
 class BookQuery(BaseModel):
     age: int
     author: str
 
 
-@app.get('/book', tags=[book_tag])
+@app.get("/book", tags=[book_tag])
 def get_book(query: BookQuery):
     """get books
     to get all books
@@ -32,23 +32,21 @@ def get_book(query: BookQuery):
     }
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     app.run(debug=True)
 ```
 
 ## REST Demo
 
 ```python
 from http import HTTPStatus
-from typing import Optional, List
-
 from pydantic import BaseModel, Field
 
 from flask_openapi3 import Info, Tag
 from flask_openapi3 import OpenAPI
 
 
-info = Info(title='book API', version='1.0.0')
+info = Info(title="book API", version="1.0.0")
 # Basic Authentication Sample
 basic = {
   "type": "http",
@@ -89,44 +87,44 @@ class NotFoundResponse(BaseModel):
 
 app = OpenAPI(__name__, info=info, security_schemes=security_schemes, responses={404: NotFoundResponse})
 
-book_tag = Tag(name='book', description='Some Book')
+book_tag = Tag(name="book", description="Some Book")
 security = [
     {"jwt": []},
     {"oauth2": ["write:pets", "read:pets"]}
 ]
 
 
 class BookPath(BaseModel):
-    bid: int = Field(..., description='book id')
+    bid: int = Field(..., description="book id")
 
 
 class BookQuery(BaseModel):
-    age: Optional[int] = Field(None, description='Age')
-    s_list: List[str] = Field(None, alias='s_list[]', description='some array')
+    age: int | None = Field(None, description="Age")
+    s_list: list[str] = Field(None, alias="s_list[]", description="some array")
 
 
 class BookBody(BaseModel):
-    age: Optional[int] = Field(..., ge=2, le=4, description='Age')
-    author: str = Field(None, min_length=2, max_length=4, description='Author')
+    age: int | None = Field(..., ge=2, le=4, description="Age")
+    author: str = Field(None, min_length=2, max_length=4, description="Author")
 
 
 class BookBodyWithID(BaseModel):
-    bid: int = Field(..., description='book id')
-    age: Optional[int] = Field(None, ge=2, le=4, description='Age')
-    author: str = Field(None, min_length=2, max_length=4, description='Author')
+    bid: int = Field(..., description="book id")
+    age: int | None = Field(None, ge=2, le=4, description="Age")
+    author: str = Field(None, min_length=2, max_length=4, description="Author")
 
 
 class BookResponse(BaseModel):
     code: int = Field(0, description="Status Code")
     message: str = Field("ok", description="Exception Information")
-    data: Optional[BookBodyWithID]
+    data: BookBodyWithID | None
 
 
 @app.get(
-    '/book/<int:bid>',
+    "/book/<int:bid>",
     tags=[book_tag],
-    summary='new summary',
-    description='new description',
+    summary="new summary",
+    description="new description",
     responses={200: BookResponse, 201: {"content": {"text/csv": {"schema": {"type": "string"}}}}},
     security=security
 )
@@ -137,11 +135,11 @@ def get_book(path: BookPath):
     """
     if path.bid == 4:
         return NotFoundResponse().dict(), 404
-    return {"code": 0, "message": "ok", "data": {"bid": path.bid, "age": 3, "author": 'no'}}
+    return {"code": 0, "message": "ok", "data": {"bid": path.bid, "age": 3, "author": "no"}}
 
 
 # set doc_ui False disable openapi UI
-@app.get('/book', doc_ui=True, deprecated=True)
+@app.get("/book", doc_ui=True, deprecated=True)
 def get_books(query: BookQuery):
     """get books
     to get all books
@@ -151,46 +149,44 @@ def get_books(query: BookQuery):
         "code": 0,
         "message": "ok",
         "data": [
-            {"bid": 1, "age": query.age, "author": 'a1'},
-            {"bid": 2, "age": query.age, "author": 'a2'}
+            {"bid": 1, "age": query.age, "author": "a1"},
+            {"bid": 2, "age": query.age, "author": "a2"}
         ]
     }
 
 
-@app.post('/book', tags=[book_tag], responses={200: BookResponse})
+@app.post("/book", tags=[book_tag], responses={200: BookResponse})
 def create_book(body: BookBody):
     print(body)
     return {"code": 0, "message": "ok"}, HTTPStatus.OK
 
 
-@app.put('/book/<int:bid>', tags=[book_tag])
+@app.put("/book/<int:bid>", tags=[book_tag])
 def update_book(path: BookPath, body: BookBody):
     print(path)
     print(body)
     return {"code": 0, "message": "ok"}
 
 
-@app.delete('/book/<int:bid>', tags=[book_tag], doc_ui=False)
+@app.delete("/book/<int:bid>", tags=[book_tag], doc_ui=False)
 def delete_book(path: BookPath):
     print(path)
     return {"code": 0, "message": "ok"}
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     app.run(debug=True)
 ```
 
 ## APIBlueprint
 
 ```python
-from typing import Optional
-
 from pydantic import BaseModel, Field
 
 from flask_openapi3 import APIBlueprint, OpenAPI
 from flask_openapi3 import Tag, Info
 
-info = Info(title='book API', version='1.0.0')
+info = Info(title="book API", version="1.0.0")
 
 jwt = {
     "type": "http",
@@ -201,7 +197,7 @@ security_schemes = {"jwt": jwt}
 
 app = OpenAPI(__name__, info=info, security_schemes=security_schemes)
 
-tag = Tag(name='book', description="Some Book")
+tag = Tag(name="book", description="Some Book")
 security = [{"jwt": []}]
 
 
@@ -211,9 +207,9 @@ class Unauthorized(BaseModel):
 
 
 api = APIBlueprint(
-    '/book',
+    "/book",
     __name__,
-    url_prefix='/api',
+    url_prefix="/api",
     abp_tags=[tag],
     abp_security=security,
     abp_responses={"401": Unauthorized},
@@ -223,26 +219,26 @@ api = APIBlueprint(
 
 
 class BookBody(BaseModel):
-    age: Optional[int] = Field(..., ge=2, le=4, description='Age')
-    author: str = Field(None, min_length=2, max_length=4, description='Author')
+    age: int | None = Field(..., ge=2, le=4, description="Age")
+    author: str = Field(None, min_length=2, max_length=4, description="Author")
 
 
 class Path(BaseModel):
-    bid: int = Field(..., description='book id')
+    bid: int = Field(..., description="book id")
 
 
-@api.get('/book', doc_ui=False)
+@api.get("/book", doc_ui=False)
 def get_book():
     return {"code": 0, "message": "ok"}
 
 
-@api.post('/book', responses={201: {"content": {"text/csv": {"schema": {"type": "string"}}}}})
+@api.post("/book", responses={201: {"content": {"text/csv": {"schema": {"type": "string"}}}}})
 def create_book(body: BookBody):
     assert body.age == 3
     return {"code": 0, "message": "ok"}
 
 
-@api.put('/book/<int:bid>')
+@api.put("/book/<int:bid>")
 def update_book(path: Path, body: BookBody):
     assert path.bid == 1
     assert body.age == 3
@@ -252,7 +248,7 @@ def update_book(path: Path, body: BookBody):
 # register api
 app.register_api(api)
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     app.run(debug=True)
 ```
 
@@ -271,15 +267,15 @@ class UploadFileForm(BaseModel):
     file_type: str = Field(None, description="File Type")
 
 
-@app.post('/upload')
+@app.post("/upload")
 def upload_file(form: UploadFileForm):
     print(form.file.filename)
     print(form.file_type)
-    form.file.save('test.jpg')
+    form.file.save("test.jpg")
     return {"code": 0, "message": "ok"}
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     app.run(debug=True)
 ```
 

docs/Usage/Model_Config.md

@@ -11,7 +11,7 @@ The `openapi_extra` will be merged with the automatically generated OpenAPI sche
 ```python
 class UploadFilesForm(BaseModel):
     file: FileStorage
-    str_list: List[str]
+    str_list: list[str]
 
     model_config = dict(
         openapi_extra={
@@ -82,7 +82,7 @@ You can use `reqiured` in `openapi_extra` to mark the RequestBody as Optional.
 
 ```python
 class PingBody(BaseModel):
-        ping: Optional[str] = Field("ok", description="String to return, 'ok' when null.")
+        ping: str | None = Field("ok", description="String to return, 'ok' when null.")
 
         model_config = dict(
             openapi_extra = {

docs/Usage/Request.md

@@ -36,7 +36,7 @@ like [path](#path), you need pass **`query`** to view function.
 
 ```python hl_lines="7"
 class BookQuery(BaseModel):
-    age: Optional[int] = Field(..., ge=2, le=4, description='Age')
+    age: int | None = Field(..., ge=2, le=4, description='Age')
     author: str = Field(None, min_length=2, max_length=4, description='Author')
 
 
@@ -66,7 +66,7 @@ Receive flask **`request.json`**.
 
 ```python hl_lines="7"
 class BookBody(BaseModel):
-    age: Optional[int] = Field(..., ge=2, le=4, description='Age')
+    age: int | None = Field(..., ge=2, le=4, description='Age')
     author: str = Field(None, min_length=2, max_length=4, description='Author')
 
 

docs/Usage/Response.md

@@ -5,7 +5,7 @@ If you want to generate **Schemas**, pass the **`responses`**.
 ```python hl_lines="13"
 class BookBodyWithID(BaseModel):
     bid: int = Field(..., description='book id')
-    age: Optional[int] = Field(None, ge=2, le=4, description='Age')
+    age: int | None = Field(None, ge=2, le=4, description='Age')
     author: str = Field(None, min_length=2, max_length=4, description='Author')