pyview-web 0.7.2__tar.gz → 0.8.0__tar.gz

{pyview_web-0.7.2 → pyview_web-0.8.0}/PKG-INFO

@@ -1,44 +1,43 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.3
 Name: pyview-web
-Version: 0.7.2
+Version: 0.8.0
 Summary: LiveView in Python
-License: MIT
-License-File: LICENSE
 Keywords: web,api,LiveView
 Author: Larry Ogrodnek
-Author-email: ogrodnek@gmail.com
-Requires-Python: >=3.11,<3.15
+Author-email: Larry Ogrodnek <ogrodnek@gmail.com>
+License: MIT
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python
+Classifier: Topic :: Internet
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development
+Classifier: Typing :: Typed
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Web Environment
 Classifier: Framework :: AsyncIO
 Classifier: Framework :: Pydantic
 Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Information Technology
-Classifier: Intended Audience :: System Administrators
 Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Topic :: Internet
-Classifier: Topic :: Internet :: WWW/HTTP
 Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
-Classifier: Topic :: Software Development
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Typing :: Typed
-Requires-Dist: APScheduler (>=3.11.0,<4.0.0)
-Requires-Dist: click (>=8.1.7,<9.0.0)
-Requires-Dist: itsdangerous (>=2.2.0,<3.0.0)
-Requires-Dist: markupsafe (>=3.0.2,<4.0.0)
-Requires-Dist: pydantic (>=2.11,<3.0)
-Requires-Dist: starlette (>=0.50.0,<0.51.0)
-Requires-Dist: wsproto (>=1.3.0,<2.0.0)
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Dist: starlette>=0.50.0,<0.51
+Requires-Dist: wsproto>=1.3.0,<2
+Requires-Dist: apscheduler>=3.11.0,<4
+Requires-Dist: markupsafe>=3.0.2,<4
+Requires-Dist: itsdangerous>=2.2.0,<3
+Requires-Dist: pydantic>=2.11,<3
+Requires-Dist: click>=8.1.7,<9
+Requires-Python: >=3.11, <3.15
 Project-URL: Homepage, https://pyview.rocks
 Project-URL: Repository, https://github.com/ogrodnek/pyview
 Description-Content-Type: text/markdown
@@ -51,6 +50,8 @@ Description-Content-Type: text/markdown
 
 PyView enables dynamic, real-time web apps, using server-rendered HTML.
 
+**Documentation**: <a href="https://pyview.rocks" target="_blank">https://pyview.rocks</a>
+
 **Source Code**: <a href="https://github.com/ogrodnek/pyview" target="_blank">https://github.com/ogrodnek/pyview</a>
 
 # Installation
@@ -136,28 +137,31 @@ PyView is in the very early stages of active development. Please check it out an
 ## Setup
 
 ```
-poetry install
+uv sync
 ```
 
 ## Running
 
 ```
-poetry run uvicorn examples.app:app --reload
+uv run uvicorn examples.app:app --reload
 ```
 
 Then go to http://localhost:8000/
 
-### Poetry Install
+### uv Install
+
+```
+brew install uv
+```
+
+or
 
 ```
-brew install pipx
-pipx install poetry
-pipx ensurepath
+curl -LsSf https://astral.sh/uv/install.sh | sh
 ```
 
-(see https://python-poetry.org/docs/#installation for more details)
+(see https://docs.astral.sh/uv/getting-started/installation/ for more details)
 
 # License
 
 PyView is licensed under the [MIT License](LICENSE).
-

{pyview_web-0.7.2 → pyview_web-0.8.0}/pyproject.toml

@@ -1,17 +1,11 @@
-[tool.poetry]
+[project]
 name = "pyview-web"
-
-packages = [
-  { include = "pyview" },
-]
-
-version = "0.7.2"
+version = "0.8.0"
 description = "LiveView in Python"
-authors = ["Larry Ogrodnek <ogrodnek@gmail.com>"]
-license = "MIT"
+authors = [{ name = "Larry Ogrodnek", email = "ogrodnek@gmail.com" }]
+license = { text = "MIT" }
 readme = "readme.md"
-homepage = "https://pyview.rocks"
-repository = "https://github.com/ogrodnek/pyview"
+requires-python = ">=3.11,<3.15"
 keywords = ["web", "api", "LiveView"]
 
 classifiers = [
@@ -41,33 +35,49 @@ classifiers = [
     "Topic :: Internet :: WWW/HTTP",
 ]
 
-[tool.poetry.dependencies]
-python = ">=3.11,<3.15"
-starlette = "^0.50.0"
-wsproto = "^1.3.0"
-APScheduler = "^3.11.0"
-markupsafe = "^3.0.2"
-itsdangerous = "^2.2.0"
-pydantic = "^2.11"
-click = "^8.1.7"
+dependencies = [
+    "starlette>=0.50.0,<0.51",
+    "wsproto>=1.3.0,<2",
+    "APScheduler>=3.11.0,<4",
+    "markupsafe>=3.0.2,<4",
+    "itsdangerous>=2.2.0,<3",
+    "pydantic>=2.11,<3",
+    "click>=8.1.7,<9",
+]
 
-[tool.poetry.scripts]
+[project.scripts]
 pv = "pyview.cli.main:cli"
 
-[tool.poetry.group.dev.dependencies]
-pytest = "^8.2.0"
-ruff = "^0.14.0"
-pyright = "^1.1.403"
-pytest-cov = "^6.1.1"
-pytest-asyncio = "^1.3.0"
+[project.urls]
+Homepage = "https://pyview.rocks"
+Repository = "https://github.com/ogrodnek/pyview"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.2.0,<9",
+    "ruff>=0.14.0",
+    "pyright>=1.1.403,<2",
+    "pytest-cov>=6.1.1,<7",
+    "pytest-asyncio>=1.3.0,<2",
+]
+profiling = [
+    "scalene>=1.5.51,<2; python_version != '3.11.0'",
+]
+docs = [
+    "mkdocs>=1.6.1,<2",
+    "mkdocs-material>=9.6.14,<10",
+]
 
-[tool.poetry.group.profiling.dependencies]
-scalene = {version = "^1.5.51", python = "!=3.11.0,>=3.11"}
+[build-system]
+requires = ["uv_build>=0.7,<1"]
+build-backend = "uv_build"
 
+[tool.uv]
+package = true
 
-[build-system]
-requires = ["poetry-core"]
-build-backend = "poetry.core.masonry.api"
+[tool.uv.build-backend]
+module-root = "."
+module-name = "pyview"
 
 [tool.pyright]
 exclude = [
@@ -78,8 +88,13 @@ exclude = [
     "**/node_modules",
     "**/__pycache__",
     # T-string files require Python 3.14+
+    "pyview/components/renderer.py",
     "tests/test_live_view_template.py",
     "tests/test_template_view.py",
+    "tests/test_stream_tstring.py",
+    "tests/components/test_statics_sharing.py",
+    "tests/components/test_lifecycle.py",
+    "tests/components/test_slots.py",
 ]
 
 [tool.pytest.ini_options]
@@ -93,9 +108,18 @@ exclude = [
     "pyview/template/__init__.py",
     "pyview/template/template_view.py",
     "pyview/template/live_view_template.py",
+    "pyview/components/slots.py",
     "examples/views/count/count_tstring.py",
+    "examples/views/streams/streams_tstring.py",
+    "examples/views/components/slots_demo.py",
+    "examples/views/components/stateful_demo.py",
+    "examples/views/components/stateless_demo.py",
     "tests/test_live_view_template.py",
     "tests/test_template_view.py",
+    "tests/test_stream_tstring.py",
+    "tests/components/test_slots.py",
+    "tests/components/test_statics_sharing.py",
+    "tests/components/test_lifecycle.py",
 ]
 
 [tool.ruff.lint]

{pyview_web-0.7.2 → pyview_web-0.8.0}/pyview/__init__.py

@@ -1,3 +1,4 @@
+from pyview.components import ComponentMeta, ComponentsManager, ComponentSocket, LiveComponent
 from pyview.js import JsCommand
 from pyview.live_socket import (
     ConnectedLiveViewSocket,
@@ -8,6 +9,7 @@ from pyview.live_socket import (
 from pyview.live_view import LiveView
 from pyview.playground import playground
 from pyview.pyview import PyView, RootTemplate, RootTemplateContext, defaultRootTemplate
+from pyview.stream import Stream
 
 __all__ = [
     "LiveView",
@@ -21,4 +23,10 @@ __all__ = [
     "ConnectedLiveViewSocket",
     "UnconnectedSocket",
     "playground",
+    "Stream",
+    # Components
+    "LiveComponent",
+    "ComponentMeta",
+    "ComponentSocket",
+    "ComponentsManager",
 ]

{pyview_web-0.7.2 → pyview_web-0.8.0}/pyview/assets/package-lock.json

@@ -6,9 +6,9 @@
     "": {
       "dependencies": {
         "nprogress": "^0.2.0",
-        "phoenix": "^1.7.0-rc.2",
+        "phoenix": "^1.7.0",
         "phoenix_html": "^3.2.0",
-        "phoenix_live_view": "^0.18.11"
+        "phoenix_live_view": "^0.20.17"
       }
     },
     "node_modules/nprogress": {
@@ -17,9 +17,10 @@
       "integrity": "sha512-I19aIingLgR1fmhftnbWWO3dXc0hSxqHQHQb3H8m+K3TnEn/iSeTZZOyvKXWqQESMwuUVnatlCnZdLBZZt2VSA=="
     },
     "node_modules/phoenix": {
-      "version": "1.7.0-rc.2",
-      "resolved": "https://registry.npmjs.org/phoenix/-/phoenix-1.7.0-rc.2.tgz",
-      "integrity": "sha512-05DaSo/ws2VtieY3Z6CJVx36DyhTil6/KesK1a4JlQPxYgNHZn7swv7R/R7etoN8SGtEjMV/a9HBkPS5wF/Xdg=="
+      "version": "1.8.3",
+      "resolved": "https://registry.npmjs.org/phoenix/-/phoenix-1.8.3.tgz",
+      "integrity": "sha512-5bMYQI30wl3erxbHnXMdt1xuQeRTeEOpQrakf3yqj/1HRHl7Gj4Cdk2NKXkUcCD5WpbxrilvZEMexM1VhWbnDg==",
+      "license": "MIT"
     },
     "node_modules/phoenix_html": {
       "version": "3.2.0",
@@ -27,9 +28,10 @@
       "integrity": "sha512-zv7PIZk0MPkF0ax8n465Q6w86+sGAy5cTem6KcbkUbdgxGc0y3WZmzkM2bSlYdSGbLEZfjXxos1G72xXsha6xA=="
     },
     "node_modules/phoenix_live_view": {
-      "version": "0.18.11",
-      "resolved": "https://registry.npmjs.org/phoenix_live_view/-/phoenix_live_view-0.18.11.tgz",
-      "integrity": "sha512-p/mBu/O3iVLvAreUoDeSZ4/myQJJeR8BH7Yu9LVCMI2xe2IZ2mffxtDGJb0mxnJrUQa7p03HHNlKGXj7LSJDdg=="
+      "version": "0.20.17",
+      "resolved": "https://registry.npmjs.org/phoenix_live_view/-/phoenix_live_view-0.20.17.tgz",
+      "integrity": "sha512-qGT3Jtj2wUawOaMrE8NKXmkexfaUn6bx5PuPMxWMzYuyp6Qv9i4xRZ2T3U6avC5Kf+oJEiBVIiWrODooC0vpQw==",
+      "license": "MIT"
     }
   },
   "dependencies": {
@@ -39,9 +41,9 @@
       "integrity": "sha512-I19aIingLgR1fmhftnbWWO3dXc0hSxqHQHQb3H8m+K3TnEn/iSeTZZOyvKXWqQESMwuUVnatlCnZdLBZZt2VSA=="
     },
     "phoenix": {
-      "version": "1.7.0-rc.2",
-      "resolved": "https://registry.npmjs.org/phoenix/-/phoenix-1.7.0-rc.2.tgz",
-      "integrity": "sha512-05DaSo/ws2VtieY3Z6CJVx36DyhTil6/KesK1a4JlQPxYgNHZn7swv7R/R7etoN8SGtEjMV/a9HBkPS5wF/Xdg=="
+      "version": "1.8.3",
+      "resolved": "https://registry.npmjs.org/phoenix/-/phoenix-1.8.3.tgz",
+      "integrity": "sha512-5bMYQI30wl3erxbHnXMdt1xuQeRTeEOpQrakf3yqj/1HRHl7Gj4Cdk2NKXkUcCD5WpbxrilvZEMexM1VhWbnDg=="
     },
     "phoenix_html": {
       "version": "3.2.0",
@@ -49,9 +51,9 @@
       "integrity": "sha512-zv7PIZk0MPkF0ax8n465Q6w86+sGAy5cTem6KcbkUbdgxGc0y3WZmzkM2bSlYdSGbLEZfjXxos1G72xXsha6xA=="
     },
     "phoenix_live_view": {
-      "version": "0.18.11",
-      "resolved": "https://registry.npmjs.org/phoenix_live_view/-/phoenix_live_view-0.18.11.tgz",
-      "integrity": "sha512-p/mBu/O3iVLvAreUoDeSZ4/myQJJeR8BH7Yu9LVCMI2xe2IZ2mffxtDGJb0mxnJrUQa7p03HHNlKGXj7LSJDdg=="
+      "version": "0.20.17",
+      "resolved": "https://registry.npmjs.org/phoenix_live_view/-/phoenix_live_view-0.20.17.tgz",
+      "integrity": "sha512-qGT3Jtj2wUawOaMrE8NKXmkexfaUn6bx5PuPMxWMzYuyp6Qv9i4xRZ2T3U6avC5Kf+oJEiBVIiWrODooC0vpQw=="
     }
   }
 }

{pyview_web-0.7.2 → pyview_web-0.8.0}/pyview/assets/package.json

@@ -1,8 +1,8 @@
 {
   "dependencies": {
     "nprogress": "^0.2.0",
-    "phoenix": "^1.7.0-rc.2",
+    "phoenix": "^1.7.0",
     "phoenix_html": "^3.2.0",
-    "phoenix_live_view": "^0.18.11"
+    "phoenix_live_view": "^0.20.17"
   }
 }

pyview_web-0.8.0/pyview/binding/__init__.py

@@ -0,0 +1,47 @@
+"""Parameter binding for pyview handlers.
+
+This module provides signature-driven parameter binding, allowing handlers to
+declare typed parameters that are automatically converted from request data.
+
+Example:
+    # Old style (manual extraction):
+    async def handle_params(self, url, params, socket):
+        page = int(params["page"][0]) if "page" in params else 1
+
+    # New style (typed binding):
+    async def handle_params(self, socket: LiveViewSocket[MyContext], page: int = 1):
+        # page is already an int!
+        pass
+
+Reserved parameter names (injected from context, not from URL params):
+    - socket: The LiveViewSocket instance
+    - url: The parsed URL
+    - event: The event name (for event handlers)
+    - payload: The event payload dict (for event handlers)
+
+Type-based injection:
+    - params: Params  -> injects Params container
+    - params: dict    -> injects params as dict
+    - params: str     -> treats "params" as a URL param name (not injected)
+"""
+
+from .binder import Binder
+from .context import BindContext
+from .converters import ConversionError, ConverterRegistry
+from .helpers import call_handle_event, call_handle_params
+from .injectables import InjectableRegistry
+from .params import Params
+from .result import BindResult, ParamError
+
+__all__ = [
+    "Params",
+    "BindContext",
+    "BindResult",
+    "ParamError",
+    "ConverterRegistry",
+    "ConversionError",
+    "InjectableRegistry",
+    "Binder",
+    "call_handle_event",
+    "call_handle_params",
+]

pyview_web-0.8.0/pyview/binding/binder.py

@@ -0,0 +1,134 @@
+"""Core binder for signature-driven parameter binding."""
+
+from __future__ import annotations
+
+import dataclasses
+import inspect
+import logging
+from typing import Any, Callable, Generic, TypeVar, get_type_hints
+
+from .context import BindContext
+from .converters import ConversionError, ConverterRegistry
+from .injectables import _NOT_FOUND, InjectableRegistry
+from .result import BindResult, ParamError
+
+logger = logging.getLogger(__name__)
+
+T = TypeVar("T")
+
+
+class Binder(Generic[T]):
+    """Binds function parameters from BindContext based on type annotations.
+
+    The binder inspects a function's signature and type hints, then:
+    1. Resolves injectable parameters (socket, event, payload, url, params)
+    2. Pulls values from params or payload for other parameters
+    3. Converts values to the expected types
+    4. Returns a BindResult with bound_args and any errors
+    """
+
+    def __init__(
+        self,
+        converter: ConverterRegistry | None = None,
+        injectables: InjectableRegistry[T] | None = None,
+    ):
+        self.converter = converter or ConverterRegistry()
+        self.injectables = injectables or InjectableRegistry()
+
+    def bind(self, func: Callable[..., Any], ctx: BindContext[T]) -> BindResult:
+        """Bind context values to function signature.
+
+        Args:
+            func: The function to bind parameters for
+            ctx: Binding context with params, payload, socket, etc.
+
+        Returns:
+            BindResult with bound_args dict and any errors
+        """
+        sig = inspect.signature(func)
+
+        # Get type hints, falling back to empty for missing annotations
+        # NameError: forward reference can't be resolved
+        # AttributeError: accessing annotations on some objects
+        # RecursionError: circular type references
+        try:
+            hints = get_type_hints(func)
+        except (NameError, AttributeError, RecursionError) as e:
+            logger.debug("Could not resolve type hints for %s: %s", func.__name__, e)
+            hints = {}
+
+        bound: dict[str, Any] = {}
+        errors: list[ParamError] = []
+
+        for name, param in sig.parameters.items():
+            # Skip 'self' for methods
+            if name == "self":
+                continue
+
+            # Skip *args and **kwargs (VAR_POSITIONAL and VAR_KEYWORD)
+            if param.kind in (inspect.Parameter.VAR_POSITIONAL, inspect.Parameter.VAR_KEYWORD):
+                continue
+
+            expected = hints.get(name, Any)
+
+            # 1) Try injectables first
+            injected = self.injectables.resolve(name, expected, ctx)
+            if injected is not _NOT_FOUND:
+                bound[name] = injected
+                continue
+
+            # 2) Check for dataclass parameter - gather fields from params
+            if dataclasses.is_dataclass(expected) and isinstance(expected, type):
+                raw = self._resolve_dataclass_fields(expected, ctx)
+                try:
+                    bound[name] = self.converter.convert(raw, expected)
+                except ConversionError as e:
+                    errors.append(ParamError(name, repr(expected), raw, str(e)))
+                continue
+
+            # 3) Pull raw value from params or payload
+            raw = self._resolve_raw(name, ctx)
+
+            # 4) Handle missing values
+            if raw is None:
+                if param.default is not inspect.Parameter.empty:
+                    bound[name] = param.default
+                    continue
+                if self.converter.is_optional(expected):
+                    bound[name] = None
+                    continue
+                errors.append(ParamError(name, repr(expected), None, "missing required parameter"))
+                continue
+
+            # 5) Convert to expected type
+            try:
+                bound[name] = self.converter.convert(raw, expected)
+            except ConversionError as e:
+                errors.append(ParamError(name, repr(expected), raw, str(e)))
+
+        return BindResult(bound, errors)
+
+    def _resolve_dataclass_fields(self, expected: type, ctx: BindContext[T]) -> dict[str, Any]:
+        """Gather dataclass fields from params."""
+        fields = dataclasses.fields(expected)
+        result: dict[str, Any] = {}
+
+        for field in fields:
+            if ctx.params.has(field.name):
+                result[field.name] = ctx.params.getlist(field.name)
+            elif ctx.payload and field.name in ctx.payload:
+                result[field.name] = ctx.payload[field.name]
+
+        return result
+
+    def _resolve_raw(self, name: str, ctx: BindContext[T]) -> Any | None:
+        """Resolve raw value from params or payload."""
+        # Check params first
+        if ctx.params.has(name):
+            return ctx.params.getlist(name)
+
+        # Check payload
+        if ctx.payload and name in ctx.payload:
+            return ctx.payload[name]
+
+        return None

pyview_web-0.8.0/pyview/binding/context.py

@@ -0,0 +1,33 @@
+"""Binding context for parameter resolution."""
+
+from dataclasses import dataclass, field
+from typing import TYPE_CHECKING, Any, Generic, Optional, TypeVar
+from urllib.parse import ParseResult
+
+if TYPE_CHECKING:
+    from pyview.live_socket import LiveViewSocket
+
+    from .params import Params
+
+T = TypeVar("T")
+
+
+@dataclass
+class BindContext(Generic[T]):
+    """Context provided to the binder for resolving parameter values.
+
+    Attributes:
+        params: Multi-value parameter container (query/path/form merged)
+        payload: Event payload dict (for handle_event)
+        url: Parsed URL (for handle_params)
+        socket: LiveView socket instance
+        event: Event name (for handle_event)
+        extra: Additional injectable values
+    """
+
+    params: "Params"
+    payload: Optional[dict[str, Any]]
+    url: Optional[ParseResult]
+    socket: Optional["LiveViewSocket[T]"]
+    event: Optional[str]
+    extra: dict[str, Any] = field(default_factory=dict)