pyview-web 0.2.3__py3-none-any.whl → 0.2.5__py3-none-any.whl

pyview/async_stream_runner.py

@@ -0,0 +1,65 @@
+import asyncio
+import uuid
+import logging
+from typing import Any, AsyncGenerator, Callable, Optional
+from pyview.events.info_event import InfoEvent, InfoEventScheduler
+
+
+class AsyncStreamRunner:
+    def __init__(self, scheduler: InfoEventScheduler):
+        self._stream_tasks: dict[str, asyncio.Task] = {}
+        self._scheduler = scheduler
+
+    def start_stream(
+        self,
+        gen: AsyncGenerator[Any, None],
+        *,
+        on_yield: Callable[[Any], InfoEvent],
+        on_done: Optional[InfoEvent] = None,
+        on_error: Optional[Callable[[Exception], InfoEvent]] = None,
+        on_cancel: Optional[InfoEvent] = None,
+    ) -> str:
+        """
+        Run `gen` in the background, returning an op_id you can later use
+        to cancel.  Hooks:
+
+        - on_yield(item)  → scheduled per chunk
+        - on_done        → scheduled once at normal completion
+        - on_error(exc)  → scheduled on unexpected exception
+        - on_cancel      → scheduled if the task is cancelled
+        """
+        task_id = uuid.uuid4().hex
+
+        async def driver():
+            try:
+                async for item in gen:
+                    self._scheduler.schedule_info_once(on_yield(item))
+            except asyncio.CancelledError:
+                # user-requested cancellation
+                if on_cancel:
+                    self._scheduler.schedule_info_once(on_cancel)
+                # swallow so it doesn’t log as an “error”
+            except Exception as exc:
+                if on_error:
+                    self._scheduler.schedule_info_once(on_error(exc))
+                else:
+                    logging.exception(f"Error in stream {task_id}", exc_info=True)
+            else:
+                if on_done:
+                    self._scheduler.schedule_info_once(on_done)
+            finally:
+                self._stream_tasks.pop(task_id, None)
+
+        task = asyncio.create_task(driver())
+        self._stream_tasks[task_id] = task
+        return task_id
+
+    def cancel_stream(self, task_id: str) -> bool:
+        """
+        Cancel a running stream.  Returns True if a task was found & cancelled.
+        """
+        task = self._stream_tasks.get(task_id)
+        if not task:
+            return False
+        task.cancel()
+        return True

pyview/cli/commands/create_view.py

@@ -0,0 +1,199 @@
+import click
+from pathlib import Path
+import tomllib
+from typing import Optional
+
+
+def snake_case(name: str) -> str:
+    """Convert PascalCase or camelCase to snake_case."""
+    import re
+
+    s1 = re.sub("(.)([A-Z][a-z]+)", r"\1_\2", name)
+    return re.sub("([a-z0-9])([A-Z])", r"\1_\2", s1).lower()
+
+
+def pascal_case(name: str) -> str:
+    """Convert snake_case or other formats to PascalCase."""
+    # If already in PascalCase or camelCase, convert to snake_case first
+    snake_name = snake_case(name)
+    return "".join(word.capitalize() for word in snake_name.split("_"))
+
+
+def kebab_case(name: str) -> str:
+    """Convert any case to kebab-case."""
+    return snake_case(name).replace("_", "-")
+
+
+def generate_python_file(name: str) -> str:
+    """Generate the Python LiveView file content."""
+    class_name = f"{pascal_case(name)}LiveView"
+    context_name = f"{pascal_case(name)}Context"
+
+    return f"""from pyview import LiveView, LiveViewSocket
+from dataclasses import dataclass
+from pyview.events import event, BaseEventHandler
+
+
+@dataclass
+class {context_name}:
+    pass
+
+
+class {class_name}(BaseEventHandler, LiveView[{context_name}]):
+    async def mount(self, socket: LiveViewSocket[{context_name}], session):
+        socket.context = {context_name}()
+"""
+
+
+def generate_html_file(name: str) -> str:
+    """Generate the HTML template file content."""
+    css_class = kebab_case(name)
+    return f'''<div class="{css_class}-container">
+    <h1>{pascal_case(name)}</h1>
+    
+    <div class="content">
+        <!-- Add your content here -->
+    </div>
+</div>
+'''
+
+
+def generate_css_file(name: str) -> str:
+    """Generate the CSS file content."""
+    css_class = kebab_case(name)
+    return f""".{css_class}-container {{
+    padding: 1rem;
+}}
+
+.{css_class}-container h1 {{
+    margin-bottom: 1rem;
+}}
+
+.{css_class}-container .content {{
+    /* Add your styles here */
+}}
+"""
+
+
+def generate_init_file(name: str) -> str:
+    """Generate the __init__.py file content."""
+    module_name = snake_case(name)
+    class_name = f"{pascal_case(name)}LiveView"
+
+    return f'''from .{module_name} import {class_name}
+
+__all__ = ["{class_name}"]
+'''
+
+
+def detect_package_structure(directory: Optional[Path] = None):
+    """Detect the package structure from pyproject.toml.
+
+    Args:
+        directory: Directory to look for pyproject.toml in. Defaults to current directory.
+
+    Returns:
+        tuple: (package_name, views_path)
+    """
+    if directory is None:
+        directory = Path.cwd()
+
+    pyproject_path = directory / "pyproject.toml"
+
+    if not pyproject_path.exists():
+        return None, "views"
+
+    try:
+        with open(pyproject_path, "rb") as f:
+            config = tomllib.load(f)
+    except Exception:
+        return None, "views"
+
+    # Check for packages configuration
+    packages = config.get("tool", {}).get("poetry", {}).get("packages", [])
+    if not packages:
+        # Check for modern pyproject.toml structure
+        packages = config.get("project", {}).get("packages", [])
+
+    if not packages:
+        return None, "views"
+
+    # Find the first package entry
+    for package in packages:
+        if isinstance(package, dict) and "include" in package:
+            package_name = package["include"]
+            from_dir = package.get("from", ".")
+
+            # Construct the path where views should go
+            if from_dir == ".":
+                package_path = Path(package_name)
+            else:
+                package_path = Path(from_dir) / package_name
+
+            views_path = package_path / "views"
+            return package_name, str(views_path)
+
+    return None, "views"
+
+
+@click.command()
+@click.argument("name")
+@click.option(
+    "--path",
+    "-p",
+    default=None,
+    help="Directory to create the view in (default: auto-detect from pyproject.toml)",
+)
+@click.option("--no-css", is_flag=True, help="Skip creating CSS file")
+def create_view(name: str, path: Optional[str], no_css: bool):
+    """Create a new LiveView with boilerplate files.
+
+    Example: pv create-view Counter
+    """
+    module_name = snake_case(name)
+
+    # Always try to detect package structure for import advice
+    package_name, detected_path = detect_package_structure()
+
+    # Use detected path if no path specified, otherwise use provided path
+    if path is None:
+        path = detected_path
+
+    view_dir = Path(path) / module_name
+
+    # Check if directory already exists
+    if view_dir.exists():
+        click.secho(f"Error: Directory '{view_dir}' already exists", fg="red")
+        raise click.Abort()
+
+    view_dir.mkdir(parents=True, exist_ok=True)
+    click.secho(f"Created directory: {view_dir}", fg="green")
+
+    # Generate files
+    files_to_create = [
+        ("__init__.py", generate_init_file(name)),
+        (f"{module_name}.py", generate_python_file(name)),
+        (f"{module_name}.html", generate_html_file(name)),
+    ]
+
+    if not no_css:
+        files_to_create.append((f"{module_name}.css", generate_css_file(name)))
+
+    # Create files
+    for filename, content in files_to_create:
+        file_path = view_dir / filename
+        file_path.write_text(content)
+        click.secho(f"Created: {file_path}", fg="green")
+
+    class_name = f"{pascal_case(name)}LiveView"
+    click.echo("\nLiveView created successfully! 🎉")
+    click.echo("\nTo use this view, add it to your app:")
+
+    # import statement based on detected package structure
+    if package_name:
+        import_path = f"{package_name}.views.{module_name}"
+    else:
+        import_path = f"{path.replace('/', '.')}.{module_name}"
+
+    click.echo(f"  from {import_path} import {class_name}")
+    click.echo(f"  app.add_live_view('/{module_name}', {class_name})")

pyview/cli/main.py

@@ -0,0 +1,17 @@
+import click
+
+from pyview.cli.commands.create_view import create_view
+
+
+@click.group()
+@click.version_option(package_name="pyview-web")
+def cli():
+    """PyView CLI - Generate boilerplate for LiveView applications."""
+    pass
+
+
+cli.add_command(create_view)
+
+
+if __name__ == "__main__":
+    cli()

pyview/events/BaseEventHandler.py

@@ -1,6 +1,9 @@
-from typing import Callable
+from typing import Callable, TYPE_CHECKING
 import logging
 
+if TYPE_CHECKING:
+    from pyview.live_view import InfoEvent
+
 
 def event(*event_names):
     """Decorator that marks methods as event handlers."""
@@ -12,22 +15,37 @@ def event(*event_names):
     return decorator
 
 
+def info(*info_names):
+    """Decorator that marks methods as info handlers."""
+
+    def decorator(func):
+        func._info_names = info_names
+        return func
+
+    return decorator
+
+
 class BaseEventHandler:
-    """Base class for event handlers to handle dispatching events."""
+    """Base class for event handlers to handle dispatching events and info."""
 
     _event_handlers: dict[str, Callable] = {}
+    _info_handlers: dict[str, Callable] = {}
 
     def __init_subclass__(cls, **kwargs):
         super().__init_subclass__(**kwargs)
 
         # Find all decorated methods and register them
         cls._event_handlers = {}
+        cls._info_handlers = {}
         for attr_name in dir(cls):
             if not attr_name.startswith("_"):
                 attr = getattr(cls, attr_name)
                 if hasattr(attr, "_event_names"):
                     for event_name in attr._event_names:
                         cls._event_handlers[event_name] = attr
+                if hasattr(attr, "_info_names"):
+                    for info_name in attr._info_names:
+                        cls._info_handlers[info_name] = attr
 
     async def handle_event(self, event: str, payload: dict, socket):
         handler = self._event_handlers.get(event)
@@ -36,3 +54,11 @@ class BaseEventHandler:
             return await handler(self, event, payload, socket)
         else:
             logging.warning(f"Unhandled event: {event} {payload}")
+
+    async def handle_info(self, info: "InfoEvent", socket):
+        handler = self._info_handlers.get(info.name)
+
+        if handler:
+            return await handler(self, info, socket)
+        else:
+            logging.warning(f"Unhandled info: {info.name} {info}")

pyview/events/__init__.py

@@ -1,4 +1,4 @@
-from .BaseEventHandler import BaseEventHandler, event
+from .BaseEventHandler import BaseEventHandler, event, info
 from .info_event import InfoEvent
 
-__all__ = ["BaseEventHandler", "event", "InfoEvent"]
+__all__ = ["BaseEventHandler", "event", "info", "InfoEvent"]

pyview/events/info_event.py

@@ -1,8 +1,16 @@
 from dataclasses import dataclass
-from typing import Any
+from typing import Any, Optional, Protocol
 
 
 @dataclass
 class InfoEvent:
     name: str
     payload: Any = None
+
+
+class InfoEventScheduler(Protocol):
+    def schedule_info(self, event: InfoEvent, seconds: float):
+        pass
+
+    def schedule_info_once(self, event: InfoEvent, seconds: Optional[float] = None):
+        pass

pyview/live_socket.py

@@ -19,6 +19,7 @@ from pyview.uploads import UploadConstraints, UploadConfig, UploadManager
 from pyview.meta import PyViewMeta
 from pyview.template.render_diff import calc_diff
 import datetime
+from pyview.async_stream_runner import AsyncStreamRunner
 
 
 if TYPE_CHECKING:
@@ -63,6 +64,7 @@ class ConnectedLiveViewSocket(Generic[T]):
         self.pub_sub = PubSub(pub_sub_hub, topic)
         self.pending_events = []
         self.upload_manager = UploadManager()
+        self.stream_runner = AsyncStreamRunner(self)
 
     @property
     def meta(self) -> PyViewMeta:

{pyview_web-0.2.3.dist-info → pyview_web-0.2.5.dist-info}/METADATA

@@ -1,12 +1,12 @@
 Metadata-Version: 2.3
 Name: pyview-web
-Version: 0.2.3
+Version: 0.2.5
 Summary: LiveView in Python
 License: MIT
 Keywords: web,api,LiveView
 Author: Larry Ogrodnek
 Author-email: ogrodnek@gmail.com
-Requires-Python: >=3.10,<3.13
+Requires-Python: >=3.11,<3.13
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Web Environment
 Classifier: Framework :: AsyncIO
@@ -18,7 +18,6 @@ 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.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3 :: Only
@@ -31,6 +30,7 @@ Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Dist: APScheduler (==3.9.1.post1)
+Requires-Dist: click (>=8.1.7,<9.0.0)
 Requires-Dist: itsdangerous (>=2.1.2,<3.0.0)
 Requires-Dist: markupsafe (>=2.1.2,<3.0.0)
 Requires-Dist: psutil (>=5.9.4,<6.0.0)

{pyview_web-0.2.3.dist-info → pyview_web-0.2.5.dist-info}/RECORD

@@ -2,18 +2,23 @@ pyview/__init__.py,sha256=5RJ_KtwJvI_-_Vhb3-py5Qf78YdH1HHvAzZO1ddzzrU,518
 pyview/assets/js/app.js,sha256=XuuSgEMY4hx8v0OuEPwaa7trktu_vppL0tc3Bs9Fw7s,2524
 pyview/assets/package-lock.json,sha256=kFCrEUJc3G7VD7EsBQf6__EKQhaKAok-I5rrwiAoX0w,2425
 pyview/assets/package.json,sha256=E6xaX8KMUAektIIedLmI55jGnmlNMSeD2tgKYXWk1vg,151
+pyview/async_stream_runner.py,sha256=_vXeU1LyuQkJrK5AlaaF1gyhRFWXhzn3Y73BFhSsWVc,2289
 pyview/auth/__init__.py,sha256=vMlirETRhD4va61NOzwg8VY8ep9wVOF96GznJGBmzD0,109
 pyview/auth/provider.py,sha256=fwriy2JZcOStutVXD-8VlMPAFXjILCM0l08lhTgmuyE,935
 pyview/auth/required.py,sha256=ZtNmLFth9nK39RxDiJkSzArXwS5Cvr55MUAzfJ1F2e0,1418
 pyview/changesets/__init__.py,sha256=55CLari2JHZtwy4hapHe7CqUyKjcP4dkM_t5d3CY2gU,46
 pyview/changesets/changesets.py,sha256=hImmvB_jS6RyLr5Mas5L7DO_0d805jR3c41LKJlnNL4,1720
+pyview/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pyview/cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pyview/cli/commands/create_view.py,sha256=9hrjc1J1sJHyp3Ihi5ls4Mj19OMNeaj6fpIwDFWrdZ8,5694
+pyview/cli/main.py,sha256=OEHqNwl9fqIPTI6qy5sLYndPHMEJ3fA9qsjSUuKzYSE,296
 pyview/csrf.py,sha256=VIURva9EJqXXYGC7engweh3SwDQCnHlhV2zWdcdnFqc,789
-pyview/events/BaseEventHandler.py,sha256=RIv1vYn-sNIAfPNAaRg5iJvM--0ZlQHt3X7av_GR0sw,1138
-pyview/events/__init__.py,sha256=5qQhZUjBwbnL9SrQ9FWHNgrEgDETCI3ysMREx7Tab4E,142
-pyview/events/info_event.py,sha256=Zv8G2F1XeXUk1wrnfomeFfxB0OPYmHdjSvxRjQew3No,125
+pyview/events/BaseEventHandler.py,sha256=0xcjFFMLMN8Aj6toI31vzeYhRQqaX9rm-G7XGXMvqsE,1923
+pyview/events/__init__.py,sha256=oP0SG4Af4uf0GEa0Y_zHYhR7TcBOcXQlTAsgOSaIcC4,156
+pyview/events/info_event.py,sha256=JOwf3KDodHkmH1MzqTD8sPxs0zbI4t8Ff0rLjwRSe2Y,358
 pyview/js.py,sha256=E6HMsUfXQjrcLqYq26ieeYuzTjBeZqfJwwOm3uSR4ME,3498
 pyview/live_routes.py,sha256=IN2Jmy8b1umcfx1R7ZgFXHZNbYDJp_kLIbADtDJknPM,1749
-pyview/live_socket.py,sha256=JcbQB0pv8srES8-fMkgMc0q6Jt-aU1huS537ZEIU7nU,4974
+pyview/live_socket.py,sha256=p1KtX9Exwhgsf0yOp3Eb32zdUOo5hSnYDJrpJuTu3QI,5084
 pyview/live_view.py,sha256=mwAp7jiABSZCBgYF-GLQCB7zcJ7Wpz9cuC84zjzsp2U,1455
 pyview/meta.py,sha256=01Z-qldB9jrewmIJHQpUqyIhuHodQGgCvpuY9YM5R6c,74
 pyview/phx_message.py,sha256=DUdPfl6tlw9K0FNXJ35ehq03JGgynvwA_JItHQ_dxMQ,2007
@@ -44,7 +49,8 @@ pyview/vendor/ibis/template.py,sha256=6XJXnztw87CrOaKeW3e18LL0fNM8AI6AaK_QgMdb7e
 pyview/vendor/ibis/tree.py,sha256=hg8f-fKHeo6DE8R-QgAhdvEaZ8rKyz7p0nGwPy0CBTs,2509
 pyview/vendor/ibis/utils.py,sha256=nLSaxPR9vMphzV9qinlz_Iurv9c49Ps6Knv8vyNlewU,2768
 pyview/ws_handler.py,sha256=CY1iDx5GETjIkqhgFbo2fkE3FhrqucSdg4AjuJ2P0Qg,9041
-pyview_web-0.2.3.dist-info/LICENSE,sha256=M_bADaBm9_MV9llX3lCicksLhwk3eZUjA2srE0uUWr0,1071
-pyview_web-0.2.3.dist-info/METADATA,sha256=UCRe_Zpa9FlUuOgZrpUmtV58qJ-wYS7NeAu3aRYoPNU,5256
-pyview_web-0.2.3.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-pyview_web-0.2.3.dist-info/RECORD,,
+pyview_web-0.2.5.dist-info/LICENSE,sha256=M_bADaBm9_MV9llX3lCicksLhwk3eZUjA2srE0uUWr0,1071
+pyview_web-0.2.5.dist-info/METADATA,sha256=3g39-VhWx0gWkq1B46NAkTTTDSqnOr692TkFZtgOrNo,5243
+pyview_web-0.2.5.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+pyview_web-0.2.5.dist-info/entry_points.txt,sha256=GAT-ic-VYmmSMUSUVKdV1bp4w-vgEeVP-XzElvarQ9U,42
+pyview_web-0.2.5.dist-info/RECORD,,

pyview_web-0.2.5.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+pv=pyview.cli.main:cli
+