fastapi-singleton 0.1.0__tar.gz → 0.2.0__tar.gz

{fastapi_singleton-0.1.0 → fastapi_singleton-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-singleton
-Version: 0.1.0
+Version: 0.2.0
 Summary: Application-scoped dependencies for FastAPI
 Author: Alex Ward
 Author-email: Alex Ward <alxwrd@googlemail.com>
@@ -14,7 +14,7 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Framework :: FastAPI
 Requires-Dist: fastapi>=0.115
-Requires-Python: >=3.13
+Requires-Python: >=3.10
 Project-URL: Repository, https://github.com/alxwrd/fastapi-singleton
 Project-URL: Releases, https://github.com/alxwrd/fastapi-singleton/releases
 Description-Content-Type: text/markdown
@@ -24,23 +24,16 @@ Description-Content-Type: text/markdown
     <p align="center"><i>
         Application-scoped dependencies for <code>fastapi</code>
     </i></p>
-    <img width="256px" src=".github/assets/three-card-trickster-768.png">
+    <img width="256px" src="https://github.com/alxwrd/fastapi-singleton/raw/main/.github/assets/three-card-trickster-768.png">
     <div align="center">
         <a href="https://github.com/alxwrd/fastapi-singleton/actions/workflows/test.yml"><img src="https://img.shields.io/github/actions/workflow/status/alxwrd/fastapi-singleton/test.yml?branch=main&label=main"></a>
         <a href="https://pypi.python.org/pypi/fastapi-singleton"><img src="https://img.shields.io/pypi/v/fastapi-singleton.svg"></a>
         <a href="https://github.com/alxwrd/fastapi-singleton/blob/main/LICENCE"><img src="https://img.shields.io/pypi/l/fastapi-singleton.svg?"></a>
     </div>
-
-Every dependency resolved through FastAPI's `Depends` is request-scoped:
-created on each request and discarded once the response is sent. That's the
-right default for most things, but it's the wrong default for connection
-pools, HTTP clients, and anything else that's expensive to create and safe to
-share.
-
-`fastapi-singleton` gives you a `@singleton` decorator that turns any
-dependency, function or class, into one shared instance per process, with
-proper startup and shutdown hooks wired into FastAPI's `lifespan`, instead of
-leaving it to whatever a `SIGTERM` does to a `@lru_cache`d object.
+    Gives you a `@singleton` decorator that turns any
+    dependency, function or class, into one shared instance per process, with
+    proper startup and shutdown hooks wired into FastAPI's `lifespan`, instead of
+    leaving it to whatever a `SIGTERM` does to a `@lru_cache`d object.
 </div>
 
 ## Example
@@ -125,14 +118,6 @@ class Connection:
         self.other = other
 ```
 
-A class singleton's `__init__` is the constructor, plain and simple -
-`Depends(Connection)` calls it exactly once, the same way any FastAPI
-class-based dependency works. `__init__` can never be `async def` in
-Python, so a class singleton can't do real async setup itself - if you need
-that (an async connection pool, an `await`-based client, anything with
-teardown), write it as a function singleton instead and have your class
-depend on it, the same way `Connection` depends on `get_other` above.
-
 A singleton can't depend on a regular, request-scoped dependency - there's
 no request to resolve it from when the singleton is constructed eagerly at
 startup, or directly in plain Python. `@singleton`-ing something that

{fastapi_singleton-0.1.0 → fastapi_singleton-0.2.0}/README.md

@@ -3,23 +3,16 @@
     <p align="center"><i>
         Application-scoped dependencies for <code>fastapi</code>
     </i></p>
-    <img width="256px" src=".github/assets/three-card-trickster-768.png">
+    <img width="256px" src="https://github.com/alxwrd/fastapi-singleton/raw/main/.github/assets/three-card-trickster-768.png">
     <div align="center">
         <a href="https://github.com/alxwrd/fastapi-singleton/actions/workflows/test.yml"><img src="https://img.shields.io/github/actions/workflow/status/alxwrd/fastapi-singleton/test.yml?branch=main&label=main"></a>
         <a href="https://pypi.python.org/pypi/fastapi-singleton"><img src="https://img.shields.io/pypi/v/fastapi-singleton.svg"></a>
         <a href="https://github.com/alxwrd/fastapi-singleton/blob/main/LICENCE"><img src="https://img.shields.io/pypi/l/fastapi-singleton.svg?"></a>
     </div>
-
-Every dependency resolved through FastAPI's `Depends` is request-scoped:
-created on each request and discarded once the response is sent. That's the
-right default for most things, but it's the wrong default for connection
-pools, HTTP clients, and anything else that's expensive to create and safe to
-share.
-
-`fastapi-singleton` gives you a `@singleton` decorator that turns any
-dependency, function or class, into one shared instance per process, with
-proper startup and shutdown hooks wired into FastAPI's `lifespan`, instead of
-leaving it to whatever a `SIGTERM` does to a `@lru_cache`d object.
+    Gives you a `@singleton` decorator that turns any
+    dependency, function or class, into one shared instance per process, with
+    proper startup and shutdown hooks wired into FastAPI's `lifespan`, instead of
+    leaving it to whatever a `SIGTERM` does to a `@lru_cache`d object.
 </div>
 
 ## Example
@@ -104,14 +97,6 @@ class Connection:
         self.other = other
 ```
 
-A class singleton's `__init__` is the constructor, plain and simple -
-`Depends(Connection)` calls it exactly once, the same way any FastAPI
-class-based dependency works. `__init__` can never be `async def` in
-Python, so a class singleton can't do real async setup itself - if you need
-that (an async connection pool, an `await`-based client, anything with
-teardown), write it as a function singleton instead and have your class
-depend on it, the same way `Connection` depends on `get_other` above.
-
 A singleton can't depend on a regular, request-scoped dependency - there's
 no request to resolve it from when the singleton is constructed eagerly at
 startup, or directly in plain Python. `@singleton`-ing something that

{fastapi_singleton-0.1.0 → fastapi_singleton-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fastapi-singleton"
-version = "0.1.0"
+version = "0.2.0"
 description = "Application-scoped dependencies for FastAPI"
 license = "MIT"
 readme = "README.md"
@@ -17,7 +17,7 @@ classifiers = [
   "Programming Language :: Python :: 3 :: Only",
   "Framework :: FastAPI",
 ]
-requires-python = ">=3.13"
+requires-python = ">=3.10"
 dependencies = [
     "fastapi>=0.115",
 ]

{fastapi_singleton-0.1.0 → fastapi_singleton-0.2.0}/src/fastapi_singleton/_function.py

@@ -61,7 +61,6 @@ class _BaseFunctionSingleton(Generic[_LockT]):
         self._provider = Provider(self._fn)
         self._created = None
         self._torn_down = False
-        self._before_end_done = False
         self._value = _UNSET
         self._construction_kwargs = {}
         self._lock = self.LOCK_METHOD()
@@ -114,12 +113,12 @@ class SyncFunctionSingleton(_BaseFunctionSingleton[threading.Lock]):
     def teardown(self) -> None:
         if not self._should_teardown():
             return
-        if not self._before_end_done:
-            self._before_end_done = True
-            _hooks.run_sync(self._hooks.before_end)
-        self._provider.teardown()
-        _hooks.run_sync(self._hooks.after_end)
         self._torn_down = True
+        try:
+            _hooks.run_sync(self._hooks.before_end)
+        finally:
+            self._provider.teardown()
+            _hooks.run_sync(self._hooks.after_end)
 
 
 class AsyncFunctionSingleton(_BaseFunctionSingleton[asyncio.Lock]):
@@ -143,14 +142,14 @@ class AsyncFunctionSingleton(_BaseFunctionSingleton[asyncio.Lock]):
     async def teardown(self) -> None:
         if not self._should_teardown():
             return
-        if not self._before_end_done:
-            self._before_end_done = True
-            await _hooks.run_async(self._hooks.before_end)
-        result = self._provider.teardown()
-        if inspect.isawaitable(result):
-            await result
-        await _hooks.run_async(self._hooks.after_end)
         self._torn_down = True
+        try:
+            await _hooks.run_async(self._hooks.before_end)
+        finally:
+            result = self._provider.teardown()
+            if inspect.isawaitable(result):
+                await result
+            await _hooks.run_async(self._hooks.after_end)
 
 
 def make_function_singleton(

{fastapi_singleton-0.1.0 → fastapi_singleton-0.2.0}/src/fastapi_singleton/_signature.py

@@ -55,11 +55,15 @@ def guard_against_cycles(singleton: Any) -> Iterator[None]:
 
 
 def _values_equal(a: Any, b: Any) -> bool:
-    """Like `==`, but treats two NaN floats as equal to each other.
-
-    Plain `==` follows IEEE 754, where NaN is never equal to anything,
-    including another NaN - so a repeat call with a semantically-unchanged
-    NaN-valued argument would otherwise look like a conflicting argument."""
+    """Like `==`, but recurses into dicts/lists/tuples and treats two NaN
+    floats as equal to each other.
+
+    Covers the ways `==` alone is unreliable for argument values: NaN
+    follows IEEE 754, where it's never equal to anything (including
+    another NaN), and unhashable containers need their elements compared
+    individually to catch a NaN nested inside them. Without this, a repeat
+    call with semantically-unchanged arguments could look like a
+    conflicting one."""
     if (
         isinstance(a, float)
         and isinstance(b, float)