pulse-framework 0.1.37__py3-none-any.whl → 0.1.38a2__py3-none-any.whl

pulse/helpers.py

@@ -1,21 +1,9 @@
 import asyncio
 import inspect
-import json
 import os
-import platform
 import socket
-import time
 from collections.abc import Awaitable, Callable, Coroutine
-from pathlib import Path
-from typing import (
-	Any,
-	ParamSpec,
-	Protocol,
-	TypedDict,
-	TypeVar,
-	overload,
-	override,
-)
+from typing import Any, ParamSpec, Protocol, TypedDict, TypeVar, overload, override
 from urllib.parse import urlsplit
 
 from anyio import from_thread
@@ -380,115 +368,8 @@ def get_client_address_socketio(environ: dict[str, Any]) -> str | None:
 		return None
 
 
-# --- Runtime lock helpers (prevent multiple dev instances per web root) ---
-
-
-def _is_process_alive(pid: int) -> bool:
-	try:
-		# On POSIX, signal 0 checks for existence without killing
-		os.kill(pid, 0)
-	except ProcessLookupError:
-		return False
-	except PermissionError:
-		# Process exists but we may not have permission
-		return True
-	except Exception:
-		# Best-effort: assume alive if uncertain
-		return True
-	return True
-
-
-def lock_path_for_web_root(web_root: Path, filename: str = ".pulse.lock") -> Path:
-	return Path(web_root) / filename
-
-
-def write_gitignore_for_lock(lock_path: Path) -> None:
-	try:
-		gitignore_path = lock_path.parent / ".gitignore"
-		pattern = f"\n{lock_path.name}\n"
-		if gitignore_path.exists():
-			try:
-				content = gitignore_path.read_text()
-			except Exception:
-				content = ""
-			if lock_path.name not in content.split():
-				gitignore_path.write_text(content + pattern)
-		else:
-			gitignore_path.write_text(pattern.lstrip("\n"))
-	except Exception:
-		# Non-fatal
-		pass
-
-
-def _read_lock(lock_path: Path) -> dict[str, Any] | None:
-	try:
-		data = json.loads(lock_path.read_text())
-		if isinstance(data, dict):
-			return data
-	except Exception:
-		return None
-	return None
-
-
-def ensure_web_lock(lock_path: Path, *, owner: str = "server") -> tuple[Path, bool]:
-	"""Create a lock file or raise if an active one exists.
-
-	Returns (lock_path, created_now)
-	"""
-	lock_path = Path(lock_path)
-	write_gitignore_for_lock(lock_path)
-
-	if lock_path.exists():
-		info = _read_lock(lock_path) or {}
-		pid = int(info.get("pid", 0) or 0)
-		if pid and _is_process_alive(pid):
-			raise RuntimeError(
-				f"Another Pulse dev instance appears to be running (pid={pid}) for {lock_path.parent}."
-			)
-		# Stale lock; continue to overwrite
-
-	payload = {
-		"pid": os.getpid(),
-		"owner": owner,
-		"created_at": int(time.time()),
-		"hostname": socket.gethostname(),
-		"platform": platform.platform(),
-		"python": platform.python_version(),
-		"cwd": os.getcwd(),
-	}
-	try:
-		lock_path.parent.mkdir(parents=True, exist_ok=True)
-		lock_path.write_text(json.dumps(payload))
-	except Exception as exc:
-		raise RuntimeError(f"Failed to create lock file at {lock_path}: {exc}") from exc
-	return lock_path, True
-
-
-def validate_existing_lock(lock_path: Path) -> bool:
-	"""Validate an existing lock. Returns True if an active other instance exists.
-
-	If the file is missing or stale, returns False. If an active other instance is
-	detected, raises RuntimeError.
-	"""
-	lock_path = Path(lock_path)
-	if not lock_path.exists():
-		return False
-	info = _read_lock(lock_path) or {}
-	pid = int(info.get("pid", 0) or 0)
-	if pid and _is_process_alive(pid):
-		# Active lock
-		raise RuntimeError(
-			f"Another Pulse dev instance appears to be running (pid={pid}) for {lock_path.parent}."
-		)
-	return False
-
-
-def remove_web_lock(lock_path: Path) -> None:
-	try:
-		Path(lock_path).unlink(missing_ok=True)
-	except Exception:
-		# Best-effort cleanup
-		pass
+# --- Runtime lock helpers moved to pulse.cli.web_lock ---
+# Use WebLock context manager for idempotent lock management
 
 
 @overload
@@ -532,3 +413,19 @@ async def maybe_await(value: T | Awaitable[T]) -> T:
 	if inspect.isawaitable(value):
 		return await value
 	return value
+
+
+def find_available_port(start_port: int = 8000, max_attempts: int = 100) -> int:
+	"""Find an available port starting from start_port."""
+	for port in range(start_port, start_port + max_attempts):
+		try:
+			with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+				# Allow reuse of addresses in TIME_WAIT state (matches uvicorn behavior)
+				s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
+				s.bind(("localhost", port))
+				return port
+		except OSError:
+			continue
+	raise RuntimeError(
+		f"Could not find an available port after {max_attempts} attempts starting from {start_port}"
+	)

pulse/proxy.py

@@ -0,0 +1,192 @@
+"""
+Proxy ASGI app for forwarding requests to React Router server in single-server mode.
+"""
+
+import logging
+from collections.abc import Iterable
+from typing import Callable, cast
+
+import httpx
+from starlette.datastructures import Headers
+from starlette.types import ASGIApp, Receive, Scope, Send
+
+logger = logging.getLogger(__name__)
+
+
+class PulseProxy:
+	"""
+	ASGI app that proxies non-API requests to React Router server.
+
+	In single-server mode, Python FastAPI handles /_pulse/* routes and
+	proxies everything else to the React Router server running on an internal port.
+	"""
+
+	def __init__(
+		self,
+		app: ASGIApp,
+		get_web_port: Callable[[], int | None],
+		api_prefix: str = "/_pulse",
+	):
+		"""
+		Initialize proxy ASGI app.
+
+		Args:
+		    app: The ASGI application to wrap (socketio.ASGIApp)
+		    get_web_port: Callable that returns the React Router port (or None if not started)
+		    api_prefix: Prefix for API routes that should NOT be proxied (default: "/_pulse")
+		"""
+		self.app: ASGIApp = app
+		self.get_web_port: Callable[[], int | None] = get_web_port
+		self.api_prefix: str = api_prefix
+		self._client: httpx.AsyncClient | None = None
+
+	@property
+	def client(self) -> httpx.AsyncClient:
+		"""Lazy initialization of HTTP client."""
+		if self._client is None:
+			self._client = httpx.AsyncClient(
+				timeout=httpx.Timeout(30.0),
+				follow_redirects=False,
+			)
+		return self._client
+
+	async def __call__(self, scope: Scope, receive: Receive, send: Send) -> None:
+		"""
+		ASGI application handler.
+
+		Routes starting with api_prefix or WebSocket connections go to FastAPI.
+		Everything else is proxied to React Router.
+		"""
+		if scope["type"] != "http":
+			# Pass through non-HTTP requests (WebSocket, lifespan, etc.)
+			await self.app(scope, receive, send)
+			return
+
+		path = scope["path"]
+
+		# Check if path starts with API prefix or is a WebSocket upgrade
+		if path.startswith(self.api_prefix):
+			# This is an API route, pass through to FastAPI
+			await self.app(scope, receive, send)
+			return
+
+		# Check if this is a WebSocket upgrade request (even if not prefixed)
+		headers = Headers(scope=scope)
+		if headers.get("upgrade", "").lower() == "websocket":
+			# WebSocket request, pass through to FastAPI
+			await self.app(scope, receive, send)
+			return
+
+		# Proxy to React Router server
+		await self._proxy_request(scope, receive, send)
+
+	async def _proxy_request(self, scope: Scope, receive: Receive, send: Send) -> None:
+		"""
+		Forward HTTP request to React Router server and stream response back.
+		"""
+		# Get the web server port
+		port = self.get_web_port()
+		if port is None:
+			# Web server not started yet, return error
+			await send(
+				{
+					"type": "http.response.start",
+					"status": 503,
+					"headers": [(b"content-type", b"text/plain")],
+				}
+			)
+			await send(
+				{
+					"type": "http.response.body",
+					"body": b"Service Unavailable: Web server not ready",
+				}
+			)
+			return
+
+		# Build target URL
+		path = scope["path"]
+		query_string = scope.get("query_string", b"").decode("utf-8")
+		target_url = f"http://localhost:{port}"
+		target_path = f"{target_url}{path}"
+		if query_string:
+			target_path += f"?{query_string}"
+
+		# Extract headers
+		headers: dict[str, str] = {}
+		for name, value in cast(Iterable[tuple[bytes, bytes]], scope["headers"]):
+			name = name.decode("latin1")
+			value = value.decode("latin1")
+
+			# Skip host header (will be set by httpx)
+			if name.lower() == "host":
+				continue
+
+			# Collect headers (handle multiple values)
+			existing = headers.get(name)
+			if existing:
+				headers[name] = f"{existing},{value}"
+			else:
+				headers[name] = value
+
+		# Read request body
+		body_parts: list[bytes] = []
+		while True:
+			message = await receive()
+			if message["type"] == "http.request":
+				body_parts.append(message.get("body", b""))
+				if not message.get("more_body", False):
+					break
+		body = b"".join(body_parts)
+
+		try:
+			# Forward request to React Router
+			method = scope["method"]
+			response = await self.client.request(
+				method=method,
+				url=target_path,
+				headers=headers,
+				content=body,
+			)
+
+			# Send response status
+			await send(
+				{
+					"type": "http.response.start",
+					"status": response.status_code,
+					"headers": [
+						(name.encode("latin1"), value.encode("latin1"))
+						for name, value in response.headers.items()
+					],
+				}
+			)
+
+			# Stream response body
+			await send(
+				{
+					"type": "http.response.body",
+					"body": response.content,
+				}
+			)
+
+		except httpx.RequestError as e:
+			logger.error(f"Proxy request failed: {e}")
+
+			# Send error response
+			await send(
+				{
+					"type": "http.response.start",
+					"status": 502,
+					"headers": [(b"content-type", b"text/plain")],
+				}
+			)
+			await send(
+				{
+					"type": "http.response.body",
+					"body": b"Bad Gateway: Could not reach React Router server",
+				}
+			)
+
+	async def close(self):
+		"""Close the HTTP client."""
+		if self._client is not None:
+			await self._client.aclose()

pulse/user_session.py

@@ -189,8 +189,8 @@ class CookieSessionStore:
 		if not secret:
 			secret = env.pulse_secret or ""
 			if not secret:
-				mode = env.pulse_mode
-				if mode == "prod":
+				pulse_env = env.pulse_env
+				if pulse_env == "prod":
 					# In CI/production, require an explicit secret
 					raise RuntimeError(
 						"PULSE_SECRET must be set when using CookieSessionStore in production.\nCookieSessionStore is the default way of storing sessions in Pulse. Providing a secret is necessary to not invalidate all sessions on reload."

{pulse_framework-0.1.37.dist-info → pulse_framework-0.1.38a2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pulse-framework
-Version: 0.1.37
+Version: 0.1.38a2
 Summary: Pulse - Full-stack framework for building real-time React applications in Python
 Requires-Dist: websockets>=12.0
 Requires-Dist: fastapi>=0.104.0
@@ -12,6 +12,7 @@ Requires-Dist: rich>=13.7.1
 Requires-Dist: python-multipart>=0.0.20
 Requires-Dist: python-dateutil>=2.9.0.post0
 Requires-Dist: watchfiles>=1.1.0
+Requires-Dist: httpx>=0.28.1
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 

{pulse_framework-0.1.37.dist-info → pulse_framework-0.1.38a2.dist-info}/RECORD

@@ -1,16 +1,22 @@
-pulse/__init__.py,sha256=XJHCxLcA_mo3lRtP3tIp72Kqze6fFD8eRLRXZ5uiUuI,31475
-pulse/app.py,sha256=2LPXLOVXgFkOXAtbXdGsGjprs5rvEPo0Q5xky1scbXY,25249
+pulse/__init__.py,sha256=aJg4LvIeLYalXvEe1u47_A9ktS3HGIf4ZeAo6w1tbMQ,31463
+pulse/app.py,sha256=rCCbRUK7lNzsASbnTmPVG-JRjG0v8LTKPLTvCnPS978,29675
 pulse/channel.py,sha256=DuD1mg_xWvkpAWSKZ-EtBYdUzJ8IuKH0fxdgGOvFXpg,13041
 pulse/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pulse/cli/cmd.py,sha256=lqZii8euefMr3uRtQT0eon1TnkeFnZdmOzl9LiV1O48,15234
-pulse/cli/helpers.py,sha256=Hjda274MAIvqq_sED8XqPJTXKdAHsDoscP-05Pf0fm8,8062
+pulse/cli/cmd.py,sha256=_5vZL-7qSHA20CPocS5MH5KhG1giSn1t11T4kdYmzCY,11951
+pulse/cli/dependencies.py,sha256=ZBqBAfMvMBQUvh4THdPDztTMQ_dyR52S1IuotP_eEZs,5623
+pulse/cli/folder_lock.py,sha256=kvUmZBg869lwCTIZFoge9dhorv8qPXHTWwVv_jQg1k8,3477
+pulse/cli/helpers.py,sha256=8bRlV3d7w3w-jHaFvFYt9Pzue6_CbKOq_Z3jBsBOeUk,8820
+pulse/cli/models.py,sha256=hRmIWmhXmGf2otzVm1do4Dm19rkWkmTwAA3Am3kw2tE,692
 pulse/cli/packages.py,sha256=e7ycwwJfdmB4pzrai4DHos6-JzyUgmE4DCZp0BqjdeI,6792
+pulse/cli/processes.py,sha256=rv1FZ0aynNsYwAbyirqOOeTp-6gqfks8CETOAVPGwS0,5599
+pulse/cli/secrets.py,sha256=dNfQe6AzSYhZuWveesjCRHIbvaPd3-F9lEJ-kZA7ROw,921
+pulse/cli/uvicorn_log_config.py,sha256=Ip0iCeMUoY1ruv3Amf2SF84lW2DDpJFqdsLflZNxmeY,2407
 pulse/codegen/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pulse/codegen/codegen.py,sha256=IVP699lY7dd8oh4olaK45QBVTRGo4xNG2TsdVPnA5k8,10407
+pulse/codegen/codegen.py,sha256=RMc2NkldX0dmxRG59gdulCMEzywvHMo2akeiHQMTu4I,10681
 pulse/codegen/imports.py,sha256=13f0uzJsotw069aP_COUUPMuTXXhRKRwUzfxsSCq_6A,6070
 pulse/codegen/js.py,sha256=7MuiECSJ-DulSqKuMZ8z1q_d7e3AbK6MYiNTYALZCLA,881
 pulse/codegen/templates/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pulse/codegen/templates/layout.py,sha256=VeJo5qwikQdmyXl3f1KAz3OeLqtQb28iGvED9IXodyM,3587
+pulse/codegen/templates/layout.py,sha256=zvNAOo0rt0p6pduxZJ-nSZlzOYNySTV2KHkfUyU84RM,3676
 pulse/codegen/templates/route.py,sha256=cwmNHYkuecZ5M986hmm6SxisIoVSc656dtpqAvPjMjM,7824
 pulse/codegen/templates/routes_ts.py,sha256=nPgKCvU0gzue2k6KlOL1TJgrBqqRLmyy7K_qKAI8zAE,1129
 pulse/codegen/utils.py,sha256=QoXcV-h-DLLmq_t03hDNUePS0fNnofUQLoR-TXzDFCY,539
@@ -19,12 +25,12 @@ pulse/components/for_.py,sha256=LUyJEUlDM6b9oPjvUFgSsddxu6b6usF4BQdXe8FIiGI,1302
 pulse/components/if_.py,sha256=rQywsmdirNpkb-61ZEdF-tgzUh-37JWd4YFGblkzIdQ,1624
 pulse/components/react_router.py,sha256=TbRec-NVliUqrvAMeFXCrnDWV1rh6TGTPfRhqLuLubk,1129
 pulse/context.py,sha256=x_nCbCEUGygAdCZiTfko5uuYxVSAeCNhYa59zBq015M,1692
-pulse/cookies.py,sha256=elweCRj4mowgFEQG5sY1mNfunDUkWbfindvwMWRRibU,4787
+pulse/cookies.py,sha256=c7ua1Lv6mNe1nYnA4SFVvewvRQAbYy9fN5G3Hr_Dr5c,5000
 pulse/css.py,sha256=-FyQQQ0EZI1Ins30qiF3l4z9yDb1V9qWuJKWxHcKGkw,3910
 pulse/decorators.py,sha256=8At1HQTFs9KG7nd83miGMe3KkhTBVGDviaqZaY62bHI,6651
-pulse/env.py,sha256=ltJQL5ZNvVyrLP7_IGzeK3RA55UhzJTzoV4FOrJtV2c,2937
+pulse/env.py,sha256=BMEsIzR1_4c5bZzou7kYtSMk50gLnZ0Yf6l8U6Ve4IE,2575
 pulse/form.py,sha256=M87QwG4KFOrI8Nba7BTDoJ_wZ1-jzJW7QN4JweYCpuM,9004
-pulse/helpers.py,sha256=fhxoOvXQxnqgFnY_sZXOfwZxo8emhPiSSKnx1TWVj3M,13915
+pulse/helpers.py,sha256=q54JGen1lBIEGyLnNKvmW_7nnTFqFZBDMYXsoXvth7o,11628
 pulse/hooks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pulse/hooks/core.py,sha256=Ksb-vSYbigL2GnUooxdLVUTfnT7cHOlYEKgKtrihvJo,7344
 pulse/hooks/effects.py,sha256=CQvt5viAweGLSxaGGlWm155GlEQiwQnGussw7OfiCGc,2393
@@ -42,6 +48,7 @@ pulse/html/tags.pyi,sha256=I8dFoft9w4RvneZ3li1weAdijY1krj9jfO_p2SU6e04,13953
 pulse/messages.py,sha256=SKfNHYCDkoRa5X0CPlBQbsFfqIVMZQ7z34vWxQY-bUs,3206
 pulse/middleware.py,sha256=26ETGBLrIj8m0DOOUkafhLueQDzUurgjcqtI1L-6DNs,6518
 pulse/plugin.py,sha256=rYk1tR4SSoQQM8ZD2rWC-AnMfcN7xOscW92RbyK6LKA,594
+pulse/proxy.py,sha256=jQ9XRiRYHSeHA6GOVuYhXgLWU7HoKNtobQWn_bt07uQ,4984
 pulse/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pulse/query.py,sha256=u0KVFNt0d36sfmoxpQXvJ8DjctIHZaM_szlEonRiyRg,12849
 pulse/react_component.py,sha256=Rw1J6cHOX8-K3BnkswVOu2COgneVvRz1OYmyXkX17RM,25993
@@ -55,10 +62,10 @@ pulse/serializer.py,sha256=8RAITNoSNm5-U38elHpWmkBpcM_rxZFMCluJSfldfk4,5420
 pulse/state.py,sha256=nbnN9wGrHTP0AOFBfb4zKNzYaSkmLR5u0t4TVHg-UDA,9972
 pulse/types/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pulse/types/event_handler.py,sha256=OF7sOgYBb6iUs59RH1vQIH7aOrGPfs3nAaF7how-4PQ,1658
-pulse/user_session.py,sha256=UOOjUs18Ock1kNGMVnql02UqK3VJEfMF3phjFuogQWc,7569
+pulse/user_session.py,sha256=kCZtQpYZe2keDXzusd6jsjjw075am0dXrb25jKLg5JU,7578
 pulse/vdom.py,sha256=KTNBh2dVvDy9eXRzhneBJgk7F35MyWec8R_puQ4tSRY,12420
 pulse/version.py,sha256=711vaM1jVIQPgkisGgKZqwmw019qZIsc_QTae75K2pg,1895
-pulse_framework-0.1.37.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-pulse_framework-0.1.37.dist-info/entry_points.txt,sha256=i7aohd3QaPu5IcuGKKvsQQEiMYMe5HcF56QEsaLVO64,46
-pulse_framework-0.1.37.dist-info/METADATA,sha256=WYlLOfcpgE0FMRyM9qKXgpbAAk6Gu5Q0tfPcd8iWrcY,551
-pulse_framework-0.1.37.dist-info/RECORD,,
+pulse_framework-0.1.38a2.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+pulse_framework-0.1.38a2.dist-info/entry_points.txt,sha256=i7aohd3QaPu5IcuGKKvsQQEiMYMe5HcF56QEsaLVO64,46
+pulse_framework-0.1.38a2.dist-info/METADATA,sha256=Il4RlKJSqYB_RSQ5JyRJb0Qu897nUm-MACZA1VgrV3Y,582
+pulse_framework-0.1.38a2.dist-info/RECORD,,