pulse-framework 0.1.71__py3-none-any.whl → 0.1.72__py3-none-any.whl

pulse/queries/common.py

@@ -34,19 +34,31 @@ class Key(tuple[Hashable, ...]):
 			parts = tuple(key)
 			try:
 				key_hash = hash(parts)
-			except TypeError:
-				raise TypeError("QueryKey values must be hashable") from None
+			except TypeError as e:
+				raise TypeError(
+					f"Query key contains unhashable value: {e}.\n\n"
+					+ "Keys must contain only hashable values (strings, numbers, tuples).\n"
+					+ f"Got: {key!r}\n\n"
+					+ "If using a dict or list inside the key, convert it to a tuple:\n"
+					+ "    key=('users', tuple(user_ids))  # instead of list"
+				) from None
 			obj = super().__new__(cls, parts)
 			obj._hash = key_hash
 			return obj
-		raise TypeError("QueryKey must be a list or tuple of hashable values")
+		raise TypeError(
+			f"Query key must be a tuple or list, got {type(key).__name__}: {key!r}\n\n"
+			+ "Examples of valid keys:\n"
+			+ "    key=('users',)           # single-element tuple\n"
+			+ "    key=('user', user_id)    # tuple with dynamic value\n"
+			+ "    key=['posts', 'feed']    # list form also works"
+		)
 
 	@override
 	def __hash__(self) -> int:
 		return self._hash
 
 
-QueryKey: TypeAlias = tuple[Hashable, ...] | list[Hashable] | Key
+QueryKey: TypeAlias = tuple[Hashable, ...] | list[Hashable] | Key  # pyright: ignore[reportImplicitStringConcatenation]
 """List/tuple of hashable values identifying a query in the store.
 
 Used to uniquely identify queries for caching, deduplication, and invalidation.

pulse/queries/infinite_query.py

@@ -432,7 +432,8 @@ class InfiniteQuery(Generic[T, TParam], Disposable):
 		self._cancel_observer_actions(observer)
 
 		if len(self._observers) == 0:
-			self.schedule_gc()
+			if not self.__disposed__:
+				self.schedule_gc()
 
 	def invalidate(
 		self,
@@ -1308,8 +1309,17 @@ class InfiniteQueryProperty(Generic[T, TParam, TState], InitializableProperty):
 		)
 
 		if self._key is None:
+			# pyright: ignore[reportImplicitStringConcatenation]
 			raise RuntimeError(
-				f"key is required for infinite query '{self.name}'. Provide a key via @infinite_query(key=...) or @{self.name}.key decorator."
+				f"Missing query key for @infinite_query '{self.name}'. "
+				+ "A key is required to cache and share query results.\n\n"
+				+ f"Fix: Add key=(...) to the decorator or use the @{self.name}.key decorator:\n\n"
+				+ "    @ps.infinite_query(initial_page_param=..., key=('my_query',))\n"
+				+ f"    async def {self.name}(self, param): ...\n\n"
+				+ "Or with a dynamic key:\n\n"
+				+ f"    @{self.name}.key\n"
+				+ f"    def _{self.name}_key(self):\n"
+				+ "        return ('my_query', self.some_param)"
 			)
 		raw_initial = (
 			call_flexible(self._initial_data, state)

pulse/queries/query.py

@@ -563,7 +563,8 @@ class KeyedQuery(Generic[T], Disposable):
 				)
 
 		if len(self.observers) == 0:
-			self.schedule_gc()
+			if not self.__disposed__:
+				self.schedule_gc()
 
 	def schedule_gc(self):
 		self.cancel_gc()

pulse/render_session.py

@@ -285,7 +285,6 @@ class RenderSession:
 		self._send_message = None
 		self._global_states = {}
 		self._global_queue = []
-		self.query_store = QueryStore()
 		self.connected = False
 		self.channels = ChannelsManager(self)
 		self.forms = FormRegistry(self)
@@ -293,6 +292,7 @@ class RenderSession:
 		self._pending_js_results = {}
 		self._tasks = TaskRegistry(name=f"render:{id}")
 		self._timers = TimerRegistry(tasks=self._tasks, name=f"render:{id}")
+		self.query_store = QueryStore()
 		self.prerender_queue_timeout = prerender_queue_timeout
 		self.detach_queue_timeout = detach_queue_timeout
 		self.disconnect_queue_timeout = disconnect_queue_timeout
@@ -574,9 +574,10 @@ class RenderSession:
 	# ---- Helpers ----
 
 	def close(self):
+		# Close all pending timers at the start, to avoid anything firing while we clean up
+		self._timers.cancel_all()
 		self.forms.dispose()
 		self._tasks.cancel_all()
-		self._timers.cancel_all()
 		for path in list(self.route_mounts.keys()):
 			self.detach(path, timeout=0)
 		self.route_mounts.clear()
@@ -597,6 +598,8 @@ class RenderSession:
 			if not fut.done():
 				fut.cancel()
 		self._pending_js_results.clear()
+		# Close any timer that may have been scheduled during cleanup (ex: query GC)
+		self._timers.cancel_all()
 		self._global_queue = []
 		self._send_message = None
 		self.connected = False

{pulse_framework-0.1.71.dist-info → pulse_framework-0.1.72.dist-info}/METADATA

@@ -1,20 +1,20 @@
 Metadata-Version: 2.3
 Name: pulse-framework
-Version: 0.1.71
+Version: 0.1.72
 Summary: Pulse - Full-stack framework for building real-time React applications in Python
-Requires-Dist: websockets>=12.0
 Requires-Dist: fastapi>=0.128.0
 Requires-Dist: uvicorn>=0.24.0
 Requires-Dist: mako>=1.3.10
 Requires-Dist: typer>=0.16.0
 Requires-Dist: python-socketio>=5.16.0
 Requires-Dist: rich>=13.7.1
-Requires-Dist: python-multipart>=0.0.20
+Requires-Dist: python-multipart>=0.0.22
 Requires-Dist: python-dateutil>=2.9.0.post0
 Requires-Dist: starlette>=0.50.0,<0.51.0
 Requires-Dist: urllib3>=2.6.3
 Requires-Dist: watchfiles>=1.1.0
 Requires-Dist: httpx>=0.28.1
+Requires-Dist: aiohttp>=3.12.0
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 

{pulse_framework-0.1.71.dist-info → pulse_framework-0.1.72.dist-info}/RECORD

@@ -1,11 +1,11 @@
-pulse/__init__.py,sha256=yeGbAC9Nkp5ug4sfi3U1epaRfI1_D0zBbMtPQpPEBHA,32393
+pulse/__init__.py,sha256=VV1oD_y0xnhQ_yBj1XqGWjIaw4Hi-xGHYQfEMv-Z1Bo,32453
 pulse/_examples.py,sha256=dFuhD2EVXsbvAeexoG57s4VuN4gWLaTMOEMNYvlPm9A,561
-pulse/app.py,sha256=TjMP21lpwYpRnkMkeKL8EA22V9xSKTA6_5GQI9Btw_o,36059
+pulse/app.py,sha256=Bi94rYG-MoldkGa-_CscLMstjTEV8BHVAgDbvapRGzI,36167
 pulse/channel.py,sha256=ePpvD2mDbddt_LMxxxDjNRgOLbVi8Ed6TmJFgkrALB0,15790
 pulse/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pulse/cli/cmd.py,sha256=zh3Ah6c16cNg3o_v_If_S58Qe8rvxNe5M2VrTkwvDU8,15957
+pulse/cli/cmd.py,sha256=LQK_B6iANOAqcQCM0KMTfRbpqGYRaPDkEBvvaAS3qNI,15985
 pulse/cli/dependencies.py,sha256=qU-rF7QyP0Rl1Fl0YKQubrGNBzj84BAbH1uUT3ehxik,4283
-pulse/cli/folder_lock.py,sha256=-AKld2iM91G0uHB3F5ARD0QAjOw0TmsYYGaFgy_V350,3477
+pulse/cli/folder_lock.py,sha256=CGJCovbSxZ59dllwNUqtPDx6YCED8k3ct5ZsEL0gzfw,4035
 pulse/cli/helpers.py,sha256=XXRRXeGFgeq-jbp0QGFFVq_aGg_Kp7_AkYsTK8LfSdg,7810
 pulse/cli/logging.py,sha256=3uuB1dqI-lHJkodNUURN6UMWdKF5UQ9spNG-hBG7bA4,2516
 pulse/cli/models.py,sha256=NBV5byBDNoAQSk0vKwibLjoxuA85XBYIyOVJn64L8oU,858
@@ -17,7 +17,7 @@ pulse/code_analysis.py,sha256=NBba_7VtOxZYMyfku_p-bWkG0O_1pi1AxcaNyVM1nmY,1024
 pulse/codegen/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pulse/codegen/codegen.py,sha256=Zw55vzevg_17hFtSi6KLl-EWSiABKRfZe6fB-cWpLAk,10330
 pulse/codegen/templates/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pulse/codegen/templates/layout.py,sha256=xz2ImZrbpu-tUkHZ38U6npIDzeYhrR_s41BuNPJUnOU,4470
+pulse/codegen/templates/layout.py,sha256=nJ9k0MDUHOGjtwbt8QAo9XdCPR06rqJSU9E8Qi4Uot4,4597
 pulse/codegen/templates/route.py,sha256=UjBrb3e_8tMkd1OjBjEsnYmK6PCQqOYZBWDuU59FcrI,9234
 pulse/codegen/templates/routes_ts.py,sha256=nPgKCvU0gzue2k6KlOL1TJgrBqqRLmyy7K_qKAI8zAE,1129
 pulse/codegen/utils.py,sha256=QoXcV-h-DLLmq_t03hDNUePS0fNnofUQLoR-TXzDFCY,539
@@ -41,7 +41,7 @@ pulse/forms.py,sha256=0irpErCMJk8-YO1BrxjMkFb8dnvSz3rfzTywmMeib7g,14042
 pulse/helpers.py,sha256=imVA9XzkYrYmdeqEdD7ot0g99adL1SVKv5bQGkKb-aQ,9504
 pulse/hooks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pulse/hooks/core.py,sha256=tDEcB_CTD4yI5bNKn7CtB40sRKIanGNqPD5_qLgSzf4,10982
-pulse/hooks/effects.py,sha256=cEPurXwRQoFmxasI0tZE1cQsZYnZr6VB5mWMUK0Db8c,2604
+pulse/hooks/effects.py,sha256=IRb37K9p0egBqlPvAnlW5dPohPvQGzmcyLSgbuNk5FU,3005
 pulse/hooks/init.py,sha256=PhjVBLlHpodPzVrRcx_QfEUrsx_6gEX_NuVhe6ojiYI,17834
 pulse/hooks/runtime.py,sha256=nxqwl8ByclIh5i3ZcCN6L3f0X3ZpwOBWajLb_FSbcDw,11839
 pulse/hooks/setup.py,sha256=ILbn2v6UFJPFBOWnJef1X2A9JLpIagEHN9Mx0d9947I,6925
@@ -74,21 +74,21 @@ pulse/js/window.py,sha256=yC1BjyH2jqp1x-CXJCUFta-ASyZ5668ozQ0AmAjZcxA,4097
 pulse/messages.py,sha256=hz5EUFVHbzXHkcByZcV_Y199vb-M9cGjMMBL1HXPctE,4024
 pulse/middleware.py,sha256=2syzmJ0r9fEa0k1pD7zC_1DHUMs9qLSWRzo5XXtKqsA,10896
 pulse/plugin.py,sha256=bu90qaUVFtZsIsW41dpshVK1vvIGHUsg6mFoiF0Wfso,2370
-pulse/proxy.py,sha256=tj30GIJJVNKMxMwPNJ39-gn3PAXbx5wua4PiQ7XupvQ,7857
+pulse/proxy.py,sha256=c13b0fE3sq82sFo46vv0emWLQ_ePwRkI7hiPZrnQDCE,22780
 pulse/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pulse/queries/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pulse/queries/client.py,sha256=KMGT92dESMrzpLlhd701fyh7Wrs3VKmM5cZoRQ0AEzg,18994
-pulse/queries/common.py,sha256=24EK5AWeunTeC7xObG3xufOjqLUNvnLN7PEECtlgqGU,3705
+pulse/queries/common.py,sha256=tjW5pqpWvRYUy3gsj-KxhUB9c5KBOgBqRKIuKJkob9A,4278
 pulse/queries/effect.py,sha256=1ePUi2TwP49L9LhlkKI2qV_HhIO4jKj1r5jyPaWiUn8,1508
-pulse/queries/infinite_query.py,sha256=sfZ_nwznD8kO_zWOvJ9uiyhJRb8slN1QMYWgzUnRvVQ,50025
+pulse/queries/infinite_query.py,sha256=QZmXN2G8r0FA7cCez5bjPxEEvWZTB2Sl5_Pob3d5E6E,50489
 pulse/queries/mutation.py,sha256=fhEpOZ7CuHImH4Y02QapYdTJrwe6K52-keb0d67wmms,8274
 pulse/queries/protocol.py,sha256=TOrUiI4QK55xuh0i4ch1u96apNl12QeYafkf6RVDd08,3544
-pulse/queries/query.py,sha256=R5XXQ32pCSNX5tpedietIlI4saT1MVIJnR6ElnKQyVk,41819
+pulse/queries/query.py,sha256=Ap1PRKoc1U1ddhnnHgBOuNX9oUcYD9nInpq87uTLnb8,41849
 pulse/queries/store.py,sha256=iw05_EFpyfiXv5_FV_x4aHtCo00mk0dDPFD461cajcg,3850
 pulse/react_component.py,sha256=8RLg4Bi7IcjqbnbEnp4hJpy8t1UsE7mG0UR1Q655LDk,2332
 pulse/reactive.py,sha256=GSh9wSH3THCBjDTafwWttyx7djeKBWV_KqjaKRYUNsA,31393
 pulse/reactive_extensions.py,sha256=yQ1PpdAh4kMvll7R15T72FOg8NFdG_HGBsGc63dawYk,33754
-pulse/render_session.py,sha256=RJgxJp_yRpDBr3l9ZFW0Eb6-dSp_urTzzPhPcHd0_Vo,23224
+pulse/render_session.py,sha256=65mhbKZ9o1vIDSRrM2p3VNPmo6Z5vn1Aoz7we5mw7P8,23417
 pulse/renderer.py,sha256=fjSsUvCqV12jyN7Y5XspKUfjQJJzKX-Chha5oF5PrAk,16001
 pulse/request.py,sha256=N0oFOLiGxpbgSgxznjvu64lG3YyOcZPKC8JFyKx6X7w,6023
 pulse/requirements.py,sha256=nMnE25Uu-TUuQd88jW7m2xwus6fD-HvXxQ9UNb7OOGc,1254
@@ -122,7 +122,7 @@ pulse/types/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pulse/types/event_handler.py,sha256=psQCydj-WEtBcFU5JU4mDwvyzkW8V2O0g_VFRU2EOHI,1618
 pulse/user_session.py,sha256=nsnsMgqq2xGJZLpbHRMHUHcLrElMP8WcA4gjGMrcoBk,10208
 pulse/version.py,sha256=711vaM1jVIQPgkisGgKZqwmw019qZIsc_QTae75K2pg,1895
-pulse_framework-0.1.71.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-pulse_framework-0.1.71.dist-info/entry_points.txt,sha256=i7aohd3QaPu5IcuGKKvsQQEiMYMe5HcF56QEsaLVO64,46
-pulse_framework-0.1.71.dist-info/METADATA,sha256=emzemQv95geCAUlozNCamUpuVbiVyo2REoNCYsAx3JI,8300
-pulse_framework-0.1.71.dist-info/RECORD,,
+pulse_framework-0.1.72.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+pulse_framework-0.1.72.dist-info/entry_points.txt,sha256=i7aohd3QaPu5IcuGKKvsQQEiMYMe5HcF56QEsaLVO64,46
+pulse_framework-0.1.72.dist-info/METADATA,sha256=Vn_d62C23dTizl4uuQ05BAkhQUDrBmnELQI3OrHkkE8,8299
+pulse_framework-0.1.72.dist-info/RECORD,,