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

{fasthttp_client-1.2.0 → fasthttp_client-1.2.2}/.github/workflows/release.yml

@@ -63,8 +63,7 @@ jobs:
           generate_release_notes: true
           draft: false
           prerelease: false
-        env:
-          GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
+          token: ${{ secrets.GH_TOKEN }}
 
       - name: Set up Python
         if: steps.tag_check.outputs.skip == 'false'

{fasthttp_client-1.2.0 → fasthttp_client-1.2.2}/.github/workflows/welcome.yml

@@ -17,6 +17,7 @@ jobs:
       - name: Welcome contributor
         uses: actions/github-script@v8
         with:
+          token: ${{ secrets.GH_TOKEN }}
           script: |
             const { issue, pull_request, sender } = context.payload;
             

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fasthttp-client
-Version: 1.2.0
+Version: 1.2.2
 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

{fasthttp_client-1.2.0 → fasthttp_client-1.2.2}/docs/en/reference/fasthttp.md

@@ -14,6 +14,7 @@ app = FastHTTP(
     security: bool = True,
     lifespan: Callable = None,
     middleware: list = [],
+    base_url: str = None,
     get_request: dict = {},
     post_request: dict = {},
     put_request: dict = {},
@@ -32,12 +33,24 @@ app = FastHTTP(
 | `security` | `bool` | `True` | Enable security |
 | `lifespan` | `Callable` | `None` | Startup/shutdown handler |
 | `middleware` | `list` | `[]` | Middleware list |
+| `base_url` | `str` | `None` | Default base URL for decorators and routers |
 | `get_request` | `dict` | `{}` | Default GET settings |
 | `post_request` | `dict` | `{}` | Default POST settings |
 | `put_request` | `dict` | `{}` | Default PUT settings |
 | `patch_request` | `dict` | `{}` | Default PATCH settings |
 | `delete_request` | `dict` | `{}` | Default DELETE settings |
 
+**base_url Usage:**
+
+```python
+app = FastHTTP(base_url="https://api.example.com")
+
+@app.get("/users")      # → https://api.example.com/users
+@app.post("/users")     # → https://api.example.com/users
+
+@app.get("https://other.com/api")  # → https://other.com/api (absolute URL)
+```
+
 ## Methods
 
 ### run()

{fasthttp_client-1.2.0 → fasthttp_client-1.2.2}/docs/en/tutorial/routers.md

@@ -182,7 +182,7 @@ from fasthttp import FastHTTP
 
 from src.clients.integrations import setup_integrations_router
 
-app = FastHTTP()
+app = FastHTTP(base_url="https://api.example.com")
 app.include_router(setup_integrations_router())
 ```
 
@@ -229,6 +229,44 @@ app.include_router(router, base_url="https://api.example.com")
 
 If no `base_url` is provided, FastHTTP raises `ValueError`.
 
+## base_url in FastHTTP Constructor
+
+You can set `base_url` directly in the `FastHTTP` constructor, and it will be applied to all decorators:
+
+```python
+from fasthttp import FastHTTP
+from fasthttp.response import Response
+
+app = FastHTTP(base_url="https://api.example.com")
+
+
+@app.get("/users")      # → https://api.example.com/users
+async def get_users(resp: Response) -> dict:
+    return resp.json()
+
+
+@app.post("/users")     # → https://api.example.com/users
+async def create_user(resp: Response) -> dict:
+    return resp.json()
+
+
+@app.graphql("/graphql")  # → https://api.example.com/graphql
+async def query(resp: Response) -> dict:
+    return {"query": "{ users { id } }"}
+```
+
+This works the same way for all decorators: `get`, `post`, `put`, `patch`, `delete`, and `graphql`.
+
+Absolute URLs are used as-is and ignore `base_url`:
+
+```python
+app = FastHTTP(base_url="https://api.example.com")
+
+@app.get("https://other.com/api")  # → https://other.com/api (base_url ignored)
+async def other_api(resp: Response) -> dict:
+    return resp.json()
+```
+
 ## When to Use Routers
 
 Use routers when your project has:

{fasthttp_client-1.2.0 → fasthttp_client-1.2.2}/docs/ru/reference/fasthttp.md

@@ -14,6 +14,7 @@ app = FastHTTP(
     security: bool = True,
     lifespan: Callable = None,
     middleware: list = [],
+    base_url: str = None,
     get_request: dict = {},
     post_request: dict = {},
     put_request: dict = {},
@@ -32,7 +33,23 @@ app = FastHTTP(
 | `security` | `bool` | `True` | Включить безопасность |
 | `lifespan` | `Callable` | `None` | Обработчик запуска/завершения |
 | `middleware` | `list` | `[]` | Список middleware |
+| `base_url` | `str` | `None` | Базовый URL для декораторов и роутеров |
 | `get_request` | `dict` | `{}` | Настройки GET |
+| `post_request` | `dict` | `{}` | Настройки POST |
+| `put_request` | `dict` | `{}` | Настройки PUT |
+| `patch_request` | `dict` | `{}` | Настройки PATCH |
+| `delete_request` | `dict` | `{}` | Настройки DELETE |
+
+**Использование base_url:**
+
+```python
+app = FastHTTP(base_url="https://api.example.com")
+
+@app.get("/users")      # → https://api.example.com/users
+@app.post("/users")     # → https://api.example.com/users
+
+@app.get("https://other.com/api")  # → https://other.com/api (абсолютный URL)
+```
 
 ## Методы
 

{fasthttp_client-1.2.0 → fasthttp_client-1.2.2}/docs/ru/tutorial/routers.md

@@ -186,7 +186,7 @@ from fasthttp import FastHTTP
 
 from src.clients.integrations import setup_integrations_router
 
-app = FastHTTP()
+app = FastHTTP(base_url="https://api.example.com")
 app.include_router(setup_integrations_router())
 ```
 
@@ -235,6 +235,45 @@ app.include_router(router, base_url="https://api.example.com")
 
 Если `base_url` не передан, FastHTTP выбросит `ValueError`.
 
+## base_url в конструкторе FastHTTP
+
+Можно указать `base_url` прямо в конструкторе `FastHTTP`, и он будет
+применяться ко всем декораторам:
+
+```python
+from fasthttp import FastHTTP
+from fasthttp.response import Response
+
+app = FastHTTP(base_url="https://api.example.com")
+
+
+@app.get("/users")      # → https://api.example.com/users
+async def get_users(resp: Response) -> dict:
+    return resp.json()
+
+
+@app.post("/users")     # → https://api.example.com/users
+async def create_user(resp: Response) -> dict:
+    return resp.json()
+
+
+@app.graphql("/graphql")  # → https://api.example.com/graphql
+async def query(resp: Response) -> dict:
+    return {"query": "{ users { id } }"}
+```
+
+Это работает для всех декораторов: `get`, `post`, `put`, `patch`, `delete` и `graphql`.
+
+Абсолютные URL используются как есть и игнорируют `base_url`:
+
+```python
+app = FastHTTP(base_url="https://api.example.com")
+
+@app.get("https://other.com/api")  # → https://other.com/api (base_url игнорируется)
+async def other_api(resp: Response) -> dict:
+    return resp.json()
+```
+
 ## Когда использовать роутеры
 
 Используйте роутеры, когда в проекте есть:

fasthttp_client-1.2.2/fasthttp/__meta__.py

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

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

@@ -1,7 +1,6 @@
 from __future__ import annotations
 
 import asyncio
-import inspect
 import json
 import secrets
 import time
@@ -12,7 +11,7 @@ import httpx
 from annotated_doc import Doc
 
 from .client import HTTPClient
-from .helpers.routing import check_annotated_parameters, check_annotated_return, check_https_url
+from .helpers.routing import apply_base_url, check_annotated_parameters, check_annotated_return, check_https_url
 from .graphql.client import create_graphql_client
 from .logging import setup_logger
 from .middleware import BaseMiddleware, MiddlewareManager
@@ -278,6 +277,26 @@ class FastHTTP:
             ),
         ] = "v4",
         base_url: Annotated[
+            str | None,
+            Doc(
+                """
+                Default base URL for requests.
+
+                This value is used by:
+                - Decorators (`@app.get`, `@app.post`, etc.) with relative paths
+                - GraphQL (`@app.graphql`) with relative paths
+                - `include_router()` when the router tree contains relative URLs
+
+                Example:
+                ```python
+                app = FastHTTP(base_url="https://api.example.com")
+
+                @app.get("/users")  # → https://api.example.com/users
+                ```
+                """
+            ),
+        ] = None,
+        docs_base_url: Annotated[
             str,
             Doc(
                 """
@@ -288,7 +307,7 @@ class FastHTTP:
 
                 Example:
                 ```python
-                app = FastHTTP(base_url="/api")
+                app = FastHTTP(docs_base_url="/api")
                 ```
                 """
             ),
@@ -300,6 +319,7 @@ class FastHTTP:
         self.lifespan = lifespan
         self.proxy = proxy
         self.base_url = base_url
+        self.docs_base_url = docs_base_url
         self.generate_startup_uuid = generate_startup_uuid
         self.startup_uuid_version = startup_uuid_version
 
@@ -431,6 +451,9 @@ class FastHTTP:
         """
         return check_https_url(url=url)
 
+    def _resolve_url(self, url: str) -> str:
+        return apply_base_url(url=url, base_url=self.base_url)
+
     def _add_route(
         self,
         *,
@@ -452,7 +475,7 @@ class FastHTTP:
             self.routes.append(
                 Route(
                     method=method,
-                    url=self._check_https_url(url=url),
+                    url=self._resolve_url(url),
                     handler=func,
                     params=params,
                     json=json,
@@ -550,9 +573,11 @@ class FastHTTP:
             tags: Tags prepended before router tags.
             dependencies: Dependencies prepended before router dependencies.
             base_url: Base URL override for the included router tree.
+                If not provided, `FastHTTP.base_url` will be used.
         """
+        resolved_base_url = base_url if base_url is not None else self.base_url
         routes = router.build_routes(
-            base_url=base_url,
+            base_url=resolved_base_url,
             prefix=prefix,
             tags=tags,
             dependencies=dependencies,
@@ -814,7 +839,7 @@ class FastHTTP:
             self.routes.append(
                 Route(
                     method="POST",
-                    url=url,
+                    url=self._resolve_url(url),
                     handler=graphql_handler,
                     tags=tags,
                     skip_request=True,
@@ -1028,17 +1053,17 @@ class FastHTTP:
             host: Host to bind to. Default is "127.0.0.1".
             port: Port to bind to. Default is 8000.
             base_url: Optional prefix for documentation endpoints.
-                If not provided, `FastHTTP.base_url` will be used.
+                If not provided, `FastHTTP.docs_base_url` will be used.
         """
         self.logger.info("FastHTTP started")
 
-        base_url = (
-            base_url if base_url is not None else self.base_url
+        docs_base_url = (
+            base_url if base_url is not None else self.docs_base_url
         )
-        app = ASGIApp(self, base_url=base_url)
+        app = ASGIApp(self, base_url=docs_base_url)
 
         server_base_url = f"http://{host}:{port}"
-        docs_urls = build_docs_urls(base_url)
+        docs_urls = build_docs_urls(docs_base_url)
 
         print(f"\n\033[92mfasthttp\033[0m running on \033[94m{server_base_url}\033[0m")
         print(

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

@@ -1,9 +1,12 @@
 from __future__ import annotations
 
 import inspect
-from collections.abc import Callable
+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:
     """
@@ -133,7 +136,19 @@ def resolve_url(*, url: str, base_url: str | None, prefix: str) -> str:
     return urljoin(base, path)
 
 
+def apply_base_url(*, url: str, base_url: str | None) -> str:
+    url = url.strip()
+    if url.startswith(("https://", "http://")):
+        return url
+
+    if base_url:
+        return check_https_url(url=f"{base_url.rstrip('/')}/{url.lstrip('/')}")
+
+    return check_https_url(url=url)
+
+
 __all__ = (
+    "apply_base_url",
     "check_annotated_parameters",
     "check_annotated_return",
     "check_https_url",

{fasthttp_client-1.2.0 → fasthttp_client-1.2.2}/pyproject.toml

@@ -10,7 +10,7 @@ exclude = ["/tests", "/docs", "/examples"]
 
 [project]
 name = "fasthttp-client"
-version = "1.2.0"
+version = "1.2.2"
 description = "Fast and simple HTTP client library with async support and beautiful logging"
 readme = "README.md"
 license = {text = "MIT"}

{fasthttp_client-1.2.0 → fasthttp_client-1.2.2}/tests/test_app.py

@@ -34,11 +34,17 @@ class TestFastHTTPApp:
         assert app.request_configs["GET"]["timeout"] == 60.0
         assert app.request_configs["POST"]["timeout"] == 120.0
 
-    def test_app_creation_with_docs_base_url(self) -> None:
+    def test_app_creation_with_base_url(self) -> None:
         """Test FastHTTP creation with base_url."""
-        app = FastHTTP(base_url="/api")
+        app = FastHTTP(base_url="https://example.com")
+
+        assert app.base_url == "https://example.com"
+
+    def test_app_creation_with_docs_base_url(self) -> None:
+        """Test FastHTTP creation with docs_base_url."""
+        app = FastHTTP(docs_base_url="/api")
 
-        assert app.base_url == "/api"
+        assert app.docs_base_url == "/api"
 
     def test_app_get_decorator(self) -> None:
         """Test GET decorator registers route."""
@@ -170,13 +176,26 @@ class TestFastHTTPApp:
         with pytest.raises(ValueError, match="Relative URL requires base_url"):
             app.include_router(router)
 
+    def test_app_include_router_uses_app_base_url_by_default(self) -> None:
+        app = FastHTTP(base_url="https://example.com")
+        router = Router(prefix="/v1")
+
+        @router.get("/me")
+        async def handler(resp: Response) -> dict:
+            return resp.json()
+
+        app.include_router(router)
+
+        assert len(app.routes) == 1
+        assert app.routes[0].url == "https://example.com/v1/me"
+
     @pytest.mark.asyncio
     async def test_asgi_handle_request_docs_uses_app_docs_base_url(self) -> None:
-        """Test ASGI docs path uses base_url from FastHTTP."""
+        """Test ASGI docs path uses docs_base_url from FastHTTP."""
         from fasthttp.app import ASGIApp
 
-        app = FastHTTP(base_url="/api")
-        asgi_app = ASGIApp(app, base_url=app.base_url)
+        app = FastHTTP(docs_base_url="/api")
+        asgi_app = ASGIApp(app, base_url=app.docs_base_url)
 
         scope = {"type": "http", "path": "/api/docs", "method": "GET"}
         receive = AsyncMock()

fasthttp_client-1.2.0/fasthttp/__meta__.py

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