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

{fasthttp_client-1.2.2 → fasthttp_client-1.2.4}/.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.4/.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.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fasthttp-client
-Version: 1.2.2
+Version: 1.2.4
 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.4}/docs/en/cli.md

@@ -267,6 +267,75 @@ clear             # clear screen
 exit              # exit REPL
 ```
 
+## Running Application Files
+
+FastHTTP CLI provides two commands to run your application files directly.
+
+### Run Mode — Execute Requests
+
+Run your FastHTTP app in request mode. Executes all registered HTTP requests and displays results:
+
+```bash
+fasthttp run main.py
+```
+
+With tag filtering:
+
+```bash
+fasthttp run main.py --tags api,users
+```
+
+Enable debug mode:
+
+```bash
+fasthttp run main.py --debug
+```
+
+Options:
+- `-t, --tags` — Run only routes with specific tags (comma-separated)
+- `-d, --debug` — Enable debug mode
+
+### Dev Mode — Development Server
+
+Run your FastHTTP app with an interactive Swagger UI for testing requests:
+
+```bash
+fasthttp dev main.py
+```
+
+With custom host and port:
+
+```bash
+fasthttp dev main.py --host 0.0.0.0 --port 3000
+```
+
+With base URL for documentation:
+
+```bash
+fasthttp dev main.py --base-url /api
+```
+
+Enable debug mode:
+
+```bash
+fasthttp dev main.py --debug
+```
+
+Options:
+- `-h, --host` — Host to bind the server to (default: 127.0.0.1)
+- `-p, --port` — Port to bind the server to (default: 8000)
+- `-b, --base-url` — Base URL prefix for documentation endpoints
+- `-d, --debug` — Enable debug mode
+
+Example output:
+
+```
+▲ FastHTTP dev server
+➜  Server:   http://127.0.0.1:8000
+➜  Docs:     http://127.0.0.1:8000/docs
+─────────────────────────────────
+```
+
 ## See Also
 
 - [Quick Start](quick-start.md) — basics

{fasthttp_client-1.2.2 → fasthttp_client-1.2.4}/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.4}/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.2 → fasthttp_client-1.2.4}/docs/ru/cli.md

@@ -103,17 +103,9 @@ fasthttp get https://api.example.com/data --debug
 - JSON/data тело
 - Заголовки ответа
 
-## Формат вывода
-
-Второй аргумент после URL определяет что вывести:
-
-### status — только статус (по умолчанию)
-
 ### Прокси (-p, --proxy)
 
 ```bash
-fasthttp get https://api.example.com/data status
-# 200
 # HTTP прокси
 fasthttp get https://api.example.com/data -p "http://proxy.example.com:8080"
 
@@ -127,8 +119,6 @@ fasthttp get https://api.example.com/data -p "socks5://proxy.example.com:1080"
 fasthttp get https://api.example.com/data -p "http://user:password@proxy.example.com:8080"
 ```
 
-### json — JSON тело ответа
-
 ## Формат вывода
 
 Второй аргумент после URL определяет что вывести:
@@ -136,62 +126,34 @@ fasthttp get https://api.example.com/data -p "http://user:password@proxy.example
 ### status — только статус (по умолчанию)
 
 ```bash
-fasthttp get https://api.example.com/data json
-# {"id": 1, "name": "John"}
 fasthttp get https://api.example.com/data status
 # 200
 ```
 
-### text — текст ответа
-
 ### json — JSON тело ответа
 
 ```bash
-fasthttp get https://api.example.com/data text
-# <html>...</html>
 fasthttp get https://api.example.com/data json
 # {"id": 1, "name": "John"}
 ```
 
-### headers — заголовки ответа
-
 ### text — текст ответа
 
 ```bash
-fasthttp get https://api.example.com/data headers
-# {"Content-Type": "application/json", "Date": "..."}
 fasthttp get https://api.example.com/data text
 # <html>...</html>
 ```
 
-### all — всё вместе
-
 ### headers — заголовки ответа
 
 ```bash
-fasthttp get https://api.example.com/data all
-# Status: 200
-# Elapsed: 234.56ms
-# Headers: {...}
-# Body: {...}
 fasthttp get https://api.example.com/data headers
 # {"Content-Type": "application/json", "Date": "..."}
 ```
 
-## Примеры
-
-### Простой GET
-
 ### all — всё вместе
 
 ```bash
-$ fasthttp get https://jsonplaceholder.typicode.com/posts/1 json
-{
-  "userId": 1,
-  "id": 1,
-  "title": "sunt aut facere repellat provident occaecati",
-  "body": "..."
-}
 fasthttp get https://api.example.com/data all
 # Status: 200
 # Elapsed: 234.56ms
@@ -199,41 +161,26 @@ fasthttp get https://api.example.com/data all
 # Body: {...}
 ```
 
-### POST с JSON
-
 ## Примеры
 
 ### Простой GET
 
 ```bash
-$ fasthttp post https://jsonplaceholder.typicode.com/posts \
-  --json '{"title": "foo", "body": "bar", "userId": 1}' json
 $ fasthttp get https://jsonplaceholder.typicode.com/posts/1 json
 {
-  "title": "foo",
-  "body": "bar",
   "userId": 1,
-  "id": 101
   "id": 1,
   "title": "sunt aut facere repellat provident occaecati",
   "body": "..."
 }
 ```
 
-### С заголовками
-
 ### POST с JSON
 
 ```bash
-$ fasthttp get https://httpbin.org/headers \
-  -H "Authorization: Bearer test-token" json
 $ fasthttp post https://jsonplaceholder.typicode.com/posts \
   --json '{"title": "foo", "body": "bar", "userId": 1}' json
 {
-  "headers": {
-    "Authorization": "Bearer test-token",
-    "Host": "httpbin.org"
-  }
   "title": "foo",
   "body": "bar",
   "userId": 1,
@@ -241,17 +188,9 @@ $ fasthttp post https://jsonplaceholder.typicode.com/posts \
 }
 ```
 
-### С отладкой
-
 ### С заголовками
 
 ```bash
-$ fasthttp get https://httpbin.org/get --debug
-ℹ → GET https://httpbin.org/get
-✔ HTTP 200 in 234.56ms
-ℹ ← Response headers:
-ℹ   Content-Type: application/json
-ℹ   Date: Mon, 15 Jan 2025 10:30:00 GMT
 $ fasthttp get https://httpbin.org/headers \
   -H "Authorization: Bearer test-token" json
 {
@@ -262,14 +201,9 @@ $ fasthttp get https://httpbin.org/headers \
 }
 ```
 
-### Проверить статус API
-
 ### С отладкой
 
 ```bash
-$ fasthttp get https://api.example.com/health
-✔ HTTP 200 in 45.23ms
-200
 $ fasthttp get https://httpbin.org/get --debug
 ℹ → GET https://httpbin.org/get
 ✔ HTTP 200 in 234.56ms
@@ -278,25 +212,130 @@ $ fasthttp get https://httpbin.org/get --debug
 ℹ   Date: Mon, 15 Jan 2025 10:30:00 GMT
 ```
 
-## Справка
-
 ### Проверить статус API
 
 ```bash
-fasthttp --help
-fasthttp get --help
-fasthttp post --help
 $ fasthttp get https://api.example.com/health
 ✔ HTTP 200 in 45.23ms
 200
 ```
 
+## Интерактивный REPL
+
+Запуск интерактивного режима:
+
+```bash
+fasthttp repl
+```
+
+С прокси:
+
+```bash
+fasthttp repl -p "http://proxy:8080"
+```
+
+### Команды REPL
+
+```bash
+# Выполнение запросов
+get https://api.example.com/data
+post https://api.example.com/users -j '{"name": "John"}'
+g https://api.example.com/data          # сокращение для GET
+p https://api.example.com/users         # сокращение для POST
+
+# Опции
+-H "Key:Value"    # заголовки
+-j '{"json": 1}'  # JSON тело
+-d "data"         # form данные
+-t 30             # таймаут
+-o json           # формат вывода
+-p "proxy"        # URL прокси
+
+# Специальные команды
+help              # показать справку
+history           # показать историю команд
+last              # показать последний ответ
+clear             # очистить экран
+exit              # выйти из REPL
+```
+
+## Запуск файлов приложения
+
+FastHTTP CLI предоставляет две команды для запуска файлов приложения напрямую.
+
+### Режим run — Выполнение запросов
+
+Запустите ваше FastHTTP приложение в режиме выполнения запросов:
+
+```bash
+fasthttp run main.py
+```
+
+С фильтрацией по тегам:
+
+```bash
+fasthttp run main.py --tags api,users
+```
+
+Включить режим отладки:
+
+```bash
+fasthttp run main.py --debug
+```
+
+Опции:
+- `-t, --tags` — Запустить только маршруты с определёнными тегами (через запятую)
+- `-d, --debug` — Включить режим отладки
+
+### Режим dev — Сервер разработки
+
+Запустите ваше FastHTTP приложение с интерактивным Swagger UI для тестирования запросов:
+
+```bash
+fasthttp dev main.py
+```
+
+С кастомным хостом и портом:
+
+```bash
+fasthttp dev main.py --host 0.0.0.0 --port 3000
+```
+
+С базовым URL для документации:
+
+```bash
+fasthttp dev main.py --base-url /api
+```
+
+Включить режим отладки:
+
+```bash
+fasthttp dev main.py --debug
+```
+
+Опции:
+- `-h, --host` — Хост для сервера (по умолчанию: 127.0.0.1)
+- `-p, --port` — Порт для сервера (по умолчанию: 8000)
+- `-b, --base-url` — Базовый URL для эндпоинтов документации
+- `-d, --debug` — Включить режим отладки
+
+Пример вывода:
+
+```
+▲ FastHTTP dev server
+➜  Server:   http://127.0.0.1:8000
+➜  Docs:     http://127.0.0.1:8000/docs
+─────────────────────────────────
+```
+
 ## Справка
 
 ```bash
 fasthttp --help
 fasthttp get --help
 fasthttp post --help
+fasthttp run --help
+fasthttp dev --help
 ```
 
 ## Смотрите также

fasthttp_client-1.2.4/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.4}/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.4/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.4/examples/basic/test_delete.py

@@ -0,0 +1,16 @@
+from fasthttp import FastHTTP
+from fasthttp.response import Response
+from pydantic import BaseModel
+
+class TestSwagger(BaseModel):
+    origin: str
+
+app = FastHTTP(debug=True)
+
+
+@app.delete("httpbin.org/delete", response_model=TestSwagger)
+async def test_delete(resp: Response) -> int:
+    return resp.status
+
+
+