omlish 0.0.0.dev415__py3-none-any.whl → 0.0.0.dev416__py3-none-any.whl

omlish/lang/__init__.py

@@ -1,473 +1,486 @@
-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,
-    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 .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,
-)
-
-empty = Maybe.empty
-just = Maybe.just
-
-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,
-)
+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,
+    )