omlish 0.0.0.dev74__py3-none-any.whl → 0.0.0.dev76__py3-none-any.whl

omlish/.manifests.json

@@ -47,6 +47,18 @@
       }
     }
   },
+  {
+    "module": ".secrets.pwgen",
+    "attr": "_CLI_MODULE",
+    "file": "omlish/secrets/pwgen.py",
+    "line": 75,
+    "value": {
+      "$omdev.cli.types.CliModule": {
+        "cmd_name": "pwgen",
+        "mod_name": "omlish.secrets.pwgen"
+      }
+    }
+  },
   {
     "module": ".specs.jmespath.__main__",
     "attr": "_CLI_MODULE",

omlish/__about__.py

@@ -1,5 +1,5 @@
-__version__ = '0.0.0.dev74'
-__revision__ = '002d07c8f9579e6b60584c9b2c6c05cd6b7219af'
+__version__ = '0.0.0.dev76'
+__revision__ = 'f7a91a7adb0b3e2018caef9de1ec592d87644c60'
 
 
 #
@@ -97,7 +97,7 @@ class Project(ProjectBase):
 
             'aiomysql ~= 0.2',
             'aiosqlite ~= 0.20',
-            'asyncpg ~= 0.29; python_version < "3.13"',
+            'asyncpg ~= 0.30; python_version < "3.13"',
 
             'apsw ~= 3.46',
 

omlish/dataclasses/impl/exceptions.py

@@ -1,8 +1,50 @@
+import types
+import typing as ta
+
+
 class ValidationError(Exception):
     pass
 
 
+def _hands_off_repr(obj: ta.Any) -> str:
+    return f'{obj.__class__.__qualname__}@{hex(id(obj))[2:]}'
+
+
+def _fn_repr(fn: ta.Callable) -> str:
+    if (co := getattr(fn, '__code__', None)) is None or not isinstance(co, types.CodeType):
+        return repr(fn)
+
+    if not (co_filename := co.co_filename):
+        return repr(fn)
+
+    return f'{fn!r} ({co_filename}:{co.co_firstlineno})'
+
+
 class FieldValidationError(ValidationError):
-    def __init__(self, field: str) -> None:
-        super().__init__(field)
+    def __init__(
+            self,
+            obj: ta.Any,
+            field: str,
+            fn: ta.Callable,
+            value: ta.Any,
+    ) -> None:
+        super().__init__(
+            f'{self.__class__.__name__} '
+            f'for field {field!r} '
+            f'on object {_hands_off_repr(obj)} '
+            f'in validator {_fn_repr(fn)} '
+            f'with value {value!r}',
+        )
+
+        self.obj = obj
         self.field = field
+        self.fn = fn
+        self.value = value
+
+    def __repr__(self) -> str:
+        return f'{self.__class__.__name__}({", ".join([
+            f"obj={_hands_off_repr(self.obj)}",
+            f"field={self.field!r}",
+            f"fn={_fn_repr(self.fn)}",
+            f"value={self.value!r}",
+        ])})'

omlish/dataclasses/impl/fields.py

@@ -8,6 +8,7 @@ import typing as ta
 
 from ... import check as check_
 from ... import lang
+from .exceptions import FieldValidationError
 from .internals import FIELDS_ATTR
 from .internals import FieldType
 from .internals import is_classvar
@@ -29,6 +30,23 @@ MISSING = dc.MISSING
 ##
 
 
+def raise_field_validation_error(
+        obj: ta.Any,
+        field: str,
+        fn: ta.Callable,
+        value: ta.Any,
+):
+    raise FieldValidationError(
+        obj,
+        field,
+        fn,
+        value,
+    )
+
+
+##
+
+
 def field_type(f: dc.Field) -> FieldType:
     if (ft := getattr(f, '_field_type')) is not None:
         return FieldType(ft)
@@ -193,7 +211,10 @@ def field_init(
     if fx.validate is not None:
         cn = f'__dataclass_validate__{f.name}__'
         locals[cn] = fx.validate
-        lines.append(f'if not {cn}({value}): raise __dataclass_FieldValidationError__({f.name})')
+        lines.append(
+            f'if not {cn}({value}): '
+            f'__dataclass_raise_field_validation_error__({self_name}, {f.name!r}, {cn}, {value})',
+        )
 
     if fx.check_type:
         cn = f'__dataclass_check_type__{f.name}__'

omlish/dataclasses/impl/init.py

@@ -3,11 +3,11 @@ import inspect
 import typing as ta
 
 from ... import lang
-from .exceptions import FieldValidationError
 from .exceptions import ValidationError
 from .fields import field_init
 from .fields import field_type
 from .fields import has_default
+from .fields import raise_field_validation_error
 from .internals import HAS_DEFAULT_FACTORY
 from .internals import POST_INIT_NAME
 from .internals import FieldType
@@ -101,7 +101,7 @@ class InitBuilder:
             '__dataclass_builtins_isinstance__': isinstance,
             '__dataclass_builtins_TypeError__': TypeError,
             '__dataclass_ValidationError__': ValidationError,
-            '__dataclass_FieldValidationError__': FieldValidationError,
+            '__dataclass_raise_field_validation_error__': raise_field_validation_error,
         })
 
         body_lines: list[str] = []

omlish/formats/yaml.py

@@ -118,7 +118,7 @@ class NodeWrappingConstructorMixin:
         yield omap
         uomap = next(gen)
         lang.exhaust(gen)
-        for key, value in uomap:  # type: ignore
+        for key, value in uomap:
             omap.append(NodeWrapped((key, value), node))
 
     def construct_yaml_omap(self, node):

omlish/graphs/dags.py

@@ -80,7 +80,7 @@ class Subdag(ta.Generic[U]):
     ) -> None:
         super().__init__()
 
-        self._dag: Dag[U] = check.isinstance(dag, Dag)  # type: ignore
+        self._dag: Dag[U] = check.isinstance(dag, Dag)
         self._targets = set(targets)
         self._ignored = set(ignored or []) - self._targets
 

omlish/graphs/domination.py

@@ -195,7 +195,7 @@ class _ImmediateDominanceComputer(ta.Generic[V]):
     def __init__(self, dfs: _Dfs[V]) -> None:
         super().__init__()
 
-        self._dfs: _Dfs[V] = check.isinstance(dfs, _Dfs)  # type: ignore
+        self._dfs: _Dfs[V] = check.isinstance(dfs, _Dfs)
 
         self._ancestor: dict[V, V] = {}
         self._semi = dict(self._dfs.semi)

omlish/http/__init__.py

@@ -40,3 +40,9 @@ from .json import (  # noqa
     json_dumps,
     json_loads,
 )
+
+from .multipart import (  # noqa
+    MultipartData,
+    MultipartEncoder,
+    MultipartField,
+)

omlish/http/clients.py

@@ -1,5 +1,6 @@
 """
 TODO:
+ - httpx catch
  - check=False
  - return non-200 HttpResponses
  - async
@@ -202,10 +203,14 @@ class HttpxHttpClient(HttpClient):
 ##
 
 
-def client() -> HttpClient:
+def _default_client() -> HttpClient:
     return UrllibHttpClient()
 
 
+def client() -> HttpClient:
+    return _default_client()
+
+
 def request(
         url: str,
         method: str | None = None,
@@ -217,6 +222,8 @@ def request(
 
         check: bool = False,
 
+        client: HttpClient | None = None,
+
         **kwargs: ta.Any,
 ) -> HttpResponse:
     req = HttpRequest(
@@ -231,9 +238,16 @@ def request(
         **kwargs,
     )
 
-    with client() as cli:
+    def do(cli: HttpClient) -> HttpResponse:
         return cli.request(
             req,
 
             check=check,
         )
+
+    if client is not None:
+        return do(client)
+
+    else:
+        with _default_client() as cli:
+            return do(cli)

omlish/http/headers.py

@@ -1,3 +1,7 @@
+"""
+TODO:
+ - handle secrets (but they're strs..)
+"""
 import typing as ta
 
 from .. import cached

omlish/http/multipart.py

@@ -0,0 +1,82 @@
+"""
+https://datatracker.ietf.org/doc/html/rfc7578
+"""
+import dataclasses as dc
+import io
+import typing as ta
+
+from .. import cached
+
+
+MultipartData: ta.TypeAlias = ta.Any  # bytes | file
+
+
+@dc.dataclass(frozen=True)
+class MultipartField:
+    data: MultipartData
+    name: bytes | None = None
+    file_name: bytes | None = None
+    headers: ta.Sequence[tuple[bytes, bytes]] | None = None
+
+
+class MultipartEncoder:
+    def __init__(
+            self,
+            fields: ta.Sequence[MultipartField],
+            *,
+            boundary: bytes | None = None,
+    ) -> None:
+        super().__init__()
+        self._fields = fields
+        self._boundary = boundary or b'----WebKitFormBoundary7MA4YWxkTrZu0gW'
+
+    class _Line(ta.NamedTuple):
+        data: MultipartData
+        sz: int
+
+    @cached.function
+    def _lines(self) -> ta.Sequence[_Line]:
+        l: list[MultipartEncoder._Line] = []
+
+        def add(d: MultipartData) -> None:
+            if isinstance(d, bytes):
+                sz = len(d)
+            else:
+                raise TypeError(d)
+            l.append(MultipartEncoder._Line(d, sz))
+
+        for f in self._fields:
+            add(b'--%s' % (self._boundary,))
+            ps = [b'form-data']
+            if f.name is not None:
+                ps.append(b'name="%s"' % (f.name,))
+            if f.file_name is not None:
+                ps.append(b'filename="%s"' % (f.file_name,))
+            add(b'Content-Disposition: ' + b'; '.join(ps))
+            for hk, hv in f.headers or ():
+                add(b'%s: %s' % (hk, hv))
+            add(b'')
+            add(f.data)
+
+        add(b'--%s--' % (self._boundary,))
+
+        return l
+
+    @cached.function
+    def content_type(self) -> bytes:
+        return b'multipart/form-data; boundary=%s' % (self._boundary,)
+
+    @cached.function
+    def content_length(self) -> int:
+        return sum(l.sz + 2 for l in self._lines())
+
+    @cached.function
+    def content(self) -> bytes:
+        buf = io.BytesIO()
+        for l in self._lines():
+            if isinstance(l.data, bytes):
+                buf.write(l.data)
+            else:
+                raise TypeError(l.data)
+            buf.write(b'\r\n')
+        return buf.getvalue()

omlish/http/sse.py

@@ -0,0 +1,96 @@
+"""
+TODO:
+ - end-of-line   = ( cr lf / cr / lf )
+"""
+import string
+import typing as ta
+
+from .. import dataclasses as dc
+from .. import lang
+
+
+class SseDecoderOutput(lang.Abstract):
+    pass
+
+
+@dc.dataclass(frozen=True)
+class SseComment(SseDecoderOutput, lang.Final):
+    data: bytes
+
+
+SseEventId: ta.TypeAlias = bytes
+
+
+@dc.dataclass(frozen=True)
+class SseEvent(SseDecoderOutput, lang.Final):
+    type: bytes
+    data: bytes
+    last_id: SseEventId = dc.xfield(b'', repr_fn=dc.truthy_repr)
+
+
+_DIGIT_BYTES = string.digits.encode('ascii')
+
+
+class SseDecoder:
+    """https://html.spec.whatwg.org/multipage/server-sent-events.html#event-stream-interpretation"""
+
+    def __init__(self) -> None:
+        super().__init__()
+
+        self._reset()
+        self._last_event_id = b''
+        self._reconnection_time: int | None = None
+
+    _event_type: bytes
+    _data: list[bytes]
+
+    def _reset(self) -> None:
+        self._event_type = b'message'
+        self._data = []
+
+    def _process_field(self, name: bytes, value: bytes) -> None:
+        if name == b'event':
+            self._event_type = value
+
+        elif name == b'data':
+            self._data.append(value)
+
+        elif name == b'id':
+            if 0 not in value:
+                self._last_event_id = value
+
+        elif name == b'retry':
+            if all(c in _DIGIT_BYTES for c in value):
+                self._reconnection_time = int(value)
+
+    def _dispatch_event(self) -> SseEvent:
+        data = b''.join(lang.interleave(self._data, b'\n'))
+
+        e = SseEvent(
+            type=self._event_type,
+            data=data,
+            last_id=self._last_event_id,
+        )
+
+        self._reset()
+
+        return e
+
+    def process_line(self, line: bytes) -> ta.Iterable[SseDecoderOutput]:
+        if b'\r' in line or b'\n' in line:
+            raise ValueError(line)
+
+        if not line:
+            yield self._dispatch_event()
+
+        elif line[0] == b':'[0]:
+            yield SseComment(line)
+
+        elif (c := line.find(b':')) >= 0:
+            d = c + 1
+            if len(line) > d and line[d] == b' '[0]:
+                d += 1
+            self._process_field(line[:c], line[d:])
+
+        else:
+            self._process_field(line, b'')

omlish/io.py

@@ -0,0 +1,142 @@
+import dataclasses as dc
+import io
+import typing as ta
+
+from . import check
+
+
+@dc.dataclass(frozen=True)
+class DelimitingBufferError(Exception):
+    buffer: 'DelimitingBuffer'
+
+
+class ClosedDelimitingBufferError(DelimitingBufferError):
+    pass
+
+
+class FullDelimitingBufferError(DelimitingBufferError):
+    pass
+
+
+class IncompleteDelimitingBufferError(DelimitingBufferError):
+    pass
+
+
+class DelimitingBuffer:
+    """
+    https://github.com/python-trio/trio/issues/796 :|
+    """
+
+    DEFAULT_DELIMITERS: bytes = b'\n'
+
+    def __init__(
+            self,
+            delimiters: ta.Iterable[int] = DEFAULT_DELIMITERS,
+            *,
+            keep_ends: bool = False,
+            max_size: int | None = None,
+            on_full: ta.Literal['raise', 'yield'] = 'raise',
+            on_incomplete: ta.Literal['raise', 'yield'] = 'yield',
+    ) -> None:
+        super().__init__()
+
+        self._delimiters = frozenset(check.isinstance(d, int) for d in delimiters)
+        self._keep_ends = keep_ends
+        self._max_size = max_size
+        self._on_full = on_full
+        self._on_incomplete = on_incomplete
+
+        self._buf: io.BytesIO | None = io.BytesIO()
+
+    @property
+    def is_closed(self) -> bool:
+        return self._buf is None
+
+    def tell(self) -> int:
+        if (buf := self._buf) is None:
+            raise ClosedDelimitingBufferError(self)
+        return buf.tell()
+
+    def peek(self) -> bytes:
+        if (buf := self._buf) is None:
+            raise ClosedDelimitingBufferError(self)
+        return buf.getvalue()
+
+    def _find_delim(self, data: bytes | bytearray, i: int) -> int | None:
+        r = None  # type: int | None
+        for d in self._delimiters:
+            if (p := data.find(d, i)) >= 0:
+                if r is None or p < r:
+                    r = p
+        return r
+
+    def _append_and_reset(self, chunk: bytes) -> bytes:
+        buf = check.not_none(self._buf)
+        if not buf.tell():
+            return chunk
+
+        buf.write(chunk)
+        ret = buf.getvalue()
+        buf.seek(0)
+        return ret
+
+    def feed(self, data: bytes | bytearray) -> ta.Generator[bytes, None, None]:
+        if (buf := self._buf) is None:
+            raise ClosedDelimitingBufferError(self)
+
+        if not data:
+            self._buf = None
+
+            if buf.tell():
+                if self._on_incomplete == 'raise':
+                    raise IncompleteDelimitingBufferError(self)
+
+                elif self._on_incomplete == 'yield':
+                    yield buf.getvalue()
+
+                else:
+                    raise ValueError(f'Unknown on_incomplete value: {self._on_incomplete!r}')
+
+            return
+
+        l = len(data)
+        i = 0
+        while i < l:
+            if (p := self._find_delim(data, i)) is None:
+                break
+
+            n = p + 1
+            if self._keep_ends:
+                p = n
+
+            yield self._append_and_reset(data[i:p])
+
+            i = n
+
+        if i >= l:
+            return
+
+        if self._max_size is None:
+            buf.write(data[i:])
+            return
+
+        while i < l:
+            remaining_data_len = l - i
+            remaining_buf_capacity = self._max_size - buf.tell()
+
+            if remaining_data_len < remaining_buf_capacity:
+                buf.write(data[i:])
+                return
+
+            if self._on_full == 'raise':
+                raise FullDelimitingBufferError(self)
+
+            elif self._on_full == 'yield':
+                p = i + remaining_buf_capacity
+
+                yield self._append_and_reset(data[i:p])
+
+                i = p
+
+            else:
+                raise ValueError(f'Unknown on_full value: {self._on_full!r}')

omlish/lang/__init__.py

@@ -140,6 +140,7 @@ from .iterables import (  # noqa
     flatmap,
     flatten,
     ilen,
+    interleave,
     itergen,
     peek,
     prodrange,
@@ -161,6 +162,7 @@ from .objects import (  # noqa
     build_mro_dict,
     can_weakref,
     deep_subclasses,
+    dir_dict,
     new_type,
     opt_repr,
     super_meta,

omlish/lang/iterables.py

@@ -37,6 +37,13 @@ def peek(vs: ta.Iterable[T]) -> tuple[T, ta.Iterator[T]]:
     return v, itertools.chain(iter((v,)), it)
 
 
+def interleave(vs: ta.Iterable[T], d: T) -> ta.Iterable[T]:
+    for i, v in enumerate(vs):
+        if i:
+            yield d
+        yield v
+
+
 Rangeable: ta.TypeAlias = ta.Union[  # noqa
     int,
     tuple[int],

omlish/lang/objects.py

@@ -129,6 +129,13 @@ def build_mro_dict(
     return dct
 
 
+def dir_dict(o: ta.Any) -> dict[str, ta.Any]:
+    return {
+        a: getattr(o, a)
+        for a in dir(o)
+    }
+
+
 ##
 
 

omlish/lifecycles/controller.py

@@ -55,7 +55,7 @@ class LifecycleController(Lifecycle, ta.Generic[LifecycleT]):
         return self._state
 
     def add_listener(self, listener: LifecycleListener[LifecycleT]) -> 'LifecycleController':
-        self._listeners.append(check.isinstance(listener, LifecycleListener))  # type: ignore
+        self._listeners.append(check.isinstance(listener, LifecycleListener))
         return self
 
     def _advance(

omlish/marshal/mappings.py

@@ -53,7 +53,7 @@ class MappingUnmarshaler(Unmarshaler):
     def unmarshal(self, ctx: UnmarshalContext, v: Value) -> ta.Mapping:
         dct: dict = {}
         for mk, mv in check.isinstance(v, collections.abc.Mapping).items():
-            dct[self.ke.unmarshal(ctx, mk)] = self.ve.unmarshal(ctx, mv)  # type: ignore
+            dct[self.ke.unmarshal(ctx, mk)] = self.ve.unmarshal(ctx, mv)
         return self.ctor(dct)
 
 

omlish/marshal/numbers.py

@@ -18,7 +18,7 @@ class ComplexMarshalerUnmarshaler(Marshaler, Unmarshaler):
 
     def unmarshal(self, ctx: UnmarshalContext, v: Value) -> ta.Any:
         real, imag = check.isinstance(v, list)
-        return complex(real, imag)  # type: ignore
+        return complex(real, imag)
 
 
 class DecimalMarshalerUnmarshaler(Marshaler, Unmarshaler):
@@ -35,7 +35,7 @@ class FractionMarshalerUnmarshaler(Marshaler, Unmarshaler):
 
     def unmarshal(self, ctx: UnmarshalContext, v: Value) -> ta.Any:
         num, denom = check.isinstance(v, list)
-        return fractions.Fraction(num, denom)  # type: ignore
+        return fractions.Fraction(num, denom)
 
 
 NUMBERS_MARSHALER_FACTORY = TypeMapMarshalerFactory({

omlish/marshal/objects.py

@@ -167,7 +167,7 @@ class ObjectMarshaler(Marshaler):
 
             if fi.options.embed:
                 for ek, ev in check.isinstance(mv, collections.abc.Mapping).items():
-                    ret[mn + check.non_empty_str(ek)] = ev  # type: ignore
+                    ret[mn + check.non_empty_str(ek)] = ev
 
             else:
                 ret[mn] = mv

omlish/marshal/polymorphism.py

@@ -183,8 +183,8 @@ class WrapperPolymorphismUnmarshaler(Unmarshaler):
     def unmarshal(self, ctx: UnmarshalContext, v: Value) -> ta.Any | None:
         ma = check.isinstance(v, collections.abc.Mapping)
         [(tag, iv)] = ma.items()
-        u = self.m[tag]  # type: ignore
-        return u.unmarshal(ctx, iv)  # type: ignore
+        u = self.m[tag]
+        return u.unmarshal(ctx, iv)
 
 
 @dc.dataclass(frozen=True)
@@ -194,8 +194,8 @@ class FieldPolymorphismUnmarshaler(Unmarshaler):
 
     def unmarshal(self, ctx: UnmarshalContext, v: Value) -> ta.Any | None:
         ma = dict(check.isinstance(v, collections.abc.Mapping))
-        tag = ma.pop(self.tf)  # type: ignore
-        u = self.m[tag]  # type: ignore
+        tag = ma.pop(self.tf)
+        u = self.m[tag]
         return u.unmarshal(ctx, ma)
 
 

omlish/secrets/pwgen.py

@@ -0,0 +1,83 @@
+"""
+TODO:
+ - len
+ - required character classes
+  - lowercase
+  - uppercase
+  - digits
+  - symbols
+ - move to omlish/secrets
+ - argparse, CliCmd
+"""
+import argparse
+import random
+import secrets
+import string
+import typing as ta
+
+
+CHAR_CLASSES: ta.Mapping[str, str] = {
+    'lower': string.ascii_lowercase,
+    'upper': string.ascii_uppercase,
+    'digit': string.digits,
+    'special': string.punctuation,
+}
+
+
+ALL_CHAR_CLASSES = tuple(CHAR_CLASSES.values())
+DEFAULT_LENGTH = 16
+
+
+def generate_password(
+        char_classes: ta.Sequence[str] = ALL_CHAR_CLASSES,
+        length: int = DEFAULT_LENGTH,
+        *,
+        rand: random.Random | None = None,
+) -> str:
+    if rand is None:
+        rand = secrets.SystemRandom()
+    l: list[str] = []
+    for cc in char_classes:
+        l.append(rand.choice(cc))
+    cs = ''.join(char_classes)
+    if not cs:
+        raise ValueError(cs)
+    while len(l) < length:
+        l.append(rand.choice(cs))
+    rand.shuffle(l)
+    return ''.join(l)
+
+
+def _main() -> None:
+    parser = argparse.ArgumentParser()
+    parser.add_argument('length', type=int, nargs='?', default=DEFAULT_LENGTH)
+    for cc in CHAR_CLASSES:
+        parser.add_argument(f'-{cc[0]}', f'--{cc}', action='store_true')
+    args = parser.parse_args()
+
+    cs = {
+        cc
+        for cc in CHAR_CLASSES
+        if getattr(args, cc) is not None
+    }
+    if cs:
+        ccs = tuple(CHAR_CLASSES[cc] for cc in cs)
+    else:
+        ccs = ALL_CHAR_CLASSES
+
+    pw = generate_password(
+        ccs,
+        args.length,
+    )
+    print(pw)
+
+
+# @omlish-manifest
+_CLI_MODULE = {'$omdev.cli.types.CliModule': {
+    'cmd_name': 'pwgen',
+    'mod_name': __name__,
+}}
+
+
+if __name__ == '__main__':
+    _main()

omlish/secrets/secrets.py

@@ -36,6 +36,15 @@ class Secret(lang.NotPicklable, lang.Sensitive, lang.Final):
         self._key = key
         setattr(self, self._VALUE_ATTR, lambda: value)
 
+    @classmethod
+    def of(cls, src: ta.Union['Secret', str], *, key: str | None = None) -> 'Secret':
+        if isinstance(src, Secret):
+            return src
+        elif isinstance(src, str):
+            return cls(key=key, value=src)
+        else:
+            raise TypeError(src)
+
     def __repr__(self) -> str:
         return f'Secret<{self._key or ""}>'
 

{omlish-0.0.0.dev74.dist-info → omlish-0.0.0.dev76.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: omlish
-Version: 0.0.0.dev74
+Version: 0.0.0.dev76
 Summary: omlish
 Author: wrmsr
 License: BSD-3-Clause
@@ -41,7 +41,7 @@ Requires-Dist: apsw ~=3.46 ; extra == 'all'
 Requires-Dist: duckdb ~=1.1 ; extra == 'all'
 Requires-Dist: pytest ~=8.0 ; extra == 'all'
 Requires-Dist: python-snappy ~=0.7 ; (python_version < "3.13") and extra == 'all'
-Requires-Dist: asyncpg ~=0.29 ; (python_version < "3.13") and extra == 'all'
+Requires-Dist: asyncpg ~=0.30 ; (python_version < "3.13") and extra == 'all'
 Requires-Dist: sqlean.py ~=3.45 ; (python_version < "3.13") and extra == 'all'
 Provides-Extra: async
 Requires-Dist: anyio ~=4.6 ; extra == 'async'
@@ -87,7 +87,7 @@ Requires-Dist: aiomysql ~=0.2 ; extra == 'sqldrivers'
 Requires-Dist: aiosqlite ~=0.20 ; extra == 'sqldrivers'
 Requires-Dist: apsw ~=3.46 ; extra == 'sqldrivers'
 Requires-Dist: duckdb ~=1.1 ; extra == 'sqldrivers'
-Requires-Dist: asyncpg ~=0.29 ; (python_version < "3.13") and extra == 'sqldrivers'
+Requires-Dist: asyncpg ~=0.30 ; (python_version < "3.13") and extra == 'sqldrivers'
 Requires-Dist: sqlean.py ~=3.45 ; (python_version < "3.13") and extra == 'sqldrivers'
 Provides-Extra: testing
 Requires-Dist: pytest ~=8.0 ; extra == 'testing'

{omlish-0.0.0.dev74.dist-info → omlish-0.0.0.dev76.dist-info}/RECORD

@@ -1,5 +1,5 @@
-omlish/.manifests.json,sha256=TXvFdkAU0Zr2FKdo7fyvt9nr3UjCtrnAZ0diZXSAteE,1430
-omlish/__about__.py,sha256=6L5yBogPnXXOqNId_oVRZJ4kjVB68VskkdZvIJ7NlE0,3420
+omlish/.manifests.json,sha256=ucaSu1XcJPryi-AqINUejkVDeJAFk7Bp5ar5_tJTgME,1692
+omlish/__about__.py,sha256=ndeBykRuOFL5NcUF-CXeCBZk1bdqwu15XuWzvQiIeHU,3420
 omlish/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 omlish/argparse.py,sha256=Dc73G8lyoQBLvXhMYUbzQUh4SJu_OTvKUXjSUxq_ang,7499
 omlish/c3.py,sha256=4vogWgwPb8TbNS2KkZxpoWbwjj7MuHG2lQG-hdtkvjI,8062
@@ -11,6 +11,7 @@ omlish/dynamic.py,sha256=35C_cCX_Vq2HrHzGk5T-zbrMvmUdiIiwDzDNixczoDo,6541
 omlish/fnpairs.py,sha256=Sl8CMFNyDS-1JYAjSWqnT5FmUm9Lj6o7FxSRo7g4jww,10875
 omlish/fnpipes.py,sha256=AJkgz9nvRRm7oqw7ZgYyz21klu276LWi54oYCLg-vOg,2196
 omlish/genmachine.py,sha256=LCMiqvK32dAWtrlB6lKw9tXdQFiXC8rRdk4TMQYIroU,1603
+omlish/io.py,sha256=4_0naIRniQ_xGhCW44xkk3sKqgddCbtIjbs72SGqK9g,3679
 omlish/iterators.py,sha256=GGLC7RIT86uXMjhIIIqnff_Iu5SI_b9rXYywYGFyzmo,7292
 omlish/libc.py,sha256=8r7Ejyhttk9ruCfBkxNTrlzir5WPbDE2vmY7VPlceMA,15362
 omlish/matchfns.py,sha256=I1IlQGfEyk_AcFSy6ulVS3utC-uwyZM2YfUXYHc9Bw0,6152
@@ -131,11 +132,11 @@ omlish/dataclasses/impl/api.py,sha256=p7W519_EnDAWlkOVS-4BpP4SxadWIiUzC3RldSoB28
 omlish/dataclasses/impl/as_.py,sha256=CD-t7hkC1EP2F_jvZKIA_cVoDuwZ-Ln_xC4fJumPYX0,2598
 omlish/dataclasses/impl/copy.py,sha256=Tn8_n6Vohs-w4otbGdubBEvhd3TsSTaM3EfNGdS2LYo,591
 omlish/dataclasses/impl/descriptors.py,sha256=rEYE1Len99agTQCC25hSPMnM19BgPr0ZChABGi58Fdk,2476
-omlish/dataclasses/impl/exceptions.py,sha256=DeiM6rcjgncudn-XVuph9TDbVDEwBtyYb1bcbO3FFcA,193
-omlish/dataclasses/impl/fields.py,sha256=mr8tnSDceHGZ6VBbeegt-iCzQJbtCXoWOUwltjRULy4,6521
+omlish/dataclasses/impl/exceptions.py,sha256=-vqxZmfXVflymVuiM553XTlJProse5HEMktTpfdPCIY,1275
+omlish/dataclasses/impl/fields.py,sha256=DbdTUnwFNL7KxNZBmEAGg4muMyFWbiMR8BUtUAOLrrc,6863
 omlish/dataclasses/impl/frozen.py,sha256=x87DSM8FIMZ3c_BIUE8NooCkExFjPsabeqIueEP5qKs,2988
 omlish/dataclasses/impl/hashing.py,sha256=FKnHuXCg9ylrzK2TLGqO5yfRN4HX3F415CSLlVYXtYE,3190
-omlish/dataclasses/impl/init.py,sha256=IgxO9nwHaHF8jGrUAk-Y5xke9uV2OwzfEe-88McE1Wg,6161
+omlish/dataclasses/impl/init.py,sha256=t8wFWS5jw1XaY8KwL5iLSoeON0iILA2sqa-lDair0Ck,6181
 omlish/dataclasses/impl/internals.py,sha256=UvZYjrLT1S8ntyxJ_vRPIkPOF00K8HatGAygErgoXTU,2990
 omlish/dataclasses/impl/main.py,sha256=Ti0PKbFKraKvfmoPuR-G7nLVNzRC8mvEuXhCuC-M2kc,2574
 omlish/dataclasses/impl/metaclass.py,sha256=Fb0ExFiyYdOpvck4ayXMr_vEVDvHLhe28Ns3F4aduM8,3222
@@ -181,7 +182,7 @@ omlish/docker/manifests.py,sha256=LR4FpOGNUT3bZQ-gTjB6r_-1C3YiG30QvevZjrsVUQM,70
 omlish/formats/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 omlish/formats/dotenv.py,sha256=UjZl3gac-0U24sDjCCGMcCqO1UCWG2Zs8PZ4JdAg2YE,17348
 omlish/formats/props.py,sha256=JwFJbKblqzqnzXf7YKFzQSDfcAXzkKsfoYvad6FPy98,18945
-omlish/formats/yaml.py,sha256=DSJXUq9yanfxdS6ufNTyBHMtIZO57LRnJj4w9fLY1aM,6852
+omlish/formats/yaml.py,sha256=wTW8ECG9jyA7qIFUqKZUro4KAKpN4IvcW_qhlrKveXM,6836
 omlish/formats/json/__init__.py,sha256=moSR67Qkju2eYb_qVDtaivepe44mxAnYuC8OCSbtETg,298
 omlish/formats/json/__main__.py,sha256=1wxxKZVkj_u7HCcewwMIbGuZj_Wph95yrUbm474Op9M,188
 omlish/formats/json/cli.py,sha256=pHFvYji6h_kMUyTgHCuDFofeDVY_5Em0wBqqVOJzDmI,3504
@@ -192,25 +193,26 @@ omlish/formats/json/backends/orjson.py,sha256=GYZx0zgpxwkJbFh4EJLGa6VMoEK-Q6mf5t
 omlish/formats/json/backends/std.py,sha256=00NdUFT9GeWL1EWbgKhWLboDBIuDxr7EiizPZXbRWrc,1973
 omlish/formats/json/backends/ujson.py,sha256=m5-hlEQCMLhat3Hg_8QTyfMH-rSsQGJYdWRWoTWkfhM,1029
 omlish/graphs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-omlish/graphs/dags.py,sha256=JpTGxt5rsK7hy5EUy9rNUlIeDStT9ri86m8xEKiHQLE,3063
-omlish/graphs/domination.py,sha256=45iTyn7mZWPJ1ANrqD96aPXqzEeyFpybMvvcVxo9XvQ,7592
+omlish/graphs/dags.py,sha256=zp55lYgUdRCxmADwiGDHeehMJczZFA_tzdWqy77icOk,3047
+omlish/graphs/domination.py,sha256=oCGoWzWTxLwow0LDyGjjEf2AjFiOiDz4WaBtczwSbsQ,7576
 omlish/graphs/trees.py,sha256=t9kzLy33ynYV0TowVkyDvkkRBQV5x--1vtNBSB4Auus,8156
 omlish/graphs/dot/__init__.py,sha256=Y1MZRQBZkcYyG1Tn7K2FhL8aYbm4v4tk6f5g9AqEkUw,359
 omlish/graphs/dot/items.py,sha256=OWPf0-hjBgS1uyy2QgAEn4IgFHJcEg7sHVWeTx1ghZc,4083
 omlish/graphs/dot/make.py,sha256=RN30gHfJPiXx5Q51kbDdhVJYf59Fr84Lz9J-mXRt9sI,360
 omlish/graphs/dot/rendering.py,sha256=2UgXvMRN4Z9cfIqLlC7Iu_8bWbwUDEL4opHHkFfSqTw,3630
 omlish/graphs/dot/utils.py,sha256=_FMwn77WfiiAfLsRTOKWm4IYbNv5kQN22YJ5psw6CWg,801
-omlish/http/__init__.py,sha256=-ENDALr8ehHvivRD6cxIbEC94t0RHhrakf6CQRDTc8o,625
+omlish/http/__init__.py,sha256=OqCovZi_jv1Mnk975idaXA8FCGy4laoQIvNZ3hdKpRQ,722
 omlish/http/asgi.py,sha256=wXhBZ21bEl32Kv9yBrRwUR_7pHEgVtHP8ZZwbasQ6-4,3307
-omlish/http/clients.py,sha256=eOY4bmbGdXuOOabt9NLAcTO7G49u85-HoAFW28mCXS4,6004
-omlish/http/collections.py,sha256=s8w5s4Gewgxxhe2Ai0R45PgJYYifrLgTbU3VXVflHj4,260
+omlish/http/clients.py,sha256=WRtCNIt9Y790xpem69HiXJY9W-vPlpGPKZwpHusa2EE,6280
 omlish/http/consts.py,sha256=FTolezLknKU6WJjk_x2T3a5LEMlnZSqv7gzTq55lxcU,2147
 omlish/http/cookies.py,sha256=uuOYlHR6e2SC3GM41V0aozK10nef9tYg83Scqpn5-HM,6351
 omlish/http/dates.py,sha256=Otgp8wRxPgNGyzx8LFowu1vC4EKJYARCiAwLFncpfHM,2875
 omlish/http/encodings.py,sha256=w2WoKajpaZnQH8j-IBvk5ZFL2O2pAU_iBvZnkocaTlw,164
-omlish/http/headers.py,sha256=S66wiXezBHybrnjAM15E9x4GJvPRvFQHeKaXdJ799fw,5028
+omlish/http/headers.py,sha256=ZMmjrEiYjzo0YTGyK0YsvjdwUazktGqzVVYorY4fd44,5081
 omlish/http/json.py,sha256=9XwAsl4966Mxrv-1ytyCqhcE6lbBJw-0_tFZzGszgHE,7440
+omlish/http/multipart.py,sha256=vUU1OlYghsODs_OAJiz9nrWTBGXk1WIuk4FtSDykDqk,2205
 omlish/http/sessions.py,sha256=VZ_WS5uiQG5y7i3u8oKuQMqf8dPKUOjFm_qk_0OvI8c,4793
+omlish/http/sse.py,sha256=T2_EXTcDfEhCF4E9B68YtEYLFb803MPnh8eCNjdPlRo,2223
 omlish/http/wsgi.py,sha256=czZsVUX-l2YTlMrUjKN49wRoP4rVpS0qpeBn4O5BoMY,948
 omlish/inject/__init__.py,sha256=JQ7x8l9MjU-kJ5ap7cPVq7SY7zbbCIrjyJAF0UeE5-s,1886
 omlish/inject/binder.py,sha256=H8AQ4ecmBOtDL8fMgrU1yUJl1gBADLNcdysRbvO8Wso,4167
@@ -242,7 +244,7 @@ omlish/inject/impl/privates.py,sha256=alpCYyk5VJ9lJknbRH2nLVNFYVvFhkj-VC1Vco3zCF
 omlish/inject/impl/providers.py,sha256=QnwhsujJFIHC0JTgd2Wlo1kP53i3CWTrj1nKU2DNxwg,2375
 omlish/inject/impl/proxy.py,sha256=1ko0VaKqzu9UG8bIldp9xtUrAVUOFTKWKTjOCqIGr4s,1636
 omlish/inject/impl/scopes.py,sha256=ASfULXgP_ETlsAqFJfrZmyEaZt64Zr8tNn5ScA-EoXk,5900
-omlish/lang/__init__.py,sha256=-DRmyoSAwSWOh7nJh4UrpR-w_hGQfe-e06S9qLjHZF8,3636
+omlish/lang/__init__.py,sha256=pCZoKj7wnFeyl_f7AKBg3Ajl1vrInkqP7miRcjIy6tI,3666
 omlish/lang/cached.py,sha256=92TvRZQ6sWlm7dNn4hgl7aWKbX0J1XUEo3DRjBpgVQk,7834
 omlish/lang/clsdct.py,sha256=AjtIWLlx2E6D5rC97zQ3Lwq2SOMkbg08pdO_AxpzEHI,1744
 omlish/lang/cmp.py,sha256=5vbzWWbqdzDmNKAGL19z6ZfUKe5Ci49e-Oegf9f4BsE,1346
@@ -252,9 +254,9 @@ omlish/lang/descriptors.py,sha256=RRBbkMgTzg82fFFE4D0muqobpM-ZZaOta6yB1lpX3s8,66
 omlish/lang/exceptions.py,sha256=qJBo3NU1mOWWm-NhQUHCY5feYXR3arZVyEHinLsmRH4,47
 omlish/lang/functions.py,sha256=kkPfcdocg-OmyN7skIqrFxNvqAv89Zc_kXKYAN8vw8g,3895
 omlish/lang/imports.py,sha256=Oy7iInOTqgZv6nyRbnvGrPv4cKKIAzPbhfDXCajDUcc,6626
-omlish/lang/iterables.py,sha256=_q6rHbdFfW3VBqez0IV3rUABoNxsA_oBv_sykm5zsbQ,2243
+omlish/lang/iterables.py,sha256=xRwktm6i2RHSb_ELfAXdjITIfE69qDyMEzgeZqvQXiU,2386
 omlish/lang/maybes.py,sha256=NYHZDjqDtwPMheDrj2VtUVujxRPf8Qpgk4ZlZCTvBZc,3492
-omlish/lang/objects.py,sha256=t7Pvj9ILoxfdAMy5HC7bb9LfUokW5WfpLaoH2YYyTjQ,4460
+omlish/lang/objects.py,sha256=LOC3JvX1g5hPxJ7Sv2TK9kNkAo9c8J-Jw2NmClR_rkA,4576
 omlish/lang/resolving.py,sha256=OuN2mDTPNyBUbcrswtvFKtj4xgH4H4WglgqSKv3MTy0,1606
 omlish/lang/resources.py,sha256=-NmVTrSMKFZ6smVfOMz46ekZYVGgYh8cPooxQlFpG6s,2135
 omlish/lang/strings.py,sha256=BsciSYnckD4vGtC6kmtnugR9IN6CIHdcjO4nZu-pSAw,3898
@@ -270,7 +272,7 @@ omlish/lifecycles/__init__.py,sha256=1FjYceXs-4fc-S-C9zFYmc2axHs4znnQHcJVHdY7a6E
 omlish/lifecycles/abstract.py,sha256=70CQyZy-c9a2o0ZJxPeUT7eYjWZTBrp2HpUBnrHdAOM,1109
 omlish/lifecycles/base.py,sha256=ceXrNSzuv7iiTlX96UI1fvsQ70OgOmZl-UisDPyA3NA,1394
 omlish/lifecycles/contextmanagers.py,sha256=W0trOo6atbPSCoswmtUVOayAYnJ722qHBgda1oYxUEc,2073
-omlish/lifecycles/controller.py,sha256=L9U2KQohrOfxJnsu-LYNVBvLyUJnRCZyo1ehH1DjG14,3480
+omlish/lifecycles/controller.py,sha256=ToYNJKH1Mxr7HyyF1cJrrec8NV_m84jrcvTMX0V5emM,3464
 omlish/lifecycles/manager.py,sha256=Au66KaO-fI-SEJALaPUJsCHYW2GE20xextk1wKn2BEU,5445
 omlish/lifecycles/states.py,sha256=zqMOU2ZU-MDNnWuwauM3_anIAiXM8LoBDElDEraptFg,1292
 omlish/lifecycles/transitions.py,sha256=qQtFby-h4VzbvgaUqT2NnbNumlcOx9FVVADP9t83xj4,1939
@@ -306,14 +308,14 @@ omlish/marshal/forbidden.py,sha256=BNshzm4lN5O8sUZ1YvxrSYq3WPklq9NMQCRZ7RC3DLM,8
 omlish/marshal/global_.py,sha256=K76wB1-pdg4VWgiqR7wyxRNYr-voJApexYW2nV-R4DM,1127
 omlish/marshal/helpers.py,sha256=-SOgYJmrURILHpPK6Wu3cCvhj8RJrqfJxuKhh9UMs7o,1102
 omlish/marshal/iterables.py,sha256=6I_ZdJemLSQtJ4J5NrB9wi-eyxiJZS61HzHXp1yeiX8,2592
-omlish/marshal/mappings.py,sha256=zhLtyot7tzQtBNj7C4RBxjMELxA5r2q2Mth8Br7xkFs,2803
+omlish/marshal/mappings.py,sha256=s2cFSLyo0PM1eoQ2-SONtFSOldk5ARsBj55-icvWZ5o,2787
 omlish/marshal/maybes.py,sha256=mgK3QsWHkXgRqo076KxYKH6elRxzJ_QDTodv93mgHR0,2198
 omlish/marshal/naming.py,sha256=lIklR_Od4x1ghltAgOzqcKhHs-leeSv2YmFhCHO7GIs,613
 omlish/marshal/nop.py,sha256=2mWve_dicFAiUQ2Y5asKkUW-XGmEE9Qi2ClIasFad0c,461
-omlish/marshal/numbers.py,sha256=oY_yMNJEnJhjfLh89gpPXvKqeUyhQcaTcQB6ecyHiG8,1704
-omlish/marshal/objects.py,sha256=8-w4Vc222gGGmTiTnUIIZBe1XXdAy0yo9aa1ZUAi1b4,8435
+omlish/marshal/numbers.py,sha256=kFRIX9l1yofiYzafV6SnYfEg0PiCsAqeRHOeT6BSxlM,1672
+omlish/marshal/objects.py,sha256=74tUmMymimSqgd4a6kyMh_owJe6J7YQXwCXEF-JWt1c,8419
 omlish/marshal/optionals.py,sha256=r0XB5rqfasvgZJNrKYd6Unq2U4nHt3JURi26j0dYHlw,1499
-omlish/marshal/polymorphism.py,sha256=doA8aLUhna6aco5b2Ok3jsem1V4NsF3rM5RTfJt0a7U,5708
+omlish/marshal/polymorphism.py,sha256=gCQ4_uzuqOcWstihK3twiMc-10G1ZHWLuLZxbajbecY,5644
 omlish/marshal/primitives.py,sha256=f_6m24Cb-FDGsZpYSas11nLt3xCCEUXugw3Hv4-aNhg,1291
 omlish/marshal/registries.py,sha256=FvC6qXHCizNB2QmU_N3orxW7iqfGYkiUXYYdTRWS6HA,2353
 omlish/marshal/standard.py,sha256=uQZIGiCwihmhB1tmhpKnZWZly0DDkdGjCnN0d41WHho,2985
@@ -334,8 +336,9 @@ omlish/secrets/__init__.py,sha256=SGB1KrlNrxlNpazEHYy95NTzteLi8ndoEgMhU7luBl8,42
 omlish/secrets/crypto.py,sha256=6CsLy0UEqCrBK8Xx_3-iFF6SKtu2GlEqUQ8-MliY3tk,3709
 omlish/secrets/marshal.py,sha256=U9uSRTWzZmumfNZeh_dROwVdGrARsp155TylRbjilP8,2048
 omlish/secrets/openssl.py,sha256=wxA_wIlxtuOUy71ABxAJgavh-UI_taOfm-A0dVlmSwM,6219
-omlish/secrets/passwords.py,sha256=3r-vEK6Gp6aq4L5Csnd06QnrjO9xfzHJP-g_7I9W_ao,4101
-omlish/secrets/secrets.py,sha256=XkzCrGNRLXUBXbw6_2pFGV2fuphbcgehtpp8zsjHaWM,7580
+omlish/secrets/pwgen.py,sha256=v-5ztnOTHTAWXLGR-3H6HkMj2nPIZBMbo5xWR3q0rDY,1707
+omlish/secrets/pwhash.py,sha256=3r-vEK6Gp6aq4L5Csnd06QnrjO9xfzHJP-g_7I9W_ao,4101
+omlish/secrets/secrets.py,sha256=cnDGBoPknVxsCN04_gqcJT_7Ebk3iO3VPkRZ2oMjkMw,7868
 omlish/secrets/subprocesses.py,sha256=EcnKlHHtnUMHGrBWXDfu8tv28wlgZx4P4GOiuPW9Vo8,1105
 omlish/specs/__init__.py,sha256=Xl4fT1o1MlcEIAjMt5EifgMuO4UBSa9Suj5NE9eMX1A,87
 omlish/specs/jmespath/LICENSE,sha256=IH-ZZlZkS8XMkf_ubNVD1aYHQ2l_wd0tmHtXrCcYpRU,1113
@@ -436,9 +439,9 @@ omlish/text/delimit.py,sha256=ubPXcXQmtbOVrUsNh5gH1mDq5H-n1y2R4cPL5_DQf68,4928
 omlish/text/glyphsplit.py,sha256=Ug-dPRO7x-OrNNr8g1y6DotSZ2KH0S-VcOmUobwa4B0,3296
 omlish/text/indent.py,sha256=6Jj6TFY9unaPa4xPzrnZemJ-fHsV53IamP93XGjSUHs,1274
 omlish/text/parts.py,sha256=7vPF1aTZdvLVYJ4EwBZVzRSy8XB3YqPd7JwEnNGGAOo,6495
-omlish-0.0.0.dev74.dist-info/LICENSE,sha256=B_hVtavaA8zCYDW99DYdcpDLKz1n3BBRjZrcbv8uG8c,1451
-omlish-0.0.0.dev74.dist-info/METADATA,sha256=fnVoKX28JDI8_XtMIkZGO22Po_cPDkZIi8nGwf6A_84,4167
-omlish-0.0.0.dev74.dist-info/WHEEL,sha256=OVMc5UfuAQiSplgO0_WdW7vXVGAt9Hdd6qtN4HotdyA,91
-omlish-0.0.0.dev74.dist-info/entry_points.txt,sha256=Lt84WvRZJskWCAS7xnQGZIeVWksprtUHj0llrvVmod8,35
-omlish-0.0.0.dev74.dist-info/top_level.txt,sha256=pePsKdLu7DvtUiecdYXJ78iO80uDNmBlqe-8hOzOmfs,7
-omlish-0.0.0.dev74.dist-info/RECORD,,
+omlish-0.0.0.dev76.dist-info/LICENSE,sha256=B_hVtavaA8zCYDW99DYdcpDLKz1n3BBRjZrcbv8uG8c,1451
+omlish-0.0.0.dev76.dist-info/METADATA,sha256=w0ccpB3fCgf6T797VrwXYnw7tUxFswGFbwRA4qKLWTc,4167
+omlish-0.0.0.dev76.dist-info/WHEEL,sha256=OVMc5UfuAQiSplgO0_WdW7vXVGAt9Hdd6qtN4HotdyA,91
+omlish-0.0.0.dev76.dist-info/entry_points.txt,sha256=Lt84WvRZJskWCAS7xnQGZIeVWksprtUHj0llrvVmod8,35
+omlish-0.0.0.dev76.dist-info/top_level.txt,sha256=pePsKdLu7DvtUiecdYXJ78iO80uDNmBlqe-8hOzOmfs,7
+omlish-0.0.0.dev76.dist-info/RECORD,,

omlish/http/collections.py

@@ -1,15 +0,0 @@
-import typing as ta
-
-
-V = ta.TypeVar('V')
-
-
-class HttpMap(ta.Mapping[str, V]):
-    def __getitem__(self, k):
-        raise NotImplementedError
-
-    def __len__(self):
-        raise NotImplementedError
-
-    def __iter__(self):
-        raise NotImplementedError