omlish 0.0.0.dev415__tar.gz → 0.0.0.dev416__tar.gz

{omlish-0.0.0.dev415/omlish.egg-info → omlish-0.0.0.dev416}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: omlish
-Version: 0.0.0.dev415
+Version: 0.0.0.dev416
 Summary: omlish
 Author: wrmsr
 License-Expression: BSD-3-Clause
@@ -109,7 +109,8 @@ Dynamic: license-file
 
 # Overview
 
-Core utilities and foundational code. It's relatively large but completely self-contained.
+Core utilities and foundational code. It's relatively large but completely self-contained, and has **no required
+dependencies of any kind**.
 
 # Notable packages
 
@@ -121,14 +122,18 @@ Core utilities and foundational code. It's relatively large but completely self-
   - **[cached](https://github.com/wrmsr/omlish/blob/master/omlish/lang/cached)** - The standard `cached_function` /
     `cached_property` tools, which are more capable than
     [`functools.lru_cache`](https://docs.python.org/3/library/functools.html#functools.lru_cache).
-  - **[imports](https://github.com/wrmsr/omlish/blob/master/omlish/lang/imports.py)** - Import tools like `proxy_import`
-    for late-loaded imports and `proxy_init` for late-loaded module globals.
+  - **[imports](https://github.com/wrmsr/omlish/blob/master/omlish/lang/imports.py)** - Import tools like:
+    - `proxy_import` - For late-loaded imports.
+    - `proxy_init` - For late-loaded module globals.
+    - `auto_proxy_init` - For automatic late-loaded package exports.
   - **[classes](https://github.com/wrmsr/omlish/blob/master/omlish/lang/classes)** - Class tools and bases, such as
     `Abstract` (which checks at subclass definition not instantiation), `Sealed` / `PackageSealed`, and `Final`.
   - **[maybes](https://github.com/wrmsr/omlish/blob/master/omlish/lite/maybes.py)** - A simple, nestable formalization
     of the presence or absence of an object, as in [many](https://en.cppreference.com/w/cpp/utility/optional)
     [other](https://docs.oracle.com/javase/8/docs/api/java/util/Optional.html)
     [languages](https://doc.rust-lang.org/std/option/).
+  - **[maysyncs](https://github.com/wrmsr/omlish/blob/master/omlish/lite/maysyncs.py)** - A lightweight means of sharing
+    code between sync and async contexts, eliminating the need for maintaining sync and async versions of functions.
 
 - **[bootstrap](https://github.com/wrmsr/omlish/blob/master/omlish/bootstrap)** - A centralized, configurable,
   all-in-one collection of various process-initialization minutiae like resource limiting, profiling, remote debugging,
@@ -224,12 +229,12 @@ Core utilities and foundational code. It's relatively large but completely self-
 
 - **[sql](https://github.com/wrmsr/omlish/blob/master/omlish/sql)** - A collection of SQL utilities, including:
 
-  - **[alchemy](https://github.com/wrmsr/omlish/blob/master/omlish/sql/alchemy)** - SQLAlchemy utilities. The codebase
-    is moving away from SQLAlchemy however in favor of its own internal SQL api.
   - **[api](https://github.com/wrmsr/omlish/blob/master/omlish/sql/api)** - An abstracted api for SQL interaction, with
     support for dbapi compatible drivers (and a SQLAlchemy adapter).
   - **[queries](https://github.com/wrmsr/omlish/blob/master/omlish/sql/queries)** - A SQL query builder with a fluent
     interface.
+  - **[alchemy](https://github.com/wrmsr/omlish/blob/master/omlish/sql/alchemy)** - SQLAlchemy utilities. The codebase
+    is moving away from SQLAlchemy however in favor of its own internal SQL api.
 
 - **[testing](https://github.com/wrmsr/omlish/blob/master/omlish/testing)** - Test - primarily pytest - helpers,
   including:
@@ -279,15 +284,15 @@ Code written in this style has notable differences from standard code, including
 
 # Dependencies
 
-This library has no required dependencies of any kind, but there are numerous optional integrations - see
+This library has no required dependencies of any kind, but there are some optional integrations - see
 [`__about__.py`](https://github.com/wrmsr/omlish/blob/master/omlish/__about__.py) for a full list, but some specific
 examples are:
 
+- **asttokens / executing** - For getting runtime source representations of function call arguments, an optional
+  capability of [check](https://github.com/wrmsr/omlish/blob/master/omlish/check.py).
 - **anyio** - While lite code must use only asyncio, non-trivial async standard code prefers to be written to anyio.
 - **pytest** - What is used for all standard testing - as lite code has no dependencies of any kind its testing uses
   stdlib's [unittest](https://docs.python.org/3/library/unittest.html).
-- **asttokens / executing** - For getting runtime source representations of function call arguments, an optional
-  capability of [check](https://github.com/wrmsr/omlish/blob/master/omlish/check.py).
 - **wrapt** - For (optionally-enabled) injector circular proxies.
 - **greenlet** - For some gnarly stuff like the
   [sync<->async bridge](https://github.com/wrmsr/omlish/blob/master/omlish/asyncs/bridge.py) and the

{omlish-0.0.0.dev415 → omlish-0.0.0.dev416}/README.md

@@ -1,6 +1,7 @@
 # Overview
 
-Core utilities and foundational code. It's relatively large but completely self-contained.
+Core utilities and foundational code. It's relatively large but completely self-contained, and has **no required
+dependencies of any kind**.
 
 # Notable packages
 
@@ -12,14 +13,18 @@ Core utilities and foundational code. It's relatively large but completely self-
   - **[cached](https://github.com/wrmsr/omlish/blob/master/omlish/lang/cached)** - The standard `cached_function` /
     `cached_property` tools, which are more capable than
     [`functools.lru_cache`](https://docs.python.org/3/library/functools.html#functools.lru_cache).
-  - **[imports](https://github.com/wrmsr/omlish/blob/master/omlish/lang/imports.py)** - Import tools like `proxy_import`
-    for late-loaded imports and `proxy_init` for late-loaded module globals.
+  - **[imports](https://github.com/wrmsr/omlish/blob/master/omlish/lang/imports.py)** - Import tools like:
+    - `proxy_import` - For late-loaded imports.
+    - `proxy_init` - For late-loaded module globals.
+    - `auto_proxy_init` - For automatic late-loaded package exports.
   - **[classes](https://github.com/wrmsr/omlish/blob/master/omlish/lang/classes)** - Class tools and bases, such as
     `Abstract` (which checks at subclass definition not instantiation), `Sealed` / `PackageSealed`, and `Final`.
   - **[maybes](https://github.com/wrmsr/omlish/blob/master/omlish/lite/maybes.py)** - A simple, nestable formalization
     of the presence or absence of an object, as in [many](https://en.cppreference.com/w/cpp/utility/optional)
     [other](https://docs.oracle.com/javase/8/docs/api/java/util/Optional.html)
     [languages](https://doc.rust-lang.org/std/option/).
+  - **[maysyncs](https://github.com/wrmsr/omlish/blob/master/omlish/lite/maysyncs.py)** - A lightweight means of sharing
+    code between sync and async contexts, eliminating the need for maintaining sync and async versions of functions.
 
 - **[bootstrap](https://github.com/wrmsr/omlish/blob/master/omlish/bootstrap)** - A centralized, configurable,
   all-in-one collection of various process-initialization minutiae like resource limiting, profiling, remote debugging,
@@ -115,12 +120,12 @@ Core utilities and foundational code. It's relatively large but completely self-
 
 - **[sql](https://github.com/wrmsr/omlish/blob/master/omlish/sql)** - A collection of SQL utilities, including:
 
-  - **[alchemy](https://github.com/wrmsr/omlish/blob/master/omlish/sql/alchemy)** - SQLAlchemy utilities. The codebase
-    is moving away from SQLAlchemy however in favor of its own internal SQL api.
   - **[api](https://github.com/wrmsr/omlish/blob/master/omlish/sql/api)** - An abstracted api for SQL interaction, with
     support for dbapi compatible drivers (and a SQLAlchemy adapter).
   - **[queries](https://github.com/wrmsr/omlish/blob/master/omlish/sql/queries)** - A SQL query builder with a fluent
     interface.
+  - **[alchemy](https://github.com/wrmsr/omlish/blob/master/omlish/sql/alchemy)** - SQLAlchemy utilities. The codebase
+    is moving away from SQLAlchemy however in favor of its own internal SQL api.
 
 - **[testing](https://github.com/wrmsr/omlish/blob/master/omlish/testing)** - Test - primarily pytest - helpers,
   including:
@@ -170,15 +175,15 @@ Code written in this style has notable differences from standard code, including
 
 # Dependencies
 
-This library has no required dependencies of any kind, but there are numerous optional integrations - see
+This library has no required dependencies of any kind, but there are some optional integrations - see
 [`__about__.py`](https://github.com/wrmsr/omlish/blob/master/omlish/__about__.py) for a full list, but some specific
 examples are:
 
+- **asttokens / executing** - For getting runtime source representations of function call arguments, an optional
+  capability of [check](https://github.com/wrmsr/omlish/blob/master/omlish/check.py).
 - **anyio** - While lite code must use only asyncio, non-trivial async standard code prefers to be written to anyio.
 - **pytest** - What is used for all standard testing - as lite code has no dependencies of any kind its testing uses
   stdlib's [unittest](https://docs.python.org/3/library/unittest.html).
-- **asttokens / executing** - For getting runtime source representations of function call arguments, an optional
-  capability of [check](https://github.com/wrmsr/omlish/blob/master/omlish/check.py).
 - **wrapt** - For (optionally-enabled) injector circular proxies.
 - **greenlet** - For some gnarly stuff like the
   [sync<->async bridge](https://github.com/wrmsr/omlish/blob/master/omlish/asyncs/bridge.py) and the

{omlish-0.0.0.dev415 → omlish-0.0.0.dev416}/omlish/__about__.py

@@ -1,5 +1,5 @@
-__version__ = '0.0.0.dev415'
-__revision__ = '79bb2b1f7af2d9c344f8471cd6e785914768a72f'
+__version__ = '0.0.0.dev416'
+__revision__ = '2ad7f56508df7d9415fc8acee12cf5eb215afbf2'
 
 
 #

{omlish-0.0.0.dev415 → omlish-0.0.0.dev416}/omlish/dataclasses/__init__.py

@@ -4,7 +4,7 @@ import sys as _sys
 from .. import lang as _lang
 
 
-with _lang.auto_proxy_init(globals()):
+with _lang.auto_proxy_init(globals()) as _api_cap:
     ##
 
     ##
@@ -178,3 +178,7 @@ globals()['make_dataclass'] = _self_patching_global_proxy(
 )
 
 globals()['replace'] = _self_patching_global_proxy('replace', 'xreplace')
+
+
+_api_cap.update_exports()
+del _api_cap

omlish-0.0.0.dev416/omlish/lang/__init__.py

@@ -0,0 +1,486 @@
+from .imports.proxyinit import auto_proxy_init as _auto_proxy_init
+
+
+with _auto_proxy_init(
+        globals(),
+        update_exports=True,
+        # eager=True,
+):
+    ##
+
+    from .asyncs import (  # noqa
+        async_list,
+
+        sync_await,
+        sync_async_list,
+    )
+
+    from .attrs import (  # noqa
+        AttrOps,
+        AttributePresentError,
+        DictAttrOps,
+        STD_ATTR_OPS,
+        SetAttrIfPresent,
+        StdAttrOps,
+        TRANSIENT_ATTR_OPS,
+        TransientAttrOps,
+        TransientDict,
+        set_attr,
+        transient_delattr,
+        transient_getattr,
+        transient_setattr,
+    )
+
+    from .cached.function import (  # noqa
+        cached_function,
+        static_init,
+    )
+
+    from .cached.property import (  # noqa
+        cached_property,
+    )
+
+    from .casing import (  # noqa
+        StringCasingError,
+        ImproperStringCasingError,
+        UnknownStringCasingError,
+        AmbiguousStringCasingError,
+
+        StringCasing,
+        CamelCase,
+        LowCamelCase,
+        SnakeCase,
+        UpSnakeCase,
+
+        STRING_CASINGS,
+        CAMEL_CASE,
+        LOW_CAMEL_CASE,
+        SNAKE_CASE,
+        UP_SNAKE_CASE,
+
+        camel_case,
+        low_camel_case,
+        snake_case,
+        up_snake_case,
+
+        get_string_casing,
+        split_string_casing,
+    )
+
+    from .classes.abstract import (  # noqa
+        Abstract,
+        AbstractTypeError,
+        get_abstract_methods,
+        is_abstract,
+        is_abstract_class,
+        is_abstract_method,
+        make_abstract,
+        unabstract_class,
+    )
+
+    from .classes.bindable import (  # noqa
+        BindableClass,
+    )
+
+    from .classes.namespaces import (  # noqa
+        GenericNamespaceMeta,
+        Namespace,
+        NamespaceMeta,
+    )
+
+    from .classes.protocols import (  # noqa
+        ProtocolForbiddenAsBaseClass,
+        ProtocolForbiddenAsBaseClassTypeError,
+    )
+
+    from .classes.restrict import (  # noqa
+        AnySensitive,
+        Final,
+        FinalTypeError,
+        NoBool,
+        NotInstantiable,
+        NotPicklable,
+        PackageSealed,
+        SENSITIVE_ATTR,
+        Sealed,
+        SealedError,
+        Sensitive,
+        no_bool,
+    )
+
+    from .classes.simple import (  # noqa
+        LazySingleton,
+        Marker,
+        SimpleMetaDict,
+        Singleton,
+    )
+
+    from .classes.virtual import (  # noqa
+        Callable,
+        Descriptor,
+        Picklable,
+        Virtual,
+        virtual_check,
+    )
+
+    from .clsdct import (  # noqa
+        ClassDctFn,
+        cls_dct_fn,
+        get_caller_cls_dct,
+        is_possibly_cls_dct,
+    )
+
+    from .collections import (  # noqa
+        empty_map,
+        merge_dicts,
+        yield_dict_init,
+    )
+
+    from .comparison import (  # noqa
+        Infinity,
+        InfinityType,
+        NegativeInfinity,
+        NegativeInfinityType,
+        cmp,
+    )
+
+    from .contextmanagers import (  # noqa
+        AsyncContextManager,
+        ContextManaged,
+        ContextManager,
+        ContextWrapped,
+        DefaultLockable,
+        Lockable,
+        NOP_CONTEXT_MANAGER,
+        NopContextManager,
+        Timer,
+        breakpoint_on_exception,
+        context_var_setting,
+        context_wrapped,
+        default_lock,
+        disposing,
+        double_check_setdefault,
+        maybe_managing,
+    )
+
+    from .datetimes import (  # noqa
+        ISO_FMT,
+        ISO_FMT_US,
+        ISO_FMT_NTZ,
+        ISO_FMT_US_NTZ,
+
+        utcnow,
+        utcfromtimestamp,
+    )
+
+    from .descriptors import (  # noqa
+        AccessForbiddenError,
+        access_forbidden,
+        attr_property,
+        classonly,
+        decorator,
+        is_method_descriptor,
+        item_property,
+        unwrap_callable,
+        unwrap_callable_with_partials,
+        unwrap_func,
+        unwrap_func_with_partials,
+        unwrap_method_descriptors,
+        update_wrapper,
+    )
+
+    from .enums import (  # noqa
+        enum_name_repr,
+    )
+
+    from .errors import (  # noqa
+        DuplicateKeyError,
+    )
+
+    from .functions import (  # noqa
+        VoidError,
+        as_async,
+        call_with,
+        coalesce,
+        cond_kw,
+        constant,
+        finally_,
+        identity,
+        is_lambda,
+        is_none,
+        is_not_none,
+        isinstance_of,
+        issubclass_of,
+        maybe_call,
+        new_function,
+        new_function_kwargs,
+        nullary_constant,
+        opt_coalesce,
+        opt_fn,
+        opt_kw,
+        periodically,
+        raise_,
+        raising,
+        recurse,
+        strict_eq,
+        truthy_kw,
+        try_,
+        void,
+    )
+
+    from .generators import (  # noqa
+        GeneratorLike,
+        GeneratorMappedIterator,
+        autostart,
+        capture_coroutine,
+        capture_generator,
+        genmap,
+        nextgen,
+    )
+
+    from .imports.conditional import (  # noqa
+        register_conditional_import,
+        trigger_conditional_imports,
+    )
+
+    from .imports.lazy import (  # noqa
+        lazy_import,
+        proxy_import,
+    )
+
+    from .imports.proxyinit import (  # noqa
+        proxy_init,
+
+        AutoProxyInitError,
+        AutoProxyInitErrors,
+        AutoProxyInit,
+        auto_proxy_init,
+    )
+
+    from .imports.resolving import (  # noqa
+        can_import,
+        get_real_module_name,
+        resolve_import_name,
+        try_import,
+    )
+
+    from .imports.traversal import (  # noqa
+        import_all,
+        yield_import_all,
+        yield_importable,
+    )
+
+    from .iterables import (  # noqa
+        IteratorWithReturn,
+        asrange,
+        chunk,
+        common_prefix_len,
+        exhaust,
+        flatmap,
+        flatten,
+        ilen,
+        interleave,
+        itergen,
+        peek,
+        prodrange,
+        readiter,
+        renumerate,
+        take,
+    )
+
+    from .lazyglobals import (  # noqa
+        LazyGlobals,
+    )
+
+    from .maybes import (  # noqa
+        empty,
+        just,
+    )
+
+    from .maysyncs import (  # noqa
+        make_maysync_fn,
+        make_maysync_generator_fn,
+        make_maysync,
+
+        make_maysync_from_sync,
+    )
+
+    from .objects import (  # noqa
+        Identity,
+        SimpleProxy,
+        anon_object,
+        arg_repr,
+        can_weakref,
+        deep_subclasses,
+        dir_dict,
+        mro_dict,
+        mro_owner_dict,
+        new_type,
+        opt_repr,
+        super_meta,
+    )
+
+    from .outcomes import (  # noqa
+        Either,
+        Error,
+        Outcome,
+        OutcomeAlreadyUnwrappedError,
+        Value,
+        acapture,
+        capture,
+        error,
+        value,
+    )
+
+    from .overrides import (  # noqa
+        needs_override,
+
+        is_override,
+
+        RequiresOverrideError,
+        RequiresOverride,
+    )
+
+    from .params import (  # noqa
+        ArgsParam,
+        KwOnlyParam,
+        KwargsParam,
+        Param,
+        ParamSeparator,
+        ParamSpec,
+        PosOnlyParam,
+        ValParam,
+        VarParam,
+        param_render,
+    )
+
+    from .recursion import (  # noqa
+        LimitedRecursionError,
+        recursion_limiting,
+        recursion_limiting_context,
+    )
+
+    from .resolving import (  # noqa
+        Resolvable,
+        ResolvableClassNameError,
+        get_cls_fqcn,
+        get_fqcn_cls,
+    )
+
+    from .resources import (  # noqa
+        ReadableResource,
+        get_package_resources,
+        get_relative_resources,
+    )
+
+    from .strings import (  # noqa
+        BOOL_FALSE_STRINGS,
+        BOOL_STRINGS,
+        BOOL_TRUE_STRINGS,
+        STRING_BOOL_VALUES,
+        find_any,
+        indent_lines,
+        is_dunder,
+        is_ident,
+        is_ident_cont,
+        is_ident_start,
+        is_sunder,
+        iter_pat,
+        prefix_delimited,
+        prefix_lines,
+        replace_many,
+        rfind_any,
+        strip_prefix,
+        strip_suffix,
+    )
+
+    from .sys import (  # noqa
+        REQUIRED_PYTHON_VERSION,
+        check_runtime_version,
+        is_gil_enabled,
+    )
+
+    from .typing import (  # noqa
+        BytesLike,
+
+        static_check_isinstance,
+        static_check_issubclass,
+        copy_type,
+
+        protocol_check,
+
+        typed_lambda,
+        typed_partial,
+
+        SequenceNotStr,
+    )
+
+    ##
+
+    from ..lite.args import (  # noqa
+        Args,
+    )
+
+    from ..lite.contextmanagers import (  # noqa
+        AsyncExitStacked,
+        ExitStacked,
+        adefer,
+        attr_setting,
+        defer,
+    )
+
+    from ..lite.imports import (  # noqa
+        import_attr,
+        import_module,
+        import_module_attr,
+    )
+
+    from ..lite.maybes import (  # noqa
+        Maybe,
+    )
+
+    from ..lite.maysyncs import (  # noqa
+        mark_maysync,
+        is_maysync,
+
+        AnyMaysyncFn,
+
+        MaywaitableAlreadyConsumedError,
+        AnyMaywaitable,
+
+        MaysyncFn,
+        Maywaitable,
+
+        MaysyncGeneratorFn,
+        MaysyncGenerator,
+
+        is_running_maysync,
+
+        run_maysync,
+    )
+
+    from ..lite.reprs import (  # noqa
+        AttrRepr,
+        attr_repr,
+    )
+
+    from ..lite.timeouts import (  # noqa
+        DeadlineTimeout,
+        InfiniteTimeout,
+        Timeout,
+        TimeoutLike,
+    )
+
+    from ..lite.types import (  # noqa
+        BUILTIN_SCALAR_ITERABLE_TYPES,
+    )
+
+    from ..lite.typing import (  # noqa
+        AnyFunc,
+        Func0,
+        Func1,
+        Func2,
+        Func3,
+
+        typing_annotations_attr,
+    )