pyferro 2.0.0__tar.gz → 2.1.0__tar.gz

{pyferro-2.0.0 → pyferro-2.1.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: pyferro
-Version: 2.0.0
+Version: 2.1.0
 Summary: High-performance reactive fullstack Python framework on Rust RSGI (Granian) with symmetric WSRPC (JSON-RPC 2.0) and Tabular Data Compression.
 Author-email: Alex Titoff <a.tit.off@gmail.com>
 License: MIT
 Project-URL: Homepage, https://github.com/atitoff-dotcom/PyFerro
 Project-URL: Repository, https://github.com/atitoff-dotcom/PyFerro.git
-Keywords: pyferro,rsgi,granian,wsrpc,json-rpc,websocket,reactive
+Keywords: pyferro,rsgi,granian,wsrpc,json-rpc,websocket,reactive,seo
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -18,6 +18,9 @@ Requires-Dist: jinja2>=3.1.0
 Requires-Dist: sqlalchemy[asyncio]>=2.0.0
 Requires-Dist: aiosqlite>=0.19.0
 Requires-Dist: greenlet>=3.0.0
+Provides-Extra: help-generator
+Requires-Dist: markdown-it-py>=3.0.0; extra == "help-generator"
+Requires-Dist: pygments>=2.15.0; extra == "help-generator"
 Dynamic: license-file
 
 # PyFerro 2.0 — Руководство разработчика и Архитектура
@@ -146,100 +149,17 @@ class feed:
 
 ---
 
-## 4. Файловая подсистема (2PC) и конфиги прокси (Nginx / Angie / Caddy)
+## 4. Файловая подсистема (2PC) и проксирование (Nginx / Angie / Caddy)
 
 Загрузка файлов выполняется в 2 фазы (без буферизации в RAM):
 1. Вызов RPC `files.init_upload` -> возвращает `folder_hash` и `upload_url`.
 2. Потоковая отправка `POST /upload?folder=<folder_hash>&filename=<name>`.
 3. Вызов RPC `files.commit(folder_hash=..., is_public=True)` -> атомарный перенос в постоянное хранилище (`os.replace`) и запись в `pf_file_metadata`.
 
-### Полная боевая конфигурация Nginx / Angie для Granian (`WS /ws` + `2PC Files`)
-
-Для корректной работы **Granian** за Nginx/Angie важно:
-1. Выделить `location /ws` с отключенной буферизацией (`proxy_buffering off`) и длинным `proxy_read_timeout`, чтобы Nginx не обрывал живые WebSocket-соединения и долгие мультиретурн-стримы (`yield`) каждые 60 секунд.
-2. В `location /upload` отключить буферизацию запроса (`proxy_request_buffering off`), чтобы файлы стримились чанками напрямую в Granian за `O(1)` памяти.
-3. В `location /internal_files/` включить `internal;` для прямой раздачи файлов с диска по заголовку `X-Accel-Redirect`.
-
-```nginx
-# В секции http { ... } определяем корректный заголовок Connection для WebSocket и Keep-Alive:
-map $http_upgrade $connection_upgrade {
-    default upgrade;
-    ''      close;
-}
-
-upstream granian_backend {
-    server 127.0.0.1:8000;
-    keepalive 64;
-}
-
-server {
-    listen 80;
-    server_name example.com;
-
-    # 1. WebSocket JSON-RPC 2.0 и мультиретурн (yield) для Granian
-    location /ws {
-        proxy_pass http://granian_backend/ws;
-        proxy_http_version 1.1;
-
-        proxy_set_header Upgrade $http_upgrade;
-        proxy_set_header Connection $connection_upgrade;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-
-        # Отключаем буферизацию для мгновенной доставки пакетов yield и session.notify
-        proxy_buffering off;
-        # Держим соединение для долгих подписок (24 часа; heartbeat ping/pong поддерживает активность)
-        proxy_read_timeout 86400s;
-        proxy_send_timeout 86400s;
-    }
-
-    # 2. Потоковая закачка файлов напрямую в Granian без двойной буферизации на диске Nginx
-    location /upload {
-        client_max_body_size 2G;
-        proxy_request_buffering off;
-        proxy_http_version 1.1;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_pass http://granian_backend/upload;
-    }
-
-    # 3. Внутренняя раздача файлов с диска мимо Python (по заголовку X-Accel-Redirect от PyFerroApp)
-    location /internal_files/ {
-        internal;
-        alias /var/lib/pyferro/storage/;
-    }
-
-    # 4. Остальные HTTP-маршруты (/rpc, /files/..., /pyferro_admin)
-    location / {
-        proxy_pass http://granian_backend;
-        proxy_http_version 1.1;
-        proxy_set_header Connection "";
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-    }
-}
-```
+Раздача защищенных файлов осуществляется через заголовок `X-Accel-Redirect` без прогона байт через Python.
 
-### Конфигурация Caddy v2 (`Caddyfile`)
-Caddy понимает тот же самый заголовок `X-Accel-Redirect` через `handle_response`:
-
-```caddyfile
-example.com {
-    reverse_proxy 127.0.0.1:8000 {
-        @accel header X-Accel-Redirect *
-        handle_response @accel {
-            root * /var/lib/pyferro/storage
-            rewrite * {rp.header.X-Accel-Redirect}
-            uri strip_prefix /internal_files
-            file_server
-        }
-    }
-}
-```
+> [!TIP]
+> **Боевые конфигурации Nginx, Angie и Caddy v2**, архитектура потокового отсечения неавторизованных загрузок (Fail-Fast) и раздачи статики подробно описаны в [NGINX.md](NGINX.md).
 
 ---
 
@@ -252,3 +172,13 @@ example.com {
 | `POST /upload` | Потоковая закачка файлов во временную транзакцию (`O(1)` RAM) |
 | `GET /files/<folder>/<name>` | Защищенная раздача файлов (поддержка `X-Accel-Redirect` и файловых JWT) |
 | `GET /pyferro_admin` | Встроенная панель управления RBAC и CRUD (маршрут `/admin` свободен для вашего приложения) |
+
+---
+
+## 6. Табличная пагинация и сжатие трафика ($tabular)
+
+PyFerro 2.0 включает высокопроизводительную подсистему пагинации для SQLAlchemy и фронтенда:
+
+- **Бэкенд:** `paginate_tabular(db, Model, **params)` — выполняет поиск, фильтры, сортировку, умный `count(*)` и пакует ответ в сжатый протокол `$tabular` за **1 строчку кода**.
+- **Фронтенд:** `createPaginator("Model.read")` + компонент `<Pagination />` — полностью берут на себя состояние, номера страниц `[1, '...', 4, 5, 6, '...', 25]`, стрелки «Назад/Вперед» и живой поиск.
+- **Подробное руководство:** см. [PAGINATION.md](PAGINATION.md).

{pyferro-2.0.0 → pyferro-2.1.0}/README.md

@@ -124,100 +124,17 @@ class feed:
 
 ---
 
-## 4. Файловая подсистема (2PC) и конфиги прокси (Nginx / Angie / Caddy)
+## 4. Файловая подсистема (2PC) и проксирование (Nginx / Angie / Caddy)
 
 Загрузка файлов выполняется в 2 фазы (без буферизации в RAM):
 1. Вызов RPC `files.init_upload` -> возвращает `folder_hash` и `upload_url`.
 2. Потоковая отправка `POST /upload?folder=<folder_hash>&filename=<name>`.
 3. Вызов RPC `files.commit(folder_hash=..., is_public=True)` -> атомарный перенос в постоянное хранилище (`os.replace`) и запись в `pf_file_metadata`.
 
-### Полная боевая конфигурация Nginx / Angie для Granian (`WS /ws` + `2PC Files`)
-
-Для корректной работы **Granian** за Nginx/Angie важно:
-1. Выделить `location /ws` с отключенной буферизацией (`proxy_buffering off`) и длинным `proxy_read_timeout`, чтобы Nginx не обрывал живые WebSocket-соединения и долгие мультиретурн-стримы (`yield`) каждые 60 секунд.
-2. В `location /upload` отключить буферизацию запроса (`proxy_request_buffering off`), чтобы файлы стримились чанками напрямую в Granian за `O(1)` памяти.
-3. В `location /internal_files/` включить `internal;` для прямой раздачи файлов с диска по заголовку `X-Accel-Redirect`.
-
-```nginx
-# В секции http { ... } определяем корректный заголовок Connection для WebSocket и Keep-Alive:
-map $http_upgrade $connection_upgrade {
-    default upgrade;
-    ''      close;
-}
-
-upstream granian_backend {
-    server 127.0.0.1:8000;
-    keepalive 64;
-}
-
-server {
-    listen 80;
-    server_name example.com;
-
-    # 1. WebSocket JSON-RPC 2.0 и мультиретурн (yield) для Granian
-    location /ws {
-        proxy_pass http://granian_backend/ws;
-        proxy_http_version 1.1;
-
-        proxy_set_header Upgrade $http_upgrade;
-        proxy_set_header Connection $connection_upgrade;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-
-        # Отключаем буферизацию для мгновенной доставки пакетов yield и session.notify
-        proxy_buffering off;
-        # Держим соединение для долгих подписок (24 часа; heartbeat ping/pong поддерживает активность)
-        proxy_read_timeout 86400s;
-        proxy_send_timeout 86400s;
-    }
-
-    # 2. Потоковая закачка файлов напрямую в Granian без двойной буферизации на диске Nginx
-    location /upload {
-        client_max_body_size 2G;
-        proxy_request_buffering off;
-        proxy_http_version 1.1;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_pass http://granian_backend/upload;
-    }
-
-    # 3. Внутренняя раздача файлов с диска мимо Python (по заголовку X-Accel-Redirect от PyFerroApp)
-    location /internal_files/ {
-        internal;
-        alias /var/lib/pyferro/storage/;
-    }
-
-    # 4. Остальные HTTP-маршруты (/rpc, /files/..., /pyferro_admin)
-    location / {
-        proxy_pass http://granian_backend;
-        proxy_http_version 1.1;
-        proxy_set_header Connection "";
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-    }
-}
-```
+Раздача защищенных файлов осуществляется через заголовок `X-Accel-Redirect` без прогона байт через Python.
 
-### Конфигурация Caddy v2 (`Caddyfile`)
-Caddy понимает тот же самый заголовок `X-Accel-Redirect` через `handle_response`:
-
-```caddyfile
-example.com {
-    reverse_proxy 127.0.0.1:8000 {
-        @accel header X-Accel-Redirect *
-        handle_response @accel {
-            root * /var/lib/pyferro/storage
-            rewrite * {rp.header.X-Accel-Redirect}
-            uri strip_prefix /internal_files
-            file_server
-        }
-    }
-}
-```
+> [!TIP]
+> **Боевые конфигурации Nginx, Angie и Caddy v2**, архитектура потокового отсечения неавторизованных загрузок (Fail-Fast) и раздачи статики подробно описаны в [NGINX.md](NGINX.md).
 
 ---
 
@@ -230,3 +147,13 @@ example.com {
 | `POST /upload` | Потоковая закачка файлов во временную транзакцию (`O(1)` RAM) |
 | `GET /files/<folder>/<name>` | Защищенная раздача файлов (поддержка `X-Accel-Redirect` и файловых JWT) |
 | `GET /pyferro_admin` | Встроенная панель управления RBAC и CRUD (маршрут `/admin` свободен для вашего приложения) |
+
+---
+
+## 6. Табличная пагинация и сжатие трафика ($tabular)
+
+PyFerro 2.0 включает высокопроизводительную подсистему пагинации для SQLAlchemy и фронтенда:
+
+- **Бэкенд:** `paginate_tabular(db, Model, **params)` — выполняет поиск, фильтры, сортировку, умный `count(*)` и пакует ответ в сжатый протокол `$tabular` за **1 строчку кода**.
+- **Фронтенд:** `createPaginator("Model.read")` + компонент `<Pagination />` — полностью берут на себя состояние, номера страниц `[1, '...', 4, 5, 6, '...', 25]`, стрелки «Назад/Вперед» и живой поиск.
+- **Подробное руководство:** см. [PAGINATION.md](PAGINATION.md).

{pyferro-2.0.0 → pyferro-2.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pyferro"
-version = "2.0.0"
+version = "2.1.0"
 description = "High-performance reactive fullstack Python framework on Rust RSGI (Granian) with symmetric WSRPC (JSON-RPC 2.0) and Tabular Data Compression."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -12,7 +12,7 @@ license = { text = "MIT" }
 authors = [
     { name = "Alex Titoff", email = "a.tit.off@gmail.com" }
 ]
-keywords = ["pyferro", "rsgi", "granian", "wsrpc", "json-rpc", "websocket", "reactive"]
+keywords = ["pyferro", "rsgi", "granian", "wsrpc", "json-rpc", "websocket", "reactive", "seo"]
 dependencies = [
     "granian>=1.6.0",
     "orjson>=3.9.0",
@@ -24,13 +24,26 @@ dependencies = [
     "greenlet>=3.0.0",
 ]
 
+[project.optional-dependencies]
+help-generator = [
+    "markdown-it-py>=3.0.0",
+    "pygments>=2.15.0",
+]
+
 [project.urls]
 Homepage = "https://github.com/atitoff-dotcom/PyFerro"
 Repository = "https://github.com/atitoff-dotcom/PyFerro.git"
 
 [tool.setuptools.packages.find]
-where = ["."]
-include = ["auth*", "core*", "crud*", "db*", "files*", "rpc*", "server*", "pyferro2*"]
+where = ["src"]
+include = ["pyferro2*"]
 
 [tool.setuptools.package-data]
-"*" = ["frontend/dist/*", "frontend/dist/**/*"]
+"pyferro2" = [
+    "help/help_data.json",
+    "frontend/dist/*",
+    "frontend/dist/**/*",
+]
+
+[tool.pytest.ini_options]
+pythonpath = [".", "src"]

{pyferro-2.0.0 → pyferro-2.1.0/src}/pyferro.egg-info/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: pyferro
-Version: 2.0.0
+Version: 2.1.0
 Summary: High-performance reactive fullstack Python framework on Rust RSGI (Granian) with symmetric WSRPC (JSON-RPC 2.0) and Tabular Data Compression.
 Author-email: Alex Titoff <a.tit.off@gmail.com>
 License: MIT
 Project-URL: Homepage, https://github.com/atitoff-dotcom/PyFerro
 Project-URL: Repository, https://github.com/atitoff-dotcom/PyFerro.git
-Keywords: pyferro,rsgi,granian,wsrpc,json-rpc,websocket,reactive
+Keywords: pyferro,rsgi,granian,wsrpc,json-rpc,websocket,reactive,seo
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -18,6 +18,9 @@ Requires-Dist: jinja2>=3.1.0
 Requires-Dist: sqlalchemy[asyncio]>=2.0.0
 Requires-Dist: aiosqlite>=0.19.0
 Requires-Dist: greenlet>=3.0.0
+Provides-Extra: help-generator
+Requires-Dist: markdown-it-py>=3.0.0; extra == "help-generator"
+Requires-Dist: pygments>=2.15.0; extra == "help-generator"
 Dynamic: license-file
 
 # PyFerro 2.0 — Руководство разработчика и Архитектура
@@ -146,100 +149,17 @@ class feed:
 
 ---
 
-## 4. Файловая подсистема (2PC) и конфиги прокси (Nginx / Angie / Caddy)
+## 4. Файловая подсистема (2PC) и проксирование (Nginx / Angie / Caddy)
 
 Загрузка файлов выполняется в 2 фазы (без буферизации в RAM):
 1. Вызов RPC `files.init_upload` -> возвращает `folder_hash` и `upload_url`.
 2. Потоковая отправка `POST /upload?folder=<folder_hash>&filename=<name>`.
 3. Вызов RPC `files.commit(folder_hash=..., is_public=True)` -> атомарный перенос в постоянное хранилище (`os.replace`) и запись в `pf_file_metadata`.
 
-### Полная боевая конфигурация Nginx / Angie для Granian (`WS /ws` + `2PC Files`)
-
-Для корректной работы **Granian** за Nginx/Angie важно:
-1. Выделить `location /ws` с отключенной буферизацией (`proxy_buffering off`) и длинным `proxy_read_timeout`, чтобы Nginx не обрывал живые WebSocket-соединения и долгие мультиретурн-стримы (`yield`) каждые 60 секунд.
-2. В `location /upload` отключить буферизацию запроса (`proxy_request_buffering off`), чтобы файлы стримились чанками напрямую в Granian за `O(1)` памяти.
-3. В `location /internal_files/` включить `internal;` для прямой раздачи файлов с диска по заголовку `X-Accel-Redirect`.
-
-```nginx
-# В секции http { ... } определяем корректный заголовок Connection для WebSocket и Keep-Alive:
-map $http_upgrade $connection_upgrade {
-    default upgrade;
-    ''      close;
-}
-
-upstream granian_backend {
-    server 127.0.0.1:8000;
-    keepalive 64;
-}
-
-server {
-    listen 80;
-    server_name example.com;
-
-    # 1. WebSocket JSON-RPC 2.0 и мультиретурн (yield) для Granian
-    location /ws {
-        proxy_pass http://granian_backend/ws;
-        proxy_http_version 1.1;
-
-        proxy_set_header Upgrade $http_upgrade;
-        proxy_set_header Connection $connection_upgrade;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-
-        # Отключаем буферизацию для мгновенной доставки пакетов yield и session.notify
-        proxy_buffering off;
-        # Держим соединение для долгих подписок (24 часа; heartbeat ping/pong поддерживает активность)
-        proxy_read_timeout 86400s;
-        proxy_send_timeout 86400s;
-    }
-
-    # 2. Потоковая закачка файлов напрямую в Granian без двойной буферизации на диске Nginx
-    location /upload {
-        client_max_body_size 2G;
-        proxy_request_buffering off;
-        proxy_http_version 1.1;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_pass http://granian_backend/upload;
-    }
-
-    # 3. Внутренняя раздача файлов с диска мимо Python (по заголовку X-Accel-Redirect от PyFerroApp)
-    location /internal_files/ {
-        internal;
-        alias /var/lib/pyferro/storage/;
-    }
-
-    # 4. Остальные HTTP-маршруты (/rpc, /files/..., /pyferro_admin)
-    location / {
-        proxy_pass http://granian_backend;
-        proxy_http_version 1.1;
-        proxy_set_header Connection "";
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-    }
-}
-```
+Раздача защищенных файлов осуществляется через заголовок `X-Accel-Redirect` без прогона байт через Python.
 
-### Конфигурация Caddy v2 (`Caddyfile`)
-Caddy понимает тот же самый заголовок `X-Accel-Redirect` через `handle_response`:
-
-```caddyfile
-example.com {
-    reverse_proxy 127.0.0.1:8000 {
-        @accel header X-Accel-Redirect *
-        handle_response @accel {
-            root * /var/lib/pyferro/storage
-            rewrite * {rp.header.X-Accel-Redirect}
-            uri strip_prefix /internal_files
-            file_server
-        }
-    }
-}
-```
+> [!TIP]
+> **Боевые конфигурации Nginx, Angie и Caddy v2**, архитектура потокового отсечения неавторизованных загрузок (Fail-Fast) и раздачи статики подробно описаны в [NGINX.md](NGINX.md).
 
 ---
 
@@ -252,3 +172,13 @@ example.com {
 | `POST /upload` | Потоковая закачка файлов во временную транзакцию (`O(1)` RAM) |
 | `GET /files/<folder>/<name>` | Защищенная раздача файлов (поддержка `X-Accel-Redirect` и файловых JWT) |
 | `GET /pyferro_admin` | Встроенная панель управления RBAC и CRUD (маршрут `/admin` свободен для вашего приложения) |
+
+---
+
+## 6. Табличная пагинация и сжатие трафика ($tabular)
+
+PyFerro 2.0 включает высокопроизводительную подсистему пагинации для SQLAlchemy и фронтенда:
+
+- **Бэкенд:** `paginate_tabular(db, Model, **params)` — выполняет поиск, фильтры, сортировку, умный `count(*)` и пакует ответ в сжатый протокол `$tabular` за **1 строчку кода**.
+- **Фронтенд:** `createPaginator("Model.read")` + компонент `<Pagination />` — полностью берут на себя состояние, номера страниц `[1, '...', 4, 5, 6, '...', 25]`, стрелки «Назад/Вперед» и живой поиск.
+- **Подробное руководство:** см. [PAGINATION.md](PAGINATION.md).

pyferro-2.1.0/src/pyferro.egg-info/SOURCES.txt

@@ -0,0 +1,68 @@
+LICENSE
+README.md
+pyproject.toml
+src/pyferro.egg-info/PKG-INFO
+src/pyferro.egg-info/SOURCES.txt
+src/pyferro.egg-info/dependency_links.txt
+src/pyferro.egg-info/requires.txt
+src/pyferro.egg-info/top_level.txt
+src/pyferro2/__init__.py
+src/pyferro2/__main__.py
+src/pyferro2/auth/__init__.py
+src/pyferro2/auth/models.py
+src/pyferro2/auth/passwords.py
+src/pyferro2/auth/seeder.py
+src/pyferro2/core/__init__.py
+src/pyferro2/core/constants.py
+src/pyferro2/core/session.py
+src/pyferro2/core/session_data.py
+src/pyferro2/core/tabular.py
+src/pyferro2/crud/__init__.py
+src/pyferro2/crud/engine.py
+src/pyferro2/crud/rpc.py
+src/pyferro2/crud/spec.py
+src/pyferro2/db/__init__.py
+src/pyferro2/db/base.py
+src/pyferro2/db/engine.py
+src/pyferro2/db/pagination.py
+src/pyferro2/files/__init__.py
+src/pyferro2/files/models.py
+src/pyferro2/files/rpc.py
+src/pyferro2/files/storage.py
+src/pyferro2/frontend/dist/index.html
+src/pyferro2/frontend/dist/assets/index-qNsvt_pa.js
+src/pyferro2/frontend/dist/assets/index-v64oplBl.css
+src/pyferro2/help/__init__.py
+src/pyferro2/help/help_data.json
+src/pyferro2/help/rpc.py
+src/pyferro2/migrations/__init__.py
+src/pyferro2/migrations/migration_v2_0_0.py
+src/pyferro2/migrations/migration_v2_1_0.py
+src/pyferro2/rpc/__init__.py
+src/pyferro2/rpc/errors.py
+src/pyferro2/rpc/router.py
+src/pyferro2/seo/__init__.py
+src/pyferro2/seo/detector.py
+src/pyferro2/seo/indexnow.py
+src/pyferro2/seo/jinja_engine.py
+src/pyferro2/seo/models.py
+src/pyferro2/seo/page_cache.py
+src/pyferro2/seo/renderer.py
+src/pyferro2/seo/router.py
+src/pyferro2/seo/rpc.py
+src/pyferro2/seo/site_tree.py
+src/pyferro2/seo/sitemap.py
+src/pyferro2/server/__init__.py
+src/pyferro2/server/app.py
+src/pyferro2/server/auth_rpc.py
+src/pyferro2/server/test_client.py
+src/pyferro2/server/tokens.py
+src/pyferro2/starters/__init__.py
+src/pyferro2/starters/catalog.py
+src/pyferro2/starters/manager.py
+src/pyferro2/starters/models.py
+src/pyferro2/starters/rpc.py
+src/pyferro2/starters/seeder.py
+src/pyferro2/starters/seo.py
+tests/test_e2e_lifecycle.py
+tests/test_pagination.py

{pyferro-2.0.0 → pyferro-2.1.0/src}/pyferro.egg-info/requires.txt

@@ -6,3 +6,7 @@ jinja2>=3.1.0
 sqlalchemy[asyncio]>=2.0.0
 aiosqlite>=0.19.0
 greenlet>=3.0.0
+
+[help-generator]
+markdown-it-py>=3.0.0
+pygments>=2.15.0

pyferro-2.1.0/src/pyferro.egg-info/top_level.txt

@@ -0,0 +1 @@
+pyferro2

pyferro-2.1.0/src/pyferro2/__init__.py

@@ -0,0 +1,34 @@
+"""
+PyFerro 2.0 — высокопроизводительный веб-фреймворк с минимальным потреблением CPU и zero-boilerplate.
+"""
+
+from pyferro2.db.pagination import decode_cursor, encode_cursor, paginate_tabular
+from pyferro2.seo import (
+    HtmlBuilder,
+    SeoConfig,
+    SeoPageData,
+    bot_page,
+    configure_seo,
+    get_seo_config,
+    is_bot,
+    notify_indexnow,
+    register_sitemap_provider,
+)
+
+__version__ = "2.1.0"
+
+__all__ = [
+    "__version__",
+    "paginate_tabular",
+    "encode_cursor",
+    "decode_cursor",
+    "SeoConfig",
+    "SeoPageData",
+    "HtmlBuilder",
+    "configure_seo",
+    "get_seo_config",
+    "is_bot",
+    "bot_page",
+    "register_sitemap_provider",
+    "notify_indexnow",
+]

pyferro-2.1.0/src/pyferro2/__main__.py

@@ -0,0 +1,15 @@
+"""
+CLI-точка входа для выполнения служебных команд PyFerro 2.0 (например, python -m pyferro2 --add-admin).
+"""
+
+from pyferro2.server.app import PyFerroApp
+
+
+def main() -> None:
+    app = PyFerroApp()
+    if not app.handle_cli():
+        print("Использование: python -m pyferro2 --add-admin [--username admin] [--password admin]")
+
+
+if __name__ == "__main__":
+    main()

{pyferro-2.0.0 → pyferro-2.1.0/src/pyferro2}/auth/seeder.py

@@ -23,8 +23,9 @@ SYSTEM_ROLE_DESCRIPTIONS: dict[str, str] = {
     admRole.adm_roles.value: "Доступ к разделу управления ролями и матрицей прав",
     admRole.adm_settings.value: "Доступ к системным настройкам",
     admRole.adm_rpc.value: "Доступ к инспектору и правам JSON-RPC методов",
-    admRole.adm_help.value: "Доступ к управлению справочной системой",
+    admRole.adm_help.value: "Чтение справки PyFerro2",
     admRole.adm_seo.value: "Доступ к управлению SEO-правилами и страницами",
+    admRole.adm_starters.value: "Доступ к разделу шаблонов и примеров",
 }
 
 

{pyferro-2.0.0 → pyferro-2.1.0/src/pyferro2}/core/constants.py

@@ -25,6 +25,7 @@ class admRole(StrEnum):
     adm_rpc = "adm_rpc"
     adm_help = "adm_help"
     adm_seo = "adm_seo"
+    adm_starters = "adm_starters"
 
 
 # Базовые роли пользователей в системе

{pyferro-2.0.0 → pyferro-2.1.0/src/pyferro2}/core/session.py

@@ -30,6 +30,7 @@ class Session:
     __slots__ = (
         "session_id",
         "data",
+        "_guest_permissions",
         "_notify",
         "_close",
         "_active_rpcs",
@@ -44,6 +45,7 @@ class Session:
         data: SessionData = GUEST_SESSION_DATA,
         notify: NotifyCallback | None = None,
         close: CloseCallback | None = None,
+        guest_permissions: frozenset[str] | None = None,
     ) -> None:
         if type(session_id) is not str or not session_id:
             raise ValueError("session_id должен быть непустой строкой")
@@ -56,6 +58,12 @@ class Session:
 
         self.session_id: str = session_id
         self.data: SessionData = data
+        if guest_permissions is not None:
+            self._guest_permissions: frozenset[str] = frozenset(guest_permissions)
+        elif data.is_guest:
+            self._guest_permissions = data.permissions
+        else:
+            self._guest_permissions = GUEST_SESSION_DATA.permissions
         self._notify: NotifyCallback | None = notify
         self._close: CloseCallback | None = close
         self._active_rpcs: int = 0
@@ -76,11 +84,14 @@ class Session:
             raise TypeError(f"new_data должен быть экземпляром SessionData, получено: {type(new_data).__name__}")
         self.data = new_data
 
-    def reset_to_guest(self, guest_permissions: frozenset[str] = frozenset()) -> None:
+    def reset_to_guest(self, guest_permissions: frozenset[str] | None = None) -> None:
         """
-        Сбрасывает сессию обратно в гостевое состояние (при вызове `auth.logout`).
+        Сбрасывает сессию обратно в гостевое состояние (при вызове `auth.logout`),
+        сохраняя актуальные разрешения роли `guest`.
         """
-        self.data = SessionData.guest(guest_permissions)
+        if guest_permissions is not None:
+            self._guest_permissions = frozenset(guest_permissions)
+        self.data = SessionData.guest(self._guest_permissions)
 
     async def notify(self, event: str, payload: Any = None) -> None:
         """