next-resolver 0.0.1__tar.gz

next_resolver-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright © 2025-today, Andrea Giammarchi, @WebReflection
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the “Software”), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software
+is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+IN THE SOFTWARE.

next_resolver-0.0.1/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: next-resolver
+Version: 0.0.1
+Summary: A utility to simpify the repeated unique ID + promise dance (asyncio).
+Author: Andrea Giammarchi
+License: MIT
+Project-URL: Homepage, https://github.com/WebReflection/next-resolver#readme
+Project-URL: Repository, https://github.com/WebReflection/next-resolver
+Project-URL: Issues, https://github.com/WebReflection/next-resolver/issues
+Keywords: promise,async,asyncio,unique-id,resolver
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# next-resolver
+
+[![Coverage Status](https://coveralls.io/repos/github/WebReflection/next-resolver/badge.svg?branch=main)](https://coveralls.io/github/WebReflection/next-resolver?branch=main)
+
+<sup>**Social Media Photo by [Jan Genge](https://unsplash.com/@jan_genge) on [Unsplash](https://unsplash.com/)**</sup>
+
+
+A utility to simpify the repeated *unique ID* + *promise* dance.
+
+```js
+import nextResolver from 'next-resolver';
+
+const [next, resolve] = nextResolver();
+
+// next unique identifier and its promise
+const [id, promise] = next();
+
+// pass the promise around, hold the id ...
+// ... so that whenever it's done:
+if (condition) {
+  resolve(id, value);
+
+  // or reject via
+  resolve(id, null, new Error('reason'));
+}
+```
+
+The default `nextResolver()` accepts an optional callback that will receive a unique identifier that can be used to return something else:
+
+```js
+// use strings instead of numbers as IDs
+const [next, resolve] = nextResolver(String);
+
+const [id, promise] = next();
+typeof id; // string
+
+// use any Map key variant
+const [next, resolve] = nextResolver(id => {
+  // make it stronger (not really useful)
+  return `${id}-${crypto.randomUUID()}`;
+  // make it a unique ref
+  return { id };
+});
+```
+
+Please note that if the returned value is still awaited, the next `id` will be passed to create a new identifier (so don't put too much logic within the `id` creation, it's already granted to be unique per that logic/session).
+
+This is mostly needed in case you want to brand your async operations, so that something like a prefix would be enough:
+
+```js
+const [next, resolve] = nextResolver(id => `my-logic-${id}`);
+```
+
+And that's all folks 🥕

next_resolver-0.0.1/README.md

@@ -0,0 +1,54 @@
+# next-resolver
+
+[![Coverage Status](https://coveralls.io/repos/github/WebReflection/next-resolver/badge.svg?branch=main)](https://coveralls.io/github/WebReflection/next-resolver?branch=main)
+
+<sup>**Social Media Photo by [Jan Genge](https://unsplash.com/@jan_genge) on [Unsplash](https://unsplash.com/)**</sup>
+
+
+A utility to simpify the repeated *unique ID* + *promise* dance.
+
+```js
+import nextResolver from 'next-resolver';
+
+const [next, resolve] = nextResolver();
+
+// next unique identifier and its promise
+const [id, promise] = next();
+
+// pass the promise around, hold the id ...
+// ... so that whenever it's done:
+if (condition) {
+  resolve(id, value);
+
+  // or reject via
+  resolve(id, null, new Error('reason'));
+}
+```
+
+The default `nextResolver()` accepts an optional callback that will receive a unique identifier that can be used to return something else:
+
+```js
+// use strings instead of numbers as IDs
+const [next, resolve] = nextResolver(String);
+
+const [id, promise] = next();
+typeof id; // string
+
+// use any Map key variant
+const [next, resolve] = nextResolver(id => {
+  // make it stronger (not really useful)
+  return `${id}-${crypto.randomUUID()}`;
+  // make it a unique ref
+  return { id };
+});
+```
+
+Please note that if the returned value is still awaited, the next `id` will be passed to create a new identifier (so don't put too much logic within the `id` creation, it's already granted to be unique per that logic/session).
+
+This is mostly needed in case you want to brand your async operations, so that something like a prefix would be enough:
+
+```js
+const [next, resolve] = nextResolver(id => `my-logic-${id}`);
+```
+
+And that's all folks 🥕

next_resolver-0.0.1/next_resolver.egg-info/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: next-resolver
+Version: 0.0.1
+Summary: A utility to simpify the repeated unique ID + promise dance (asyncio).
+Author: Andrea Giammarchi
+License: MIT
+Project-URL: Homepage, https://github.com/WebReflection/next-resolver#readme
+Project-URL: Repository, https://github.com/WebReflection/next-resolver
+Project-URL: Issues, https://github.com/WebReflection/next-resolver/issues
+Keywords: promise,async,asyncio,unique-id,resolver
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# next-resolver
+
+[![Coverage Status](https://coveralls.io/repos/github/WebReflection/next-resolver/badge.svg?branch=main)](https://coveralls.io/github/WebReflection/next-resolver?branch=main)
+
+<sup>**Social Media Photo by [Jan Genge](https://unsplash.com/@jan_genge) on [Unsplash](https://unsplash.com/)**</sup>
+
+
+A utility to simpify the repeated *unique ID* + *promise* dance.
+
+```js
+import nextResolver from 'next-resolver';
+
+const [next, resolve] = nextResolver();
+
+// next unique identifier and its promise
+const [id, promise] = next();
+
+// pass the promise around, hold the id ...
+// ... so that whenever it's done:
+if (condition) {
+  resolve(id, value);
+
+  // or reject via
+  resolve(id, null, new Error('reason'));
+}
+```
+
+The default `nextResolver()` accepts an optional callback that will receive a unique identifier that can be used to return something else:
+
+```js
+// use strings instead of numbers as IDs
+const [next, resolve] = nextResolver(String);
+
+const [id, promise] = next();
+typeof id; // string
+
+// use any Map key variant
+const [next, resolve] = nextResolver(id => {
+  // make it stronger (not really useful)
+  return `${id}-${crypto.randomUUID()}`;
+  // make it a unique ref
+  return { id };
+});
+```
+
+Please note that if the returned value is still awaited, the next `id` will be passed to create a new identifier (so don't put too much logic within the `id` creation, it's already granted to be unique per that logic/session).
+
+This is mostly needed in case you want to brand your async operations, so that something like a prefix would be enough:
+
+```js
+const [next, resolve] = nextResolver(id => `my-logic-${id}`);
+```
+
+And that's all folks 🥕

next_resolver-0.0.1/next_resolver.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+LICENSE
+README.md
+pyproject.toml
+next_resolver.egg-info/PKG-INFO
+next_resolver.egg-info/SOURCES.txt
+next_resolver.egg-info/dependency_links.txt
+next_resolver.egg-info/top_level.txt
+python/__init__.py

next_resolver-0.0.1/next_resolver.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

next_resolver-0.0.1/next_resolver.egg-info/top_level.txt

@@ -0,0 +1 @@
+next_resolver

next_resolver-0.0.1/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "next-resolver"
+version = "0.0.1"
+description = "A utility to simpify the repeated unique ID + promise dance (asyncio)."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.8"
+authors = [{ name = "Andrea Giammarchi" }]
+keywords = ["promise", "async", "asyncio", "unique-id", "resolver"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+]
+
+[project.urls]
+Homepage = "https://github.com/WebReflection/next-resolver#readme"
+Repository = "https://github.com/WebReflection/next-resolver"
+Issues = "https://github.com/WebReflection/next-resolver/issues"
+
+[tool.setuptools]
+package-dir = { "next_resolver" = "python" }
+packages = ["next_resolver"]

next_resolver-0.0.1/python/__init__.py

@@ -0,0 +1,105 @@
+import asyncio
+
+__all__ = ["Promise", "next_resolver"]
+
+def resolver(value, wait=True):
+  if asyncio.iscoroutine(value):
+    task = asyncio.create_task(value)
+    if wait:
+      async def wait(resolve, reject):
+        try:
+          resolve(await task)
+        except Exception as e:
+          reject(e)
+
+      value = Promise(wait)
+
+  return value
+
+class PromiseWithResolvers:
+  def __init__(self):
+    self.resolve = None
+    self.reject = None
+    self.promise = None
+
+class Promise(asyncio.Future):
+
+  async def value(promise):
+    while isinstance(promise, Promise):
+      promise = await promise
+
+    return promise
+
+  def with_resolvers():
+    ref = PromiseWithResolvers()
+
+    def fn(resolve, reject):
+      ref.resolve = resolve
+      ref.reject = reject
+
+    ref.promise = Promise(fn)
+    return ref
+
+  def __init__(self, fn):
+    super().__init__()
+    this = self
+
+    def resolve(value):
+      this.set_result(value)
+
+    def reject(reason):
+      this.set_exception(reason)
+
+    resolver(fn(resolve, reject), wait=False)
+
+  def then(self, resolve, reject=None):
+    p = Promise.with_resolvers()
+
+    def done(future):
+      try:
+        result = future.result()
+        if resolve:
+          p.resolve(resolver(resolve(result)))
+
+      except Exception as e:
+        if reject:
+          p.reject(resolver(reject(e)))
+
+        else:
+          raise e
+
+    self.add_done_callback(done)
+
+    return p.promise
+
+  def catch(self, on_rejected):
+    return self.then(None, on_rejected)
+
+def next_resolver(typed = int):
+  map = {}
+  id = 0
+
+  def next():
+    nonlocal id
+
+    while True:
+      uid = typed(id)
+      id += 1
+      if not uid in map:
+        break
+
+    wr = Promise.with_resolvers()
+    map[uid] = wr
+    return [uid, wr.promise]
+
+  def resolver(uid, value, error=None):
+    if uid in map:
+      wr = map[uid]
+      del map[uid]
+
+      if error:
+        wr.reject(error)
+      else:
+        wr.resolve(value)
+
+  return [next, resolver]

next_resolver-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+