fasthttp-client 1.2.2__tar.gz → 1.2.3__tar.gz

{fasthttp_client-1.2.2 → fasthttp_client-1.2.3}/.github/workflows/labeler.yml

@@ -21,5 +21,5 @@ jobs:
       - name: Run Labeler
         uses: actions/labeler@v6
         with:
-          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          repo-token: ${{ secrets.GH_TOKEN }}
           configuration-path: .github/labeler.yml

fasthttp_client-1.2.3/.github/workflows/welcome.yml

@@ -0,0 +1,59 @@
+name: Welcome Bot
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+
+permissions:
+  pull-requests: write
+
+jobs:
+  welcome:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Welcome contributor
+        uses: actions/github-script@v8
+        with:
+          script: |
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+            const prNumber = context.payload.pull_request.number;
+            const sender = context.payload.sender.login;
+            const marker = '<!-- welcome-bot -->';
+            
+            const message = `${marker}
+👋 # Thanks for your contribution, @${sender}!
+
+Please make sure:
+- Code is clean and formatted
+- Tests are passing
+- PR description is clear
+
+Maintainers will review it soon.
+`;
+            
+            const { data: comments } = await github.rest.issues.listComments({
+              owner,
+              repo,
+              issue_number: prNumber
+            });
+            
+            const existingComment = comments.find(comment => 
+              comment.body.includes(marker)
+            );
+            
+            if (existingComment) {
+              await github.rest.issues.updateComment({
+                owner,
+                repo,
+                comment_id: existingComment.id,
+                body: message
+              });
+            } else {
+              await github.rest.issues.createComment({
+                owner,
+                repo,
+                issue_number: prNumber,
+                body: message
+              });
+            }

{fasthttp_client-1.2.2 → fasthttp_client-1.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fasthttp-client
-Version: 1.2.2
+Version: 1.2.3
 Summary: Fast and simple HTTP client library with async support and beautiful logging
 Project-URL: Homepage, https://github.com/ndugram/fasthttp
 Project-URL: Documentation, https://github.com/ndugram/fasthttp
@@ -34,8 +34,11 @@ Requires-Dist: typer>=0.24.1
 Requires-Dist: uvicorn>=0.42.0
 Provides-Extra: dev
 Requires-Dist: aiohttp>=3.9.0; extra == 'dev'
+Requires-Dist: mkdocs-material>=9.5.0; extra == 'dev'
+Requires-Dist: mkdocs>=1.6.0; extra == 'dev'
 Requires-Dist: mypy>=1.13.0; extra == 'dev'
 Requires-Dist: pre-commit>=4.0.0; extra == 'dev'
+Requires-Dist: pymdown-extensions>=10.2; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
 Requires-Dist: pytest-codspeed>=4.3.0; extra == 'dev'
 Requires-Dist: pytest-cov>=6.0.0; extra == 'dev'

{fasthttp_client-1.2.2 → fasthttp_client-1.2.3}/docs/en/reference/response.md

@@ -11,6 +11,7 @@ Response object reference.
 | `headers` | `dict` | Response headers |
 | `content` | `bytes` | Raw bytes |
 | `method` | `str` | HTTP method |
+| `url` | `str` | Request URL |
 
 ## Methods
 
@@ -38,6 +39,46 @@ Get request body as text:
 sent = resp.req_text()  # Returns str or None
 ```
 
+### assets()
+
+Extract CSS and JavaScript asset URLs from HTML response:
+
+```python
+result = resp.assets()
+# Returns: {"css": [...], "js": [...]}
+```
+
+**Parameters:**
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `css` | `bool` | `True` | Include CSS links |
+| `js` | `bool` | `True` | Include JavaScript links |
+
+**Examples:**
+
+```python
+# Get all assets (CSS + JS)
+@app.get(url="https://example.com")
+async def handler(resp: Response):
+    return resp.assets()
+# Returns: {"css": ["https://example.com/style.css"], "js": ["https://example.com/app.js"]}
+
+# CSS only
+@app.get(url="https://example.com")
+async def handler(resp: Response):
+    return resp.assets(js=False)
+# Returns: {"css": [...], "js": []}
+
+# JS only
+@app.get(url="https://example.com")
+async def handler(resp: Response):
+    return resp.assets(css=False)
+# Returns: {"css": [], "js": [...]}
+```
+
+The method parses `<link rel="stylesheet" href="...">` for CSS and `<script src="...">` for JavaScript. All URLs are normalized using `urljoin`, so relative paths are converted to absolute URLs based on the request URL.
+
 ## Example
 
 ```python

{fasthttp_client-1.2.2 → fasthttp_client-1.2.3}/docs/en/tutorial/response-handling.md

@@ -61,6 +61,28 @@ Returns request body as text:
 sent = resp.req_text()  # Returns "raw data"
 ```
 
+### assets()
+
+Extracts CSS and JavaScript asset URLs from HTML page:
+
+```python
+# Get all assets
+result = resp.assets()
+# Returns: {"css": [...], "js": [...]}
+
+# CSS only
+css_only = resp.assets(js=False)
+
+# JS only
+js_only = resp.assets(css=False)
+```
+
+The method parses:
+- CSS: `<link rel="stylesheet" href="...">` tags
+- JS: `<script src="...">` tags
+
+All URLs are normalized relative to the request URL.
+
 ## Error Handling
 
 FastHTTP automatically handles errors and logs them:

fasthttp_client-1.2.3/docs/ru/reference/response.md

@@ -0,0 +1,86 @@
+# Класс Response
+
+Объект ответа.
+
+## Атрибуты
+
+| Атрибут | Тип | Описание |
+|---------|-----|----------|
+| `status` | `int` | Код статуса HTTP |
+| `text` | `str` | Сырое тело ответа |
+| `headers` | `dict` | Заголовки ответа |
+| `content` | `bytes` | Сырые байты |
+| `method` | `str` | HTTP метод |
+| `url` | `str` | URL запроса |
+
+## Методы
+
+### json()
+
+Преобразовать тело ответа в JSON:
+
+```python
+data = resp.json()  # Возвращает dict или list
+```
+
+### req_json()
+
+Получить JSON, отправленный с запросом:
+
+```python
+sent = resp.req_json()  # Возвращает dict или None
+```
+
+### assets()
+
+Извлечь URL-адреса CSS и JavaScript ресурсов из HTML-ответа:
+
+```python
+result = resp.assets()
+# Возвращает: {"css": [...], "js": [...]}
+```
+
+**Параметры:**
+
+| Параметр | Тип | По умолчанию | Описание |
+|----------|-----|--------------|----------|
+| `css` | `bool` | `True` | Включать ссылки CSS |
+| `js` | `bool` | `True` | Включать ссылки JavaScript |
+
+**Примеры:**
+
+```python
+# Получить все ресурсы (CSS + JS)
+@app.get(url="https://example.com")
+async def handler(resp: Response):
+    return resp.assets()
+# Возвращает: {"css": ["https://example.com/style.css"], "js": ["https://example.com/app.js"]}
+
+# Только CSS
+@app.get(url="https://example.com")
+async def handler(resp: Response):
+    return resp.assets(js=False)
+# Возвращает: {"css": [...], "js": []}
+
+# Только JS
+@app.get(url="https://example.com")
+async def handler(resp: Response):
+    return resp.assets(css=False)
+# Возвращает: {"css": [], "js": [...]}
+```
+
+Метод парсит `<link rel="stylesheet" href="...">` для CSS и `<script src="...">` для JavaScript. Все URL нормализуются через `urljoin`, поэтому относительные пути преобразуются в абсолютные на основе URL запроса.
+
+## Пример
+
+```python
+from fasthttp import FastHTTP
+from fasthttp.response import Response
+
+app = FastHTTP(debug=True)
+
+
+@app.get(url="https://api.example.com/data")
+async def handler(resp: Response) -> dict:
+    return {"status": resp.status, "data": resp.json(), "headers": resp.headers}
+```

{fasthttp_client-1.2.2 → fasthttp_client-1.2.3}/docs/ru/tutorial/response-handling.md

@@ -52,6 +52,28 @@ text = resp.text  # Возвращает str
 sent = resp.req_json()  # Возвращает {"name": "John"}
 ```
 
+### assets()
+
+Извлекает URL-адреса CSS и JavaScript ресурсов из HTML-страницы:
+
+```python
+# Получить все ресурсы
+result = resp.assets()
+# Returns: {"css": [...], "js": [...]}
+
+# Только CSS
+css_only = resp.assets(js=False)
+
+# Только JS
+js_only = resp.assets(css=False)
+```
+
+Метод парсит:
+- CSS: теги `<link rel="stylesheet" href="...">`
+- JS: теги `<script src="...">`
+
+Все ссылки нормализуются относительно URL запроса.
+
 ## Обработка ошибок
 
 FastHTTP автоматически обрабатывает ошибки:

fasthttp_client-1.2.3/examples/basic/extract_assets.py

@@ -0,0 +1,24 @@
+from fasthttp import FastHTTP
+from fasthttp.response import Response
+
+
+app = FastHTTP(debug=True)
+
+
+@app.get(url="https://example.com")
+async def get_assets(resp: Response) -> dict:
+    return resp.assets()
+
+
+@app.get(url="https://example.com")
+async def get_css_only(resp: Response) -> dict:
+    return resp.assets(js=False)
+
+
+@app.get(url="https://example.com")
+async def get_js_only(resp: Response) -> dict:
+    return resp.assets(css=False)
+
+
+if __name__ == "__main__":
+    app.run()

{fasthttp_client-1.2.2 → fasthttp_client-1.2.3}/fasthttp/__init__.py

@@ -1,3 +1,4 @@
+from . import status
 from .__meta__ import __version__
 from .app import FastHTTP
 from .dependencies import Depends
@@ -11,5 +12,6 @@ __all__ = (
     "FastHTTP",
     "MiddlewareManager",
     "Router",
-    "__version__"
+    "__version__",
+    "status",
 )

fasthttp_client-1.2.3/fasthttp/__meta__.py

@@ -0,0 +1 @@
+__version__ = "1.2.3"

{fasthttp_client-1.2.2 → fasthttp_client-1.2.3}/fasthttp/app.py

@@ -11,8 +11,13 @@ import httpx
 from annotated_doc import Doc
 
 from .client import HTTPClient
-from .helpers.routing import apply_base_url, check_annotated_parameters, check_annotated_return, check_https_url
 from .graphql.client import create_graphql_client
+from .helpers.route_inspect import (
+    check_annotated_parameters,
+    check_annotated_return,
+    validate_handler,
+)
+from .helpers.routing import apply_base_url, check_https_url
 from .logging import setup_logger
 from .middleware import BaseMiddleware, MiddlewareManager
 from .openapi.generator import generate_openapi_schema
@@ -469,8 +474,7 @@ class FastHTTP:
         responses: dict[int, dict[Literal["model"], type[BaseModel]]] | None = None,
     ) -> Callable[[Callable[..., object]], Callable[..., object]]:
         def decorator(func: Callable[..., object]) -> Callable[..., object]:
-            self._check_annotated_parameters(func=func)
-            self._check_annotated_func(func=func)
+            validate_handler(func=func)
 
             self.routes.append(
                 Route(
@@ -795,8 +799,7 @@ class FastHTTP:
         ```
         """
         def decorator(func: Callable[..., object]) -> Callable[..., object]:
-            self._check_annotated_parameters(func=func)
-            self._check_annotated_func(func=func)
+            validate_handler(func=func)
 
             async def graphql_handler(response: Response) -> object:
                 from inspect import iscoroutinefunction

{fasthttp_client-1.2.2 → fasthttp_client-1.2.3}/fasthttp/client.py

@@ -239,7 +239,7 @@ class HTTPClient:
         config: dict,
         response: httpx.Response
     ) -> Response:
-        return Response(
+        resp = Response(
             status=response.status_code,
             text=response.text,
             headers=dict(response.headers),
@@ -249,6 +249,8 @@ class HTTPClient:
             req_json=route.json,
             req_data=route.data,
         )
+        resp._set_url(route.url)
+        return resp
 
     async def _process_handler_result(
         self,
@@ -334,6 +336,7 @@ class HTTPClient:
                 headers={},
                 method=route.method,
             )
+            empty_response._set_url(route.url)
             handler_result = await route.handler(empty_response)
             return await self._process_handler_result(
                 empty_response,

fasthttp_client-1.2.3/fasthttp/helpers/route_inspect.py

@@ -0,0 +1,156 @@
+from __future__ import annotations
+
+import inspect
+from typing import TYPE_CHECKING, Any, Literal
+
+from pydantic import BaseModel
+
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
+
+
+# Route params type for HTTP methods
+RouteParams = dict[str, Any]
+
+
+def check_annotated_parameters(*, func: Callable[..., object]) -> None:
+    """
+    Validate that all function parameters have type annotations.
+
+    Args:
+        func: Target function to validate.
+
+    Raises:
+        TypeError: If any parameter does not have a type annotation.
+    """
+    sig = inspect.signature(func)
+    for name, param in sig.parameters.items():
+        if param.annotation is inspect.Parameter.empty:
+            msg = (
+                f"Parameter '{name}' in function '{func.__name__}' "
+                "must have a type annotation"
+            )
+            raise TypeError(msg)
+
+
+def check_annotated_return(*, func: Callable[..., object]) -> None:
+    """
+    Validate that a function has an explicit return type annotation.
+
+    Args:
+        func: Target function to validate.
+
+    Raises:
+        TypeError: If the function does not have a return type annotation.
+    """
+    sig = inspect.signature(func)
+    if sig.return_annotation is inspect.Signature.empty:
+        msg = (
+            f"Function '{func.__name__}' must explicitly "
+            "define return type annotation"
+        )
+        raise TypeError(msg)
+
+
+def validate_handler(func: Callable[..., object]) -> None:
+    """
+    Validate a handler function has proper type annotations.
+
+    Checks both parameters and return type annotations.
+
+    Args:
+        func: Handler function to validate.
+
+    Raises:
+        TypeError: If validation fails.
+    """
+    check_annotated_parameters(func=func)
+    check_annotated_return(func=func)
+
+
+# Common parameters for HTTP methods
+COMMON_PARAMS = {
+    "response_model": {
+        "type": type[BaseModel] | None,
+        "default": None,
+        "doc": "Optional Pydantic model for validating the handler result.",
+    },
+    "request_model": {
+        "type": type[BaseModel] | None,
+        "default": None,
+        "doc": "Optional Pydantic model for validating request data.",
+    },
+    "tags": {
+        "type": list[str] | None,
+        "default": None,
+        "doc": "Optional tags for grouping and filtering the route.",
+    },
+    "dependencies": {
+        "type": list | None,
+        "default": None,
+        "doc": "Optional dependencies executed before the request.",
+    },
+    "responses": {
+        "type": dict[int, dict[Literal["model"], type[BaseModel]]] | None,
+        "default": None,
+        "doc": "Optional response models for error status codes.",
+    },
+}
+
+
+def create_route_params(
+    *,
+    method: Literal["GET", "POST", "PUT", "PATCH", "DELETE"],
+    url: str,
+    params: dict | None = None,
+    json: dict | None = None,
+    data: object | None = None,
+    response_model: type[BaseModel] | None = None,
+    request_model: type[BaseModel] | None = None,
+    tags: list[str] | None = None,
+    dependencies: list | None = None,
+    skip_request: bool = False,
+    responses: dict[int, dict[Literal["model"], type[BaseModel]]] | None = None,
+) -> RouteParams:
+    """
+    Create a route parameters dictionary from common arguments.
+
+    Args:
+        method: HTTP method.
+        url: Target URL.
+        params: Query parameters.
+        json: JSON body.
+        data: Raw body.
+        response_model: Response model.
+        request_model: Request model.
+        tags: Route tags.
+        dependencies: Route dependencies.
+        skip_request: Skip HTTP request flag.
+        responses: Response models for status codes.
+
+    Returns:
+        Dictionary of route parameters.
+    """
+    return {
+        "method": method,
+        "url": url,
+        "params": params,
+        "json": json,
+        "data": data,
+        "response_model": response_model,
+        "request_model": request_model,
+        "tags": tags or [],
+        "dependencies": dependencies or [],
+        "skip_request": skip_request,
+        "responses": responses or {},
+    }
+
+
+__all__ = (
+    "COMMON_PARAMS",
+    "check_annotated_parameters",
+    "check_annotated_return",
+    "create_route_params",
+    "validate_handler",
+)

{fasthttp_client-1.2.2 → fasthttp_client-1.2.3}/fasthttp/helpers/routing.py

@@ -1,51 +1,7 @@
 from __future__ import annotations
 
-import inspect
-from typing import TYPE_CHECKING
 from urllib.parse import urljoin
 
-if TYPE_CHECKING:
-    from collections.abc import Callable
-
-
-def check_annotated_parameters(*, func: Callable[..., object]) -> None:
-    """
-    Validate that all function parameters have type annotations.
-
-    Args:
-        func: Target function to validate.
-
-    Raises:
-        TypeError: If any parameter does not have a type annotation.
-    """
-    sig = inspect.signature(func)
-    for name, param in sig.parameters.items():
-        if param.annotation is inspect.Parameter.empty:
-            msg = (
-                f"Parameter '{name}' in function '{func.__name__}'"
-                "must have a type annotation"
-            )
-            raise TypeError(msg)
-
-
-def check_annotated_return(*, func: Callable[..., object]) -> None:
-    """
-    Validate that a function has an explicit return type annotation.
-
-    Args:
-        func: Target function to validate.
-
-    Raises:
-        TypeError: If the function does not have a return type annotation.
-    """
-    sig = inspect.signature(func)
-    if sig.return_annotation is inspect.Signature.empty:
-        msg = (
-            f"Function '{func.__name__}' must explicitly"
-            "define return type annotation"
-        )
-        raise TypeError(msg)
-
 
 def check_https_url(*, url: str) -> str:
     """
@@ -149,8 +105,6 @@ def apply_base_url(*, url: str, base_url: str | None) -> str:
 
 __all__ = (
     "apply_base_url",
-    "check_annotated_parameters",
-    "check_annotated_return",
     "check_https_url",
     "join_prefix",
     "resolve_url",

{fasthttp_client-1.2.2 → fasthttp_client-1.2.3}/fasthttp/openapi/routes.py

@@ -7,7 +7,7 @@ import httpx
 from annotated_doc import Doc
 
 from fasthttp.response import Response
-
+from fasthttp import status
 from .generator import generate_openapi_schema
 from .swagger import get_swagger_html, get_not_found_html
 from .urls import build_docs_urls
@@ -38,7 +38,7 @@ async def handle_docs(
         request_url=urls["request_url"],
     )
     return Response(
-        status=200,
+        status=status.HTTP_200_OK,
         text=html,
         headers={"Content-Type": "text/html"},
     )
@@ -64,7 +64,7 @@ async def handle_openapi_json(
     schema = generate_openapi_schema(app, server_url=urls["request_url"])
     json_str = json.dumps(schema, indent=2, ensure_ascii=False)
     return Response(
-        status=200,
+        status=status.HTTP_200_OK,
         text=json_str,
         headers={"Content-Type": "application/json"},
     )
@@ -92,7 +92,7 @@ async def handle_not_found(
         openapi_url=urls["openapi_url"],
     )
     return Response(
-        status=404,
+        status=status.HTTP_404_NOT_FOUND,
         text=html,
         headers={"Content-Type": "text/html"},
     )
@@ -127,7 +127,7 @@ async def handle_request(
 
     if not url:
         return Response(
-            status=400,
+            status=status.HTTP_400_BAD_REQUEST,
             text=json.dumps({"error": "URL is required"}),
             headers={"Content-Type": "application/json"},
         )
@@ -160,26 +160,26 @@ async def handle_request(
                 pass
 
             return Response(
-                status=200,
+                status=status.HTTP_200_OK,
                 text=json.dumps(result, indent=2, ensure_ascii=False),
                 headers={"Content-Type": "application/json"},
             )
 
     except httpx.ConnectError as e:
         return Response(
-            status=502,
+            status=status.HTTP_502_BAD_GATEWAY,
             text=json.dumps({"error": f"Connection error: {str(e)}"}),
             headers={"Content-Type": "application/json"},
         )
     except httpx.TimeoutException as e:
         return Response(
-            status=504,
+            status=status.HTTP_504_GATEWAY_TIMEOUT,
             text=json.dumps({"error": f"Timeout: {str(e)}"}),
             headers={"Content-Type": "application/json"},
         )
     except Exception as e:
         return Response(
-            status=500,
+            status=status.HTTP_500_INTERNAL_SERVER_ERROR,
             text=json.dumps({"error": f"Request failed: {str(e)}"}),
             headers={"Content-Type": "application/json"},
         )