UploadFile as alias to DataUpload (#353)

* UploadFile as alias to DataUpload
* Fix OpenAPI requestBody
* Update internals of directives
* Update docs

Author: tarsil

docs/en/docs/contrib/openapi.md

@@ -422,9 +422,7 @@ The `OpenAPIConfig` model encapsulates all settings that control how Lilya gener
 * **Description**: A longer, more detailed description for `info.description`. This field supports Markdown formatting and can cover architecture, usage notes, or any high‐level explanation.
 * **Type**: `str` (nullable)
 * **Default**: `"Yet another framework/toolkit that delivers."`
-* **Usage**:
-
-  * Renders in the expanded “Info” panel of Swagger UI or as introductory text in ReDoc.
+* **Usage**:  Renders in the expanded “Info” panel of Swagger UI or as introductory text in ReDoc.
 
 ---
 

docs/en/docs/directives/directives.md

@@ -122,11 +122,7 @@ You should have a folder called `myproject` with a similar structure to this:
 │   │   ├── __init__.py
 │   │   └── test_app.py
 │   └── urls.py
-└── requirements
-    ├── base.txt
-    ├── development.txt
-    └── testing.txt
-
+└── pyproject.toml
 ```
 
 A lot of files generated right? Yes but those are actually quite simple but let's talk about what is happening there.
@@ -136,7 +132,7 @@ peoject locally, for example:
     * `task run` - Starts your project with the development settings.
     * `make test` - Runs your local tests with the testing settings.
     * `task clean` - Removes all the `*.pyc` from your project.
-    * `task requirements` - Installs the mininum requirements from the `requirements` folder.
+    * `task requirements` - Installs the minimum requirements from the `pyproject.toml`.
 
     !!! Info
         The tests are using [pytest](https://docs.pytest.org/) but you can change to whatever you want.

docs/en/docs/release-notes.md

@@ -7,6 +7,16 @@ hide:
 
 ## 0.23.3
 
+### Added
+
+- `lilya.datastructures` now supports UploadFile as an alias to DataUpload.
+- `@openapi` decorator now accepts the `request_body` as parameter and fixes an issue of getting from responses.
+
+### Changed
+
+- Lilya now using the `createproject` directive instead of generating a requirements folder, generates a `pyproject.toml`
+instead. This follows the new Python requirements conventions.
+
 ### Fixed
 
 - `lilya createdeployment` directive files (nginx and docker) updated to the latest stable versions.

docs_src/openapi/examples/all_in.py

@@ -5,6 +5,7 @@
 from lilya.contrib.openapi.datastructures import OpenAPIResponse
 from pydantic import BaseModel
 
+
 # Pydantic models
 class Item(BaseModel):
     id: int
@@ -24,41 +25,46 @@ class Person(BaseModel):
         "limit": Query(default=5, schema={"type": "integer"}, description="Max items"),
         "tags": Query(
             default=[],
-            schema={"type":"array","items":{"type":"string"}},
+            schema={"type": "array", "items": {"type": "string"}},
             style="form",
             explode=True,
-            description="Tags filter"
-        )
+            description="Tags filter",
+        ),
     },
     responses={
         200: OpenAPIResponse(model=[Item], description="Array of Item"),
-        404: OpenAPIResponse(model=Person, description="User not found")
+        404: OpenAPIResponse(model=Person, description="User not found"),
     },
     tags=["items", "users"],
-    security=[{"BearerAuth": {"type": "http", "scheme": "bearer", "bearerFormat": "JWT"}}],
+    security=[
+        {"BearerAuth": {"type": "http", "scheme": "bearer", "bearerFormat": "JWT"}}
+    ],
 )
-async def list_user_items(request, user_id: str):
-    ...
+async def list_user_items(request, user_id: str): ...
 
 
-@openapi(summary="Create a new item")
-async def create_item(request, user_id: str):
-    ...
+@openapi(
+    summary="Create a new item",
+    request_body=Item,
+)
+async def create_item(request, user_id: str, item: Item): ...
 
 
 # Build app with nested includes and a child app
-child = ChildLilya(routes=[
-    Path("/profile", list_user_items)
-], enable_openapi=True)
+child = ChildLilya(routes=[Path("/profile", list_user_items)], enable_openapi=True)
 
 
-app = Lilya(routes=[
-    Include("/users", routes=[
-        Path("/{user_id}/items", list_user_items),
-        Path("/{user_id}/items/create", create_item),
-        Include("/extra", routes=[
-            Path("/{user_id}/extra-info", create_item)
-        ])
-    ]),
-    Include("/account", app=child)
-], enable_openapi=True)
+app = Lilya(
+    routes=[
+        Include(
+            "/users",
+            routes=[
+                Path("/{user_id}/items", list_user_items),
+                Path("/{user_id}/items/create", create_item),
+                Include("/extra", routes=[Path("/{user_id}/extra-info", create_item)]),
+            ],
+        ),
+        Include("/account", app=child),
+    ],
+    enable_openapi=True,
+)

docs_src/openapi/response_model_list.py

@@ -2,6 +2,7 @@
 from lilya.contrib.openapi.decorator import openapi
 from pydantic import BaseModel
 
+
 class Item(BaseModel):
     id: str
     name: str
@@ -10,8 +11,7 @@ class Item(BaseModel):
 
 @openapi(
     responses={
-        200: OpenAPIResponse(model=[Item], description="List of Person")
+        200: OpenAPIResponse(model=[Item], description="List of Person"),
     }
 )
-async def list_people(request):
-    ...
+async def list_people(): ...

docs_src/openapi/single_level.py

@@ -2,17 +2,19 @@
 from lilya.routing import Path, Include
 from lilya.contrib.openapi.decorator import openapi
 
+
 @openapi(summary="Leaf endpoint")
-async def leaf_handler(request):
+async def leaf_handler():
     return {"msg": "leaf"}
 
+
 app = Lilya(
     routes=[
         Include(
             "/nest",
             routes=[
-                Path("/leaf", leaf_handler)
-            ]
-        )
-    ]
+                Path("/leaf", leaf_handler),
+            ],
+        ),
+    ],
 )

lilya/_internal/_templates/project_template/Taskfile.yaml.e-tpl

@@ -17,7 +17,7 @@ tasks:
   requirements:
     desc: Install requirements
     cmds:
-      - pip install -r requirements/development.txt
+      - pip install -e .[dev,test]
 
   test:
     desc: Run the suite of tests

lilya/_internal/_templates/project_template/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "{{ project_name }}"
+version = "0.1.0"
+description = "Project generated via Lilya version: {{ lilya_version }}"
+requires-python = ">=3.14"
+dependencies = [
+  "lilya[standard]>={{ lilya_version }}",
+  "gunicorn",
+  "uvicorn"
+]
+
+[project.optional-dependencies]
+dev = [
+    "ruff>=0.15.0",
+]
+test = [
+  "pytest",
+  "pytest-cov",
+  "pytest-asyncio",
+  "anyio",
+  "coverage",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"
+asyncio_mode = "auto"