pulse-framework 0.1.58__tar.gz → 0.1.59__tar.gz

{pulse_framework-0.1.58 → pulse_framework-0.1.59}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pulse-framework
-Version: 0.1.58
+Version: 0.1.59
 Summary: Pulse - Full-stack framework for building real-time React applications in Python
 Requires-Dist: websockets>=12.0
 Requires-Dist: fastapi>=0.128.0

{pulse_framework-0.1.58 → pulse_framework-0.1.59}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pulse-framework"
-version = "0.1.58"
+version = "0.1.59"
 description = "Pulse - Full-stack framework for building real-time React applications in Python"
 readme = "README.md"
 requires-python = ">=3.11"

{pulse_framework-0.1.58 → pulse_framework-0.1.59}/src/pulse/app.py

@@ -823,8 +823,6 @@ class App:
 	async def _handle_pulse_message(
 		self, render: RenderSession, session: UserSession, msg: ClientPulseMessage
 	) -> None:
-		print(f"[MSG] {msg}")
-
 		async def _next() -> Ok[None]:
 			if msg["type"] == "attach":
 				render.attach(msg["path"], msg["routeInfo"])

{pulse_framework-0.1.58 → pulse_framework-0.1.59}/src/pulse/cli/cmd.py

@@ -398,6 +398,7 @@ def build_uvicorn_command(
 	on_ready: Callable[[], None] | None = None,
 	plain: bool = False,
 ) -> CommandSpec:
+	cwd = app_ctx.server_cwd or app_ctx.app_dir or Path.cwd()
 	app_import = f"{app_ctx.module_name}:{app_ctx.app_var}.asgi_factory"
 	args: list[str] = [
 		sys.executable,
@@ -418,6 +419,12 @@ def build_uvicorn_command(
 		args.extend(["--reload-dir", str(app_dir)])
 		if web_root.exists():
 			args.extend(["--reload-dir", str(web_root)])
+			pulse_dir = str(app_ctx.app.codegen.cfg.pulse_dir)
+			pulse_app_dir = web_root / "app" / pulse_dir
+			rel_path = Path(os.path.relpath(pulse_app_dir, cwd))
+			if not rel_path.is_absolute():
+				args.extend(["--reload-exclude", str(rel_path)])
+				args.extend(["--reload-exclude", str(rel_path / "**")])
 
 	if app_ctx.app.env == "prod":
 		args.extend(production_flags())
@@ -450,8 +457,6 @@ def build_uvicorn_command(
 	if dev_secret:
 		command_env[ENV_PULSE_SECRET] = dev_secret
 
-	cwd = app_ctx.server_cwd or app_ctx.app_dir or Path.cwd()
-
 	# Apply custom log config to filter noisy requests (dev/ci only)
 	if app_ctx.app.env != "prod" and not verbose:
 		import json

{pulse_framework-0.1.58 → pulse_framework-0.1.59}/src/pulse/codegen/codegen.py

@@ -1,5 +1,4 @@
 import logging
-import shutil
 from collections.abc import Sequence
 from dataclasses import dataclass
 from pathlib import Path
@@ -107,20 +106,26 @@ class CodegenConfig:
 		return self.web_root / "app" / self.pulse_dir
 
 
-def write_file_if_changed(path: Path, content: str) -> Path:
+def write_file_if_changed(path: Path, content: str | bytes) -> Path:
 	"""Write content to file only if it has changed."""
 	if path.exists():
 		try:
-			current_content = path.read_text()
+			if isinstance(content, bytes):
+				current_content = path.read_bytes()
+			else:
+				current_content = path.read_text()
 			if current_content == content:
 				return path  # Skip writing, content is the same
-		except Exception:
-			logging.warning(f"Can't read file {path.absolute()}")
+		except Exception as exc:
+			logging.warning("Can't read file %s: %s", path.absolute(), exc)
 			# If we can't read the file for any reason, just write it
 			pass
 
 	path.parent.mkdir(exist_ok=True, parents=True)
-	path.write_text(content)
+	if isinstance(content, bytes):
+		path.write_bytes(content)
+	else:
+		path.write_text(content)
 	return path
 
 
@@ -202,9 +207,17 @@ class Codegen:
 
 			# Copy file if source exists
 			if asset.source_path.exists():
-				shutil.copy2(asset.source_path, dest_path)
 				self._copied_files.add(dest_path)
-				logger.debug(f"Copied {asset.source_path} -> {dest_path}")
+				try:
+					content = asset.source_path.read_bytes()
+				except OSError as exc:
+					logger.warning(
+						"Can't read asset %s: %s",
+						asset.source_path,
+						exc,
+					)
+					continue
+				write_file_if_changed(dest_path, content)
 
 	def generate_layout_tsx(
 		self,

{pulse_framework-0.1.58 → pulse_framework-0.1.59}/src/pulse/components/react_router.py

@@ -19,8 +19,7 @@ class LinkPath(TypedDict):
 	hash: str
 
 
-# @react_component(Import("Link", "react-router", version="^7"))
-@react_component(Import("Link", "react-router"))
+@react_component(Import("Link", "react-router", version="^7"))
 def Link(
 	*children: Node,
 	key: str | None = None,
@@ -69,8 +68,7 @@ def Link(
 	...
 
 
-# @react_component(Import("Outlet", "react-router", version="^7"))
-@react_component(Import("Outlet", "react-router"))
+@react_component(Import("Outlet", "react-router", version="^7"))
 def Outlet(key: str | None = None) -> None:
 	"""Renders the matched child route's element.
 

{pulse_framework-0.1.58 → pulse_framework-0.1.59}/src/pulse/js/react.py

@@ -384,7 +384,7 @@ class _LazyComponentFactory(_Expr):
 
 	```python
 	# At definition time (Python executes this)
-	LazyChart = lazy(Import("Chart", "./Chart", lazy=True))
+	LazyChart = lazy(Import("./Chart", lazy=True))
 
 	# As reference in transpiled code
 	@javascript

{pulse_framework-0.1.58 → pulse_framework-0.1.59}/src/pulse/react_component.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 from collections.abc import Callable
 from typing import Any, ParamSpec, overload
 
+from pulse.js.react import lazy as react_lazy
 from pulse.transpiler.imports import Import
 from pulse.transpiler.nodes import Element, Expr, Jsx, Node
 
@@ -19,9 +20,20 @@ def default_signature(
 class ReactComponent(Jsx):
 	"""JSX wrapper for React components with runtime call support."""
 
-	def __init__(self, expr: Expr) -> None:
+	def __init__(self, expr_or_src: Expr | str, *, lazy: bool = False) -> None:
+		if isinstance(expr_or_src, str):
+			if lazy:
+				expr: Expr = react_lazy(Import(expr_or_src, lazy=True))
+			else:
+				expr = Import(expr_or_src)
+		else:
+			if lazy:
+				raise TypeError(
+					"ReactComponent lazy only supported with a source string"
+				)
+			expr = expr_or_src
 		if not isinstance(expr, Expr):
-			raise TypeError("ReactComponent expects an Expr")
+			raise TypeError("ReactComponent expects an Expr or source string")
 		if isinstance(expr, Jsx):
 			expr = expr.expr
 		super().__init__(expr)
@@ -36,10 +48,9 @@ def react_component(
 @overload
 def react_component(
 	expr_or_name: str,
-	src: str,
+	src: str | None = None,
 	*,
 	lazy: bool = False,
-	is_default: bool = False,
 ) -> Callable[[Callable[P, Any]], Callable[P, Element]]: ...
 
 
@@ -48,24 +59,23 @@ def react_component(
 	src: str | None = None,
 	*,
 	lazy: bool = False,
-	is_default: bool = False,
 ) -> Callable[[Callable[P, Any]], Callable[P, Element]]:
 	"""Decorator for typed React component bindings."""
 	if isinstance(expr_or_name, Expr):
 		if src is not None:
 			raise TypeError("react_component expects (expr) or (name, src)")
 		if lazy:
-			raise TypeError("react_component lazy only supported with (name, src)")
-		if is_default:
-			raise TypeError(
-				"react_component is_default only supported with (name, src)"
-			)
+			raise TypeError("react_component lazy only supported with string inputs")
 		component = ReactComponent(expr_or_name)
 	elif isinstance(expr_or_name, str):
 		if src is None:
-			raise TypeError("react_component expects (name, src)")
-		kind = "default" if is_default else None
-		component = ReactComponent(Import(expr_or_name, src, kind=kind, lazy=lazy))
+			component = ReactComponent(expr_or_name, lazy=lazy)
+		else:
+			imp = Import(expr_or_name, src, lazy=lazy)
+			if lazy:
+				component = ReactComponent(react_lazy(imp))
+			else:
+				component = ReactComponent(imp)
 	else:
 		raise TypeError("react_component expects an Expr or (name, src)")
 

{pulse_framework-0.1.58 → pulse_framework-0.1.59}/src/pulse/render_session.py

@@ -457,7 +457,6 @@ class RenderSession:
 	def detach(self, path: str, *, timeout: float | None = None):
 		"""Client no longer wants updates. Queue briefly, then dispose."""
 		path = ensure_absolute_path(path)
-		print(f"Detaching '{path}'")
 		mount = self.route_mounts.get(path)
 		if not mount:
 			return

{pulse_framework-0.1.58 → pulse_framework-0.1.59}/src/pulse/transpiler/dynamic_import.py

@@ -11,7 +11,7 @@ For lazy-loaded React components, use Import(lazy=True) with React.lazy:
     from pulse.js.react import React, lazy
 
     # Low-level: Import(lazy=True) creates a factory, wrap with React.lazy
-    factory = Import("Chart", "./Chart", kind="default", lazy=True)
+    factory = Import("./Chart", lazy=True)
     LazyChart = Jsx(React.lazy(factory))
 
     # High-level: lazy() helper combines both

{pulse_framework-0.1.58 → pulse_framework-0.1.59}/src/pulse/transpiler/imports.py

@@ -154,14 +154,13 @@ class Import(Expr):
 		useState = Import("useState", "react")
 
 		# Default import: import React from "react"
-		React = Import("React", "react", kind="default")
+		React = Import("react")
 
-		# Namespace import: import * as utils from "./utils"
-		utils = Import("utils", "./utils", kind="namespace")
+		# Namespace import: import * as React from "react"
+		React = Import("*", "react")
 
 		# Side-effect import: import "./styles.css"
-		Import("", "./styles.css", kind="side_effect")
-		Import("./styles.css")
+		Import("./styles.css", side_effect=True)
 
 		# Type-only import: import type { Props } from "./types"
 		Props = Import("Props", "./types", is_type=True)
@@ -171,12 +170,12 @@ class Import(Expr):
 		# Button("Click me", disabled=True) -> <Button_1 disabled={true}>Click me</Button_1>
 
 		# Local file imports (relative or absolute paths)
-		Import("", "./styles.css", kind="side_effect")  # Local CSS
-		utils = Import("utils", "./utils", kind="namespace")  # Local JS (resolves extension)
-		config = Import("config", "/absolute/path/config", kind="default")  # Absolute path
+		Import("./styles.css", side_effect=True)  # Local CSS
+		utils = Import("*", "./utils")  # Local JS namespace (resolves extension)
+		config = Import("/absolute/path/config")  # Absolute path default import
 
 		# Lazy import (generates factory for code-splitting)
-		Chart = Import("Chart", "./Chart", kind="default", lazy=True)
+		Chart = Import("./Chart", lazy=True)
 		# Generates: const Chart_1 = () => import("./Chart")
 	"""
 
@@ -197,7 +196,7 @@ class Import(Expr):
 		name: str,
 		src: str | None = None,
 		*,
-		kind: ImportKind | None = None,
+		side_effect: bool = False,
 		is_type: bool = False,
 		lazy: bool = False,
 		version: str | None = None,
@@ -205,13 +204,25 @@ class Import(Expr):
 		_caller_depth: int = 2,
 	) -> None:
 		if src is None:
-			if kind not in (None, "side_effect"):
-				raise TypeError(
-					"Import single-argument form is reserved for side effect imports"
-				)
+			if name == "*":
+				raise TypeError("Import('*') requires a source")
 			src = name
-			name = ""
-			kind = "side_effect"
+			if side_effect:
+				name = ""
+				kind: ImportKind = "side_effect"
+			else:
+				kind = "default"
+		else:
+			if side_effect:
+				raise TypeError("side_effect imports cannot specify a name")
+			if name == "*":
+				name = src
+				kind = "namespace"
+			else:
+				if not name:
+					raise TypeError("Import(name, src) requires a non-empty name")
+				kind = "named"
+
 		# Validate: lazy imports cannot be type-only
 		if lazy and is_type:
 			raise TranspileError("Import cannot be both lazy and type-only")
@@ -229,10 +240,6 @@ class Import(Expr):
 				asset = register_local_asset(resolved)
 				import_src = str(resolved)
 
-		# Default kind to "named" if not specified
-		if kind is None:
-			kind = "named"
-
 		self.name = name
 		self.src = import_src
 		self.kind = kind

{pulse_framework-0.1.58 → pulse_framework-0.1.59}/src/pulse/transpiler/js_module.py

@@ -160,8 +160,9 @@ class JsModule(Expr):
 		if self.src is None:
 			return Identifier(self.name)
 
-		import_kind = "default" if self.kind == "default" else "named"
-		return Import(self.name, self.src, kind=import_kind)
+		if self.kind == "default":
+			return Import(self.src)
+		return Import("*", self.src)
 
 	def get_value(self, name: str) -> Member | Class | Jsx | Identifier | Import:
 		"""Get a member of this module as an expression.

pulse_framework-0.1.58/src/pulse/codegen/js.py

@@ -1,74 +0,0 @@
-# Placeholders for the WIP JS compilation feature
-# NOTE: This module is deprecated. Use pulse.transpiler instead.
-
-from collections.abc import Callable
-from typing import Generic, TypeVar, TypeVarTuple
-
-from pulse.transpiler.imports import Import
-
-Args = TypeVarTuple("Args")
-R = TypeVar("R")
-
-
-class JsFunction(Generic[*Args, R]):
-	"A transpiled JS function (deprecated - use pulse.transpiler.function.JsFunction)"
-
-	name: str
-	hint: Callable[[*Args], R]
-
-	def __init__(
-		self,
-		name: str,
-		hint: Callable[[*Args], R],
-	) -> None:
-		self.name = name
-		self.hint = hint
-
-	def __call__(self, *args: *Args) -> R: ...
-
-
-class ExternalJsFunction(Generic[*Args, R]):
-	"An imported JS function (deprecated - use pulse.transpiler.imports.Import)"
-
-	import_: Import
-	hint: Callable[[*Args], R]
-	_prop: str | None
-
-	def __init__(
-		self,
-		name: str,
-		src: str,
-		*,
-		prop: str | None = None,
-		is_default: bool,
-		hint: Callable[[*Args], R],
-	) -> None:
-		kind = "default" if is_default else "named"
-		self.import_ = Import(name, src, kind=kind)
-		self._prop = prop
-		self.hint = hint
-
-	@property
-	def name(self) -> str:
-		return self.import_.name
-
-	@property
-	def src(self) -> str:
-		return self.import_.src
-
-	@property
-	def is_default(self) -> bool:
-		return self.import_.is_default
-
-	@property
-	def prop(self) -> str | None:
-		return self._prop
-
-	@property
-	def expr(self) -> str:
-		base = self.import_.js_name
-		if self._prop:
-			return f"{base}.{self._prop}"
-		return base
-
-	def __call__(self, *args: *Args) -> R: ...