omlish 0.0.0.dev123__py3-none-any.whl → 0.0.0.dev125__py3-none-any.whl

omlish/__about__.py

@@ -1,5 +1,5 @@
-__version__ = '0.0.0.dev123'
-__revision__ = '09fa6f9aa73934c146949b217e1a50a12e238dda'
+__version__ = '0.0.0.dev125'
+__revision__ = 'ab4e58c3eaba25f0520ed6cb0df32e2322ca439a'
 
 
 #
@@ -168,6 +168,7 @@ class SetuptoolsBase:
             '.manifests.json',
 
             'LICENSE',
+            'LICENSE.txt',
         ],
     }
 

omlish/__init__.py

@@ -0,0 +1,3 @@
+# While the library as a whole only supports modern python, the 'lite' package is importable and usable down to python
+# 3.8. As a result this file needs to be kept basically empty as anything it would otherwise do would likely involve
+# non-lite code.

omlish/antlr/_runtime/LICENSE.txt

@@ -0,0 +1,28 @@
+Copyright (c) 2012-2022 The ANTLR Project. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright
+notice, this list of conditions and the following disclaimer in the
+documentation and/or other materials provided with the distribution.
+
+3. Neither name of copyright holders nor the names of its contributors
+may be used to endorse or promote products derived from this software
+without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

omlish/c3.py

@@ -1,40 +1,38 @@
-"""
-PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2
---------------------------------------------
-
-1. This LICENSE AGREEMENT is between the Python Software Foundation ("PSF"), and the Individual or Organization
-("Licensee") accessing and otherwise using this software ("Python") in source or binary form and its associated
-documentation.
-
-2. Subject to the terms and conditions of this License Agreement, PSF hereby grants Licensee a nonexclusive,
-royalty-free, world-wide license to reproduce, analyze, test, perform and/or display publicly, prepare derivative works,
-distribute, and otherwise use Python alone or in any derivative version, provided, however, that PSF's License Agreement
-and PSF's notice of copyright, i.e., "Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011,
-2012, 2013, 2014, 2015, 2016, 2017 Python Software Foundation; All Rights Reserved" are retained in Python alone or in
-any derivative version prepared by Licensee.
-
-3. In the event Licensee prepares a derivative work that is based on or incorporates Python or any part thereof, and
-wants to make the derivative work available to others as provided herein, then Licensee hereby agrees to include in any
-such work a brief summary of the changes made to Python.
-
-4. PSF is making Python available to Licensee on an "AS IS" basis.  PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS
-OR IMPLIED.  BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND DISCLAIMS ANY REPRESENTATION OR WARRANTY OF
-MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT INFRINGE ANY THIRD PARTY
-RIGHTS.
-
-5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL
-DAMAGES OR LOSS AS A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON, OR ANY DERIVATIVE THEREOF, EVEN IF
-ADVISED OF THE POSSIBILITY THEREOF.
-
-6. This License Agreement will automatically terminate upon a material breach of its terms and conditions.
-
-7. Nothing in this License Agreement shall be deemed to create any relationship of agency, partnership, or joint venture
-between PSF and Licensee.  This License Agreement does not grant permission to use PSF trademarks or trade name in a
-trademark sense to endorse or promote products or services of Licensee, or any third party.
-
-8. By copying, installing or otherwise using Python, Licensee agrees to be bound by the terms and conditions of this
-License Agreement.
-"""
+# PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2
+# --------------------------------------------
+#
+# 1. This LICENSE AGREEMENT is between the Python Software Foundation ("PSF"), and the Individual or Organization
+# ("Licensee") accessing and otherwise using this software ("Python") in source or binary form and its associated
+# documentation.
+#
+# 2. Subject to the terms and conditions of this License Agreement, PSF hereby grants Licensee a nonexclusive,
+# royalty-free, world-wide license to reproduce, analyze, test, perform and/or display publicly, prepare derivative
+# works, distribute, and otherwise use Python alone or in any derivative version, provided, however, that PSF's License
+# Agreement and PSF's notice of copyright, i.e., "Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
+# 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017 Python Software Foundation; All Rights Reserved" are retained in Python
+# alone or in any derivative version prepared by Licensee.
+#
+# 3. In the event Licensee prepares a derivative work that is based on or incorporates Python or any part thereof, and
+# wants to make the derivative work available to others as provided herein, then Licensee hereby agrees to include in
+# any such work a brief summary of the changes made to Python.
+#
+# 4. PSF is making Python available to Licensee on an "AS IS" basis.  PSF MAKES NO REPRESENTATIONS OR WARRANTIES,
+# EXPRESS OR IMPLIED.  BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND DISCLAIMS ANY REPRESENTATION OR WARRANTY
+# OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT INFRINGE ANY THIRD PARTY
+# RIGHTS.
+#
+# 5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL
+# DAMAGES OR LOSS AS A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON, OR ANY DERIVATIVE THEREOF, EVEN IF
+# ADVISED OF THE POSSIBILITY THEREOF.
+#
+# 6. This License Agreement will automatically terminate upon a material breach of its terms and conditions.
+#
+# 7. Nothing in this License Agreement shall be deemed to create any relationship of agency, partnership, or joint
+# venture between PSF and Licensee.  This License Agreement does not grant permission to use PSF trademarks or trade
+# name in a trademark sense to endorse or promote products or services of Licensee, or any third party.
+#
+# 8. By copying, installing or otherwise using Python, Licensee agrees to be bound by the terms and conditions of this
+# License Agreement.
 import operator
 import typing as ta
 

omlish/dataclasses/__init__.py

@@ -104,4 +104,8 @@ from .utils import (  # noqa
     update_fields_metadata,
 
     deep_replace,
+
+    iter_items,
+    iter_keys,
+    iter_values,
 )

omlish/dataclasses/utils.py

@@ -14,7 +14,7 @@ from .impl.params import get_field_extras
 T = ta.TypeVar('T')
 
 
-#
+##
 
 
 def maybe_post_init(sup: ta.Any) -> bool:
@@ -26,7 +26,7 @@ def maybe_post_init(sup: ta.Any) -> bool:
     return True
 
 
-#
+##
 
 
 def opt_repr(o: ta.Any) -> str | None:
@@ -37,7 +37,7 @@ def truthy_repr(o: ta.Any) -> str | None:
     return repr(o) if o else None
 
 
-#
+##
 
 
 def fields_dict(cls_or_instance: ta.Any) -> dict[str, dc.Field]:
@@ -121,7 +121,7 @@ def update_fields_metadata(
     return update_fields(inner, fields)
 
 
-#
+##
 
 
 def deep_replace(o: T, *args: str | ta.Callable[[ta.Any], ta.Mapping[str, ta.Any]]) -> T:
@@ -131,3 +131,21 @@ def deep_replace(o: T, *args: str | ta.Callable[[ta.Any], ta.Mapping[str, ta.Any
         return dc.replace(o, **args[0](o))  # type: ignore
     else:
         return dc.replace(o, **{args[0]: deep_replace(getattr(o, args[0]), *args[1:])})  # type: ignore
+
+
+##
+
+
+def iter_items(obj: ta.Any) -> ta.Iterator[tuple[str, ta.Any]]:
+    for f in dc.fields(obj):
+        yield (f.name, getattr(obj, f.name))
+
+
+def iter_keys(obj: ta.Any) -> ta.Iterator[str]:
+    for f in dc.fields(obj):
+        yield f.name
+
+
+def iter_values(obj: ta.Any) -> ta.Iterator[ta.Any]:
+    for f in dc.fields(obj):
+        yield getattr(obj, f.name)

omlish/http/consts.py

@@ -1,6 +1,7 @@
 """
 TODO:
  - import mimetypes lol
+ - http.HTTPStatus / http.HTTPMethod
 """
 import base64
 import http
@@ -36,6 +37,7 @@ STATUS_GATEWAY_TIMEOUT = format_status(http.HTTPStatus.GATEWAY_TIMEOUT)
 
 
 HEADER_CONTENT_TYPE = b'Content-Type'
+HEADER_CONTENT_LENGTH = b'Content-Length'
 HEADER_ACCEPT = b'Accept'
 
 CONTENT_CHARSET_UTF8 = b'charset=utf-8'

omlish/inject/impl/inspect.py

@@ -31,13 +31,15 @@ _SIGNATURE_CACHE: ta.MutableMapping[ta.Any, inspect.Signature] = weakref.WeakKey
 
 
 def signature(obj: ta.Any) -> inspect.Signature:
+    def get() -> inspect.Signature:
+        return inspect.signature(obj, eval_str=True)
     try:
         return _SIGNATURE_CACHE[obj]
     except TypeError:
-        return inspect.signature(obj)
+        return get()
     except KeyError:
         pass
-    sig = inspect.signature(obj)
+    sig = get()
     _SIGNATURE_CACHE[obj] = sig
     return sig
 

omlish/lang/__init__.py

@@ -1,3 +1,5 @@
+# This module should import nothing but stdlib modules, and as few as possible. That *includes* lite - no using lite.
+
 from .cached import (  # noqa
     cached_function,
     cached_property,
@@ -217,6 +219,7 @@ from .timeouts import (  # noqa
 )
 
 from .typing import (  # noqa
+    AnyFunc,
     BytesLike,
     Func0,
     Func1,

omlish/lang/typing.py

@@ -106,6 +106,14 @@ def typed_partial(obj, **kw):  # noqa
 # A workaround for typing deficiencies (like `Argument 2 to NewType(...) must be subclassable`).
 
 
+@dc.dataclass(frozen=True)
+class AnyFunc(ta.Generic[T]):
+    fn: ta.Callable[..., T]
+
+    def __call__(self, *args: ta.Any, **kwargs: ta.Any) -> T:
+        return self.fn(*args, **kwargs)
+
+
 @dc.dataclass(frozen=True)
 class Func0(ta.Generic[T]):
     fn: ta.Callable[[], T]

omlish/lite/check.py

@@ -17,6 +17,11 @@ def check_not_isinstance(v: T, spec: ta.Union[type, tuple]) -> T:
     return v
 
 
+def check_none(v: T) -> None:
+    if v is not None:
+        raise ValueError(v)
+
+
 def check_not_none(v: ta.Optional[T]) -> T:
     if v is None:
         raise ValueError