From 5e4cb995b8b705435ad1eed0083a0fe1a41dbb39 Mon Sep 17 00:00:00 2001 From: GitHub CI Runner Date: Mon, 8 Aug 2022 21:40:15 +0000 Subject: [PATCH] **CI** Formatted code + Updated version number and documentation. [skip ci] --- docs/.buildinfo | 2 +- docs/_modules/dol.html | 2 +- docs/_modules/dol/appendable.html | 2 +- docs/_modules/dol/base.html | 2 +- docs/_modules/dol/caching.html | 2 +- docs/_modules/dol/core.html | 2 +- docs/_modules/dol/dig.html | 2 +- docs/_modules/dol/errors.html | 2 +- docs/_modules/dol/explicit.html | 2 +- docs/_modules/dol/filesys.html | 2 +- docs/_modules/dol/mixins.html | 2 +- docs/_modules/dol/naming.html | 2 +- docs/_modules/dol/paths.html | 2 +- docs/_modules/dol/signatures.html | 62 ++++++++++++++++-- docs/_modules/dol/sources.html | 2 +- docs/_modules/dol/tests/base_test.html | 2 +- docs/_modules/dol/tests/pickability_test.html | 2 +- docs/_modules/dol/tools.html | 2 +- docs/_modules/dol/trans.html | 2 +- docs/_modules/dol/util.html | 2 +- docs/_modules/dol/zipfiledol.html | 2 +- docs/_modules/index.html | 2 +- docs/_static/documentation_options.js | 2 +- docs/genindex.html | 8 ++- docs/index.html | 6 +- docs/module_docs/dol.html | 2 +- docs/module_docs/dol/appendable.html | 2 +- docs/module_docs/dol/base.html | 2 +- docs/module_docs/dol/caching.html | 2 +- docs/module_docs/dol/core.html | 2 +- docs/module_docs/dol/dig.html | 2 +- docs/module_docs/dol/errors.html | 2 +- docs/module_docs/dol/explicit.html | 2 +- docs/module_docs/dol/filesys.html | 2 +- docs/module_docs/dol/mixins.html | 2 +- docs/module_docs/dol/naming.html | 2 +- docs/module_docs/dol/paths.html | 2 +- docs/module_docs/dol/signatures.html | 58 +++++++++++++--- docs/module_docs/dol/sources.html | 2 +- docs/module_docs/dol/tests/base_test.html | 2 +- .../dol/tests/pickability_test.html | 2 +- docs/module_docs/dol/tests/scrap.html | 2 +- docs/module_docs/dol/tools.html | 2 +- docs/module_docs/dol/trans.html | 2 +- docs/module_docs/dol/util.html | 2 +- docs/module_docs/dol/zipfiledol.html | 2 +- docs/objects.inv | Bin 3347 -> 3359 bytes docs/py-modindex.html | 2 +- docs/search.html | 2 +- docs/searchindex.js | 2 +- docs/table_of_contents.html | 2 +- setup.cfg | 2 +- 52 files changed, 160 insertions(+), 68 deletions(-) diff --git a/docs/.buildinfo b/docs/.buildinfo index 56c6a70b..561ea491 100644 --- a/docs/.buildinfo +++ b/docs/.buildinfo @@ -1,4 +1,4 @@ # Sphinx build info version 1 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: da189bbd59119d2f23d804cdc33896f5 +config: 3d89b3397c789d64428282c809dc66dc tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/docs/_modules/dol.html b/docs/_modules/dol.html index 79f5a560..4ad4496b 100644 --- a/docs/_modules/dol.html +++ b/docs/_modules/dol.html @@ -3,7 +3,7 @@ - dol — dol 0.1.101 documentation + dol — dol 0.1.102 documentation diff --git a/docs/_modules/dol/appendable.html b/docs/_modules/dol/appendable.html index d226c4b9..ffbb0d4c 100644 --- a/docs/_modules/dol/appendable.html +++ b/docs/_modules/dol/appendable.html @@ -3,7 +3,7 @@ - dol.appendable — dol 0.1.101 documentation + dol.appendable — dol 0.1.102 documentation diff --git a/docs/_modules/dol/base.html b/docs/_modules/dol/base.html index b969b14e..a72061ef 100644 --- a/docs/_modules/dol/base.html +++ b/docs/_modules/dol/base.html @@ -3,7 +3,7 @@ - dol.base — dol 0.1.101 documentation + dol.base — dol 0.1.102 documentation diff --git a/docs/_modules/dol/caching.html b/docs/_modules/dol/caching.html index a34060d1..000b5615 100644 --- a/docs/_modules/dol/caching.html +++ b/docs/_modules/dol/caching.html @@ -3,7 +3,7 @@ - dol.caching — dol 0.1.101 documentation + dol.caching — dol 0.1.102 documentation diff --git a/docs/_modules/dol/core.html b/docs/_modules/dol/core.html index 23dd9d37..9dbf8479 100644 --- a/docs/_modules/dol/core.html +++ b/docs/_modules/dol/core.html @@ -3,7 +3,7 @@ - dol.core — dol 0.1.101 documentation + dol.core — dol 0.1.102 documentation diff --git a/docs/_modules/dol/dig.html b/docs/_modules/dol/dig.html index 6f6c960f..9b029986 100644 --- a/docs/_modules/dol/dig.html +++ b/docs/_modules/dol/dig.html @@ -3,7 +3,7 @@ - dol.dig — dol 0.1.101 documentation + dol.dig — dol 0.1.102 documentation diff --git a/docs/_modules/dol/errors.html b/docs/_modules/dol/errors.html index 71d42e2c..ef6a40ad 100644 --- a/docs/_modules/dol/errors.html +++ b/docs/_modules/dol/errors.html @@ -3,7 +3,7 @@ - dol.errors — dol 0.1.101 documentation + dol.errors — dol 0.1.102 documentation diff --git a/docs/_modules/dol/explicit.html b/docs/_modules/dol/explicit.html index ef650f58..cde4cf1b 100644 --- a/docs/_modules/dol/explicit.html +++ b/docs/_modules/dol/explicit.html @@ -3,7 +3,7 @@ - dol.explicit — dol 0.1.101 documentation + dol.explicit — dol 0.1.102 documentation diff --git a/docs/_modules/dol/filesys.html b/docs/_modules/dol/filesys.html index 11a5c74b..c8f7dfd6 100644 --- a/docs/_modules/dol/filesys.html +++ b/docs/_modules/dol/filesys.html @@ -3,7 +3,7 @@ - dol.filesys — dol 0.1.101 documentation + dol.filesys — dol 0.1.102 documentation diff --git a/docs/_modules/dol/mixins.html b/docs/_modules/dol/mixins.html index ce9b8435..b2b50d2c 100644 --- a/docs/_modules/dol/mixins.html +++ b/docs/_modules/dol/mixins.html @@ -3,7 +3,7 @@ - dol.mixins — dol 0.1.101 documentation + dol.mixins — dol 0.1.102 documentation diff --git a/docs/_modules/dol/naming.html b/docs/_modules/dol/naming.html index 64dbe452..5a9c1756 100644 --- a/docs/_modules/dol/naming.html +++ b/docs/_modules/dol/naming.html @@ -3,7 +3,7 @@ - dol.naming — dol 0.1.101 documentation + dol.naming — dol 0.1.102 documentation diff --git a/docs/_modules/dol/paths.html b/docs/_modules/dol/paths.html index 77a10c62..3fb4c680 100644 --- a/docs/_modules/dol/paths.html +++ b/docs/_modules/dol/paths.html @@ -3,7 +3,7 @@ - dol.paths — dol 0.1.101 documentation + dol.paths — dol 0.1.102 documentation diff --git a/docs/_modules/dol/signatures.html b/docs/_modules/dol/signatures.html index 39816db2..9993f77b 100644 --- a/docs/_modules/dol/signatures.html +++ b/docs/_modules/dol/signatures.html @@ -3,7 +3,7 @@ - dol.signatures — dol 0.1.101 documentation + dol.signatures — dol 0.1.102 documentation @@ -203,7 +203,7 @@

Source code for dol.signatures

     Parameter(name='param_kind', kind=Parameter.POSITIONAL_OR_KEYWORD)
 )
 ParamsType = Iterable[Parameter]
-ParamsAble = Union[ParamsType, MappingType[str, Parameter], Callable, str]
+ParamsAble = Union[ParamsType, Signature, MappingType[str, Parameter], Callable, str]
 SignatureAble = Union[Signature, ParamsAble]
 HasParams = Union[Iterable[Parameter], MappingType[str, Parameter], Signature, Callable]
 
@@ -313,7 +313,7 @@ 

Source code for dol.signatures

 assure_callable = ensure_callable  # alias for backcompatibility
 
 
-def ensure_signature(obj: SignatureAble):
+def ensure_signature(obj: SignatureAble) -> Signature:
     if isinstance(obj, Signature):
         return obj
     elif isinstance(obj, Callable):
@@ -3716,7 +3716,57 @@ 

Source code for dol.signatures

     # Not returning func so it's clear(er) that the function is transformed in place
 
 
-########################################################################################################################
+# Pattern: (rewiring) wrapper of make_dataclass
+# TODO: Is there a clean way for module to be populated by __name__ of caller module?
+
[docs]def sig_to_dataclass( + sig: SignatureAble, *, cls_name=None, bases=(), module=None, **kwargs +): + """ + Make a ``class`` (through ``make_dataclass``) from the given signature. + + :param sig: A ``SignatureAble``, that is, anything that ensure_signature can + resolve into an ``inspect.Signature`` object, including a signature object + itself, but also most callables, a list or params, etc. + :param cls_name: The same as ``cls_name`` of ``dataclasses.make_dataclass`` + :param bases: The same as ``bases`` of ``dataclasses.make_dataclass`` + :param module: Set to module (usually ``__name__`` to specify ther module of + caller) so that the class and instances can be pickle-able. + :param kwargs: Passed on to ``dataclasses.make_dataclass`` + :return: A dataclass + + >>> def foo(a, /, b : int=2, *, c=3): + ... pass + ... + >>> K = sig_to_dataclass(foo, cls_name='K') + >>> str(Sig(K)) + '(a, b: int = 2, c=3) -> None' + >>> k = K(1,2,3) + >>> (k.a, k.b, k.c) + (1, 2, 3) + + Would also work with any of these (and more): + + >>> K = sig_to_dataclass(Sig(foo), cls_name='K') + >>> K = sig_to_dataclass(Sig(foo).params, cls_name='K') + + Note: ``cls_name`` is not required (we'll try to figure out a good default for you), + but it's advised to only use this convenience in extreme mode. + Choosing your own name might make for a safer future if you're reusing your class. + + """ + from dataclasses import make_dataclass + + sig = ensure_signature(sig) + cls_name = cls_name or getattr(sig, 'name', '_made_by_sig_to_dataclass') + params = ensure_params(sig) + fields = [(p.name, p.annotation, p.default) for p in params] + cls = make_dataclass(cls_name, fields, bases=bases, **kwargs) + if module: + cls.__module__ = module + return cls
+ + +######################################################################################### # Manual construction of missing signatures # ############################################################################ @@ -3810,9 +3860,7 @@

Source code for dol.signatures

     # zip(*iterables) --> A zip object yielding tuples until an input is exhausted.
 }
 
-############# Tools for testing
-# ########################################################################################
-from functools import partial
+############# Tools for testing #########################################################
 
 
 
[docs]def param_for_kind( diff --git a/docs/_modules/dol/sources.html b/docs/_modules/dol/sources.html index 90f32b30..fd167a46 100644 --- a/docs/_modules/dol/sources.html +++ b/docs/_modules/dol/sources.html @@ -3,7 +3,7 @@ - dol.sources — dol 0.1.101 documentation + dol.sources — dol 0.1.102 documentation diff --git a/docs/_modules/dol/tests/base_test.html b/docs/_modules/dol/tests/base_test.html index 036e337f..f08f2cd8 100644 --- a/docs/_modules/dol/tests/base_test.html +++ b/docs/_modules/dol/tests/base_test.html @@ -3,7 +3,7 @@ - dol.tests.base_test — dol 0.1.101 documentation + dol.tests.base_test — dol 0.1.102 documentation diff --git a/docs/_modules/dol/tests/pickability_test.html b/docs/_modules/dol/tests/pickability_test.html index 15639ba5..4cbf8f14 100644 --- a/docs/_modules/dol/tests/pickability_test.html +++ b/docs/_modules/dol/tests/pickability_test.html @@ -3,7 +3,7 @@ - dol.tests.pickability_test — dol 0.1.101 documentation + dol.tests.pickability_test — dol 0.1.102 documentation diff --git a/docs/_modules/dol/tools.html b/docs/_modules/dol/tools.html index f33704f0..c7c66b71 100644 --- a/docs/_modules/dol/tools.html +++ b/docs/_modules/dol/tools.html @@ -3,7 +3,7 @@ - dol.tools — dol 0.1.101 documentation + dol.tools — dol 0.1.102 documentation diff --git a/docs/_modules/dol/trans.html b/docs/_modules/dol/trans.html index 83cea22e..eecca4ae 100644 --- a/docs/_modules/dol/trans.html +++ b/docs/_modules/dol/trans.html @@ -3,7 +3,7 @@ - dol.trans — dol 0.1.101 documentation + dol.trans — dol 0.1.102 documentation diff --git a/docs/_modules/dol/util.html b/docs/_modules/dol/util.html index 9878ef6e..b64767a6 100644 --- a/docs/_modules/dol/util.html +++ b/docs/_modules/dol/util.html @@ -3,7 +3,7 @@ - dol.util — dol 0.1.101 documentation + dol.util — dol 0.1.102 documentation diff --git a/docs/_modules/dol/zipfiledol.html b/docs/_modules/dol/zipfiledol.html index 06d8602b..6ed94515 100644 --- a/docs/_modules/dol/zipfiledol.html +++ b/docs/_modules/dol/zipfiledol.html @@ -3,7 +3,7 @@ - dol.zipfiledol — dol 0.1.101 documentation + dol.zipfiledol — dol 0.1.102 documentation diff --git a/docs/_modules/index.html b/docs/_modules/index.html index 12c3663a..83375d79 100644 --- a/docs/_modules/index.html +++ b/docs/_modules/index.html @@ -3,7 +3,7 @@ - Overview: module code — dol 0.1.101 documentation + Overview: module code — dol 0.1.102 documentation diff --git a/docs/_static/documentation_options.js b/docs/_static/documentation_options.js index 26a09cee..87871820 100644 --- a/docs/_static/documentation_options.js +++ b/docs/_static/documentation_options.js @@ -1,6 +1,6 @@ var DOCUMENTATION_OPTIONS = { URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), - VERSION: '0.1.101', + VERSION: '0.1.102', LANGUAGE: 'None', COLLAPSE_INDEX: false, BUILDER: 'html', diff --git a/docs/genindex.html b/docs/genindex.html index 3945fbf7..8873a1b9 100644 --- a/docs/genindex.html +++ b/docs/genindex.html @@ -3,7 +3,7 @@ - Index — dol 0.1.101 documentation + Index — dol 0.1.102 documentation @@ -902,6 +902,8 @@

S

  • sig_or_default() (dol.signatures.Sig class method)
  • sig_or_none() (dol.signatures.Sig class method) +
  • +
  • sig_to_dataclass() (in module dol.signatures)
  • SimpleJsonMixin (class in dol.mixins)
  • @@ -910,11 +912,11 @@

    S

  • source_args_and_kwargs() (dol.signatures.Sig method)
  • source_kwargs() (dol.signatures.Sig method) -
  • -
  • Store (class in dol.base)
  • -

    Release: 0.1.101

    -

    Last change: Aug 06, 2022

    +

    Release: 0.1.102

    +

    Last change: Aug 08, 2022

    diff --git a/docs/module_docs/dol.html b/docs/module_docs/dol.html index c231176e..db1d9326 100644 --- a/docs/module_docs/dol.html +++ b/docs/module_docs/dol.html @@ -4,7 +4,7 @@ - dol — dol 0.1.101 documentation + dol — dol 0.1.102 documentation diff --git a/docs/module_docs/dol/appendable.html b/docs/module_docs/dol/appendable.html index 4753e20d..65d28433 100644 --- a/docs/module_docs/dol/appendable.html +++ b/docs/module_docs/dol/appendable.html @@ -4,7 +4,7 @@ - dol.appendable — dol 0.1.101 documentation + dol.appendable — dol 0.1.102 documentation diff --git a/docs/module_docs/dol/base.html b/docs/module_docs/dol/base.html index 923083c7..53ca339e 100644 --- a/docs/module_docs/dol/base.html +++ b/docs/module_docs/dol/base.html @@ -4,7 +4,7 @@ - dol.base — dol 0.1.101 documentation + dol.base — dol 0.1.102 documentation diff --git a/docs/module_docs/dol/caching.html b/docs/module_docs/dol/caching.html index 1eb32706..39417fe7 100644 --- a/docs/module_docs/dol/caching.html +++ b/docs/module_docs/dol/caching.html @@ -4,7 +4,7 @@ - dol.caching — dol 0.1.101 documentation + dol.caching — dol 0.1.102 documentation diff --git a/docs/module_docs/dol/core.html b/docs/module_docs/dol/core.html index 42712573..591809a4 100644 --- a/docs/module_docs/dol/core.html +++ b/docs/module_docs/dol/core.html @@ -4,7 +4,7 @@ - dol.core — dol 0.1.101 documentation + dol.core — dol 0.1.102 documentation diff --git a/docs/module_docs/dol/dig.html b/docs/module_docs/dol/dig.html index ea34e0a5..294f224a 100644 --- a/docs/module_docs/dol/dig.html +++ b/docs/module_docs/dol/dig.html @@ -4,7 +4,7 @@ - dol.dig — dol 0.1.101 documentation + dol.dig — dol 0.1.102 documentation diff --git a/docs/module_docs/dol/errors.html b/docs/module_docs/dol/errors.html index 696e9887..95aeb366 100644 --- a/docs/module_docs/dol/errors.html +++ b/docs/module_docs/dol/errors.html @@ -4,7 +4,7 @@ - dol.errors — dol 0.1.101 documentation + dol.errors — dol 0.1.102 documentation diff --git a/docs/module_docs/dol/explicit.html b/docs/module_docs/dol/explicit.html index 23d8e86c..3d35f99e 100644 --- a/docs/module_docs/dol/explicit.html +++ b/docs/module_docs/dol/explicit.html @@ -4,7 +4,7 @@ - dol.explicit — dol 0.1.101 documentation + dol.explicit — dol 0.1.102 documentation diff --git a/docs/module_docs/dol/filesys.html b/docs/module_docs/dol/filesys.html index 957ef53b..6878b997 100644 --- a/docs/module_docs/dol/filesys.html +++ b/docs/module_docs/dol/filesys.html @@ -4,7 +4,7 @@ - dol.filesys — dol 0.1.101 documentation + dol.filesys — dol 0.1.102 documentation diff --git a/docs/module_docs/dol/mixins.html b/docs/module_docs/dol/mixins.html index 44e12bdd..073497ce 100644 --- a/docs/module_docs/dol/mixins.html +++ b/docs/module_docs/dol/mixins.html @@ -4,7 +4,7 @@ - dol.mixins — dol 0.1.101 documentation + dol.mixins — dol 0.1.102 documentation diff --git a/docs/module_docs/dol/naming.html b/docs/module_docs/dol/naming.html index 34f5f29b..096bffc1 100644 --- a/docs/module_docs/dol/naming.html +++ b/docs/module_docs/dol/naming.html @@ -4,7 +4,7 @@ - dol.naming — dol 0.1.101 documentation + dol.naming — dol 0.1.102 documentation diff --git a/docs/module_docs/dol/paths.html b/docs/module_docs/dol/paths.html index e26d9665..5056accf 100644 --- a/docs/module_docs/dol/paths.html +++ b/docs/module_docs/dol/paths.html @@ -4,7 +4,7 @@ - dol.paths — dol 0.1.101 documentation + dol.paths — dol 0.1.102 documentation diff --git a/docs/module_docs/dol/signatures.html b/docs/module_docs/dol/signatures.html index 4110b226..0d83f57e 100644 --- a/docs/module_docs/dol/signatures.html +++ b/docs/module_docs/dol/signatures.html @@ -4,7 +4,7 @@ - dol.signatures — dol 0.1.101 documentation + dol.signatures — dol 0.1.102 documentation @@ -213,7 +213,7 @@
    -class dol.signatures.Sig(obj: Union[Iterable[inspect.Parameter], Mapping[str, inspect.Parameter], Callable, str] = None, *, name=None, return_annotation, __validate_parameters__=True)[source]
    +class dol.signatures.Sig(obj: Union[Iterable[inspect.Parameter], inspect.Signature, Mapping[str, inspect.Parameter], Callable, str] = None, *, name=None, return_annotation, __validate_parameters__=True)[source]

    A subclass of inspect.Signature that has a lot of extra api sugar, such as

    @@ -909,7 +909,7 @@
    -merge_with_sig(sig: Union[Iterable[inspect.Parameter], Mapping[str, inspect.Parameter], Callable, str], ch_to_all_pk: bool = False, *, default_conflict_method: str = 'strict')[source]
    +merge_with_sig(sig: Union[Iterable[inspect.Parameter], inspect.Signature, Mapping[str, inspect.Parameter], Callable, str], ch_to_all_pk: bool = False, *, default_conflict_method: str = 'strict')[source]

    Return a signature obtained by merging self signature with another signature. Insofar as it can, given the kind precedence rules, the arguments of self will appear first.

    @@ -1442,7 +1442,7 @@
    -dol.signatures.assure_params(obj: Union[Iterable[inspect.Parameter], Mapping[str, inspect.Parameter], Callable, str] = None)
    +dol.signatures.assure_params(obj: Union[Iterable[inspect.Parameter], inspect.Signature, Mapping[str, inspect.Parameter], Callable, str] = None)

    Get an interable of Parameter instances from an object.

    Parameters
    @@ -1781,7 +1781,7 @@
    -dol.signatures.ensure_params(obj: Union[Iterable[inspect.Parameter], Mapping[str, inspect.Parameter], Callable, str] = None)[source]
    +dol.signatures.ensure_params(obj: Union[Iterable[inspect.Parameter], inspect.Signature, Mapping[str, inspect.Parameter], Callable, str] = None)[source]

    Get an interable of Parameter instances from an object.

    Parameters
    @@ -1826,7 +1826,7 @@
    -dol.signatures.extract_arguments(params: Union[Iterable[inspect.Parameter], Mapping[str, inspect.Parameter], Callable, str], *, what_to_do_with_remainding='return', include_all_when_var_keywords_in_params=False, assert_no_missing_position_only_args=False, **kwargs)[source]
    +dol.signatures.extract_arguments(params: Union[Iterable[inspect.Parameter], inspect.Signature, Mapping[str, inspect.Parameter], Callable, str], *, what_to_do_with_remainding='return', include_all_when_var_keywords_in_params=False, assert_no_missing_position_only_args=False, **kwargs)[source]

    Extract arguments needed to satisfy the params of a callable, dealing with the dirty details.

    Returns an (param_args, param_kwargs, remaining_kwargs) tuple where @@ -1991,7 +1991,7 @@

    -dol.signatures.extract_arguments_asserting_no_remainder(params: Union[Iterable[inspect.Parameter], Mapping[str, inspect.Parameter], Callable, str], *, what_to_do_with_remainding='assert_empty', include_all_when_var_keywords_in_params=False, assert_no_missing_position_only_args=False, **kwargs)
    +dol.signatures.extract_arguments_asserting_no_remainder(params: Union[Iterable[inspect.Parameter], inspect.Signature, Mapping[str, inspect.Parameter], Callable, str], *, what_to_do_with_remainding='assert_empty', include_all_when_var_keywords_in_params=False, assert_no_missing_position_only_args=False, **kwargs)

    Extract arguments needed to satisfy the params of a callable, dealing with the dirty details.

    Returns an (param_args, param_kwargs, remaining_kwargs) tuple where @@ -2156,7 +2156,7 @@

    -dol.signatures.extract_arguments_ignoring_remainder(params: Union[Iterable[inspect.Parameter], Mapping[str, inspect.Parameter], Callable, str], *, what_to_do_with_remainding='ignore', include_all_when_var_keywords_in_params=False, assert_no_missing_position_only_args=False, **kwargs)
    +dol.signatures.extract_arguments_ignoring_remainder(params: Union[Iterable[inspect.Parameter], inspect.Signature, Mapping[str, inspect.Parameter], Callable, str], *, what_to_do_with_remainding='ignore', include_all_when_var_keywords_in_params=False, assert_no_missing_position_only_args=False, **kwargs)

    Extract arguments needed to satisfy the params of a callable, dealing with the dirty details.

    Returns an (param_args, param_kwargs, remaining_kwargs) tuple where @@ -2575,6 +2575,48 @@

    +
    +
    +dol.signatures.sig_to_dataclass(sig: Union[inspect.Signature, Iterable[inspect.Parameter], Mapping[str, inspect.Parameter], Callable, str], *, cls_name=None, bases=(), module=None, **kwargs)[source]
    +

    Make a class (through make_dataclass) from the given signature.

    +
    +
    Parameters
    +
      +
    • sig – A SignatureAble, that is, anything that ensure_signature can +resolve into an inspect.Signature object, including a signature object +itself, but also most callables, a list or params, etc.

    • +
    • cls_name – The same as cls_name of dataclasses.make_dataclass

    • +
    • bases – The same as bases of dataclasses.make_dataclass

    • +
    • module – Set to module (usually __name__ to specify ther module of +caller) so that the class and instances can be pickle-able.

    • +
    • kwargs – Passed on to dataclasses.make_dataclass

    • +
    +
    +
    Returns
    +

    A dataclass

    +
    +
    +
    >>> def foo(a, /, b : int=2, *, c=3):
    +...     pass
    +...
    +>>> K = sig_to_dataclass(foo, cls_name='K')
    +>>> str(Sig(K))
    +'(a, b: int = 2, c=3) -> None'
    +>>> k = K(1,2,3)
    +>>> (k.a, k.b, k.c)
    +(1, 2, 3)
    +
    +
    +

    Would also work with any of these (and more):

    +
    >>> K = sig_to_dataclass(Sig(foo), cls_name='K')
    +>>> K = sig_to_dataclass(Sig(foo).params, cls_name='K')
    +
    +
    +

    Note: cls_name is not required (we’ll try to figure out a good default for you), +but it’s advised to only use this convenience in extreme mode. +Choosing your own name might make for a safer future if you’re reusing your class.

    +
    +
    dol.signatures.sort_params(params)[source]
    diff --git a/docs/module_docs/dol/sources.html b/docs/module_docs/dol/sources.html index 41a0652f..c59f8866 100644 --- a/docs/module_docs/dol/sources.html +++ b/docs/module_docs/dol/sources.html @@ -4,7 +4,7 @@ - dol.sources — dol 0.1.101 documentation + dol.sources — dol 0.1.102 documentation diff --git a/docs/module_docs/dol/tests/base_test.html b/docs/module_docs/dol/tests/base_test.html index 2cfa9d1d..f6221453 100644 --- a/docs/module_docs/dol/tests/base_test.html +++ b/docs/module_docs/dol/tests/base_test.html @@ -4,7 +4,7 @@ - dol.tests.base_test — dol 0.1.101 documentation + dol.tests.base_test — dol 0.1.102 documentation diff --git a/docs/module_docs/dol/tests/pickability_test.html b/docs/module_docs/dol/tests/pickability_test.html index 64097274..5d7abf59 100644 --- a/docs/module_docs/dol/tests/pickability_test.html +++ b/docs/module_docs/dol/tests/pickability_test.html @@ -4,7 +4,7 @@ - dol.tests.pickability_test — dol 0.1.101 documentation + dol.tests.pickability_test — dol 0.1.102 documentation diff --git a/docs/module_docs/dol/tests/scrap.html b/docs/module_docs/dol/tests/scrap.html index 8e18bf13..2173f3ae 100644 --- a/docs/module_docs/dol/tests/scrap.html +++ b/docs/module_docs/dol/tests/scrap.html @@ -4,7 +4,7 @@ - dol.tests.scrap — dol 0.1.101 documentation + dol.tests.scrap — dol 0.1.102 documentation diff --git a/docs/module_docs/dol/tools.html b/docs/module_docs/dol/tools.html index 6ba5c5cb..a55139be 100644 --- a/docs/module_docs/dol/tools.html +++ b/docs/module_docs/dol/tools.html @@ -4,7 +4,7 @@ - dol.tools — dol 0.1.101 documentation + dol.tools — dol 0.1.102 documentation diff --git a/docs/module_docs/dol/trans.html b/docs/module_docs/dol/trans.html index ac800447..7d5a7ab3 100644 --- a/docs/module_docs/dol/trans.html +++ b/docs/module_docs/dol/trans.html @@ -4,7 +4,7 @@ - dol.trans — dol 0.1.101 documentation + dol.trans — dol 0.1.102 documentation diff --git a/docs/module_docs/dol/util.html b/docs/module_docs/dol/util.html index 392e9433..aa9e8ef8 100644 --- a/docs/module_docs/dol/util.html +++ b/docs/module_docs/dol/util.html @@ -4,7 +4,7 @@ - dol.util — dol 0.1.101 documentation + dol.util — dol 0.1.102 documentation diff --git a/docs/module_docs/dol/zipfiledol.html b/docs/module_docs/dol/zipfiledol.html index 5e6a151e..ea22fb86 100644 --- a/docs/module_docs/dol/zipfiledol.html +++ b/docs/module_docs/dol/zipfiledol.html @@ -4,7 +4,7 @@ - dol.zipfiledol — dol 0.1.101 documentation + dol.zipfiledol — dol 0.1.102 documentation diff --git a/docs/objects.inv b/docs/objects.inv index 3188fc8e52a30b8925efa3c255b78522c22e318a..328f3e4d00e7be3a332f43c55d044458dd8ad8fa 100644 GIT binary patch delta 1384 zcmV-u1(*7h8lM`l$p?QCs}L7!siAH$Bc3Rs$EQ+R-D>iVC2HbUFF#c?i?i-$U}4Xt znO@cF-rX9bPN8Y)cP0Bo?nHIgEIlV;l-Xl zad+LovRb|r@l^KjlHxxEpH}GBJTD1(`Z7JwO&9$X+W!GI-E^s?to&xmrkIz#`Ggx| z{rzbmoQqPuCt!bVm34s*v}(bb+%d6m+u$s=kYdACP2_3v8Wfu;qh|9DI| z817}b9UYxB6Tx}5dRj%2-05p>g0pl#p|rl*dW0!MR2U*#)3mGG ztCTHHx7!A9pMkjvG~ID6t6Md)*K9;K+J;vqs?9bP?wJy6#ryS>ii6eHk(5f(l9X-T z#PaZ7h46nKlaM%R`qLK+c3sWFaDUr@DC?7UA^HR8vhe|=mDq|MSYcIwiE0;B;Zh3aRjdj*t;Hj+{al4KlArGCla*==Ua#NYL5U0Pu$#2+7g4ao_8+WYO2eruz zrJ~=DjgrlZZ|Fr~uBh>}i(qSpbWLAK7rz>|ZeRZ$0(vG|iv`+!mH@Vy)U+VqTCrbp z{%U^?)YkUCz3>{ZA8^`cv7Xep^9f59!)FMJMGX+U1y$NzOz`t+#&_P}A-B?hvEkESkJsVkdarIZ;My{bd7O-vC&MO9KK`50r&xMi&6T^h*@W@6%X7 z?TXmdV3L9+{pxerttjp3Wjk+AfL?ZUz%qYUDo${%X8{KP;^wRFv@VQ)cxeyv1{A;o zHs27AxW*p-pg~t?0TLW?^o-z%UbN|d0aCGA9@t<^>|EwMZ<3L5R}FYUMscPS(vvoo zgJDBG;i!oRj%nDd)?&9z*!{J+Hsy~MeFDGb%@2A1)TYbt@Mkt810W_ErTCRq;J1IU z+{hg0|NGB>HT*5?b`I+r{~^QOrN7UoIlk#%IMBT_Yc9u&@{jYLI+KlAXY-e~dc-fU zcFoT(i_NBPR`lUcH!tS>m5tfV?R7rN_=3B9bZK5Tbqk#r)ZbE<_ZQt|6W7W42>oqy zd3RM^Hhr^`4>7v?DIac=%I5Cy@uGjm_x$AJ3xl$mYXN+;@y!AG==OnZ`k1s2H9AP0 z59hG6>GNkk(CCC(J{)t)CeJ7NIKu&^{B#s5o8J!MLtSi|$j|p*WHX^sFL4x2%|{{G zED#^`F{eU_`9zE|TNb_xXEhn{%jZLjnJ3m4&TR+@<`?nAY%&hzC7uFR`6*z?l}#>q zc`2tAvHY}}mQ77&e2~**C+{aq*}U!Yfi5guer`0gk+})jp$8j3IyXm}QB~~D1>G|z q^XT3`&@Iah+6|nz7E&0yBXd;h-@SD5e-$z}+*Isu+5Z7;U?=&JOT8cf delta 1372 zcmV-i1*7_(8j~8Z$p?Q?OX#1e6im1FyJLwOq}9vMz|7*Tvlv*0b7`j6;JSCW#;8*u z*}L{LhD}jI$6mZIpau5k5=vFTtTsgDb~A%Azg7UP6C#yBemAwx{Tb>Gmbe zY7d+C?J4b~7P;Wv;9iS{l_6CyiC)0O4KTI-g|p{Zq2u680B?A)r%&8n4zR42FGW0+ z{kx?255cDuIw8+X0+hZ?&vVm7KjHO%fK4}DYAGwfnX)P7Wp6&=HdcRs8VKj2RPPB` zTV)-V1Fc$c{dRv$EZpQbi!G$sa8(m|V9K5>i~!*le>)ij_g`^vfpHUJBcXiZJ0NDc z{ITLicoXrId>+6d)eb3TX?U$RSVWf;VN3it5hGlVz(w!X)HN6jMDzVR1z0FNO+3WNVssb$gYv#mRBo;9W5= zH-V-*u4Q#=JoZwI$VS`n%0#uL`u>-5@bq~1x-$an?j|FQWK1Qd6))Jg9 zELkBHUZ=4ZW7}-eQ7D({5kS|27S@8|M zD9jZ#o=p*K&5*9?3+bXw!$#}tze7OJL~F4?yU!B9Hj|nb`CcqFa#UjzAeNH%G7Mz25CjXD0C zH;X23m)HqjcdC=oT7TI9*Eawb;?jUX)dOYW3C{($SBTqLVD7saxiSDCmc2Lz%dPb z)mrS93A-CM*QWfjqEFzry!j#TpW1Z!9sbOQWB|lOqZGfg3j7w98<_+BfB*TfhQEJ> z-F#tP<3D7$7xee}G{-mn3kSM)X3gbzQT}n>Qzxh~>ummtRgd`PMXdSx)vnppJ%~Qs z>7K;AzhE(&xogfx8DB@2kFL1OrtXaMg8Dn<^8Q-7Y~u1aAECb+F7Gau%ck#P@*zey zHRZ$IPubj!J6_cIR-Sx(y-zlCh~Ixl8=v#fM|TBe(}$XUsL`?Kd^k0oO`jI?fkx-a z^5IZgHhG%J#~F?r<)?#7+5C10AL?S$M1H>iBAW@7dWoZGYCa0dW`X#ik2w`e%qL=$ z*|P9mIIGEkUp^mN%sjEaaBf3LFu#Z=W|MI!FYy$p%1=SAY;wWNOF6BG<)>8Dv}|fJ z)nMe2jfo@r5&~D(w ewUENt{gb0o|L&!e|ErL>;ih7L%l;3^cnNw-)xN?2 diff --git a/docs/py-modindex.html b/docs/py-modindex.html index d8ef6c11..6c5c9eb4 100644 --- a/docs/py-modindex.html +++ b/docs/py-modindex.html @@ -3,7 +3,7 @@ - Python Module Index — dol 0.1.101 documentation + Python Module Index — dol 0.1.102 documentation diff --git a/docs/search.html b/docs/search.html index cc2a9074..7d537924 100644 --- a/docs/search.html +++ b/docs/search.html @@ -3,7 +3,7 @@ - Search — dol 0.1.101 documentation + Search — dol 0.1.102 documentation diff --git a/docs/searchindex.js b/docs/searchindex.js index 56c612e7..c92d7351 100644 --- a/docs/searchindex.js +++ b/docs/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["index","module_docs/dol","module_docs/dol/appendable","module_docs/dol/base","module_docs/dol/caching","module_docs/dol/core","module_docs/dol/dig","module_docs/dol/errors","module_docs/dol/explicit","module_docs/dol/filesys","module_docs/dol/mixins","module_docs/dol/naming","module_docs/dol/paths","module_docs/dol/signatures","module_docs/dol/sources","module_docs/dol/tests/base_test","module_docs/dol/tests/pickability_test","module_docs/dol/tests/scrap","module_docs/dol/tools","module_docs/dol/trans","module_docs/dol/util","module_docs/dol/zipfiledol","table_of_contents"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,"sphinx.ext.todo":2,"sphinx.ext.viewcode":1,sphinx:56},filenames:["index.rst","module_docs/dol.rst","module_docs/dol/appendable.rst","module_docs/dol/base.rst","module_docs/dol/caching.rst","module_docs/dol/core.rst","module_docs/dol/dig.rst","module_docs/dol/errors.rst","module_docs/dol/explicit.rst","module_docs/dol/filesys.rst","module_docs/dol/mixins.rst","module_docs/dol/naming.rst","module_docs/dol/paths.rst","module_docs/dol/signatures.rst","module_docs/dol/sources.rst","module_docs/dol/tests/base_test.rst","module_docs/dol/tests/pickability_test.rst","module_docs/dol/tests/scrap.rst","module_docs/dol/tools.rst","module_docs/dol/trans.rst","module_docs/dol/util.rst","module_docs/dol/zipfiledol.rst","table_of_contents.rst"],objects:{"":{dol:[1,0,0,"-"]},"dol.appendable":{FirstAppendOnly:[2,1,1,""],add_append_functionality_to_store_cls:[2,2,1,""],appendable:[2,2,1,""],define_extend_as_seq_of_appends:[2,2,1,""],mk_item2kv_for:[2,1,1,""]},"dol.appendable.mk_item2kv_for":{field:[2,3,1,""],fields:[2,3,1,""],item_to_key:[2,3,1,""],item_to_key_params_and_val:[2,3,1,""],utc_key:[2,3,1,""]},"dol.base":{Collection:[3,1,1,""],KeyValidationABC:[3,1,1,""],KvPersister:[3,1,1,""],KvReader:[3,1,1,""],KvStore:[3,4,1,""],Persister:[3,4,1,""],Reader:[3,4,1,""],Store:[3,1,1,""],Stream:[3,1,1,""],delegator_wrap:[3,2,1,""],has_kv_store_interface:[3,2,1,""],kv_walk:[3,2,1,""]},"dol.base.KvPersister":{clear:[3,3,1,""]},"dol.base.KvReader":{head:[3,3,1,""]},"dol.base.Store":{get:[3,3,1,""],head:[3,3,1,""],wrap:[3,3,1,""]},"dol.base.Stream":{wrap:[3,3,1,""]},"dol.caching":{HashableDict:[4,1,1,""],WriteBackChainMap:[4,1,1,""],cache_vals:[4,2,1,""],get_cache:[4,2,1,""],mk_cached_store:[4,2,1,""],mk_sourced_store:[4,2,1,""],mk_write_cached_store:[4,2,1,""],store_cached:[4,2,1,""],store_cached_with_single_key:[4,2,1,""]},"dol.core":{PrefixRelativization:[5,1,1,""]},"dol.dig":{trace_getitem:[6,2,1,""]},"dol.errors":{AlreadyExists:[7,5,1,""],DeletionsNotAllowed:[7,5,1,""],IterationNotAllowed:[7,5,1,""],KeyValidationError:[7,5,1,""],MethodFuncNotValid:[7,5,1,""],MethodNameAlreadyExists:[7,5,1,""],NoSuchKeyError:[7,5,1,""],NotAllowed:[7,5,1,""],NotValid:[7,5,1,""],OperationNotAllowed:[7,5,1,""],OverWritesNotAllowedError:[7,5,1,""],ReadsNotAllowed:[7,5,1,""],SetattrNotAllowed:[7,5,1,""],WritesNotAllowed:[7,5,1,""],items_with_caught_exceptions:[7,2,1,""]},"dol.explicit":{ExplicitKeymapReader:[8,1,1,""],ExplicitKeys:[8,1,1,""],ExplicitKeysSource:[8,1,1,""],ExplicitKeysStore:[8,1,1,""],ExplicitKeysWithPrefixRelativization:[8,1,1,""],ObjReader:[8,1,1,""],invertible_maps:[8,2,1,""]},"dol.filesys":{DirCollection:[9,1,1,""],FileBytesPersister:[9,1,1,""],FileBytesReader:[9,1,1,""],FileCollection:[9,1,1,""],FileInfoReader:[9,1,1,""],FileStringPersister:[9,1,1,""],FileStringReader:[9,1,1,""],FileSysCollection:[9,1,1,""],Files:[9,1,1,""],FilesReader:[9,1,1,""],KeyValidationError:[9,5,1,""],MakeMissingDirsStoreMixin:[9,1,1,""],PickleStore:[9,1,1,""],PickleStores:[9,1,1,""],RelPathFileBytesPersister:[9,4,1,""],RelPathFileBytesReader:[9,4,1,""],RelPathFileStringPersister:[9,4,1,""],RelPathFileStringReader:[9,4,1,""],TextFiles:[9,1,1,""],TextFilesReader:[9,1,1,""],ensure_slash_suffix:[9,2,1,""],iter_dirpaths_in_folder_recursively:[9,2,1,""],iter_filepaths_in_folder_recursively:[9,2,1,""],mk_dirs_if_missing:[9,2,1,""],resolve_dir:[9,2,1,""],resolve_path:[9,2,1,""]},"dol.mixins":{FilteredKeysMixin:[10,1,1,""],IdentityKeysWrapMixin:[10,1,1,""],IdentityKvWrapMixin:[10,1,1,""],IdentityValsWrapMixin:[10,1,1,""],IterBasedSizedContainerMixin:[10,1,1,""],OverWritesNotAllowedMixin:[10,1,1,""],ReadOnlyMixin:[10,1,1,""],SimpleJsonMixin:[10,1,1,""],StringKvWrap:[10,1,1,""]},"dol.naming":{BigDocTest:[11,1,1,""],KeyMapNames:[11,4,1,""],KeyMaps:[11,1,1,""],LinearNaming:[11,4,1,""],ParametricKeyStore:[11,1,1,""],PartialFormatter:[11,1,1,""],StoreWithDictKeys:[11,1,1,""],StoreWithNamedTupleKeys:[11,1,1,""],StoreWithTupleKeys:[11,1,1,""],StrTupleDictWithPrefix:[11,1,1,""],dict_to_namedtuple:[11,2,1,""],get_fields_from_template:[11,2,1,""],mk_kwargs_trans:[11,2,1,""],mk_pattern_from_template_and_format_dict:[11,2,1,""],mk_store_from_path_format_store_cls:[11,2,1,""],mk_tupled_store_from_path_format_store_cls:[11,2,1,""],namedtuple_to_dict:[11,2,1,""],update_fields_of_namedtuple:[11,2,1,""],validate_kwargs:[11,2,1,""]},"dol.naming.KeyMaps":{id_of_key:[11,4,1,""],key_of_id:[11,4,1,""]},"dol.naming.StrTupleDictWithPrefix":{is_valid_prefix:[11,3,1,""]},"dol.paths":{KeyPath:[12,1,1,""],PathKeyTypes:[12,1,1,""],PrefixRelativizationMixin:[12,1,1,""],mk_relative_path_store:[12,2,1,""],path_get:[12,2,1,""],rel_path_wrap:[12,2,1,""],str_template_key_trans:[12,2,1,""]},"dol.signatures":{FuncCallNotMatchingSignature:[13,5,1,""],IncompatibleSignatures:[13,5,1,""],MissingArgValFor:[13,1,1,""],P:[13,4,1,""],Param:[13,1,1,""],Sig:[13,1,1,""],all_pk_signature:[13,2,1,""],assure_params:[13,2,1,""],call_forgivingly:[13,2,1,""],call_somewhat_forgivingly:[13,2,1,""],ch_func_to_all_pk:[13,2,1,""],ch_signature_to_all_pk:[13,2,1,""],ch_variadics_to_non_variadic_kind:[13,2,1,""],common_and_diff_argnames:[13,2,1,""],copy_func:[13,2,1,""],ensure_params:[13,2,1,""],extract_arguments:[13,2,1,""],extract_arguments_asserting_no_remainder:[13,2,1,""],extract_arguments_ignoring_remainder:[13,2,1,""],has_signature:[13,2,1,""],insert_annotations:[13,2,1,""],is_call_compatible_with:[13,2,1,""],is_param_compatible_with:[13,2,1,""],kind_forgiving_func:[13,2,1,""],mk_sig_from_args:[13,2,1,""],name_of_obj:[13,2,1,""],param_for_kind:[13,2,1,""],set_signature_of_func:[13,2,1,""],sort_params:[13,2,1,""],tuple_the_args:[13,2,1,""],use_interface:[13,2,1,""]},"dol.signatures.Sig":{add_params:[13,3,1,""],annotations:[13,3,1,""],args_and_kwargs_from_kwargs:[13,3,1,""],ch_param_attrs:[13,3,1,""],extract_args_and_kwargs:[13,3,1,""],extract_kwargs:[13,3,1,""],has_var_keyword:[13,3,1,""],has_var_kinds:[13,3,1,""],has_var_positional:[13,3,1,""],index_of_var_keyword:[13,3,1,""],index_of_var_positional:[13,3,1,""],is_call_compatible_with:[13,3,1,""],kwargs_from_args_and_kwargs:[13,3,1,""],merge_with_sig:[13,3,1,""],modified:[13,3,1,""],n_required:[13,3,1,""],names_for_kind:[13,3,1,""],params:[13,3,1,""],required_names:[13,3,1,""],sig_or_default:[13,3,1,""],sig_or_none:[13,3,1,""],source_args_and_kwargs:[13,3,1,""],source_kwargs:[13,3,1,""],to_signature_kwargs:[13,3,1,""],to_simple_signature:[13,3,1,""],with_defaults:[13,3,1,""],without_defaults:[13,3,1,""],wrap:[13,3,1,""]},"dol.sources":{AttrContainer:[14,1,1,""],AttrDict:[14,1,1,""],Attrs:[14,1,1,""],CachedKeysSequenceKvReader:[14,1,1,""],CachedSequenceKvReader:[14,1,1,""],Ddir:[14,4,1,""],FlatReader:[14,1,1,""],FuncDag:[14,1,1,""],FuncReader:[14,1,1,""],NotUnique:[14,5,1,""],ObjReader:[14,1,1,""],SequenceKvReader:[14,1,1,""]},"dol.sources.Attrs":{update_keys_cache:[14,3,1,""]},"dol.sources.CachedKeysSequenceKvReader":{update_keys_cache:[14,3,1,""]},"dol.tests":{base_test:[15,0,0,"-"],pickability_test:[16,0,0,"-"],scrap:[17,0,0,"-"]},"dol.tests.base_test":{WrappedDict:[15,1,1,""]},"dol.tests.base_test.WrappedDict":{ItemsView:[15,1,1,""],KeysView:[15,1,1,""]},"dol.tests.pickability_test":{test_pickling_w_dict:[16,2,1,""]},"dol.tools":{Forest:[18,1,1,""],ask_user_for_value_when_missing:[18,2,1,""],confirm_overwrite:[18,2,1,""],convert_to_numerical_if_possible:[18,2,1,""],iSliceStore:[18,1,1,""]},"dol.trans":{CachedInvertibleTrans:[19,1,1,""],FirstArgIsMapping:[19,1,1,""],MapInvertabilityError:[19,5,1,""],OverWritesNotAllowedMixin:[19,1,1,""],add_ipython_key_completions:[19,2,1,""],add_path_access:[19,2,1,""],add_path_get:[19,2,1,""],add_store_method:[19,2,1,""],add_wrapper_method:[19,2,1,""],cache_iter:[19,2,1,""],cached_keys:[19,2,1,""],catch_and_cache_error_keys:[19,2,1,""],constant_output:[19,2,1,""],double_up_as_factory:[19,2,1,""],ensure_clear_method:[19,2,1,""],filt_iter:[19,2,1,""],flatten:[19,2,1,""],insert_aliases:[19,2,1,""],insert_load_dump_aliases:[19,2,1,""],kv_wrap:[19,2,1,""],kv_wrap_persister_cls:[19,2,1,""],mk_kv_reader_from_kv_collection:[19,2,1,""],mk_level_walk_filt:[19,2,1,""],mk_trans_obj:[19,2,1,""],mk_wrapper:[19,2,1,""],store_decorator:[19,2,1,""],wrap_kvs:[19,2,1,""]},"dol.util":{Literal:[20,1,1,""],Pipe:[20,1,1,""],add_attrs:[20,2,1,""],copy_attrs:[20,2,1,""],fill_with_dflts:[20,2,1,""],flatten_pipe:[20,2,1,""],format_invocation:[20,2,1,""],groupby:[20,2,1,""],has_enabled_clear_method:[20,2,1,""],igroupby:[20,2,1,""],imdict:[20,1,1,""],inject_method:[20,2,1,""],instance_checker:[20,2,1,""],lazyprop:[20,1,1,""],lazyprop_w_sentinel:[20,1,1,""],max_common_prefix:[20,2,1,""],norm_kv_filt:[20,2,1,""],not_a_mac_junk_path:[20,2,1,""],num_of_args:[20,2,1,""],num_of_required_args:[20,2,1,""],partialclass:[20,2,1,""],regroupby:[20,2,1,""],str_to_var_str:[20,2,1,""]},"dol.util.Literal":{get_val:[20,3,1,""]},"dol.zipfiledol":{EmptyZipError:[21,5,1,""],FileStreamsOfZip:[21,1,1,""],FilesOfZip:[21,1,1,""],FlatZipFilesReader:[21,1,1,""],OverwriteNotAllowed:[21,5,1,""],ZipFileStreamsReader:[21,1,1,""],ZipFilesReader:[21,1,1,""],ZipFilesReaderAndBytesWriter:[21,1,1,""],ZipInfoReader:[21,1,1,""],ZipReader:[21,1,1,""],ZipStore:[21,1,1,""],file_or_folder_to_zip_file:[21,2,1,""],if_i_zipped_stats:[21,2,1,""],mk_flatzips_store:[21,2,1,""],remove_mac_junk_from_zip:[21,2,1,""],remove_some_entries_from_zip:[21,2,1,""],to_zip_file:[21,2,1,""],to_zipped_bytes:[21,2,1,""],zipped_bytes_to_bytes:[21,2,1,""]},dol:{appendable:[2,0,0,"-"],base:[3,0,0,"-"],caching:[4,0,0,"-"],core:[5,0,0,"-"],dig:[6,0,0,"-"],errors:[7,0,0,"-"],explicit:[8,0,0,"-"],filesys:[9,0,0,"-"],ihead:[1,2,1,""],kvhead:[1,2,1,""],mixins:[10,0,0,"-"],naming:[11,0,0,"-"],paths:[12,0,0,"-"],signatures:[13,0,0,"-"],sources:[14,0,0,"-"],tools:[18,0,0,"-"],trans:[19,0,0,"-"],util:[20,0,0,"-"],zipfiledol:[21,0,0,"-"]}},objnames:{"0":["py","module","Python module"],"1":["py","class","Python class"],"2":["py","function","Python function"],"3":["py","method","Python method"],"4":["py","attribute","Python attribute"],"5":["py","exception","Python exception"]},objtypes:{"0":"py:module","1":"py:class","2":"py:function","3":"py:method","4":"py:attribute","5":"py:exception"},terms:{"0000":11,"00012612342834472656":21,"00015592575073242188":21,"0005228519439697266":21,"0011119842529296875":21,"0013129711151123047":21,"0058901309967041016":21,"02f":11,"0_0":11,"0x1538999e0":21,"100":19,"1000":[6,11,20,21],"101":[0,19],"102":19,"1024":13,"103":19,"11283961":11,"120":19,"1225779243969_1225779246969":11,"123":[11,18],"1234":11,"137":21,"14159":14,"1485261448469":11,"1485272231982":11,"1485272231982_":11,"1485272231982_1485261448469":11,"155":8,"1574287049078391":21,"1574288084739961":21,"1574304926795633":21,"1574305026895702":21,"1574305159343326":21,"1574305276853053":21,"1574333557263758":21,"180":19,"1st":19,"2000":[6,11,21],"2008":11,"2017":11,"2019_11_21":21,"2021_09_11":21,"2021_09_12":21,"2021_09_13":21,"2022":0,"206":21,"21379":13,"221":21,"239578":20,"3000":11,"434":20,"444":4,"456":11,"53280":21,"53432":21,"99_ballon":20,"\u00eatre":20,"boolean":[10,13,19,20,21],"byte":[2,3,19,21],"case":[2,3,4,6,7,10,12,13,14,18,19,20,21],"catch":[7,13],"class":[2,3,4,5,7,8,9,10,11,12,13,14,15,18,19,20,21],"default":[2,3,4,10,11,12,13,14,19,20,21],"final":19,"float":[13,18,20],"function":[2,3,4,7,8,10,11,12,13,14,18,19,20,21],"import":[2,3,4,6,7,8,11,12,13,14,18,19,20,21],"int":[3,6,11,13,14,20],"long":[4,5,11,12,13,19,20],"new":[2,3,11,12,13,18,19,20,21],"return":[2,3,4,6,7,8,11,12,13,14,18,19,20,21],"short":[11,13],"static":[2,4,12,19,21],"super":[3,4,12,19],"switch":19,"true":[2,3,4,8,11,13,14,18,19,20,21],"try":[3,11,12,13,18,19,20],"var":13,"voil\u00e0":13,"while":19,AND:4,And:[4,6,13,18,19,21],But:[3,4,5,7,11,12,13,14,18,19,20,21],DBs:4,For:[2,3,4,6,13,14,18,19,21],NOT:[3,4,13],Not:[2,7,13],ONE:19,One:[3,13,20,21],Such:13,THe:3,That:[3,4,9,13,14,19,20],The:[2,3,4,5,6,7,8,10,11,12,13,14,18,19,20,21],Then:[13,20,21],There:[3,4,14],These:[3,13,20],Use:[2,4,7,13,14],Used:11,Useful:10,Uses:14,Using:[2,19],WILL:[10,19],Was:19,Will:[9,19],With:[12,19],Yes:7,_99_ballon:20,__add__:[5,12],__annotations__:[2,4,9,11,12,13,18,19],__cache_act:20,__class__:[19,20],__contains__:[3,10],__defaults__:[2,4,9,11,12,13,18,19],__delitem__:[3,19],__dict__:20,__doc__:[2,4,9,11,12,13,18,19],__file__:8,__getattr__:3,__getitem__:[3,4,6,7,19],__init__:[2,3,12,19,20],__iter__:[3,7,10,19],__kwdefault__:13,__kwdefaults__:[2,4,9,11,12,13,18,19],__len__:[3,5,7,10,12,19],__macosx:[20,21],__module__:[2,4,9,11,12,13,18,19],__name__:[2,4,9,11,12,13,14,18,19,20],__nin__:3,__qualname__:[2,4,9,11,12,13,18,19],__repr__:[19,20],__reversed__:3,__setitem__:[3,4,10,19],__signature__:13,__str__:19,__validate_parameters__:13,_adapt_:13,_added_attr:20,_allow_parti:13,_allow_reord:13,_apply_default:13,_args_limit:13,_black_list:19,_cach:4,_call_forgivingli:13,_current_level:9,_data_of_obj:[3,19],_delete_keys_one_by_on:19,_dflt_object_nam:14,_empti:19,_error_kei:19,_explicit_kei:19,_func:19,_id:[3,12,14,19],_id_of_kei:[3,6,12,19],_ignore_kind:13,_isinst:13,_key_filt:10,_key_of_id:[3,12,19],_keys_cach:[14,19],_obj_of_data:[3,6,19],_obj_of_kei:8,_object_nam:14,_parameterkind:13,_path_typ:12,_post_filt:3,_pre_it:3,_prefix:[5,8,12],_root_length:19,_sourc:14,_w_cach:4,_w_sommeth:19,a00:13,a11:13,a12:13,a23:13,a34:13,a35:13,a36:13,a47:13,a_fil:11,a_forest:18,a_func:20,abc:[2,3,7,8,10,12,19],abil:[19,21],abl:[3,13,19],about:[11,13,19,21],abov:[3,13,18,19,21],abs:2,absolut:[5,12],acccumul:19,accept:13,access:[3,4,9,12,13,14,19,21],accord:[11,13,19,20],accordingli:21,account:13,accumul:[11,20],accur:2,acrobat:[18,21],act:[3,4,18,21],action:21,actual:[3,4,12,13,18,19,20],add:[2,3,4,6,9,11,12,13,18,19,20],add_append_functionality_to_store_cl:2,add_attr:20,add_get_path:19,add_ipython_key_complet:19,add_numb:20,add_param:13,add_path_access:19,add_path_access_if_map:19,add_path_get:19,add_store_method:19,add_wrapper_method:19,added:[2,12,19,20],adding:[3,11,19],addit:[2,3,19],addition:14,advanc:[13,19],advantag:[4,18],advis:[14,21],affect:20,aforement:19,after:[2,3,4,13,19],again:[3,4,13,19,20],against:[11,13],alia:[3,9,11,13,14,19],alias:[13,19],alic:[8,18],align:[2,13],all:[3,4,7,11,13,14,18,19,20,21],all_but_:14,all_kwargs_should_be_in_validation_dict:11,all_pk_signatur:13,allig:18,allow:[3,5,7,10,11,13,18,19,20],allow_excess:13,allow_overwrit:21,allow_parti:13,allowzip64:21,alon:13,along:[14,19,21],alreadi:[3,4,7,9,10,13,18,19,20],alreadyexist:7,alright:20,also:[2,3,4,12,13,14,18,19,20],alwai:[13,14,19],always_tru:19,amongst:13,analyt:19,and_mor:19,ani:[3,4,5,7,12,13,14,18,19,20,21],annoi:[3,7,13],annot:13,annotation_compar:13,annoy:13,annoyingli:20,anoth:[2,3,4,13,19,20,21],another_foo:13,another_group:11,another_us:11,anyth:[4,13,19],anywai:[3,13,18],api:13,app:21,appear:[11,13,19],appeas:7,append:[0,20,22],append_to_group_item:20,appendable_store_cl:2,appl:[18,20],appli:[3,4,7,13,14,19,20,21],applic:[3,19],apply_default:13,appropri:21,arg:[3,4,9,11,12,13,14,18,19,20],arg_extractor:13,arg_nam:13,arg_new_v:13,argnam:13,args1:13,args_and_kwargs_from_kwarg:13,args_limit:13,args_with_default:13,args_without_default:13,arguabl:18,argument:[3,4,11,13,14,19,20,21],argument_argu:13,argval:13,around:[4,18],ascii:3,asdf:13,asi:3,ask:[3,4,12,13,18,19,21],ask_before_before_delet:21,ask_user_for_value_when_miss:18,aspect:[3,19],assert:[2,3,4,9,11,12,13,14,18,19,20,21],assert_empti:13,assert_exist:9,assert_no_missing_position_only_arg:13,assert_rootdir_exist:9,assertionerror:[8,11,13,19],assign:[3,13,14,19],associ:19,assum:[3,12,13,19,21],assur:3,assure_param:13,attemp:19,attempt:19,attent:20,attr:[3,14,20],attr_dict:14,attr_val:14,attrcontain:14,attrdict:14,attribut:[3,4,6,7,10,12,13,14,19,20],attributeerror:20,audio:21,aug:0,author:13,auto:[4,14],automat:[4,9,12,13,19],avail:[4,12,18],averag:2,avoid:[3,11,13],awar:12,back:[3,4,8,12,13],backend:[3,13],bad:13,ball:18,banana:18,bar2:[10,19],bar:[3,4,8,10,11,12,13,14,18,19,20,21],bare:[13,14],base:[0,4,6,8,10,12,13,14,15,19,20,22],base_test:[0,22],basekeysview:15,basic:[14,20],basinig:13,baz:13,bbb:[14,19],bbbbb:14,bear:[18,19],beazlei:20,becaus:[3,4,7,11,13,14,18,19,20],becom:[14,19,20],been:[4,11,20,21],befor:[3,4,9,10,11,12,13,14,18,19],beg:13,begin:[2,3,11,20],behav:[3,19],behavior:[3,13,18,19,20],behind:[12,13,19],behvior:13,being:[7,13,18,19,20],believ:12,below:[4,13,18,19,20],bend:1,besid:[10,11,13,19],better:4,between:3,beyond:4,big:[19,20],bigdoctest:11,bind:13,bind_parti:13,bit:20,bituat:20,black:19,blacklist:19,blah:20,block:4,bob:18,boggl:13,bolton:20,book:20,bool:[3,9,13,18,19,20,21],border:18,both:[3,4,8,11,13,14,19,20,21],bound:4,box:[14,20,21],brave:18,bring:20,bucket:11,bug:6,build:[1,7,18],built:[20,21],builtin:[4,13],bulk:[13,19],bunch:[2,4,7,21],busi:7,bzip2:21,cach:[0,13,14,19,20,21,22],cache_is_act:20,cache_it:19,cache_kei:19,cache_my_kei:19,cache_update_method:19,cache_v:4,cached_dict:19,cached_kei:19,cachedinvertibletran:19,cachedkeyssequencekvread:14,cachedsequencekvread:14,cachedslowdict:4,cacheutil:20,calculu:13,call:[2,3,4,6,7,8,10,12,13,14,18,19,20],call_forgivingli:13,call_somewhat_forgivingli:13,callabl:[3,4,8,12,13,14,18,19,20,21],callable_or_signatur:13,callback:[7,20],can:[2,3,4,5,7,10,12,13,14,18,19,20,21],cannon:[12,14],cannot:[10,13,19],captur:11,care:[13,19,20],carri:[3,4,13,19],cast:11,catch_and_cache_error_kei:19,catch_except:7,categori:21,caught:7,caught_error:12,ccc:19,ccould:19,ch_func_to_all_pk:13,ch_param_attr:13,ch_signature_to_all_pk:13,ch_to_all_pk:13,ch_variadic_keyword_to_keyword:13,ch_variadics_to_non_variadic_kind:13,chainmap:4,chanc:18,chang:[0,11,13,19,20,21],changes_for_nam:13,charact:[8,12],chat:19,check:[3,4,6,10,11,13,14,19,20],check_funct:11,check_val:11,child:18,children:18,choic:[13,19,21],choke:13,choos:[3,12,19],chose:[13,19],chr:3,chunk:2,clariti:20,clash:13,class_or_tupl:13,class_tran:3,classmethod:[3,13],clean:19,clear:[3,4,19,20],clear_method:19,clearli:4,clock:2,closer:19,cls:[11,19,20],coconut:18,code:[3,13,19,20],collect:[2,3,4,7,8,10,11,12,18,19,20],collectiontyp:8,color:18,column:13,com:[3,11,13,20],combin:[13,19],come:[3,4,7,18,19],command:4,common:[13,19,20],common_and_diff_argnam:13,comp_tim:21,compar:[13,21],comparison:19,compat:13,compil:[11,21],complain:[11,20],complaint:13,complet:[13,14,19,20],complex:[1,13,20],compos:[13,20],composit:20,comprehens:20,compress:[20,21],compression_method:21,compresslevel:21,comput:[3,4,14,19,20],concern:[3,19],concret:[3,9,10],condit:[4,7,19],conditional_data_tran:19,conduct:19,configur:[3,4,13],confirm:18,confirm_overwrit:18,conflict:21,consequenti:2,conserv:13,consid:[3,13,19,20],consist:[4,13,18,19],constant:19,constant_output:19,constitut:[3,13],constraint:13,construct:[12,13,18,19],constructor:18,consum:[3,18,19,20],contain:[3,4,10,11,12,13,14,19,21],content:[0,3,4,8,13,19,20,21,22],contents_of_kei:8,context:[4,10],contrast:20,control:[3,11,13,21],conveni:[4,13,14,19,21],convent:[19,21],convers:[3,11],convert:[3,11,12,18,19,21],convert_to_numerical_if_poss:18,cookbook:20,copi:[2,13,19,20],copy_attr:20,copy_func:13,core:[0,1,22],correctli:13,correspond:[13,21],could:[3,4,11,13,19,20],count:[2,3,14,19,20],cours:4,cpython:13,creat:[2,4,7,9,13,18,19,21],creativ:19,cross:13,crucial:13,crud:19,csv:19,ctor:21,culprit:19,current:2,current_utc_:2,curri:[13,18,21],custom:[3,19,21],dai:11,danger:3,darwin:11,data:[1,2,3,4,6,8,11,12,13,14,18,19,21],data_of_obj:[6,19],data_structur:18,data_tran:19,databas:3,dataset:14,david:20,dddd:19,ddir:14,deal:[6,13,19],debug:13,decid:[4,19],deco:19,decod:21,decompress:21,decor:[2,4,9,13,19,20],decorated_a:19,decorator_2:19,decorator_3:19,decorator_func:19,def:[2,3,4,7,8,12,13,14,19,20],default_conflict_method:13,default_signatur:13,default_value_compar:13,defaultdict:20,defin:[2,3,6,8,10,11,12,13,19,20],define_extend_as_seq_of_append:2,definit:[4,10,19],definitioin:19,deflat:21,del:[3,10,12,14,19,20],deleg:[3,12,19],delegation_attr:3,delegator_wrap:3,delet:[3,4,7,10,14,19,20,21],deletionsnotallow:7,demo:[3,18,19],demonstr:19,depend:[3,4,7,10,11,13,19,21],descript:13,descriptor:20,deseri:[3,19],design:12,desir:[2,3,13,19],destin:19,detail:[3,13,19,21],detect:13,determin:[3,4,13,20],deux:14,dflt_dict:20,dflt_if_miss:2,dflt_keyword_onli:13,dict:[2,3,4,6,8,10,11,12,13,14,16,18,19,20],dict_item:12,dict_of:20,dict_to_namedtupl:11,dictionari:[3,18,21],dictionnari:18,did:[4,19,21],didn:[4,7,14,18,19],die:2,differ:[3,4,10,13,14,18,19,20,21],difficult:3,dig:[0,22],ding:4,dir:[20,21],dir_of_zip:21,dircollect:9,directli:[3,13,19],directori:[9,21],dirpath:9,dirs_onli:21,dirti:13,disabl:[3,7,20],disallow:10,disappear:19,discuss:11,disguis:21,dispar:14,displai:[6,18],distinguish:21,doc:[2,4,13,14,19,20,21],doctest:19,document:[13,20],doe:[7,10,13,19,20],does_not_fit_g_signature_anymor:13,doesn:[3,4,7,10,11,13,14,19,20,21],dogma:12,doing:[3,4,11,13,19],dol:22,domain:11,don:[3,4,12,13,14,18,19,20],done:[3,7,13],dong:4,doubl:19,double_up_as_factori:19,doubt:13,download:21,dragon_con:[3,19],drop:19,ds_store:[20,21],due:14,dump:[19,21],dump_fold:21,dunder:[3,14],dure:19,dynam:12,e_nam:11,e_sref:11,e_um:11,each:[4,8,14],easi:[13,18],easier:13,easili:[11,13],ecosystem:18,edg:13,effect:[2,3,13,20],effici:[10,21],egress:19,eight:13,element:[2,3,4,10,12,13,14,18,19,21],elif:19,els:[2,3,4,7,11,13,19,20],empti:[4,13,18,19,20,21],empty_cach:4,empty_cache_entri:4,emptyziperror:21,enabl:[19,20],encod:21,encount:[3,13,21],end:[9,19,20,21],endswith:19,enforc:[13,19],enforce_sig:13,enhanc:[19,20],enough:[4,7,19,20],ensur:4,ensure_clear_method:19,ensure_clear_to_kv_stor:4,ensure_exist:9,ensure_param:13,ensure_slash_suffix:9,enter:18,entir:19,entri:[3,4,20,21],enumer:[3,12,14],environ:4,equival:[4,13,19],err:19,error:[0,10,11,12,13,19,22],error_callback:19,errors_caught:19,especi:[7,13],essenti:13,etc:[2,4,8,9,11,13,14,19,20,21],even:[2,7,13,14,18,19,20],event:2,ever:[2,3,5,10,12,13,19],everi:[4,7,12,19,20],everyth:[8,12,13],exactli:10,exampl:[2,3,4,6,7,11,13,14,18,19,20,21],except:[3,7,9,11,13,14,19,21],excess:13,exclud:14,exclusive_subdict:14,exhibit:3,exist:[4,7,9,10,12,13,18,19,20,21],existing_v:18,exit:4,expect:[3,7,8,12,13,14,19,20],explan:13,explicit:[0,4,10,19,20,22],explicitkei:8,explicitkeymapread:8,explicitkeyssourc:8,explicitkeysstor:8,explicitkeyswithprefixrelativ:8,explicitli:[8,13,19],explor:3,expos:3,express:[11,13,19],extend:[2,19],extens:19,extern:[19,20],extra:[13,14,19],extra_mk_store_kwarg:21,extract:[11,13,14,18,21],extract_args_and_kwarg:13,extract_argu:13,extract_arguments_asserting_no_remaind:13,extract_arguments_ignoring_remaind:13,extract_kwarg:13,f_1:20,f_n:20,fact:[5,7,12,13,19],factor:19,factori:19,fail:[3,13,19],fair:19,fake_signatur:13,fall:13,fals:[2,4,7,8,9,11,12,13,19,20,21],familiar:19,far:[13,19],fast:13,faster:[13,19],fav:11,favorit:[12,20,21],featur:13,fed:20,feed:[2,11],feel:13,fetch:[14,19],few:[2,3,7,13],fff:18,field:[2,11,13,14,20],field_conversion_func:11,field_nam:11,field_value_format_regex:11,file:[3,4,5,6,8,9,11,12,19,20,21],file_info_filt:21,file_or_folder_to_zip_fil:21,file_where_this_code_i:8,filebytespersist:9,filebytesread:9,filecollect:9,fileinfo:21,fileinforead:9,filenam:[11,21],filepath:[9,21],files_onli:21,filesi:[0,22],filesofzip:21,filesread:9,filestreamsofzip:21,filestringpersist:9,filestringread:9,filesyscollect:9,filesystem:[3,20],fill:20,fill_with_dflt:20,filt:[19,21],filt_it:[19,20,21],filter:[3,10,13,19,20,21],filtered_dict:19,filteredkeysmixin:10,find:[4,8,13,21],fine:[13,16,18,19,20],finit:2,first:[1,2,3,4,10,12,13,14,19,20,21],first_level_kei:14,firstappendonli:2,firstargismap:19,fit:7,fix:[13,20],fixtur:20,flag:[2,19],flat:[14,20],flatread:14,flatten:19,flatten_pip:20,flattened_stor:19,flatzipfilesread:21,flexibl:13,flush:4,flush_cach:4,flush_cache_condit:4,folder:[3,4,5,9,12,20,21],follow:[3,13,14,19,20],foo:[3,4,8,10,11,12,13,14,18,19,20,21],foo_sig:13,forest:18,forest_typ:18,forev:[14,19],form:[2,3,7,14,18,19,20],format:[2,11,18,19,20,21],format_dict:[11,12],format_invoc:20,format_str:11,formatt:11,fortun:19,forward:3,found:[4,13,18],four:[3,19,21],fox:20,free:7,french:18,frenzi:19,frequent:13,fridai:19,friend:[14,19],friendli:13,from:[2,3,4,6,7,8,10,11,12,13,14,18,19,20,21],from_cal:13,from_csv:19,from_item_to_key_params_and_v:2,from_obj:13,from_s_um:11,fromkei:12,frontend:13,frozen:20,fruit:18,fuji:18,fulfil:13,full:[9,11,19],fulli:13,func1:13,func1_not_func2:13,func2:13,func2_not_func1:13,func:[3,13,14,19,20],funccallnotmatchingsignatur:13,funcdag:14,funcread:14,functiion:19,function_to_process_this_valu:11,functool:[3,11,13,14,18,19,20,21],further:[3,13,18,19,21],fv_version:11,gave:19,gen:3,gener:[2,3,4,6,7,9,11,19,20],get:[1,2,3,4,6,7,8,10,11,12,13,14,18,19,20,21],get_cach:4,get_fields_from_templ:11,get_node_kei:18,get_src_item:18,get_val:20,getattr:[3,14,19,20],getitem:19,gettempdir:21,github:[3,7,13],give:[2,3,4,7,11,12,13,14,18,19,20,21],given:[3,7,8,9,10,11,12,13,18,19,20],go_let:2,goal:13,goe:19,going:[4,7,21],gone:4,good:[7,19],got:[13,14,19,20],gotcha:13,grab:14,grammar:19,granni:18,green:18,group:[11,13,14,20],group_collector:20,group_factori:20,group_item:20,group_kei:20,group_release_cond:20,groupbi:20,groupdict:11,grouper_map:20,grp:20,guid:14,had:[6,14,19],hand:[13,14,19,20],handl:[10,13,20],happen:[4,7,13,19],hard:[13,20],harder:3,has:[2,3,4,5,6,7,10,12,13,14,18,19,20,21],has_enabled_clear_method:20,has_kv_store_interfac:3,has_signatur:13,has_var_keyword:13,has_var_kind:13,has_var_posit:13,hasattr:[3,19],hash:4,hashabl:[4,19,20],hashabledict:4,hasn:4,have:[2,3,4,7,11,12,13,14,18,19,20,21],head:[3,8],header:3,heart:13,hei:20,hello:[4,11,13,18,20],help:13,helper:19,here:[2,3,4,6,10,11,13,14,18,19,20],hesit:20,hidden:[4,12,14],highli:19,hit:[4,18,19],hold:[4,14,19,20],home:[11,12],hood:[12,19,20],how:[2,3,6,10,13,19,20,21],html:21,http:[3,11,13,20,21],hurdl:7,i2mint:[3,13],i_think:3,id_of_kei:[6,8,11,19],idea:20,ident:3,identifi:[10,12],identitykeyswrapmixin:10,identitykvwrapmixin:10,identityvalswrapmixin:10,if_attr_exist:20,if_i_zipped_stat:21,iff:[11,13,19,20],ignor:[13,20],ignore_excess:13,ignore_incompatible_signatur:13,ignore_kind:13,ignore_misunderstood_validation_instruct:11,ignore_test:21,igroupbi:20,ihead:1,iif:8,illustr:19,imdict:20,impact:18,implement:[3,7,8,10,13,19,20],impli:11,implicit:4,importantli:3,impos:13,imposs:14,includ:[2,3,13,18,19,20],include_all_when_var_keywords_in_param:13,include_hidden:9,incom:[12,19],incompatiblesignatur:13,inconsist:11,inde:[2,3,12,13,19,21],index:[0,2,7,11,13],index_of_var_keyword:13,index_of_var_posit:13,indic:[3,7,13,14,19,20],individu:2,inf:18,infin:18,info_dict:11,inform:[13,18],ingo:[12,19],ingoing_kei:19,ingoing_key_method:19,ingoing_v:19,ingoing_value_method:19,ingress:19,inherit:10,initi:[8,19],inject:[2,14,19,20],inject_method:20,injecton:13,inner:[12,19],inplac:4,input:[3,4,8,13,18,19,20,21],insert:[13,19,20],insert_alias:19,insert_annot:13,insert_load_dump_alias:19,insid:19,insofar:13,inspect:[6,13,19,20],inspir:13,instal:14,instanc:[2,3,4,6,8,11,12,13,14,18,19,20,21],instancc:19,instance_check:[19,20],instead:[3,4,5,12,13,14,15,19,20,21],insteadk:13,integ:[13,14,18,19],integr:12,intend:[13,19],intens:21,intent:[5,13,19],inter:13,intercept:12,interest:[3,13,14,21],interfac:[1,3,5,6,11,12,13,14,18,19],interface_sig:13,intern:[3,12,19],introduc:[3,4],introspect:6,intrud:13,inv_map:8,invers:[8,13],invert:[8,19],invertible_map:8,involv:[3,5,12,13,19],ipython:19,irrelev:3,is_a_mac_junk_path:21,is_call_compatible_with:13,is_leaf:18,is_param_compatible_with:13,is_valid:11,is_valid_kei:12,is_valid_prefix:11,isfil:21,isinst:[13,14,18,19,20],isinstance_of_str:13,islic:3,islicestor:18,isn:[18,19],isnumer:3,issu:13,issubclass:3,isupp:19,item2kei:2,item2kv:2,item:[1,2,3,4,6,7,11,12,13,14,18,19,20],item_to_:20,item_to_kei:2,item_to_key_params_and_v:2,item_to_kv:2,itemgett:14,items_in_that_group:20,items_with_caught_except:7,itemsview:[3,15],iter:[1,3,7,8,10,12,13,14,18,19,20,21],iter_dirpaths_in_folder_recurs:9,iter_filepaths_in_folder_recurs:9,iter_to_contain:19,iterationnotallow:7,iterbasedsizedcontainermixin:10,itertool:[3,20],its:[3,13,14,19],itself:[2,8,11,13,14,19,20,21],job:[7,19,21],join:[3,11,19,21],json:[10,19,21],junk:[20,21],just:[2,3,4,7,8,11,12,13,14,15,16,19,20,21],kaggl:7,keep:19,keep_field_in_valu:2,kei:[2,3,4,5,6,7,8,10,11,12,13,14,15,18,19,20,21],key_as_tupl:2,key_collect:8,key_condit:9,key_func:[4,20],key_map:20,key_of_id:[6,8,11,19],key_param:2,key_str_format:2,key_templ:2,key_typ:[11,12],keyerror:[3,7,12,19],keymap:11,keymap_kwarg:11,keymapnam:11,keypath:[12,19],keys_cach:19,keys_to_be_remov:21,keysview:[3,15],keyswrapabc:10,keyvalidationabc:3,keyvalidationerror:[7,9],keyword:[3,13,19,20],keyword_onli:13,kick:13,kilo:6,kind:[3,11,13,18,19],kind_forgiving_func:13,king:20,know:[2,3,4,13,19,20,21],known:19,koa:13,kv_collect:19,kv_filt:20,kv_walk:[3,19],kv_wrap:19,kv_wrap_persister_cl:19,kvhead:1,kvpersist:3,kvreader:[3,14,19,21],kvstore:3,kw_func:20,kwarg:[9,11,12,13,14,19,20],kwargs1:13,kwargs_from_args_and_kwarg:13,kwargs_new_v:13,kwargs_to_valid:11,kws:[13,20],lag:2,lambda:[2,3,4,6,12,13,14,18,19,20,21],languag:3,larg:7,last:[0,2,3,6,8,10,12,13,14,19,20,21],later:[13,19],latter:4,layer:[3,4,6,21],layer_attr:6,lazyprop:20,lazyprop_w_sentinel:20,lead:13,leaf:[3,18],leaf_tran:18,least:[4,11,12,13,20],leav:[2,13,18],left:[3,4,20],len:[2,3,4,6,8,12,13,14,19,20,21],length:[19,20],lenienc:13,less:[4,13,19],let:[2,3,4,6,7,11,12,13,19,20,21],letter:19,level:[3,9,19],leveled_map_walk:3,librari:21,life:[14,19],lifo:3,like:[2,3,4,6,12,13,14,15,18,19,20,21],line:[3,6,20],line_pre_proc_func:3,linearnam:11,linux:11,list:[1,2,3,4,7,8,11,12,13,14,15,18,19,20,21],liter:[19,20],littl:[4,19],live:[2,19],load:19,local:[4,5,9,11,12,19,21],localfilestor:3,localjsonstor:11,locat:[19,21],logic:[19,20],lol:19,longest:20,look:[4,8,12,13,18,19,20,21],loop:[2,7],loos:11,lose:11,lost:13,lot:[7,13,19],love:[14,19,21],lower:[3,6,19],lzma:21,mac:[20,21],macosx:20,made:[3,11,19,20],magic:[14,19],mai:[11,13,19,20],main:[2,11,13,20],maintain:13,make:[2,3,4,8,9,11,12,13,14,18,19,20,21],makemissingdirsstoremixin:9,malformat:19,manag:[4,13],mani:[7,13,14,18,19],manipul:12,manner:9,manual:[4,19],map:[2,3,4,7,8,10,11,12,13,14,15,18,19,20],mapinvertabilityerror:19,mapper:12,mappingview:3,mark:[11,19],match:[11,13,14],math:13,matrix:13,matter:19,max:19,max_common_prefix:20,max_level:[9,21],maximum:13,mayb:19,mean:[3,13,19],meant:[3,13,19,20],meet:[13,19],memor:4,memori:[4,19],merg:[13,21],merge_with_sig:13,mess:13,met:20,meta:13,method:[2,3,4,6,7,10,11,12,13,14,19,20,21],method_func:19,method_funct:20,method_nam:[19,20],methodfuncnotvalid:7,methodnamealreadyexist:7,might:[3,11,13,14,18,19,20,21],million:19,mind:[13,18],minim:14,minimum:13,minut:19,misalign:13,miss:[4,13,18,20,21],missig:2,missing_kei:21,missingargvalfor:13,mistyp:11,mixin:[0,3,12,19,22],mk_cached_stor:4,mk_dirs_if_miss:9,mk_e_nam:11,mk_flatzips_stor:21,mk_item2kv:2,mk_item2kv_for:2,mk_kv_reader_from_kv_collect:19,mk_kwargs_tran:11,mk_level_walk_filt:[3,19],mk_param:13,mk_pattern_from_template_and_format_dict:11,mk_prefix:11,mk_relative_path_stor:12,mk_sig_from_arg:13,mk_sourced_stor:4,mk_store:21,mk_store_from_path_format_store_cl:11,mk_trans_obj:19,mk_tupled_store_from_path_format_store_cl:11,mk_u_nam:11,mk_wrapper:19,mk_write_cached_stor:4,mod3:20,mod:20,mode:19,modern:3,modif:3,modifi:[13,19,21],modul:[0,3,6,11,12,14],more:[2,3,4,10,11,13,14,18,19,20,21],more_of:19,morphem:19,most:[6,8,10,12,13,14,18,19,20,21],move:14,mro:[3,9,10,19],msg:19,much:[12,13],muddl:20,multilin:20,multipl:[13,14,19,20,21],multipli:19,multiply_by_2:20,multiply_by_3:19,must:[3,4,8,11,12,13,18,19],mutabl:20,mutablemap:3,mutat:[2,19],my_data:4,my_filt:20,my_filt_func:21,my_flatten:19,my_g:13,my_log:7,my_other_log:7,mycachedstor:4,mydict:19,myfilteredstream:3,myflatdict:19,myrelstor:12,mystor:[2,3,4,12,19],mystream:3,mysum:20,mytupl:11,n_requir:13,name:[0,2,6,7,10,12,13,14,19,20,21,22],name_of_obj:13,name_of_output_typ:11,name_separ:11,named_func:20,named_key_func:20,named_object:14,named_tuple_type_nam:12,namedtupl:[11,12],namedtuple_obj:11,namedtuple_to_dict:11,namedtuplefromdict:11,nameerror:6,names_for_kind:13,names_of_kind:13,namm:19,nation:18,nativ:13,natur:[18,21],nauseam:20,naysay:7,ncach:4,need:[1,3,4,8,9,10,11,13,18,19,20,21],neg:2,neither:[13,19],nest:[3,18,19,20],network:19,neutral:10,new_f:13,new_filt_func:20,new_foo:13,new_func:13,new_group:11,new_sig:13,new_store_nam:2,new_us:11,newgui:11,next:[3,4,6,14,18,19],nice:13,nice_kind:13,no_sig_arg:13,no_sig_kwarg:13,no_such_kei:3,node:[3,18,19],non:[13,14],none:[2,3,4,7,8,9,11,12,13,14,18,19,20,21],nope:19,nor:13,norm_kv_filt:20,normal:[4,12,13,19,20],normalize_kind:13,nosuchkeyerror:7,not_a_kei:14,not_a_mac_junk_path:20,not_in_sig:13,not_valid_______434:20,notallow:7,note:[2,3,4,10,11,12,13,14,18,19,20,21],noth:[13,19,20],notic:[19,20,21],notspecifi:2,notuniqu:14,notvalid:7,now:[3,4,6,7,8,11,12,13,18,19,20,21],num:[6,11],num_of_arg:20,num_of_item:19,num_of_required_arg:20,number:[3,10,11,13,14,18,19,20],numer:6,oNe:19,obei:13,obj:[2,3,7,10,13,14,19,20],obj_of_data:[6,18,19],object:[2,3,5,7,8,10,11,12,13,14,15,18,19,20,21],object_to_forest:18,objread:[8,14],observ:13,obtain:[13,19],obviou:[18,19],obvious:19,odd:[19,20],odir:21,off:[3,19],offer:[3,10],offset:2,offset_:2,often:[10,13,19,20,21],okai:21,old:20,omit:11,on_error:12,on_missing_msg:18,onc:[13,19,20,21],one:[2,3,4,5,8,11,13,14,18,19,20,21],ones:[11,12,13,19,20,21],onli:[2,3,4,5,10,11,12,13,14,18,19,20,21],oopsi:11,open:8,open_kw:21,oper:[7,10,11,13,19],operationnotallow:7,opposit:14,opt:9,option:[11,13,18,19,20,21],ord:3,order:[2,3,11,13,19],org:[18,21],origin:[3,5,11,13,19,20,21],origina_d:3,original_d:3,other:[3,8,11,13,14,19,20,21],other_sig:13,otherwis:[3,13,19],our:[4,12,13,14,18,19],out:[2,3,4,7,13,14,19,21],outcom:[12,19],outcoming_kei:19,outcoming_key_method:19,outcoming_v:19,outcoming_value_method:19,outer:[12,19],outgo:12,output:[2,3,4,11,13,18,19,20],outrag:19,over:[3,7,10,12,13,18,19],overrid:3,overridden:10,overritten:19,oversight:13,overwrit:[7,18,19],overwritenotallow:21,overwritesnotallowederror:[7,10,19],overwritesnotallowedmixin:[10,19],overwritten:[10,19],own:[3,14,19,20],ozeip:11,packag:14,page:0,paint_it_42:19,pair:[2,3,4,8,11,13,14,15,19,20],param:[2,11,13,19,21],param_arg:13,param_attr:13,param_compar:13,param_for_kind:13,param_iter:13,param_kind:13,param_kwarg:13,param_map:13,paramat:13,paramet:[2,3,4,6,7,11,12,13,18,19,20,21],parametr:[11,13],parametrickeystor:11,parammet:13,params:13,paranoia:13,paranoid:7,parent:[10,18],parenthes:19,pariti:20,part:11,partial:[3,11,13,14,18,19,20,21],partial_formatt:11,partialclass:20,partialformatt:11,particular:[3,13],pass:[2,3,10,11,13,19,20],path:[0,3,4,5,8,9,11,19,20,21,22],path_get:12,path_sep:[12,19],path_typ:19,pathkeytyp:12,pattern:[11,13],pattern_for_field:[9,21],peek:19,peep:[4,19],per:13,perform:[4,14,19,21],perisist:9,permiss:21,persist:[3,4,10,19],persister_cl:19,person:18,perspect:21,physic:3,pick:13,pickability_test:[0,22],pickabl:16,pickal:20,pickl:[9,16,19],picklestor:9,pie:14,pip:14,pipe:20,pitfal:12,pka:13,pkl:19,pkv_to_pv:3,place:[9,10,12,13,19],plc:21,plu:[2,18],poa:13,point:[4,11,19],pointer:4,pool:7,pop:[2,3,19],popitem:[3,19],popul:4,pos:13,posit:[13,20],position_onli:13,position_or_keyword:13,positional_onli:13,positional_or_keyword:13,possibl:[2,7,13,14,19],post:7,postget:19,power:11,preced:13,preciou:4,precis:[19,20],precomput:19,prefix:[9,11,12,19,20,21],prefix_attr:12,prefixrelativ:5,prefixrelativizationmixin:12,prepar:[14,20,21],preprocess:3,present:[2,9,21],preserv:13,preset:[18,19],press:18,pretend:4,previou:4,print:[4,6,7,8,11,13,19,20],print_stat:4,probabl:19,problem:[7,13,19,20],problemat:19,process:[7,11,13],process_info_dict:[11,12],process_kwarg:[11,12],produc:[2,3,11,19],product:2,program:13,prompt:18,proof:19,prop:20,properti:[7,13,20],protect:7,prove:19,provid:[3,4,13,18,19,21],pull:13,purpos:[3,10,13,14,19,20],put:[4,10,13,19,21],pwd:21,py2stor:14,pypi:14,python:[3,13,14,18,20,21],queri:19,question:[11,20,21],quick:13,quicker:4,quickli:19,quit:[13,19,21],rais:[7,8,10,11,13,14,19,20],raise_error_if_an_attr_is_miss:20,raise_on_error:12,raison:20,ram:[4,19],rang:[4,7,18,20],rant:21,rate:[2,3],rather:19,raw:[14,19],reach:[2,20],read:[3,4,7,8,14,18,19,20,21],read_dict:8,read_fil:8,reader:[3,8,13,14,18,19,21],readi:[13,20],readlin:21,readonlymixin:10,readsnotallow:7,real:[9,13,19],realli:[3,7,10,12,13,18,19,20,21],rearrang:13,reason:19,receiv:9,recent:[6,8,10,12,13,14,19,20],recip:3,recogn:13,recommend:19,recomput:[4,19,20],recurs:[3,9,12,14,19,20],red:18,redefin:13,redrum:11,reduc:13,refer:[5,12],referenc:[5,12],refetch:4,reflect:13,refresh:[4,19],regardless:[4,19],regex:11,regroupbi:20,rel:[5,9,12],rel_path_wrap:12,relationship:18,reldict:19,releas:[0,20],release_remaind:20,reli:13,relpath:[12,19,21],relpath_wrap:19,relpathfilebytespersist:9,relpathfilebytesread:9,relpathfilestringpersist:9,relpathfilestringread:9,rema:13,remain:[2,11,13],remaind:13,remaining_kwarg:13,rememb:[13,14,19],remember_added_attr:20,remot:[3,4,19,21],remov:[4,11,12,13,19,20,21],remove_delet:19,remove_field:11,remove_mac_junk_from_zip:21,remove_some_entries_from_zip:21,reorder:13,repeat:20,repeatedli:13,repetit:13,replac:[11,13],replace_name_el:11,repr:19,repres:[2,3],represent:3,repurpos:19,request:[7,18,19],requir:[3,7,13,20],required_nam:13,resolut:4,resolv:[9,13,21],resolve_dir:9,resolve_path:9,respect:[2,4,11,13,19,20],respons:14,rest:13,restor:13,restrict:[4,13],result:[4,12,13,19,20],retriev:[3,7,10,19],return_annot:13,return_input:18,return_kei:2,return_source_data:4,return_v:19,reveal:[4,19],revers:[2,3],revisit:4,right:[7,8,11],rm_delet:19,rm_keys_without_ask:21,robust:13,robust_has_signatur:13,root:[5,8,12,18,19],root_dir:11,root_fold:9,rootdir:[9,12,21],rope:19,row:13,rule:[13,19],run:[19,21],runtim:13,s_um:11,safer:11,sai:[3,6,13,18,19,20],said:[13,19,20],same:[2,3,4,10,11,13,18,19,21],sampl:[2,3],saniti:13,satisfi:[10,13],save:[19,21],scene:[13,19],scrap:[0,22],scratch:13,script:3,search:[0,4,7,13,21],sec:19,second:[2,4,13,19],second_level_kei:14,see:[2,3,4,6,11,12,13,18,19,20,21],seed:[7,14],seek:3,seem:20,self:[2,3,4,7,11,12,13,19,20],semant:13,sens:[13,21],sent:19,sentinel_of__len:20,sep:[11,12,13],separ:[9,12,19],sequenc:[2,4,14,20],sequencekvread:[14,20],serial:[3,10,19],serv:[10,21],server:3,servic:13,session:11,session_id:21,set:[2,3,7,8,11,13,14,19,21],set_signature_of_func:13,setattrnotallow:[7,19],sever:[3,4,13,19],shallow:20,shorter:13,should:[2,3,4,6,7,8,9,10,12,13,14,18,19,20,21],shouldn:[3,4,7],show:[2,16,18,19,20],side:13,sig1:13,sig2:13,sig:13,sig_or_default:13,sig_or_non:13,signatur:[0,3,7,19,20,22],signific:14,silent:3,similar:13,simpl:[1,3,10,13,14,19,20],simplejsonmixin:10,simpler:11,simpli:[13,14,18],simplifi:20,sinc:[3,11,13,14,18,19,20,21],singl:[3,4,11,13,19,20,21],situat:[2,4,9,13,20],size:[3,10,19,21],skip:[3,19],skipe:[13,19],slap:7,slash:21,sleep:4,sleep_:4,slice:18,sliceabl:[18,20],sliceable_:18,slightli:19,slot:18,slow:19,slowdict:4,small:[6,19,20],smallest:20,smart:20,snapshot:21,sole:11,solut:[11,13,20,21],solv:19,some:[2,3,4,7,8,13,14,19,20,21],some_byt:21,some_func:13,some_zip_fil:21,somekvpersist:3,someth:[2,3,4,7,13,19,20,21],sometim:[7,13,19,21],somewher:[10,13,20],soon:21,sort:[11,13,18,19,21],sort_param:13,sorta:13,sorted_dict:19,sourc:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,15,16,18,19,20,21,22],source_args_and_kwarg:13,source_kwarg:13,sourcedloc:4,spec:11,special:[3,13,19],special_foo:13,specic:21,specif:[2,3,4,11,13,19,21],specifi:[2,3,8,11,13,14,18,19,20,21],speed:19,split:[3,13,19],src:[3,18],src_path:21,sss:[6,18],stabl:13,stackexchang:20,stackoverflow:11,start:[6,18,19,20,21],startswith:[11,18,20,21],stat:21,staticmethod:19,statu:21,stdin:6,step:[6,13],still:[2,4,10,12,13,18,19,20,21],sting:11,stop:3,stopword:20,storag:3,store:[1,2,3,4,6,7,8,9,10,11,12,14,16,18,19,20,21],store_cach:4,store_cached_with_single_kei:4,store_cl:[2,9,11,12],store_cls_kwarg:11,store_decor:19,storeinterfac:3,storewithdictkei:11,storewithnamedtuplekei:11,storewithtuplekei:11,storeyouwanttotransform:19,stori:4,str:[3,6,9,11,12,13,14,18,19,20,21],str_templat:11,str_template_key_tran:12,str_to_var_str:20,strang:19,stranger:19,stream:[2,3,21],strict:13,strict_timestamp:21,string:[2,3,5,6,11,12,13,18,19,20,21],stringifi:20,stringio:3,stringkvwrap:10,strip:3,strtupledict:11,strtupledictwithprefix:11,struct:14,structur:[3,18],stuff:[4,8,13,19,21],style:20,sub:[2,3,13,19],subclass:[2,3,4,10,12,13,19,21],subfold:[9,21],subpath:[9,11,21],subscript:[5,12],subsequ:19,subset:[11,13,19],subtl:19,subtract:13,subtre:18,subus:11,successf:19,sugar:13,suggest:13,sum:13,support:[3,4],suppos:[13,14],sure:13,sync:21,system:[2,3,9,11,21],systemat:13,tab:[14,19],take:[4,11,13,19,21],take_everyth:[19,21],taken:[13,19,20],talk:[4,19],target:[13,20],tasti:18,tell:[11,13,19,20],tempfil:21,templat:[11,12],test:[0,3,4,7,13,19,20,22],test_phas:21,test_phase_numb:21,test_pickling_w_dict:16,test_stor:3,test_wrapped_d:3,test_zipfil:21,testact:21,testpersist:[10,19],text:19,textfil:9,textfilesread:9,than:[2,11,13,14],the_persistent_dict:4,thei:[3,4,6,8,10,11,13,16,18,19,20,21],them:[3,8,11,13,14,19,20,21],themselv:[3,11,18],thenm:13,therefor:[3,18,19],thereof:[14,19],thi:[3,4,8,10,11,12,13,14,18,19,20,21],thii:19,thin:13,thing:[3,4,12,13,19,20,21],think:20,third:13,this_argnam:13,this_is_a_valid_var_nam:20,this_is_not_an_attr:20,those:[3,10,13,14,19,20],though:[4,12,13,19,20,21],thought:20,three:[13,19],through:[3,4,5,7,12,13,14,18,19,20,21],thu:[13,19],time:[2,4,7,8,12,13,18,19,20,21],time_takes_no_argu:13,timestamp:2,tip:[13,21],to_csv:19,to_signature_kwarg:13,to_simple_signatur:13,to_zip_fil:21,to_zipped_byt:21,todo:[13,19],togeth:13,toi:18,token:[11,20],too:[11,12,13,19,21],took:[2,19],tool:[0,1,2,4,5,13,14,19,22],total:13,trace:19,trace_getitem:6,traceback:[6,8,10,12,13,14,19,20],tran:[0,6,12,18,21,22],trans_func:19,trans_func_for_kei:11,trans_obj:19,transform:[3,4,6,11,12,13,14,18,19],translat:[12,13],transpar:10,transparent_key_method:19,travers:3,tre:14,tree:[3,18,19],tree_:18,treehttp:18,tri:[13,18],trick:[3,20],trigger:4,tripl:13,trivial:3,troubl:13,trust:19,tup:13,tupl:[2,3,7,8,11,12,13,14,15,19],tuple_keypath_and_v:3,tuple_the_arg:13,turn:19,twhalen:21,twice:13,two:[2,3,4,8,11,13,19,20,21],txt:11,type:[2,3,8,11,12,13,18,19,20],typeerror:[13,20],typic:19,u_nam:11,u_name_2:11,u_sref:11,unchang:2,uncomp_tim:21,uncompress:21,unconsum:14,under:[3,4,12,18,19,20],underli:[18,19],underspecifi:13,understand:13,unexpect:13,unic:[13,19],union:[3,4,12,13,14,18,19,20,21],unique_el:14,unit:[6,19],unix:[4,21],unless:19,unlik:[3,4,13,19],unnam:2,uno:14,unord:19,unpickl:16,unravel:20,untouch:[13,20],unwant:20,unwittingli:4,unwrapped_d:3,unzip:21,unzipped_byt:21,updat:[3,13,14,19,20,21],update_fields_of_namedtupl:11,update_keys_cach:[14,19],updatednt:11,upload:11,upon:12,upper:[3,6,19],uri:11,url:14,usag:[13,19,21],use:[2,3,4,7,11,12,13,14,18,19,20,21],use_cached_kei:19,use_cached_keys_after_completed_it:19,use_interfac:13,used:[2,3,4,5,7,11,12,13,14,18,19,20,21],useful:[3,4,10,11,13,14,18,19,20,21],useless:20,user:[11,13,18,19,21],user_input_msg:18,userdict:[12,19],uses:[2,8,11,12,19],using:[2,3,4,12,13,14,18,19,20,21],usual:[4,10,11,13,14,19,20,21],utc:2,utc_kei:2,utc_m:11,utf:21,util:[0,7,8,11,14,19,21,22],val:[2,7,10,11,14,15,19,20],val_is_map:3,val_postproc:14,val_reads_wrt_to_kei:19,valid:[4,7,11,12,13,18,19,20,21],validate_kwarg:11,validation_dict:11,validation_fun:11,valswrapabc:10,valu:[2,3,4,6,7,8,10,11,12,13,14,18,19,20,21],value_preprocessor:18,valueerror:[8,13,19,20],valuesview:3,var_keyword:13,var_keyword_nam:13,var_posit:13,variabl:[4,11,13,20],variad:[13,20],variadic_keyword:13,varieti:13,variou:[6,18],veri:[4,5,12,13,19],verifi:[3,13,21],versa:[3,12],version:[3,4,13,14,19,20],view:[3,12,13,14,18,19,21],visa:[3,12],visibl:[14,20],vka:13,vpa:13,w_cach:4,wai:[3,4,10,12,13,14,19,20],wait:13,walk:3,walk_filt:[3,19],want:[2,3,4,5,6,7,10,11,12,13,14,18,19,20,21],warn:[7,13,19],wasn:19,wav:[3,11],waveform:3,weird:[19,21],well:[4,6,13,14,18,19,20,21],were:[11,13,19],weren:13,wfoo:13,what:[3,4,7,8,10,11,12,13,14,19,20,21],what_to_do_with_remaind:13,whatev:[4,19,21],when:[3,4,5,7,11,12,13,14,16,18,19,20,21],where:[2,3,4,9,10,11,12,13,14,18,19,20],whether:[2,3,4,12,13,19,20],whic:18,which:[2,3,4,10,13,14,18,19,20,21],who:18,whole:[3,14],whose:[3,4,11,13,18,19,21],why:[13,19],wiith:20,wiki:[3,18],wikipedia:18,wikipediaontreeshttp:18,window:11,wish:13,with_default:13,with_key_valid:12,within:3,without:[2,7,13,19,20],without_default:13,without_remaind:13,won:[11,13,20,21],word:20,word_categori:20,work:[3,4,10,11,12,13,19,20,21],world:[4,11,13,18,20],wors:3,would:[2,3,4,11,12,13,18,19,20],wouldn:[11,19],wow:4,wrap:[3,4,5,8,10,11,12,13,14,16,18,19,20,21],wrap_cl:19,wrap_kv:[6,18,19],wrapped_d:3,wrapped_foo:19,wrapped_func:19,wrapped_obj:3,wrapped_stor:19,wrappeda:3,wrappeddict:[3,15],wrapper:[3,13,19],wrapper_kwarg:19,write:[3,4,7,9,10,13,14,18,19,20,21],writebackchainmap:4,writer:3,writesnotallow:7,written:[4,19],wrong:7,x_to_i:19,xyz:13,y_of_x:19,yeah:13,yes:[7,13,19],yet:[13,19],yield:[3,7,15,19,20],yield_callback_output:7,yield_func:3,you:[2,3,4,7,8,10,11,12,13,14,18,19,20,21],your:[1,3,4,7,10,11,13,14,18,19,20,21],your_filt_func:20,your_stor:19,yourself:21,zip:[19,20,21],zip_fil:21,zip_filepath:21,zip_pair_path_preproc:21,zip_path_pair:21,zip_read:21,zip_reader_kwarg:21,zip_sourc:21,zipfil:21,zipfiledol:[0,22],zipfileread:19,zipfilesread:21,zipfilesreaderandbyteswrit:21,zipfilestreamsread:21,zipinfo:21,zipinforead:21,zipped_byt:21,zipped_bytes_to_byt:21,zipread:[19,21],zipstor:21,zipstore_test_fil:21,zoo:13,zzz:20},titles:["Welcome to dol\u2019s documentation!","dol","dol.appendable","dol.base","dol.caching","dol.core","dol.dig","dol.errors","dol.explicit","dol.filesys","dol.mixins","dol.naming","dol.paths","dol.signatures","dol.sources","dol.tests.base_test","dol.tests.pickability_test","dol.tests.scrap","dol.tools","dol.trans","dol.util","dol.zipfiledol","<no title>"],titleterms:{append:2,base:3,base_test:15,cach:4,core:5,dig:6,document:0,dol:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21],error:7,explicit:8,filesi:9,indic:0,mixin:10,name:11,path:12,pickability_test:16,scrap:17,signatur:13,sourc:14,tabl:0,test:[15,16,17],tool:18,tran:19,util:20,welcom:0,zipfiledol:21}}) \ No newline at end of file +Search.setIndex({docnames:["index","module_docs/dol","module_docs/dol/appendable","module_docs/dol/base","module_docs/dol/caching","module_docs/dol/core","module_docs/dol/dig","module_docs/dol/errors","module_docs/dol/explicit","module_docs/dol/filesys","module_docs/dol/mixins","module_docs/dol/naming","module_docs/dol/paths","module_docs/dol/signatures","module_docs/dol/sources","module_docs/dol/tests/base_test","module_docs/dol/tests/pickability_test","module_docs/dol/tests/scrap","module_docs/dol/tools","module_docs/dol/trans","module_docs/dol/util","module_docs/dol/zipfiledol","table_of_contents"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,"sphinx.ext.todo":2,"sphinx.ext.viewcode":1,sphinx:56},filenames:["index.rst","module_docs/dol.rst","module_docs/dol/appendable.rst","module_docs/dol/base.rst","module_docs/dol/caching.rst","module_docs/dol/core.rst","module_docs/dol/dig.rst","module_docs/dol/errors.rst","module_docs/dol/explicit.rst","module_docs/dol/filesys.rst","module_docs/dol/mixins.rst","module_docs/dol/naming.rst","module_docs/dol/paths.rst","module_docs/dol/signatures.rst","module_docs/dol/sources.rst","module_docs/dol/tests/base_test.rst","module_docs/dol/tests/pickability_test.rst","module_docs/dol/tests/scrap.rst","module_docs/dol/tools.rst","module_docs/dol/trans.rst","module_docs/dol/util.rst","module_docs/dol/zipfiledol.rst","table_of_contents.rst"],objects:{"":{dol:[1,0,0,"-"]},"dol.appendable":{FirstAppendOnly:[2,1,1,""],add_append_functionality_to_store_cls:[2,2,1,""],appendable:[2,2,1,""],define_extend_as_seq_of_appends:[2,2,1,""],mk_item2kv_for:[2,1,1,""]},"dol.appendable.mk_item2kv_for":{field:[2,3,1,""],fields:[2,3,1,""],item_to_key:[2,3,1,""],item_to_key_params_and_val:[2,3,1,""],utc_key:[2,3,1,""]},"dol.base":{Collection:[3,1,1,""],KeyValidationABC:[3,1,1,""],KvPersister:[3,1,1,""],KvReader:[3,1,1,""],KvStore:[3,4,1,""],Persister:[3,4,1,""],Reader:[3,4,1,""],Store:[3,1,1,""],Stream:[3,1,1,""],delegator_wrap:[3,2,1,""],has_kv_store_interface:[3,2,1,""],kv_walk:[3,2,1,""]},"dol.base.KvPersister":{clear:[3,3,1,""]},"dol.base.KvReader":{head:[3,3,1,""]},"dol.base.Store":{get:[3,3,1,""],head:[3,3,1,""],wrap:[3,3,1,""]},"dol.base.Stream":{wrap:[3,3,1,""]},"dol.caching":{HashableDict:[4,1,1,""],WriteBackChainMap:[4,1,1,""],cache_vals:[4,2,1,""],get_cache:[4,2,1,""],mk_cached_store:[4,2,1,""],mk_sourced_store:[4,2,1,""],mk_write_cached_store:[4,2,1,""],store_cached:[4,2,1,""],store_cached_with_single_key:[4,2,1,""]},"dol.core":{PrefixRelativization:[5,1,1,""]},"dol.dig":{trace_getitem:[6,2,1,""]},"dol.errors":{AlreadyExists:[7,5,1,""],DeletionsNotAllowed:[7,5,1,""],IterationNotAllowed:[7,5,1,""],KeyValidationError:[7,5,1,""],MethodFuncNotValid:[7,5,1,""],MethodNameAlreadyExists:[7,5,1,""],NoSuchKeyError:[7,5,1,""],NotAllowed:[7,5,1,""],NotValid:[7,5,1,""],OperationNotAllowed:[7,5,1,""],OverWritesNotAllowedError:[7,5,1,""],ReadsNotAllowed:[7,5,1,""],SetattrNotAllowed:[7,5,1,""],WritesNotAllowed:[7,5,1,""],items_with_caught_exceptions:[7,2,1,""]},"dol.explicit":{ExplicitKeymapReader:[8,1,1,""],ExplicitKeys:[8,1,1,""],ExplicitKeysSource:[8,1,1,""],ExplicitKeysStore:[8,1,1,""],ExplicitKeysWithPrefixRelativization:[8,1,1,""],ObjReader:[8,1,1,""],invertible_maps:[8,2,1,""]},"dol.filesys":{DirCollection:[9,1,1,""],FileBytesPersister:[9,1,1,""],FileBytesReader:[9,1,1,""],FileCollection:[9,1,1,""],FileInfoReader:[9,1,1,""],FileStringPersister:[9,1,1,""],FileStringReader:[9,1,1,""],FileSysCollection:[9,1,1,""],Files:[9,1,1,""],FilesReader:[9,1,1,""],KeyValidationError:[9,5,1,""],MakeMissingDirsStoreMixin:[9,1,1,""],PickleStore:[9,1,1,""],PickleStores:[9,1,1,""],RelPathFileBytesPersister:[9,4,1,""],RelPathFileBytesReader:[9,4,1,""],RelPathFileStringPersister:[9,4,1,""],RelPathFileStringReader:[9,4,1,""],TextFiles:[9,1,1,""],TextFilesReader:[9,1,1,""],ensure_slash_suffix:[9,2,1,""],iter_dirpaths_in_folder_recursively:[9,2,1,""],iter_filepaths_in_folder_recursively:[9,2,1,""],mk_dirs_if_missing:[9,2,1,""],resolve_dir:[9,2,1,""],resolve_path:[9,2,1,""]},"dol.mixins":{FilteredKeysMixin:[10,1,1,""],IdentityKeysWrapMixin:[10,1,1,""],IdentityKvWrapMixin:[10,1,1,""],IdentityValsWrapMixin:[10,1,1,""],IterBasedSizedContainerMixin:[10,1,1,""],OverWritesNotAllowedMixin:[10,1,1,""],ReadOnlyMixin:[10,1,1,""],SimpleJsonMixin:[10,1,1,""],StringKvWrap:[10,1,1,""]},"dol.naming":{BigDocTest:[11,1,1,""],KeyMapNames:[11,4,1,""],KeyMaps:[11,1,1,""],LinearNaming:[11,4,1,""],ParametricKeyStore:[11,1,1,""],PartialFormatter:[11,1,1,""],StoreWithDictKeys:[11,1,1,""],StoreWithNamedTupleKeys:[11,1,1,""],StoreWithTupleKeys:[11,1,1,""],StrTupleDictWithPrefix:[11,1,1,""],dict_to_namedtuple:[11,2,1,""],get_fields_from_template:[11,2,1,""],mk_kwargs_trans:[11,2,1,""],mk_pattern_from_template_and_format_dict:[11,2,1,""],mk_store_from_path_format_store_cls:[11,2,1,""],mk_tupled_store_from_path_format_store_cls:[11,2,1,""],namedtuple_to_dict:[11,2,1,""],update_fields_of_namedtuple:[11,2,1,""],validate_kwargs:[11,2,1,""]},"dol.naming.KeyMaps":{id_of_key:[11,4,1,""],key_of_id:[11,4,1,""]},"dol.naming.StrTupleDictWithPrefix":{is_valid_prefix:[11,3,1,""]},"dol.paths":{KeyPath:[12,1,1,""],PathKeyTypes:[12,1,1,""],PrefixRelativizationMixin:[12,1,1,""],mk_relative_path_store:[12,2,1,""],path_get:[12,2,1,""],rel_path_wrap:[12,2,1,""],str_template_key_trans:[12,2,1,""]},"dol.signatures":{FuncCallNotMatchingSignature:[13,5,1,""],IncompatibleSignatures:[13,5,1,""],MissingArgValFor:[13,1,1,""],P:[13,4,1,""],Param:[13,1,1,""],Sig:[13,1,1,""],all_pk_signature:[13,2,1,""],assure_params:[13,2,1,""],call_forgivingly:[13,2,1,""],call_somewhat_forgivingly:[13,2,1,""],ch_func_to_all_pk:[13,2,1,""],ch_signature_to_all_pk:[13,2,1,""],ch_variadics_to_non_variadic_kind:[13,2,1,""],common_and_diff_argnames:[13,2,1,""],copy_func:[13,2,1,""],ensure_params:[13,2,1,""],extract_arguments:[13,2,1,""],extract_arguments_asserting_no_remainder:[13,2,1,""],extract_arguments_ignoring_remainder:[13,2,1,""],has_signature:[13,2,1,""],insert_annotations:[13,2,1,""],is_call_compatible_with:[13,2,1,""],is_param_compatible_with:[13,2,1,""],kind_forgiving_func:[13,2,1,""],mk_sig_from_args:[13,2,1,""],name_of_obj:[13,2,1,""],param_for_kind:[13,2,1,""],set_signature_of_func:[13,2,1,""],sig_to_dataclass:[13,2,1,""],sort_params:[13,2,1,""],tuple_the_args:[13,2,1,""],use_interface:[13,2,1,""]},"dol.signatures.Sig":{add_params:[13,3,1,""],annotations:[13,3,1,""],args_and_kwargs_from_kwargs:[13,3,1,""],ch_param_attrs:[13,3,1,""],extract_args_and_kwargs:[13,3,1,""],extract_kwargs:[13,3,1,""],has_var_keyword:[13,3,1,""],has_var_kinds:[13,3,1,""],has_var_positional:[13,3,1,""],index_of_var_keyword:[13,3,1,""],index_of_var_positional:[13,3,1,""],is_call_compatible_with:[13,3,1,""],kwargs_from_args_and_kwargs:[13,3,1,""],merge_with_sig:[13,3,1,""],modified:[13,3,1,""],n_required:[13,3,1,""],names_for_kind:[13,3,1,""],params:[13,3,1,""],required_names:[13,3,1,""],sig_or_default:[13,3,1,""],sig_or_none:[13,3,1,""],source_args_and_kwargs:[13,3,1,""],source_kwargs:[13,3,1,""],to_signature_kwargs:[13,3,1,""],to_simple_signature:[13,3,1,""],with_defaults:[13,3,1,""],without_defaults:[13,3,1,""],wrap:[13,3,1,""]},"dol.sources":{AttrContainer:[14,1,1,""],AttrDict:[14,1,1,""],Attrs:[14,1,1,""],CachedKeysSequenceKvReader:[14,1,1,""],CachedSequenceKvReader:[14,1,1,""],Ddir:[14,4,1,""],FlatReader:[14,1,1,""],FuncDag:[14,1,1,""],FuncReader:[14,1,1,""],NotUnique:[14,5,1,""],ObjReader:[14,1,1,""],SequenceKvReader:[14,1,1,""]},"dol.sources.Attrs":{update_keys_cache:[14,3,1,""]},"dol.sources.CachedKeysSequenceKvReader":{update_keys_cache:[14,3,1,""]},"dol.tests":{base_test:[15,0,0,"-"],pickability_test:[16,0,0,"-"],scrap:[17,0,0,"-"]},"dol.tests.base_test":{WrappedDict:[15,1,1,""]},"dol.tests.base_test.WrappedDict":{ItemsView:[15,1,1,""],KeysView:[15,1,1,""]},"dol.tests.pickability_test":{test_pickling_w_dict:[16,2,1,""]},"dol.tools":{Forest:[18,1,1,""],ask_user_for_value_when_missing:[18,2,1,""],confirm_overwrite:[18,2,1,""],convert_to_numerical_if_possible:[18,2,1,""],iSliceStore:[18,1,1,""]},"dol.trans":{CachedInvertibleTrans:[19,1,1,""],FirstArgIsMapping:[19,1,1,""],MapInvertabilityError:[19,5,1,""],OverWritesNotAllowedMixin:[19,1,1,""],add_ipython_key_completions:[19,2,1,""],add_path_access:[19,2,1,""],add_path_get:[19,2,1,""],add_store_method:[19,2,1,""],add_wrapper_method:[19,2,1,""],cache_iter:[19,2,1,""],cached_keys:[19,2,1,""],catch_and_cache_error_keys:[19,2,1,""],constant_output:[19,2,1,""],double_up_as_factory:[19,2,1,""],ensure_clear_method:[19,2,1,""],filt_iter:[19,2,1,""],flatten:[19,2,1,""],insert_aliases:[19,2,1,""],insert_load_dump_aliases:[19,2,1,""],kv_wrap:[19,2,1,""],kv_wrap_persister_cls:[19,2,1,""],mk_kv_reader_from_kv_collection:[19,2,1,""],mk_level_walk_filt:[19,2,1,""],mk_trans_obj:[19,2,1,""],mk_wrapper:[19,2,1,""],store_decorator:[19,2,1,""],wrap_kvs:[19,2,1,""]},"dol.util":{Literal:[20,1,1,""],Pipe:[20,1,1,""],add_attrs:[20,2,1,""],copy_attrs:[20,2,1,""],fill_with_dflts:[20,2,1,""],flatten_pipe:[20,2,1,""],format_invocation:[20,2,1,""],groupby:[20,2,1,""],has_enabled_clear_method:[20,2,1,""],igroupby:[20,2,1,""],imdict:[20,1,1,""],inject_method:[20,2,1,""],instance_checker:[20,2,1,""],lazyprop:[20,1,1,""],lazyprop_w_sentinel:[20,1,1,""],max_common_prefix:[20,2,1,""],norm_kv_filt:[20,2,1,""],not_a_mac_junk_path:[20,2,1,""],num_of_args:[20,2,1,""],num_of_required_args:[20,2,1,""],partialclass:[20,2,1,""],regroupby:[20,2,1,""],str_to_var_str:[20,2,1,""]},"dol.util.Literal":{get_val:[20,3,1,""]},"dol.zipfiledol":{EmptyZipError:[21,5,1,""],FileStreamsOfZip:[21,1,1,""],FilesOfZip:[21,1,1,""],FlatZipFilesReader:[21,1,1,""],OverwriteNotAllowed:[21,5,1,""],ZipFileStreamsReader:[21,1,1,""],ZipFilesReader:[21,1,1,""],ZipFilesReaderAndBytesWriter:[21,1,1,""],ZipInfoReader:[21,1,1,""],ZipReader:[21,1,1,""],ZipStore:[21,1,1,""],file_or_folder_to_zip_file:[21,2,1,""],if_i_zipped_stats:[21,2,1,""],mk_flatzips_store:[21,2,1,""],remove_mac_junk_from_zip:[21,2,1,""],remove_some_entries_from_zip:[21,2,1,""],to_zip_file:[21,2,1,""],to_zipped_bytes:[21,2,1,""],zipped_bytes_to_bytes:[21,2,1,""]},dol:{appendable:[2,0,0,"-"],base:[3,0,0,"-"],caching:[4,0,0,"-"],core:[5,0,0,"-"],dig:[6,0,0,"-"],errors:[7,0,0,"-"],explicit:[8,0,0,"-"],filesys:[9,0,0,"-"],ihead:[1,2,1,""],kvhead:[1,2,1,""],mixins:[10,0,0,"-"],naming:[11,0,0,"-"],paths:[12,0,0,"-"],signatures:[13,0,0,"-"],sources:[14,0,0,"-"],tools:[18,0,0,"-"],trans:[19,0,0,"-"],util:[20,0,0,"-"],zipfiledol:[21,0,0,"-"]}},objnames:{"0":["py","module","Python module"],"1":["py","class","Python class"],"2":["py","function","Python function"],"3":["py","method","Python method"],"4":["py","attribute","Python attribute"],"5":["py","exception","Python exception"]},objtypes:{"0":"py:module","1":"py:class","2":"py:function","3":"py:method","4":"py:attribute","5":"py:exception"},terms:{"0000":11,"00012612342834472656":21,"00015592575073242188":21,"0005228519439697266":21,"0011119842529296875":21,"0013129711151123047":21,"0058901309967041016":21,"02f":11,"0_0":11,"0x1538999e0":21,"100":19,"1000":[6,11,20,21],"101":19,"102":[0,19],"1024":13,"103":19,"11283961":11,"120":19,"1225779243969_1225779246969":11,"123":[11,18],"1234":11,"137":21,"14159":14,"1485261448469":11,"1485272231982":11,"1485272231982_":11,"1485272231982_1485261448469":11,"155":8,"1574287049078391":21,"1574288084739961":21,"1574304926795633":21,"1574305026895702":21,"1574305159343326":21,"1574305276853053":21,"1574333557263758":21,"180":19,"1st":19,"2000":[6,11,21],"2008":11,"2017":11,"2019_11_21":21,"2021_09_11":21,"2021_09_12":21,"2021_09_13":21,"2022":0,"206":21,"21379":13,"221":21,"239578":20,"3000":11,"434":20,"444":4,"456":11,"53280":21,"53432":21,"99_ballon":20,"\u00eatre":20,"boolean":[10,13,19,20,21],"byte":[2,3,19,21],"case":[2,3,4,6,7,10,12,13,14,18,19,20,21],"catch":[7,13],"class":[2,3,4,5,7,8,9,10,11,12,13,14,15,18,19,20,21],"default":[2,3,4,10,11,12,13,14,19,20,21],"final":19,"float":[13,18,20],"function":[2,3,4,7,8,10,11,12,13,14,18,19,20,21],"import":[2,3,4,6,7,8,11,12,13,14,18,19,20,21],"int":[3,6,11,13,14,20],"long":[4,5,11,12,13,19,20],"new":[2,3,11,12,13,18,19,20,21],"return":[2,3,4,6,7,8,11,12,13,14,18,19,20,21],"short":[11,13],"static":[2,4,12,19,21],"super":[3,4,12,19],"switch":19,"true":[2,3,4,8,11,13,14,18,19,20,21],"try":[3,11,12,13,18,19,20],"var":13,"voil\u00e0":13,"while":19,AND:4,And:[4,6,13,18,19,21],But:[3,4,5,7,11,12,13,14,18,19,20,21],DBs:4,For:[2,3,4,6,13,14,18,19,21],NOT:[3,4,13],Not:[2,7,13],ONE:19,One:[3,13,20,21],Such:13,THe:3,That:[3,4,9,13,14,19,20],The:[2,3,4,5,6,7,8,10,11,12,13,14,18,19,20,21],Then:[13,20,21],There:[3,4,14],These:[3,13,20],Use:[2,4,7,13,14],Used:11,Useful:10,Uses:14,Using:[2,19],WILL:[10,19],Was:19,Will:[9,19],With:[12,19],Yes:7,_99_ballon:20,__add__:[5,12],__annotations__:[2,4,9,11,12,13,18,19],__cache_act:20,__class__:[19,20],__contains__:[3,10],__defaults__:[2,4,9,11,12,13,18,19],__delitem__:[3,19],__dict__:20,__doc__:[2,4,9,11,12,13,18,19],__file__:8,__getattr__:3,__getitem__:[3,4,6,7,19],__init__:[2,3,12,19,20],__iter__:[3,7,10,19],__kwdefault__:13,__kwdefaults__:[2,4,9,11,12,13,18,19],__len__:[3,5,7,10,12,19],__macosx:[20,21],__module__:[2,4,9,11,12,13,18,19],__name__:[2,4,9,11,12,13,14,18,19,20],__nin__:3,__qualname__:[2,4,9,11,12,13,18,19],__repr__:[19,20],__reversed__:3,__setitem__:[3,4,10,19],__signature__:13,__str__:19,__validate_parameters__:13,_adapt_:13,_added_attr:20,_allow_parti:13,_allow_reord:13,_apply_default:13,_args_limit:13,_black_list:19,_cach:4,_call_forgivingli:13,_current_level:9,_data_of_obj:[3,19],_delete_keys_one_by_on:19,_dflt_object_nam:14,_empti:19,_error_kei:19,_explicit_kei:19,_func:19,_id:[3,12,14,19],_id_of_kei:[3,6,12,19],_ignore_kind:13,_isinst:13,_key_filt:10,_key_of_id:[3,12,19],_keys_cach:[14,19],_obj_of_data:[3,6,19],_obj_of_kei:8,_object_nam:14,_parameterkind:13,_path_typ:12,_post_filt:3,_pre_it:3,_prefix:[5,8,12],_root_length:19,_sourc:14,_w_cach:4,_w_sommeth:19,a00:13,a11:13,a12:13,a23:13,a34:13,a35:13,a36:13,a47:13,a_fil:11,a_forest:18,a_func:20,abc:[2,3,7,8,10,12,19],abil:[19,21],abl:[3,13,19],about:[11,13,19,21],abov:[3,13,18,19,21],abs:2,absolut:[5,12],acccumul:19,accept:13,access:[3,4,9,12,13,14,19,21],accord:[11,13,19,20],accordingli:21,account:13,accumul:[11,20],accur:2,acrobat:[18,21],act:[3,4,18,21],action:21,actual:[3,4,12,13,18,19,20],add:[2,3,4,6,9,11,12,13,18,19,20],add_append_functionality_to_store_cl:2,add_attr:20,add_get_path:19,add_ipython_key_complet:19,add_numb:20,add_param:13,add_path_access:19,add_path_access_if_map:19,add_path_get:19,add_store_method:19,add_wrapper_method:19,added:[2,12,19,20],adding:[3,11,19],addit:[2,3,19],addition:14,advanc:[13,19],advantag:[4,18],advis:[13,14,21],affect:20,aforement:19,after:[2,3,4,13,19],again:[3,4,13,19,20],against:[11,13],alia:[3,9,11,13,14,19],alias:[13,19],alic:[8,18],align:[2,13],all:[3,4,7,11,13,14,18,19,20,21],all_but_:14,all_kwargs_should_be_in_validation_dict:11,all_pk_signatur:13,allig:18,allow:[3,5,7,10,11,13,18,19,20],allow_excess:13,allow_overwrit:21,allow_parti:13,allowzip64:21,alon:13,along:[14,19,21],alreadi:[3,4,7,9,10,13,18,19,20],alreadyexist:7,alright:20,also:[2,3,4,12,13,14,18,19,20],alwai:[13,14,19],always_tru:19,amongst:13,analyt:19,and_mor:19,ani:[3,4,5,7,12,13,14,18,19,20,21],annoi:[3,7,13],annot:13,annotation_compar:13,annoy:13,annoyingli:20,anoth:[2,3,4,13,19,20,21],another_foo:13,another_group:11,another_us:11,anyth:[4,13,19],anywai:[3,13,18],api:13,app:21,appear:[11,13,19],appeas:7,append:[0,20,22],append_to_group_item:20,appendable_store_cl:2,appl:[18,20],appli:[3,4,7,13,14,19,20,21],applic:[3,19],apply_default:13,appropri:21,arg:[3,4,9,11,12,13,14,18,19,20],arg_extractor:13,arg_nam:13,arg_new_v:13,argnam:13,args1:13,args_and_kwargs_from_kwarg:13,args_limit:13,args_with_default:13,args_without_default:13,arguabl:18,argument:[3,4,11,13,14,19,20,21],argument_argu:13,argval:13,around:[4,18],ascii:3,asdf:13,asi:3,ask:[3,4,12,13,18,19,21],ask_before_before_delet:21,ask_user_for_value_when_miss:18,aspect:[3,19],assert:[2,3,4,9,11,12,13,14,18,19,20,21],assert_empti:13,assert_exist:9,assert_no_missing_position_only_arg:13,assert_rootdir_exist:9,assertionerror:[8,11,13,19],assign:[3,13,14,19],associ:19,assum:[3,12,13,19,21],assur:3,assure_param:13,attemp:19,attempt:19,attent:20,attr:[3,14,20],attr_dict:14,attr_val:14,attrcontain:14,attrdict:14,attribut:[3,4,6,7,10,12,13,14,19,20],attributeerror:20,audio:21,aug:0,author:13,auto:[4,14],automat:[4,9,12,13,19],avail:[4,12,18],averag:2,avoid:[3,11,13],awar:12,back:[3,4,8,12,13],backend:[3,13],bad:13,ball:18,banana:18,bar2:[10,19],bar:[3,4,8,10,11,12,13,14,18,19,20,21],bare:[13,14],base:[0,4,6,8,10,12,13,14,15,19,20,22],base_test:[0,22],basekeysview:15,basic:[14,20],basinig:13,baz:13,bbb:[14,19],bbbbb:14,bear:[18,19],beazlei:20,becaus:[3,4,7,11,13,14,18,19,20],becom:[14,19,20],been:[4,11,20,21],befor:[3,4,9,10,11,12,13,14,18,19],beg:13,begin:[2,3,11,20],behav:[3,19],behavior:[3,13,18,19,20],behind:[12,13,19],behvior:13,being:[7,13,18,19,20],believ:12,below:[4,13,18,19,20],bend:1,besid:[10,11,13,19],better:4,between:3,beyond:4,big:[19,20],bigdoctest:11,bind:13,bind_parti:13,bit:20,bituat:20,black:19,blacklist:19,blah:20,block:4,bob:18,boggl:13,bolton:20,book:20,bool:[3,9,13,18,19,20,21],border:18,both:[3,4,8,11,13,14,19,20,21],bound:4,box:[14,20,21],brave:18,bring:20,bucket:11,bug:6,build:[1,7,18],built:[20,21],builtin:[4,13],bulk:[13,19],bunch:[2,4,7,21],busi:7,bzip2:21,cach:[0,13,14,19,20,21,22],cache_is_act:20,cache_it:19,cache_kei:19,cache_my_kei:19,cache_update_method:19,cache_v:4,cached_dict:19,cached_kei:19,cachedinvertibletran:19,cachedkeyssequencekvread:14,cachedsequencekvread:14,cachedslowdict:4,cacheutil:20,calculu:13,call:[2,3,4,6,7,8,10,12,13,14,18,19,20],call_forgivingli:13,call_somewhat_forgivingli:13,callabl:[3,4,8,12,13,14,18,19,20,21],callable_or_signatur:13,callback:[7,20],caller:13,can:[2,3,4,5,7,10,12,13,14,18,19,20,21],cannon:[12,14],cannot:[10,13,19],captur:11,care:[13,19,20],carri:[3,4,13,19],cast:11,catch_and_cache_error_kei:19,catch_except:7,categori:21,caught:7,caught_error:12,ccc:19,ccould:19,ch_func_to_all_pk:13,ch_param_attr:13,ch_signature_to_all_pk:13,ch_to_all_pk:13,ch_variadic_keyword_to_keyword:13,ch_variadics_to_non_variadic_kind:13,chainmap:4,chanc:18,chang:[0,11,13,19,20,21],changes_for_nam:13,charact:[8,12],chat:19,check:[3,4,6,10,11,13,14,19,20],check_funct:11,check_val:11,child:18,children:18,choic:[13,19,21],choke:13,choos:[3,12,13,19],chose:[13,19],chr:3,chunk:2,clariti:20,clash:13,class_or_tupl:13,class_tran:3,classmethod:[3,13],clean:19,clear:[3,4,19,20],clear_method:19,clearli:4,clock:2,closer:19,cls:[11,19,20],cls_name:13,coconut:18,code:[3,13,19,20],collect:[2,3,4,7,8,10,11,12,18,19,20],collectiontyp:8,color:18,column:13,com:[3,11,13,20],combin:[13,19],come:[3,4,7,18,19],command:4,common:[13,19,20],common_and_diff_argnam:13,comp_tim:21,compar:[13,21],comparison:19,compat:13,compil:[11,21],complain:[11,20],complaint:13,complet:[13,14,19,20],complex:[1,13,20],compos:[13,20],composit:20,comprehens:20,compress:[20,21],compression_method:21,compresslevel:21,comput:[3,4,14,19,20],concern:[3,19],concret:[3,9,10],condit:[4,7,19],conditional_data_tran:19,conduct:19,configur:[3,4,13],confirm:18,confirm_overwrit:18,conflict:21,consequenti:2,conserv:13,consid:[3,13,19,20],consist:[4,13,18,19],constant:19,constant_output:19,constitut:[3,13],constraint:13,construct:[12,13,18,19],constructor:18,consum:[3,18,19,20],contain:[3,4,10,11,12,13,14,19,21],content:[0,3,4,8,13,19,20,21,22],contents_of_kei:8,context:[4,10],contrast:20,control:[3,11,13,21],conveni:[4,13,14,19,21],convent:[19,21],convers:[3,11],convert:[3,11,12,18,19,21],convert_to_numerical_if_poss:18,cookbook:20,copi:[2,13,19,20],copy_attr:20,copy_func:13,core:[0,1,22],correctli:13,correspond:[13,21],could:[3,4,11,13,19,20],count:[2,3,14,19,20],cours:4,cpython:13,creat:[2,4,7,9,13,18,19,21],creativ:19,cross:13,crucial:13,crud:19,csv:19,ctor:21,culprit:19,current:2,current_utc_:2,curri:[13,18,21],custom:[3,19,21],dai:11,danger:3,darwin:11,data:[1,2,3,4,6,8,11,12,13,14,18,19,21],data_of_obj:[6,19],data_structur:18,data_tran:19,databas:3,dataclass:13,dataset:14,david:20,dddd:19,ddir:14,deal:[6,13,19],debug:13,decid:[4,19],deco:19,decod:21,decompress:21,decor:[2,4,9,13,19,20],decorated_a:19,decorator_2:19,decorator_3:19,decorator_func:19,def:[2,3,4,7,8,12,13,14,19,20],default_conflict_method:13,default_signatur:13,default_value_compar:13,defaultdict:20,defin:[2,3,6,8,10,11,12,13,19,20],define_extend_as_seq_of_append:2,definit:[4,10,19],definitioin:19,deflat:21,del:[3,10,12,14,19,20],deleg:[3,12,19],delegation_attr:3,delegator_wrap:3,delet:[3,4,7,10,14,19,20,21],deletionsnotallow:7,demo:[3,18,19],demonstr:19,depend:[3,4,7,10,11,13,19,21],descript:13,descriptor:20,deseri:[3,19],design:12,desir:[2,3,13,19],destin:19,detail:[3,13,19,21],detect:13,determin:[3,4,13,20],deux:14,dflt_dict:20,dflt_if_miss:2,dflt_keyword_onli:13,dict:[2,3,4,6,8,10,11,12,13,14,16,18,19,20],dict_item:12,dict_of:20,dict_to_namedtupl:11,dictionari:[3,18,21],dictionnari:18,did:[4,19,21],didn:[4,7,14,18,19],die:2,differ:[3,4,10,13,14,18,19,20,21],difficult:3,dig:[0,22],ding:4,dir:[20,21],dir_of_zip:21,dircollect:9,directli:[3,13,19],directori:[9,21],dirpath:9,dirs_onli:21,dirti:13,disabl:[3,7,20],disallow:10,disappear:19,discuss:11,disguis:21,dispar:14,displai:[6,18],distinguish:21,doc:[2,4,13,14,19,20,21],doctest:19,document:[13,20],doe:[7,10,13,19,20],does_not_fit_g_signature_anymor:13,doesn:[3,4,7,10,11,13,14,19,20,21],dogma:12,doing:[3,4,11,13,19],dol:22,domain:11,don:[3,4,12,13,14,18,19,20],done:[3,7,13],dong:4,doubl:19,double_up_as_factori:19,doubt:13,download:21,dragon_con:[3,19],drop:19,ds_store:[20,21],due:14,dump:[19,21],dump_fold:21,dunder:[3,14],dure:19,dynam:12,e_nam:11,e_sref:11,e_um:11,each:[4,8,14],easi:[13,18],easier:13,easili:[11,13],ecosystem:18,edg:13,effect:[2,3,13,20],effici:[10,21],egress:19,eight:13,element:[2,3,4,10,12,13,14,18,19,21],elif:19,els:[2,3,4,7,11,13,19,20],empti:[4,13,18,19,20,21],empty_cach:4,empty_cache_entri:4,emptyziperror:21,enabl:[19,20],encod:21,encount:[3,13,21],end:[9,19,20,21],endswith:19,enforc:[13,19],enforce_sig:13,enhanc:[19,20],enough:[4,7,19,20],ensur:4,ensure_clear_method:19,ensure_clear_to_kv_stor:4,ensure_exist:9,ensure_param:13,ensure_signatur:13,ensure_slash_suffix:9,enter:18,entir:19,entri:[3,4,20,21],enumer:[3,12,14],environ:4,equival:[4,13,19],err:19,error:[0,10,11,12,13,19,22],error_callback:19,errors_caught:19,especi:[7,13],essenti:13,etc:[2,4,8,9,11,13,14,19,20,21],even:[2,7,13,14,18,19,20],event:2,ever:[2,3,5,10,12,13,19],everi:[4,7,12,19,20],everyth:[8,12,13],exactli:10,exampl:[2,3,4,6,7,11,13,14,18,19,20,21],except:[3,7,9,11,13,14,19,21],excess:13,exclud:14,exclusive_subdict:14,exhibit:3,exist:[4,7,9,10,12,13,18,19,20,21],existing_v:18,exit:4,expect:[3,7,8,12,13,14,19,20],explan:13,explicit:[0,4,10,19,20,22],explicitkei:8,explicitkeymapread:8,explicitkeyssourc:8,explicitkeysstor:8,explicitkeyswithprefixrelativ:8,explicitli:[8,13,19],explor:3,expos:3,express:[11,13,19],extend:[2,19],extens:19,extern:[19,20],extra:[13,14,19],extra_mk_store_kwarg:21,extract:[11,13,14,18,21],extract_args_and_kwarg:13,extract_argu:13,extract_arguments_asserting_no_remaind:13,extract_arguments_ignoring_remaind:13,extract_kwarg:13,extrem:13,f_1:20,f_n:20,fact:[5,7,12,13,19],factor:19,factori:19,fail:[3,13,19],fair:19,fake_signatur:13,fall:13,fals:[2,4,7,8,9,11,12,13,19,20,21],familiar:19,far:[13,19],fast:13,faster:[13,19],fav:11,favorit:[12,20,21],featur:13,fed:20,feed:[2,11],feel:13,fetch:[14,19],few:[2,3,7,13],fff:18,field:[2,11,13,14,20],field_conversion_func:11,field_nam:11,field_value_format_regex:11,figur:13,file:[3,4,5,6,8,9,11,12,19,20,21],file_info_filt:21,file_or_folder_to_zip_fil:21,file_where_this_code_i:8,filebytespersist:9,filebytesread:9,filecollect:9,fileinfo:21,fileinforead:9,filenam:[11,21],filepath:[9,21],files_onli:21,filesi:[0,22],filesofzip:21,filesread:9,filestreamsofzip:21,filestringpersist:9,filestringread:9,filesyscollect:9,filesystem:[3,20],fill:20,fill_with_dflt:20,filt:[19,21],filt_it:[19,20,21],filter:[3,10,13,19,20,21],filtered_dict:19,filteredkeysmixin:10,find:[4,8,13,21],fine:[13,16,18,19,20],finit:2,first:[1,2,3,4,10,12,13,14,19,20,21],first_level_kei:14,firstappendonli:2,firstargismap:19,fit:7,fix:[13,20],fixtur:20,flag:[2,19],flat:[14,20],flatread:14,flatten:19,flatten_pip:20,flattened_stor:19,flatzipfilesread:21,flexibl:13,flush:4,flush_cach:4,flush_cache_condit:4,folder:[3,4,5,9,12,20,21],follow:[3,13,14,19,20],foo:[3,4,8,10,11,12,13,14,18,19,20,21],foo_sig:13,forest:18,forest_typ:18,forev:[14,19],form:[2,3,7,14,18,19,20],format:[2,11,18,19,20,21],format_dict:[11,12],format_invoc:20,format_str:11,formatt:11,fortun:19,forward:3,found:[4,13,18],four:[3,19,21],fox:20,free:7,french:18,frenzi:19,frequent:13,fridai:19,friend:[14,19],friendli:13,from:[2,3,4,6,7,8,10,11,12,13,14,18,19,20,21],from_cal:13,from_csv:19,from_item_to_key_params_and_v:2,from_obj:13,from_s_um:11,fromkei:12,frontend:13,frozen:20,fruit:18,fuji:18,fulfil:13,full:[9,11,19],fulli:13,func1:13,func1_not_func2:13,func2:13,func2_not_func1:13,func:[3,13,14,19,20],funccallnotmatchingsignatur:13,funcdag:14,funcread:14,functiion:19,function_to_process_this_valu:11,functool:[3,11,13,14,18,19,20,21],further:[3,13,18,19,21],futur:13,fv_version:11,gave:19,gen:3,gener:[2,3,4,6,7,9,11,19,20],get:[1,2,3,4,6,7,8,10,11,12,13,14,18,19,20,21],get_cach:4,get_fields_from_templ:11,get_node_kei:18,get_src_item:18,get_val:20,getattr:[3,14,19,20],getitem:19,gettempdir:21,github:[3,7,13],give:[2,3,4,7,11,12,13,14,18,19,20,21],given:[3,7,8,9,10,11,12,13,18,19,20],go_let:2,goal:13,goe:19,going:[4,7,21],gone:4,good:[7,13,19],got:[13,14,19,20],gotcha:13,grab:14,grammar:19,granni:18,green:18,group:[11,13,14,20],group_collector:20,group_factori:20,group_item:20,group_kei:20,group_release_cond:20,groupbi:20,groupdict:11,grouper_map:20,grp:20,guid:14,had:[6,14,19],hand:[13,14,19,20],handl:[10,13,20],happen:[4,7,13,19],hard:[13,20],harder:3,has:[2,3,4,5,6,7,10,12,13,14,18,19,20,21],has_enabled_clear_method:20,has_kv_store_interfac:3,has_signatur:13,has_var_keyword:13,has_var_kind:13,has_var_posit:13,hasattr:[3,19],hash:4,hashabl:[4,19,20],hashabledict:4,hasn:4,have:[2,3,4,7,11,12,13,14,18,19,20,21],head:[3,8],header:3,heart:13,hei:20,hello:[4,11,13,18,20],help:13,helper:19,here:[2,3,4,6,10,11,13,14,18,19,20],hesit:20,hidden:[4,12,14],highli:19,hit:[4,18,19],hold:[4,14,19,20],home:[11,12],hood:[12,19,20],how:[2,3,6,10,13,19,20,21],html:21,http:[3,11,13,20,21],hurdl:7,i2mint:[3,13],i_think:3,id_of_kei:[6,8,11,19],idea:20,ident:3,identifi:[10,12],identitykeyswrapmixin:10,identitykvwrapmixin:10,identityvalswrapmixin:10,if_attr_exist:20,if_i_zipped_stat:21,iff:[11,13,19,20],ignor:[13,20],ignore_excess:13,ignore_incompatible_signatur:13,ignore_kind:13,ignore_misunderstood_validation_instruct:11,ignore_test:21,igroupbi:20,ihead:1,iif:8,illustr:19,imdict:20,impact:18,implement:[3,7,8,10,13,19,20],impli:11,implicit:4,importantli:3,impos:13,imposs:14,includ:[2,3,13,18,19,20],include_all_when_var_keywords_in_param:13,include_hidden:9,incom:[12,19],incompatiblesignatur:13,inconsist:11,inde:[2,3,12,13,19,21],index:[0,2,7,11,13],index_of_var_keyword:13,index_of_var_posit:13,indic:[3,7,13,14,19,20],individu:2,inf:18,infin:18,info_dict:11,inform:[13,18],ingo:[12,19],ingoing_kei:19,ingoing_key_method:19,ingoing_v:19,ingoing_value_method:19,ingress:19,inherit:10,initi:[8,19],inject:[2,14,19,20],inject_method:20,injecton:13,inner:[12,19],inplac:4,input:[3,4,8,13,18,19,20,21],insert:[13,19,20],insert_alias:19,insert_annot:13,insert_load_dump_alias:19,insid:19,insofar:13,inspect:[6,13,19,20],inspir:13,instal:14,instanc:[2,3,4,6,8,11,12,13,14,18,19,20,21],instancc:19,instance_check:[19,20],instead:[3,4,5,12,13,14,15,19,20,21],insteadk:13,integ:[13,14,18,19],integr:12,intend:[13,19],intens:21,intent:[5,13,19],inter:13,intercept:12,interest:[3,13,14,21],interfac:[1,3,5,6,11,12,13,14,18,19],interface_sig:13,intern:[3,12,19],introduc:[3,4],introspect:6,intrud:13,inv_map:8,invers:[8,13],invert:[8,19],invertible_map:8,involv:[3,5,12,13,19],ipython:19,irrelev:3,is_a_mac_junk_path:21,is_call_compatible_with:13,is_leaf:18,is_param_compatible_with:13,is_valid:11,is_valid_kei:12,is_valid_prefix:11,isfil:21,isinst:[13,14,18,19,20],isinstance_of_str:13,islic:3,islicestor:18,isn:[18,19],isnumer:3,issu:13,issubclass:3,isupp:19,item2kei:2,item2kv:2,item:[1,2,3,4,6,7,11,12,13,14,18,19,20],item_to_:20,item_to_kei:2,item_to_key_params_and_v:2,item_to_kv:2,itemgett:14,items_in_that_group:20,items_with_caught_except:7,itemsview:[3,15],iter:[1,3,7,8,10,12,13,14,18,19,20,21],iter_dirpaths_in_folder_recurs:9,iter_filepaths_in_folder_recurs:9,iter_to_contain:19,iterationnotallow:7,iterbasedsizedcontainermixin:10,itertool:[3,20],its:[3,13,14,19],itself:[2,8,11,13,14,19,20,21],job:[7,19,21],join:[3,11,19,21],json:[10,19,21],junk:[20,21],just:[2,3,4,7,8,11,12,13,14,15,16,19,20,21],kaggl:7,keep:19,keep_field_in_valu:2,kei:[2,3,4,5,6,7,8,10,11,12,13,14,15,18,19,20,21],key_as_tupl:2,key_collect:8,key_condit:9,key_func:[4,20],key_map:20,key_of_id:[6,8,11,19],key_param:2,key_str_format:2,key_templ:2,key_typ:[11,12],keyerror:[3,7,12,19],keymap:11,keymap_kwarg:11,keymapnam:11,keypath:[12,19],keys_cach:19,keys_to_be_remov:21,keysview:[3,15],keyswrapabc:10,keyvalidationabc:3,keyvalidationerror:[7,9],keyword:[3,13,19,20],keyword_onli:13,kick:13,kilo:6,kind:[3,11,13,18,19],kind_forgiving_func:13,king:20,know:[2,3,4,13,19,20,21],known:19,koa:13,kv_collect:19,kv_filt:20,kv_walk:[3,19],kv_wrap:19,kv_wrap_persister_cl:19,kvhead:1,kvpersist:3,kvreader:[3,14,19,21],kvstore:3,kw_func:20,kwarg:[9,11,12,13,14,19,20],kwargs1:13,kwargs_from_args_and_kwarg:13,kwargs_new_v:13,kwargs_to_valid:11,kws:[13,20],lag:2,lambda:[2,3,4,6,12,13,14,18,19,20,21],languag:3,larg:7,last:[0,2,3,6,8,10,12,13,14,19,20,21],later:[13,19],latter:4,layer:[3,4,6,21],layer_attr:6,lazyprop:20,lazyprop_w_sentinel:20,lead:13,leaf:[3,18],leaf_tran:18,least:[4,11,12,13,20],leav:[2,13,18],left:[3,4,20],len:[2,3,4,6,8,12,13,14,19,20,21],length:[19,20],lenienc:13,less:[4,13,19],let:[2,3,4,6,7,11,12,13,19,20,21],letter:19,level:[3,9,19],leveled_map_walk:3,librari:21,life:[14,19],lifo:3,like:[2,3,4,6,12,13,14,15,18,19,20,21],line:[3,6,20],line_pre_proc_func:3,linearnam:11,linux:11,list:[1,2,3,4,7,8,11,12,13,14,15,18,19,20,21],liter:[19,20],littl:[4,19],live:[2,19],load:19,local:[4,5,9,11,12,19,21],localfilestor:3,localjsonstor:11,locat:[19,21],logic:[19,20],lol:19,longest:20,look:[4,8,12,13,18,19,20,21],loop:[2,7],loos:11,lose:11,lost:13,lot:[7,13,19],love:[14,19,21],lower:[3,6,19],lzma:21,mac:[20,21],macosx:20,made:[3,11,19,20],magic:[14,19],mai:[11,13,19,20],main:[2,11,13,20],maintain:13,make:[2,3,4,8,9,11,12,13,14,18,19,20,21],make_dataclass:13,makemissingdirsstoremixin:9,malformat:19,manag:[4,13],mani:[7,13,14,18,19],manipul:12,manner:9,manual:[4,19],map:[2,3,4,7,8,10,11,12,13,14,15,18,19,20],mapinvertabilityerror:19,mapper:12,mappingview:3,mark:[11,19],match:[11,13,14],math:13,matrix:13,matter:19,max:19,max_common_prefix:20,max_level:[9,21],maximum:13,mayb:19,mean:[3,13,19],meant:[3,13,19,20],meet:[13,19],memor:4,memori:[4,19],merg:[13,21],merge_with_sig:13,mess:13,met:20,meta:13,method:[2,3,4,6,7,10,11,12,13,14,19,20,21],method_func:19,method_funct:20,method_nam:[19,20],methodfuncnotvalid:7,methodnamealreadyexist:7,might:[3,11,13,14,18,19,20,21],million:19,mind:[13,18],minim:14,minimum:13,minut:19,misalign:13,miss:[4,13,18,20,21],missig:2,missing_kei:21,missingargvalfor:13,mistyp:11,mixin:[0,3,12,19,22],mk_cached_stor:4,mk_dirs_if_miss:9,mk_e_nam:11,mk_flatzips_stor:21,mk_item2kv:2,mk_item2kv_for:2,mk_kv_reader_from_kv_collect:19,mk_kwargs_tran:11,mk_level_walk_filt:[3,19],mk_param:13,mk_pattern_from_template_and_format_dict:11,mk_prefix:11,mk_relative_path_stor:12,mk_sig_from_arg:13,mk_sourced_stor:4,mk_store:21,mk_store_from_path_format_store_cl:11,mk_trans_obj:19,mk_tupled_store_from_path_format_store_cl:11,mk_u_nam:11,mk_wrapper:19,mk_write_cached_stor:4,mod3:20,mod:20,mode:[13,19],modern:3,modif:3,modifi:[13,19,21],modul:[0,3,6,11,12,13,14],more:[2,3,4,10,11,13,14,18,19,20,21],more_of:19,morphem:19,most:[6,8,10,12,13,14,18,19,20,21],move:14,mro:[3,9,10,19],msg:19,much:[12,13],muddl:20,multilin:20,multipl:[13,14,19,20,21],multipli:19,multiply_by_2:20,multiply_by_3:19,must:[3,4,8,11,12,13,18,19],mutabl:20,mutablemap:3,mutat:[2,19],my_data:4,my_filt:20,my_filt_func:21,my_flatten:19,my_g:13,my_log:7,my_other_log:7,mycachedstor:4,mydict:19,myfilteredstream:3,myflatdict:19,myrelstor:12,mystor:[2,3,4,12,19],mystream:3,mysum:20,mytupl:11,n_requir:13,name:[0,2,6,7,10,12,13,14,19,20,21,22],name_of_obj:13,name_of_output_typ:11,name_separ:11,named_func:20,named_key_func:20,named_object:14,named_tuple_type_nam:12,namedtupl:[11,12],namedtuple_obj:11,namedtuple_to_dict:11,namedtuplefromdict:11,nameerror:6,names_for_kind:13,names_of_kind:13,namm:19,nation:18,nativ:13,natur:[18,21],nauseam:20,naysay:7,ncach:4,need:[1,3,4,8,9,10,11,13,18,19,20,21],neg:2,neither:[13,19],nest:[3,18,19,20],network:19,neutral:10,new_f:13,new_filt_func:20,new_foo:13,new_func:13,new_group:11,new_sig:13,new_store_nam:2,new_us:11,newgui:11,next:[3,4,6,14,18,19],nice:13,nice_kind:13,no_sig_arg:13,no_sig_kwarg:13,no_such_kei:3,node:[3,18,19],non:[13,14],none:[2,3,4,7,8,9,11,12,13,14,18,19,20,21],nope:19,nor:13,norm_kv_filt:20,normal:[4,12,13,19,20],normalize_kind:13,nosuchkeyerror:7,not_a_kei:14,not_a_mac_junk_path:20,not_in_sig:13,not_valid_______434:20,notallow:7,note:[2,3,4,10,11,12,13,14,18,19,20,21],noth:[13,19,20],notic:[19,20,21],notspecifi:2,notuniqu:14,notvalid:7,now:[3,4,6,7,8,11,12,13,18,19,20,21],num:[6,11],num_of_arg:20,num_of_item:19,num_of_required_arg:20,number:[3,10,11,13,14,18,19,20],numer:6,oNe:19,obei:13,obj:[2,3,7,10,13,14,19,20],obj_of_data:[6,18,19],object:[2,3,5,7,8,10,11,12,13,14,15,18,19,20,21],object_to_forest:18,objread:[8,14],observ:13,obtain:[13,19],obviou:[18,19],obvious:19,odd:[19,20],odir:21,off:[3,19],offer:[3,10],offset:2,offset_:2,often:[10,13,19,20,21],okai:21,old:20,omit:11,on_error:12,on_missing_msg:18,onc:[13,19,20,21],one:[2,3,4,5,8,11,13,14,18,19,20,21],ones:[11,12,13,19,20,21],onli:[2,3,4,5,10,11,12,13,14,18,19,20,21],oopsi:11,open:8,open_kw:21,oper:[7,10,11,13,19],operationnotallow:7,opposit:14,opt:9,option:[11,13,18,19,20,21],ord:3,order:[2,3,11,13,19],org:[18,21],origin:[3,5,11,13,19,20,21],origina_d:3,original_d:3,other:[3,8,11,13,14,19,20,21],other_sig:13,otherwis:[3,13,19],our:[4,12,13,14,18,19],out:[2,3,4,7,13,14,19,21],outcom:[12,19],outcoming_kei:19,outcoming_key_method:19,outcoming_v:19,outcoming_value_method:19,outer:[12,19],outgo:12,output:[2,3,4,11,13,18,19,20],outrag:19,over:[3,7,10,12,13,18,19],overrid:3,overridden:10,overritten:19,oversight:13,overwrit:[7,18,19],overwritenotallow:21,overwritesnotallowederror:[7,10,19],overwritesnotallowedmixin:[10,19],overwritten:[10,19],own:[3,13,14,19,20],ozeip:11,packag:14,page:0,paint_it_42:19,pair:[2,3,4,8,11,13,14,15,19,20],param:[2,11,13,19,21],param_arg:13,param_attr:13,param_compar:13,param_for_kind:13,param_iter:13,param_kind:13,param_kwarg:13,param_map:13,paramat:13,paramet:[2,3,4,6,7,11,12,13,18,19,20,21],parametr:[11,13],parametrickeystor:11,parammet:13,params:13,paranoia:13,paranoid:7,parent:[10,18],parenthes:19,pariti:20,part:11,partial:[3,11,13,14,18,19,20,21],partial_formatt:11,partialclass:20,partialformatt:11,particular:[3,13],pass:[2,3,10,11,13,19,20],path:[0,3,4,5,8,9,11,19,20,21,22],path_get:12,path_sep:[12,19],path_typ:19,pathkeytyp:12,pattern:[11,13],pattern_for_field:[9,21],peek:19,peep:[4,19],per:13,perform:[4,14,19,21],perisist:9,permiss:21,persist:[3,4,10,19],persister_cl:19,person:18,perspect:21,physic:3,pick:13,pickability_test:[0,22],pickabl:16,pickal:20,pickl:[9,13,16,19],picklestor:9,pie:14,pip:14,pipe:20,pitfal:12,pka:13,pkl:19,pkv_to_pv:3,place:[9,10,12,13,19],plc:21,plu:[2,18],poa:13,point:[4,11,19],pointer:4,pool:7,pop:[2,3,19],popitem:[3,19],popul:4,pos:13,posit:[13,20],position_onli:13,position_or_keyword:13,positional_onli:13,positional_or_keyword:13,possibl:[2,7,13,14,19],post:7,postget:19,power:11,preced:13,preciou:4,precis:[19,20],precomput:19,prefix:[9,11,12,19,20,21],prefix_attr:12,prefixrelativ:5,prefixrelativizationmixin:12,prepar:[14,20,21],preprocess:3,present:[2,9,21],preserv:13,preset:[18,19],press:18,pretend:4,previou:4,print:[4,6,7,8,11,13,19,20],print_stat:4,probabl:19,problem:[7,13,19,20],problemat:19,process:[7,11,13],process_info_dict:[11,12],process_kwarg:[11,12],produc:[2,3,11,19],product:2,program:13,prompt:18,proof:19,prop:20,properti:[7,13,20],protect:7,prove:19,provid:[3,4,13,18,19,21],pull:13,purpos:[3,10,13,14,19,20],put:[4,10,13,19,21],pwd:21,py2stor:14,pypi:14,python:[3,13,14,18,20,21],queri:19,question:[11,20,21],quick:13,quicker:4,quickli:19,quit:[13,19,21],rais:[7,8,10,11,13,14,19,20],raise_error_if_an_attr_is_miss:20,raise_on_error:12,raison:20,ram:[4,19],rang:[4,7,18,20],rant:21,rate:[2,3],rather:19,raw:[14,19],reach:[2,20],read:[3,4,7,8,14,18,19,20,21],read_dict:8,read_fil:8,reader:[3,8,13,14,18,19,21],readi:[13,20],readlin:21,readonlymixin:10,readsnotallow:7,real:[9,13,19],realli:[3,7,10,12,13,18,19,20,21],rearrang:13,reason:19,receiv:9,recent:[6,8,10,12,13,14,19,20],recip:3,recogn:13,recommend:19,recomput:[4,19,20],recurs:[3,9,12,14,19,20],red:18,redefin:13,redrum:11,reduc:13,refer:[5,12],referenc:[5,12],refetch:4,reflect:13,refresh:[4,19],regardless:[4,19],regex:11,regroupbi:20,rel:[5,9,12],rel_path_wrap:12,relationship:18,reldict:19,releas:[0,20],release_remaind:20,reli:13,relpath:[12,19,21],relpath_wrap:19,relpathfilebytespersist:9,relpathfilebytesread:9,relpathfilestringpersist:9,relpathfilestringread:9,rema:13,remain:[2,11,13],remaind:13,remaining_kwarg:13,rememb:[13,14,19],remember_added_attr:20,remot:[3,4,19,21],remov:[4,11,12,13,19,20,21],remove_delet:19,remove_field:11,remove_mac_junk_from_zip:21,remove_some_entries_from_zip:21,reorder:13,repeat:20,repeatedli:13,repetit:13,replac:[11,13],replace_name_el:11,repr:19,repres:[2,3],represent:3,repurpos:19,request:[7,18,19],requir:[3,7,13,20],required_nam:13,resolut:4,resolv:[9,13,21],resolve_dir:9,resolve_path:9,respect:[2,4,11,13,19,20],respons:14,rest:13,restor:13,restrict:[4,13],result:[4,12,13,19,20],retriev:[3,7,10,19],return_annot:13,return_input:18,return_kei:2,return_source_data:4,return_v:19,reus:13,reveal:[4,19],revers:[2,3],revisit:4,right:[7,8,11],rm_delet:19,rm_keys_without_ask:21,robust:13,robust_has_signatur:13,root:[5,8,12,18,19],root_dir:11,root_fold:9,rootdir:[9,12,21],rope:19,row:13,rule:[13,19],run:[19,21],runtim:13,s_um:11,safer:[11,13],sai:[3,6,13,18,19,20],said:[13,19,20],same:[2,3,4,10,11,13,18,19,21],sampl:[2,3],saniti:13,satisfi:[10,13],save:[19,21],scene:[13,19],scrap:[0,22],scratch:13,script:3,search:[0,4,7,13,21],sec:19,second:[2,4,13,19],second_level_kei:14,see:[2,3,4,6,11,12,13,18,19,20,21],seed:[7,14],seek:3,seem:20,self:[2,3,4,7,11,12,13,19,20],semant:13,sens:[13,21],sent:19,sentinel_of__len:20,sep:[11,12,13],separ:[9,12,19],sequenc:[2,4,14,20],sequencekvread:[14,20],serial:[3,10,19],serv:[10,21],server:3,servic:13,session:11,session_id:21,set:[2,3,7,8,11,13,14,19,21],set_signature_of_func:13,setattrnotallow:[7,19],sever:[3,4,13,19],shallow:20,shorter:13,should:[2,3,4,6,7,8,9,10,12,13,14,18,19,20,21],shouldn:[3,4,7],show:[2,16,18,19,20],side:13,sig1:13,sig2:13,sig:13,sig_or_default:13,sig_or_non:13,sig_to_dataclass:13,signatur:[0,3,7,19,20,22],signific:14,silent:3,similar:13,simpl:[1,3,10,13,14,19,20],simplejsonmixin:10,simpler:11,simpli:[13,14,18],simplifi:20,sinc:[3,11,13,14,18,19,20,21],singl:[3,4,11,13,19,20,21],situat:[2,4,9,13,20],size:[3,10,19,21],skip:[3,19],skipe:[13,19],slap:7,slash:21,sleep:4,sleep_:4,slice:18,sliceabl:[18,20],sliceable_:18,slightli:19,slot:18,slow:19,slowdict:4,small:[6,19,20],smallest:20,smart:20,snapshot:21,sole:11,solut:[11,13,20,21],solv:19,some:[2,3,4,7,8,13,14,19,20,21],some_byt:21,some_func:13,some_zip_fil:21,somekvpersist:3,someth:[2,3,4,7,13,19,20,21],sometim:[7,13,19,21],somewher:[10,13,20],soon:21,sort:[11,13,18,19,21],sort_param:13,sorta:13,sorted_dict:19,sourc:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,15,16,18,19,20,21,22],source_args_and_kwarg:13,source_kwarg:13,sourcedloc:4,spec:11,special:[3,13,19],special_foo:13,specic:21,specif:[2,3,4,11,13,19,21],specifi:[2,3,8,11,13,14,18,19,20,21],speed:19,split:[3,13,19],src:[3,18],src_path:21,sss:[6,18],stabl:13,stackexchang:20,stackoverflow:11,start:[6,18,19,20,21],startswith:[11,18,20,21],stat:21,staticmethod:19,statu:21,stdin:6,step:[6,13],still:[2,4,10,12,13,18,19,20,21],sting:11,stop:3,stopword:20,storag:3,store:[1,2,3,4,6,7,8,9,10,11,12,14,16,18,19,20,21],store_cach:4,store_cached_with_single_kei:4,store_cl:[2,9,11,12],store_cls_kwarg:11,store_decor:19,storeinterfac:3,storewithdictkei:11,storewithnamedtuplekei:11,storewithtuplekei:11,storeyouwanttotransform:19,stori:4,str:[3,6,9,11,12,13,14,18,19,20,21],str_templat:11,str_template_key_tran:12,str_to_var_str:20,strang:19,stranger:19,stream:[2,3,21],strict:13,strict_timestamp:21,string:[2,3,5,6,11,12,13,18,19,20,21],stringifi:20,stringio:3,stringkvwrap:10,strip:3,strtupledict:11,strtupledictwithprefix:11,struct:14,structur:[3,18],stuff:[4,8,13,19,21],style:20,sub:[2,3,13,19],subclass:[2,3,4,10,12,13,19,21],subfold:[9,21],subpath:[9,11,21],subscript:[5,12],subsequ:19,subset:[11,13,19],subtl:19,subtract:13,subtre:18,subus:11,successf:19,sugar:13,suggest:13,sum:13,support:[3,4],suppos:[13,14],sure:13,sync:21,system:[2,3,9,11,21],systemat:13,tab:[14,19],take:[4,11,13,19,21],take_everyth:[19,21],taken:[13,19,20],talk:[4,19],target:[13,20],tasti:18,tell:[11,13,19,20],tempfil:21,templat:[11,12],test:[0,3,4,7,13,19,20,22],test_phas:21,test_phase_numb:21,test_pickling_w_dict:16,test_stor:3,test_wrapped_d:3,test_zipfil:21,testact:21,testpersist:[10,19],text:19,textfil:9,textfilesread:9,than:[2,11,13,14],the_persistent_dict:4,thei:[3,4,6,8,10,11,13,16,18,19,20,21],them:[3,8,11,13,14,19,20,21],themselv:[3,11,18],thenm:13,ther:13,therefor:[3,18,19],thereof:[14,19],thi:[3,4,8,10,11,12,13,14,18,19,20,21],thii:19,thin:13,thing:[3,4,12,13,19,20,21],think:20,third:13,this_argnam:13,this_is_a_valid_var_nam:20,this_is_not_an_attr:20,those:[3,10,13,14,19,20],though:[4,12,13,19,20,21],thought:20,three:[13,19],through:[3,4,5,7,12,13,14,18,19,20,21],thu:[13,19],time:[2,4,7,8,12,13,18,19,20,21],time_takes_no_argu:13,timestamp:2,tip:[13,21],to_csv:19,to_signature_kwarg:13,to_simple_signatur:13,to_zip_fil:21,to_zipped_byt:21,todo:[13,19],togeth:13,toi:18,token:[11,20],too:[11,12,13,19,21],took:[2,19],tool:[0,1,2,4,5,13,14,19,22],total:13,trace:19,trace_getitem:6,traceback:[6,8,10,12,13,14,19,20],tran:[0,6,12,18,21,22],trans_func:19,trans_func_for_kei:11,trans_obj:19,transform:[3,4,6,11,12,13,14,18,19],translat:[12,13],transpar:10,transparent_key_method:19,travers:3,tre:14,tree:[3,18,19],tree_:18,treehttp:18,tri:[13,18],trick:[3,20],trigger:4,tripl:13,trivial:3,troubl:13,trust:19,tup:13,tupl:[2,3,7,8,11,12,13,14,15,19],tuple_keypath_and_v:3,tuple_the_arg:13,turn:19,twhalen:21,twice:13,two:[2,3,4,8,11,13,19,20,21],txt:11,type:[2,3,8,11,12,13,18,19,20],typeerror:[13,20],typic:19,u_nam:11,u_name_2:11,u_sref:11,unchang:2,uncomp_tim:21,uncompress:21,unconsum:14,under:[3,4,12,18,19,20],underli:[18,19],underspecifi:13,understand:13,unexpect:13,unic:[13,19],union:[3,4,12,13,14,18,19,20,21],unique_el:14,unit:[6,19],unix:[4,21],unless:19,unlik:[3,4,13,19],unnam:2,uno:14,unord:19,unpickl:16,unravel:20,untouch:[13,20],unwant:20,unwittingli:4,unwrapped_d:3,unzip:21,unzipped_byt:21,updat:[3,13,14,19,20,21],update_fields_of_namedtupl:11,update_keys_cach:[14,19],updatednt:11,upload:11,upon:12,upper:[3,6,19],uri:11,url:14,usag:[13,19,21],use:[2,3,4,7,11,12,13,14,18,19,20,21],use_cached_kei:19,use_cached_keys_after_completed_it:19,use_interfac:13,used:[2,3,4,5,7,11,12,13,14,18,19,20,21],useful:[3,4,10,11,13,14,18,19,20,21],useless:20,user:[11,13,18,19,21],user_input_msg:18,userdict:[12,19],uses:[2,8,11,12,19],using:[2,3,4,12,13,14,18,19,20,21],usual:[4,10,11,13,14,19,20,21],utc:2,utc_kei:2,utc_m:11,utf:21,util:[0,7,8,11,14,19,21,22],val:[2,7,10,11,14,15,19,20],val_is_map:3,val_postproc:14,val_reads_wrt_to_kei:19,valid:[4,7,11,12,13,18,19,20,21],validate_kwarg:11,validation_dict:11,validation_fun:11,valswrapabc:10,valu:[2,3,4,6,7,8,10,11,12,13,14,18,19,20,21],value_preprocessor:18,valueerror:[8,13,19,20],valuesview:3,var_keyword:13,var_keyword_nam:13,var_posit:13,variabl:[4,11,13,20],variad:[13,20],variadic_keyword:13,varieti:13,variou:[6,18],veri:[4,5,12,13,19],verifi:[3,13,21],versa:[3,12],version:[3,4,13,14,19,20],view:[3,12,13,14,18,19,21],visa:[3,12],visibl:[14,20],vka:13,vpa:13,w_cach:4,wai:[3,4,10,12,13,14,19,20],wait:13,walk:3,walk_filt:[3,19],want:[2,3,4,5,6,7,10,11,12,13,14,18,19,20,21],warn:[7,13,19],wasn:19,wav:[3,11],waveform:3,weird:[19,21],well:[4,6,13,14,18,19,20,21],were:[11,13,19],weren:13,wfoo:13,what:[3,4,7,8,10,11,12,13,14,19,20,21],what_to_do_with_remaind:13,whatev:[4,19,21],when:[3,4,5,7,11,12,13,14,16,18,19,20,21],where:[2,3,4,9,10,11,12,13,14,18,19,20],whether:[2,3,4,12,13,19,20],whic:18,which:[2,3,4,10,13,14,18,19,20,21],who:18,whole:[3,14],whose:[3,4,11,13,18,19,21],why:[13,19],wiith:20,wiki:[3,18],wikipedia:18,wikipediaontreeshttp:18,window:11,wish:13,with_default:13,with_key_valid:12,within:3,without:[2,7,13,19,20],without_default:13,without_remaind:13,won:[11,13,20,21],word:20,word_categori:20,work:[3,4,10,11,12,13,19,20,21],world:[4,11,13,18,20],wors:3,would:[2,3,4,11,12,13,18,19,20],wouldn:[11,19],wow:4,wrap:[3,4,5,8,10,11,12,13,14,16,18,19,20,21],wrap_cl:19,wrap_kv:[6,18,19],wrapped_d:3,wrapped_foo:19,wrapped_func:19,wrapped_obj:3,wrapped_stor:19,wrappeda:3,wrappeddict:[3,15],wrapper:[3,13,19],wrapper_kwarg:19,write:[3,4,7,9,10,13,14,18,19,20,21],writebackchainmap:4,writer:3,writesnotallow:7,written:[4,19],wrong:7,x_to_i:19,xyz:13,y_of_x:19,yeah:13,yes:[7,13,19],yet:[13,19],yield:[3,7,15,19,20],yield_callback_output:7,yield_func:3,you:[2,3,4,7,8,10,11,12,13,14,18,19,20,21],your:[1,3,4,7,10,11,13,14,18,19,20,21],your_filt_func:20,your_stor:19,yourself:21,zip:[19,20,21],zip_fil:21,zip_filepath:21,zip_pair_path_preproc:21,zip_path_pair:21,zip_read:21,zip_reader_kwarg:21,zip_sourc:21,zipfil:21,zipfiledol:[0,22],zipfileread:19,zipfilesread:21,zipfilesreaderandbyteswrit:21,zipfilestreamsread:21,zipinfo:21,zipinforead:21,zipped_byt:21,zipped_bytes_to_byt:21,zipread:[19,21],zipstor:21,zipstore_test_fil:21,zoo:13,zzz:20},titles:["Welcome to dol\u2019s documentation!","dol","dol.appendable","dol.base","dol.caching","dol.core","dol.dig","dol.errors","dol.explicit","dol.filesys","dol.mixins","dol.naming","dol.paths","dol.signatures","dol.sources","dol.tests.base_test","dol.tests.pickability_test","dol.tests.scrap","dol.tools","dol.trans","dol.util","dol.zipfiledol","<no title>"],titleterms:{append:2,base:3,base_test:15,cach:4,core:5,dig:6,document:0,dol:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21],error:7,explicit:8,filesi:9,indic:0,mixin:10,name:11,path:12,pickability_test:16,scrap:17,signatur:13,sourc:14,tabl:0,test:[15,16,17],tool:18,tran:19,util:20,welcom:0,zipfiledol:21}}) \ No newline at end of file diff --git a/docs/table_of_contents.html b/docs/table_of_contents.html index eda877b4..08b66055 100644 --- a/docs/table_of_contents.html +++ b/docs/table_of_contents.html @@ -4,7 +4,7 @@ - <no title> — dol 0.1.101 documentation + <no title> — dol 0.1.102 documentation diff --git a/setup.cfg b/setup.cfg index b9d120ed..9337f618 100644 --- a/setup.cfg +++ b/setup.cfg @@ -1,6 +1,6 @@ [metadata] name = dol -version = 0.1.101 +version = 0.1.102 url = https://github.com/i2mint/dol platforms = any description_file = README.md