str-to-obj 2024.5__py3-none-any.whl → 2024.6__py3-none-any.whl

str_to_obj/__init__.py

@@ -6,12 +6,8 @@ SEE COPYRIGHT NOTICE BELOW
 
 from str_to_obj.main import ObjectFromStr
 from str_to_obj.runtime.value import INVALID_VALUE
-from str_to_obj.task.casting import CastValue
-from str_to_obj.type.annotation import annotation_t
-from str_to_obj.type.type import type_t
 from str_to_obj.version import __version__
 
-
 """
 COPYRIGHT NOTICE
 

str_to_obj/api/catalog.py

@@ -0,0 +1,58 @@
+"""
+Copyright CNRS/Inria/UniCA
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+SEE COPYRIGHT NOTICE BELOW
+"""
+
+from str_to_obj.catalog.boolean import boolean_mode_e, boolean_t
+from str_to_obj.catalog.callable import callable_t
+from str_to_obj.catalog.choices import choices_t
+from str_to_obj.catalog.collection import collection_t
+from str_to_obj.catalog.number import number_t
+from str_to_obj.catalog.path import path_purpose_e, path_t, path_type_e
+
+"""
+COPYRIGHT NOTICE
+
+This software is governed by the CeCILL  license under French law and
+abiding by the rules of distribution of free software.  You can  use,
+modify and/ or redistribute the software under the terms of the CeCILL
+license as circulated by CEA, CNRS and INRIA at the following URL
+"http://www.cecill.info".
+
+As a counterpart to the access to the source code and  rights to copy,
+modify and redistribute granted by the license, users are provided only
+with a limited warranty  and the software's author,  the holder of the
+economic rights,  and the successive licensors  have only  limited
+liability.
+
+In this respect, the user's attention is drawn to the risks associated
+with loading,  using,  modifying and/or developing or reproducing the
+software by the user in light of its specific status of free software,
+that may mean  that it is complicated to manipulate,  and  that  also
+therefore means  that it is reserved for developers  and  experienced
+professionals having in-depth computer knowledge. Users are therefore
+encouraged to load and test the software's suitability as regards their
+requirements in conditions enabling the security of their systems and/or
+data to be ensured and,  more generally, to use and operate it in the
+same conditions as regards security.
+
+The fact that you are presently reading this means that you have had
+knowledge of the CeCILL license and that you accept its terms.
+
+SEE LICENCE NOTICE: file README-LICENCE-utf8.txt at project source root.
+
+This software is being developed by Eric Debreuve, a CNRS employee and
+member of team Morpheme.
+Team Morpheme is a joint team between Inria, CNRS, and UniCA.
+It is hosted by the Centre Inria d'Université Côte d'Azur, Laboratory
+I3S, and Laboratory iBV.
+
+CNRS: https://www.cnrs.fr/index.php/en
+Inria: https://www.inria.fr/en/
+UniCA: https://univ-cotedazur.eu/
+Centre Inria d'Université Côte d'Azur: https://www.inria.fr/en/centre/sophia/
+I3S: https://www.i3s.unice.fr/en/
+iBV: http://ibv.unice.fr/
+Team Morpheme: https://team.inria.fr/morpheme/
+"""

str_to_obj/api/type.py

@@ -0,0 +1,58 @@
+"""
+Copyright CNRS/Inria/UniCA
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+SEE COPYRIGHT NOTICE BELOW
+"""
+
+from str_to_obj.runtime.type import ANY_TYPE
+from str_to_obj.task.casting import CastValue
+from str_to_obj.task.comparison import TypesAreCompatible
+from str_to_obj.type.annotation import annotation_t
+from str_to_obj.type.hint_tree import hint_t
+from str_to_obj.type.type import type_t
+
+"""
+COPYRIGHT NOTICE
+
+This software is governed by the CeCILL  license under French law and
+abiding by the rules of distribution of free software.  You can  use,
+modify and/ or redistribute the software under the terms of the CeCILL
+license as circulated by CEA, CNRS and INRIA at the following URL
+"http://www.cecill.info".
+
+As a counterpart to the access to the source code and  rights to copy,
+modify and redistribute granted by the license, users are provided only
+with a limited warranty  and the software's author,  the holder of the
+economic rights,  and the successive licensors  have only  limited
+liability.
+
+In this respect, the user's attention is drawn to the risks associated
+with loading,  using,  modifying and/or developing or reproducing the
+software by the user in light of its specific status of free software,
+that may mean  that it is complicated to manipulate,  and  that  also
+therefore means  that it is reserved for developers  and  experienced
+professionals having in-depth computer knowledge. Users are therefore
+encouraged to load and test the software's suitability as regards their
+requirements in conditions enabling the security of their systems and/or
+data to be ensured and,  more generally, to use and operate it in the
+same conditions as regards security.
+
+The fact that you are presently reading this means that you have had
+knowledge of the CeCILL license and that you accept its terms.
+
+SEE LICENCE NOTICE: file README-LICENCE-utf8.txt at project source root.
+
+This software is being developed by Eric Debreuve, a CNRS employee and
+member of team Morpheme.
+Team Morpheme is a joint team between Inria, CNRS, and UniCA.
+It is hosted by the Centre Inria d'Université Côte d'Azur, Laboratory
+I3S, and Laboratory iBV.
+
+CNRS: https://www.cnrs.fr/index.php/en
+Inria: https://www.inria.fr/en/
+UniCA: https://univ-cotedazur.eu/
+Centre Inria d'Université Côte d'Azur: https://www.inria.fr/en/centre/sophia/
+I3S: https://www.i3s.unice.fr/en/
+iBV: http://ibv.unice.fr/
+Team Morpheme: https://team.inria.fr/morpheme/
+"""

str_to_obj/catalog/collection.py

@@ -4,8 +4,6 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-from __future__ import annotations
-
 import dataclasses as d
 import types as t
 import typing as h
@@ -72,7 +70,7 @@ class collection_t(annotation_t):
         cls,
         stripe: any_hint_h | tuple[any_hint_h, ...] | type_t | tuple[type_t, ...],
         /,
-    ) -> collection_t:
+    ) -> h.Self:
         """"""
         if not isinstance(stripe, (type_t | tuple[type_t, ...])):
             stripe = type_t.NewForHint(stripe)

str_to_obj/interface/console.py

@@ -4,7 +4,6 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-
 import typing as h
 
 

str_to_obj/main.py

@@ -9,14 +9,14 @@ import types as t
 import typing as h
 
 from str_to_obj.task.casting import CastValue
-from str_to_obj.type.hint_tree import any_hint_h, hint_tree_t
+from str_to_obj.type.hint_tree import any_hint_h, hint_t
 
 
 def ObjectFromStr(
     string: str,
     /,
     *,
-    expected_type: any_hint_h | hint_tree_t | type[t.NoneType] = None,
+    expected_type: any_hint_h | hint_t | type[t.NoneType] = None,
 ) -> tuple[h.Any, list[str]]:
     """
     expected_type: Must not be passed explicitly as None since None is interpreted as

str_to_obj/task/casting.py

@@ -4,15 +4,13 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-from __future__ import annotations
-
-import dataclasses as dtcl
+import dataclasses as d
 import types as t
 import typing as h
 from pathlib import Path as path_t
 
 from str_to_obj.type.hint import any_hint_h, simple_hint_h
-from str_to_obj.type.hint_tree import hint_tree_t
+from str_to_obj.type.hint_tree import hint_t
 
 
 class _not_a_leaf_node_t:
@@ -22,7 +20,7 @@ class _not_a_leaf_node_t:
 _NOT_A_LEAF_NODE = _not_a_leaf_node_t()
 
 
-@dtcl.dataclass(slots=True, repr=False, eq=False)
+@d.dataclass(slots=True, repr=False, eq=False)
 class _value_node_t:
     """
     Leave elements to the tree.
@@ -33,12 +31,12 @@ class _value_node_t:
     leaf_value: h.Any | None = _NOT_A_LEAF_NODE
 
 
-@dtcl.dataclass(slots=True, repr=False, eq=False)
+@d.dataclass(slots=True, repr=False, eq=False)
 class _value_tree_t(_value_node_t):
-    elements: tuple[_value_tree_t, ...] = None
+    elements: tuple[h.Self, ...] = None
 
     @classmethod
-    def NewFromValue(cls, value: h.Any, /) -> _value_tree_t:
+    def NewFromValue(cls, value: h.Any, /) -> h.Self:
         """"""
         if isinstance(value, h.Iterable) and not isinstance(value, str):
             elements = tuple(cls.NewFromValue(_elm) for _elm in value)
@@ -54,7 +52,7 @@ class _value_tree_t(_value_node_t):
         return self.leaf_value
 
     def CastValue(
-        self, hint_tree: hint_tree_t, /, *, only_check_validity: bool = False
+        self, hint_tree: hint_t, /, *, only_check_validity: bool = False
     ) -> tuple[h.Any, list[str]] | list[str]:
         """"""
         issues = self._CastToHint(hint_tree)
@@ -69,7 +67,7 @@ class _value_tree_t(_value_node_t):
         else:
             return self._RebuiltValue(), []
 
-    def _CastToHint(self, hint_node: hint_tree_t, /) -> list[str]:
+    def _CastToHint(self, hint_node: hint_t, /) -> list[str]:
         """
         Returned value=the value tree has been successfully cast to the hint tree
         specification, or not.
@@ -183,7 +181,7 @@ class _value_tree_t(_value_node_t):
             f"Expected=Value following template {hint_node.template_as_str}."
         ]
 
-    def _CompliesWithAnnotations(self, hint_node: hint_tree_t, /) -> list[str]:
+    def _CompliesWithAnnotations(self, hint_node: hint_t, /) -> list[str]:
         """"""
         output = []
 
@@ -195,15 +193,15 @@ class _value_tree_t(_value_node_t):
 
 def CastValue(
     value: h.Any,
-    hint: any_hint_h | hint_tree_t,
+    hint: any_hint_h | hint_t,
     /,
     *,
     only_check_validity: bool = False,
 ) -> tuple[h.Any, list[str]] | list[str]:
     """"""
     value_tree = _value_tree_t.NewFromValue(value)
-    if not isinstance(hint, hint_tree_t):
-        hint = hint_tree_t.NewForHint(hint)
+    if not isinstance(hint, hint_t):
+        hint = hint_t.NewForHint(hint)
 
     return value_tree.CastValue(hint, only_check_validity=only_check_validity)
 

str_to_obj/task/comparison.py

@@ -7,12 +7,12 @@ SEE COPYRIGHT NOTICE BELOW
 import types as t
 import typing as h
 
-from str_to_obj.type.hint_tree import hint_tree_t
+from str_to_obj.type.hint_tree import hint_t
 
 
 def TypesAreCompatible(
-    one: hint_tree_t,
-    another: hint_tree_t,
+    one: hint_t,
+    another: hint_t,
     /,
     *,
     strict_mode: bool = True,

str_to_obj/type/annotation.py

@@ -1,35 +1,10 @@
-# Copyright CNRS/Inria/UNS
-# Contributor(s): Eric Debreuve (since 2023)
-#
-# eric.debreuve@cnrs.fr
-#
-# This software is governed by the CeCILL  license under French law and
-# abiding by the rules of distribution of free software.  You can  use,
-# modify and/ or redistribute the software under the terms of the CeCILL
-# license as circulated by CEA, CNRS and INRIA at the following URL
-# "http://www.cecill.info".
-#
-# As a counterpart to the access to the source code and  rights to copy,
-# modify and redistribute granted by the license, users are provided only
-# with a limited warranty  and the software's author,  the holder of the
-# economic rights,  and the successive licensors  have only  limited
-# liability.
-#
-# In this respect, the user's attention is drawn to the risks associated
-# with loading,  using,  modifying and/or developing or reproducing the
-# software by the user in light of its specific status of free software,
-# that may mean  that it is complicated to manipulate,  and  that  also
-# therefore means  that it is reserved for developers  and  experienced
-# professionals having in-depth computer knowledge. Users are therefore
-# encouraged to load and test the software's suitability as regards their
-# requirements in conditions enabling the security of their systems and/or
-# data to be ensured and,  more generally, to use and operate it in the
-# same conditions as regards security.
-#
-# The fact that you are presently reading this means that you have had
-# knowledge of the CeCILL license and that you accept its terms.
-
-import dataclasses as dtcl
+"""
+Copyright CNRS/Inria/UniCA
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+SEE COPYRIGHT NOTICE BELOW
+"""
+
+import dataclasses as d
 import typing as h
 
 from rich.text import Text as text_t
@@ -37,7 +12,7 @@ from str_to_obj.interface.console import NameValueTypeAsRichStr, TypeAsRichStr
 from str_to_obj.type.hint import annotated_hint_t, non_complex_hint_h
 
 
-@dtcl.dataclass(slots=True, repr=False, eq=False)
+@d.dataclass(slots=True, repr=False, eq=False)
 class annotation_t:
     ACCEPTED_TYPES: h.ClassVar[tuple[non_complex_hint_h, ...]] = (h.Any,)
 
@@ -73,9 +48,56 @@ class annotation_t:
         """"""
         output = [TypeAsRichStr(self)]
 
-        names = (_fld.name for _fld in dtcl.fields(self))
+        names = (_fld.name for _fld in d.fields(self))
         for name in names:
             value = getattr(self, name)
             output.append(f"    {NameValueTypeAsRichStr(name, value, separator=' = ')}")
 
         return "\n".join(output)
+
+
+"""
+COPYRIGHT NOTICE
+
+This software is governed by the CeCILL  license under French law and
+abiding by the rules of distribution of free software.  You can  use,
+modify and/ or redistribute the software under the terms of the CeCILL
+license as circulated by CEA, CNRS and INRIA at the following URL
+"http://www.cecill.info".
+
+As a counterpart to the access to the source code and  rights to copy,
+modify and redistribute granted by the license, users are provided only
+with a limited warranty  and the software's author,  the holder of the
+economic rights,  and the successive licensors  have only  limited
+liability.
+
+In this respect, the user's attention is drawn to the risks associated
+with loading,  using,  modifying and/or developing or reproducing the
+software by the user in light of its specific status of free software,
+that may mean  that it is complicated to manipulate,  and  that  also
+therefore means  that it is reserved for developers  and  experienced
+professionals having in-depth computer knowledge. Users are therefore
+encouraged to load and test the software's suitability as regards their
+requirements in conditions enabling the security of their systems and/or
+data to be ensured and,  more generally, to use and operate it in the
+same conditions as regards security.
+
+The fact that you are presently reading this means that you have had
+knowledge of the CeCILL license and that you accept its terms.
+
+SEE LICENCE NOTICE: file README-LICENCE-utf8.txt at project source root.
+
+This software is being developed by Eric Debreuve, a CNRS employee and
+member of team Morpheme.
+Team Morpheme is a joint team between Inria, CNRS, and UniCA.
+It is hosted by the Centre Inria d'Université Côte d'Azur, Laboratory
+I3S, and Laboratory iBV.
+
+CNRS: https://www.cnrs.fr/index.php/en
+Inria: https://www.inria.fr/en/
+UniCA: https://univ-cotedazur.eu/
+Centre Inria d'Université Côte d'Azur: https://www.inria.fr/en/centre/sophia/
+I3S: https://www.i3s.unice.fr/en/
+iBV: http://ibv.unice.fr/
+Team Morpheme: https://team.inria.fr/morpheme/
+"""

str_to_obj/type/hint.py

@@ -1,33 +1,8 @@
-# Copyright CNRS/Inria/UNS
-# Contributor(s): Eric Debreuve (since 2023)
-#
-# eric.debreuve@cnrs.fr
-#
-# This software is governed by the CeCILL  license under French law and
-# abiding by the rules of distribution of free software.  You can  use,
-# modify and/ or redistribute the software under the terms of the CeCILL
-# license as circulated by CEA, CNRS and INRIA at the following URL
-# "http://www.cecill.info".
-#
-# As a counterpart to the access to the source code and  rights to copy,
-# modify and redistribute granted by the license, users are provided only
-# with a limited warranty  and the software's author,  the holder of the
-# economic rights,  and the successive licensors  have only  limited
-# liability.
-#
-# In this respect, the user's attention is drawn to the risks associated
-# with loading,  using,  modifying and/or developing or reproducing the
-# software by the user in light of its specific status of free software,
-# that may mean  that it is complicated to manipulate,  and  that  also
-# therefore means  that it is reserved for developers  and  experienced
-# professionals having in-depth computer knowledge. Users are therefore
-# encouraged to load and test the software's suitability as regards their
-# requirements in conditions enabling the security of their systems and/or
-# data to be ensured and,  more generally, to use and operate it in the
-# same conditions as regards security.
-#
-# The fact that you are presently reading this means that you have had
-# knowledge of the CeCILL license and that you accept its terms.
+"""
+Copyright CNRS/Inria/UniCA
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+SEE COPYRIGHT NOTICE BELOW
+"""
 
 import types as t
 import typing as h
@@ -55,3 +30,49 @@ any_hint_h = raw_hint_h | annotated_hint_t
 #     - EllipsisType for GenericAlias, as in: tuple[int, ...]
 #     - None for UnionType, as in: int | None
 complex_hint_additions_h = t.EllipsisType | None
+
+"""
+COPYRIGHT NOTICE
+
+This software is governed by the CeCILL  license under French law and
+abiding by the rules of distribution of free software.  You can  use,
+modify and/ or redistribute the software under the terms of the CeCILL
+license as circulated by CEA, CNRS and INRIA at the following URL
+"http://www.cecill.info".
+
+As a counterpart to the access to the source code and  rights to copy,
+modify and redistribute granted by the license, users are provided only
+with a limited warranty  and the software's author,  the holder of the
+economic rights,  and the successive licensors  have only  limited
+liability.
+
+In this respect, the user's attention is drawn to the risks associated
+with loading,  using,  modifying and/or developing or reproducing the
+software by the user in light of its specific status of free software,
+that may mean  that it is complicated to manipulate,  and  that  also
+therefore means  that it is reserved for developers  and  experienced
+professionals having in-depth computer knowledge. Users are therefore
+encouraged to load and test the software's suitability as regards their
+requirements in conditions enabling the security of their systems and/or
+data to be ensured and,  more generally, to use and operate it in the
+same conditions as regards security.
+
+The fact that you are presently reading this means that you have had
+knowledge of the CeCILL license and that you accept its terms.
+
+SEE LICENCE NOTICE: file README-LICENCE-utf8.txt at project source root.
+
+This software is being developed by Eric Debreuve, a CNRS employee and
+member of team Morpheme.
+Team Morpheme is a joint team between Inria, CNRS, and UniCA.
+It is hosted by the Centre Inria d'Université Côte d'Azur, Laboratory
+I3S, and Laboratory iBV.
+
+CNRS: https://www.cnrs.fr/index.php/en
+Inria: https://www.inria.fr/en/
+UniCA: https://univ-cotedazur.eu/
+Centre Inria d'Université Côte d'Azur: https://www.inria.fr/en/centre/sophia/
+I3S: https://www.i3s.unice.fr/en/
+iBV: http://ibv.unice.fr/
+Team Morpheme: https://team.inria.fr/morpheme/
+"""

str_to_obj/type/hint_tree.py

@@ -1,37 +1,10 @@
-# Copyright CNRS/Inria/UNS
-# Contributor(s): Eric Debreuve (since 2023)
-#
-# eric.debreuve@cnrs.fr
-#
-# This software is governed by the CeCILL  license under French law and
-# abiding by the rules of distribution of free software.  You can  use,
-# modify and/ or redistribute the software under the terms of the CeCILL
-# license as circulated by CEA, CNRS and INRIA at the following URL
-# "http://www.cecill.info".
-#
-# As a counterpart to the access to the source code and  rights to copy,
-# modify and redistribute granted by the license, users are provided only
-# with a limited warranty  and the software's author,  the holder of the
-# economic rights,  and the successive licensors  have only  limited
-# liability.
-#
-# In this respect, the user's attention is drawn to the risks associated
-# with loading,  using,  modifying and/or developing or reproducing the
-# software by the user in light of its specific status of free software,
-# that may mean  that it is complicated to manipulate,  and  that  also
-# therefore means  that it is reserved for developers  and  experienced
-# professionals having in-depth computer knowledge. Users are therefore
-# encouraged to load and test the software's suitability as regards their
-# requirements in conditions enabling the security of their systems and/or
-# data to be ensured and,  more generally, to use and operate it in the
-# same conditions as regards security.
-#
-# The fact that you are presently reading this means that you have had
-# knowledge of the CeCILL license and that you accept its terms.
-
-from __future__ import annotations
+"""
+Copyright CNRS/Inria/UniCA
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+SEE COPYRIGHT NOTICE BELOW
+"""
 
-import dataclasses as dtcl
+import dataclasses as d
 import re as regx
 import types as t
 import typing as h
@@ -47,22 +20,22 @@ from str_to_obj.type.hint import (
 )
 
 
-@dtcl.dataclass(slots=True, repr=False, eq=False)
+@d.dataclass(slots=True, repr=False, eq=False)
 class _hint_node_t:
     """
     Leave elements to the tree.
     """
 
     type: non_complex_hint_h | t.UnionType | t.EllipsisType | type[t.NoneType]
-    annotations: tuple[annotation_t, ...] = dtcl.field(default_factory=tuple)
+    annotations: tuple[annotation_t, ...] = d.field(default_factory=tuple)
 
 
-@dtcl.dataclass(slots=True, repr=False, eq=False)
-class hint_tree_t(_hint_node_t):
-    elements: tuple[hint_tree_t, ...] = None
+@d.dataclass(slots=True, repr=False, eq=False)
+class hint_t(_hint_node_t):
+    elements: tuple[h.Self, ...] = None
 
     @classmethod
-    def NewForHint(cls, hint: any_hint_h | complex_hint_additions_h, /) -> hint_tree_t:
+    def NewForHint(cls, hint: any_hint_h | complex_hint_additions_h, /) -> h.Self:
         """
         Note that type hints cannot translate into hint trees with an OR-node having a child
         OR-node. For example: str | (int | float) is interpreted as str | int | float. This
@@ -162,7 +135,7 @@ class hint_tree_t(_hint_node_t):
 #     """"""
 #     output = [TypeAsRichStr(self)]
 #
-#     names = (_fld.name for _fld in dtcl.fields(self))
+#     names = (_fld.name for _fld in d.fields(self))
 #     for name in names:
 #         value = getattr(self, name)
 #         output.append(f"    {NameValueTypeAsRichStr(name, value, separator='@=@')}")
@@ -170,3 +143,49 @@ class hint_tree_t(_hint_node_t):
 #     output = AlignedOnSeparator(output, "@=@", " = ")
 #
 #     return "\n".join(output)
+
+"""
+COPYRIGHT NOTICE
+
+This software is governed by the CeCILL  license under French law and
+abiding by the rules of distribution of free software.  You can  use,
+modify and/ or redistribute the software under the terms of the CeCILL
+license as circulated by CEA, CNRS and INRIA at the following URL
+"http://www.cecill.info".
+
+As a counterpart to the access to the source code and  rights to copy,
+modify and redistribute granted by the license, users are provided only
+with a limited warranty  and the software's author,  the holder of the
+economic rights,  and the successive licensors  have only  limited
+liability.
+
+In this respect, the user's attention is drawn to the risks associated
+with loading,  using,  modifying and/or developing or reproducing the
+software by the user in light of its specific status of free software,
+that may mean  that it is complicated to manipulate,  and  that  also
+therefore means  that it is reserved for developers  and  experienced
+professionals having in-depth computer knowledge. Users are therefore
+encouraged to load and test the software's suitability as regards their
+requirements in conditions enabling the security of their systems and/or
+data to be ensured and,  more generally, to use and operate it in the
+same conditions as regards security.
+
+The fact that you are presently reading this means that you have had
+knowledge of the CeCILL license and that you accept its terms.
+
+SEE LICENCE NOTICE: file README-LICENCE-utf8.txt at project source root.
+
+This software is being developed by Eric Debreuve, a CNRS employee and
+member of team Morpheme.
+Team Morpheme is a joint team between Inria, CNRS, and UniCA.
+It is hosted by the Centre Inria d'Université Côte d'Azur, Laboratory
+I3S, and Laboratory iBV.
+
+CNRS: https://www.cnrs.fr/index.php/en
+Inria: https://www.inria.fr/en/
+UniCA: https://univ-cotedazur.eu/
+Centre Inria d'Université Côte d'Azur: https://www.inria.fr/en/centre/sophia/
+I3S: https://www.i3s.unice.fr/en/
+iBV: http://ibv.unice.fr/
+Team Morpheme: https://team.inria.fr/morpheme/
+"""

str_to_obj/type/type.py

@@ -1,45 +1,22 @@
-# Copyright CNRS/Inria/UniCA
-# Contributor(s): Eric Debreuve (since 2021)
-#
-# eric.debreuve@cnrs.fr
-#
-# This software is governed by the CeCILL  license under French law and
-# abiding by the rules of distribution of free software.  You can  use,
-# modify and/ or redistribute the software under the terms of the CeCILL
-# license as circulated by CEA, CNRS and INRIA at the following URL
-# "http://www.cecill.info".
-#
-# As a counterpart to the access to the source code and  rights to copy,
-# modify and redistribute granted by the license, users are provided only
-# with a limited warranty  and the software's author,  the holder of the
-# economic rights,  and the successive licensors  have only  limited
-# liability.
-#
-# In this respect, the user's attention is drawn to the risks associated
-# with loading,  using,  modifying and/or developing or reproducing the
-# software by the user in light of its specific status of free software,
-# that may mean  that it is complicated to manipulate,  and  that  also
-# therefore means  that it is reserved for developers  and  experienced
-# professionals having in-depth computer knowledge. Users are therefore
-# encouraged to load and test the software's suitability as regards their
-# requirements in conditions enabling the security of their systems and/or
-# data to be ensured and,  more generally, to use and operate it in the
-# same conditions as regards security.
-#
-# The fact that you are presently reading this means that you have had
-# knowledge of the CeCILL license and that you accept its terms.
-
-import dataclasses as dtcl
+"""
+Copyright CNRS/Inria/UniCA
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+SEE COPYRIGHT NOTICE BELOW
+"""
+
+import dataclasses as d
 import typing as h
 
 from rich.text import Text as text_t
-from str_to_obj import CastValue, ObjectFromStr, annotation_t
+from str_to_obj.main import ObjectFromStr
 from str_to_obj.runtime.value import INVALID_VALUE
-from str_to_obj.type.hint_tree import hint_tree_t
+from str_to_obj.task.casting import CastValue
+from str_to_obj.type.annotation import annotation_t
+from str_to_obj.type.hint_tree import hint_t
 
 
-@dtcl.dataclass(slots=True, repr=False, eq=False)
-class type_t(hint_tree_t):
+@d.dataclass(slots=True, repr=False, eq=False)
+class type_t(hint_t):
     def FirstAnnotationWithType(
         self, stripe: type[annotation_t], /
     ) -> annotation_t | None:
@@ -80,7 +57,7 @@ class type_t(hint_tree_t):
         return "[yellow]" + "::".join(output) + "[/]"
 
 
-@dtcl.dataclass(slots=True, repr=False, eq=False)
+@d.dataclass(slots=True, repr=False, eq=False)
 class any_type_t(type_t):
     def FirstAnnotationWithType(
         self, stripe: type[annotation_t], /
@@ -95,3 +72,50 @@ class any_type_t(type_t):
     def InterpretedValueOf(self, value: h.Any, /) -> tuple[h.Any, list[str]]:
         """"""
         return value, []
+
+
+"""
+COPYRIGHT NOTICE
+
+This software is governed by the CeCILL  license under French law and
+abiding by the rules of distribution of free software.  You can  use,
+modify and/ or redistribute the software under the terms of the CeCILL
+license as circulated by CEA, CNRS and INRIA at the following URL
+"http://www.cecill.info".
+
+As a counterpart to the access to the source code and  rights to copy,
+modify and redistribute granted by the license, users are provided only
+with a limited warranty  and the software's author,  the holder of the
+economic rights,  and the successive licensors  have only  limited
+liability.
+
+In this respect, the user's attention is drawn to the risks associated
+with loading,  using,  modifying and/or developing or reproducing the
+software by the user in light of its specific status of free software,
+that may mean  that it is complicated to manipulate,  and  that  also
+therefore means  that it is reserved for developers  and  experienced
+professionals having in-depth computer knowledge. Users are therefore
+encouraged to load and test the software's suitability as regards their
+requirements in conditions enabling the security of their systems and/or
+data to be ensured and,  more generally, to use and operate it in the
+same conditions as regards security.
+
+The fact that you are presently reading this means that you have had
+knowledge of the CeCILL license and that you accept its terms.
+
+SEE LICENCE NOTICE: file README-LICENCE-utf8.txt at project source root.
+
+This software is being developed by Eric Debreuve, a CNRS employee and
+member of team Morpheme.
+Team Morpheme is a joint team between Inria, CNRS, and UniCA.
+It is hosted by the Centre Inria d'Université Côte d'Azur, Laboratory
+I3S, and Laboratory iBV.
+
+CNRS: https://www.cnrs.fr/index.php/en
+Inria: https://www.inria.fr/en/
+UniCA: https://univ-cotedazur.eu/
+Centre Inria d'Université Côte d'Azur: https://www.inria.fr/en/centre/sophia/
+I3S: https://www.i3s.unice.fr/en/
+iBV: http://ibv.unice.fr/
+Team Morpheme: https://team.inria.fr/morpheme/
+"""

str_to_obj/type/value.py

@@ -1,33 +1,8 @@
-# Copyright CNRS/Inria/UniCA
-# Contributor(s): Eric Debreuve (since 2021)
-#
-# eric.debreuve@cnrs.fr
-#
-# This software is governed by the CeCILL  license under French law and
-# abiding by the rules of distribution of free software.  You can  use,
-# modify and/ or redistribute the software under the terms of the CeCILL
-# license as circulated by CEA, CNRS and INRIA at the following URL
-# "http://www.cecill.info".
-#
-# As a counterpart to the access to the source code and  rights to copy,
-# modify and redistribute granted by the license, users are provided only
-# with a limited warranty  and the software's author,  the holder of the
-# economic rights,  and the successive licensors  have only  limited
-# liability.
-#
-# In this respect, the user's attention is drawn to the risks associated
-# with loading,  using,  modifying and/or developing or reproducing the
-# software by the user in light of its specific status of free software,
-# that may mean  that it is complicated to manipulate,  and  that  also
-# therefore means  that it is reserved for developers  and  experienced
-# professionals having in-depth computer knowledge. Users are therefore
-# encouraged to load and test the software's suitability as regards their
-# requirements in conditions enabling the security of their systems and/or
-# data to be ensured and,  more generally, to use and operate it in the
-# same conditions as regards security.
-#
-# The fact that you are presently reading this means that you have had
-# knowledge of the CeCILL license and that you accept its terms.
+"""
+Copyright CNRS/Inria/UniCA
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+SEE COPYRIGHT NOTICE BELOW
+"""
 
 
 class invalid_value_t:
@@ -45,3 +20,50 @@ class invalid_value_t:
     def __rich__(self) -> str:
         """"""
         return f"[red]{self.__class__.TEXT}[/]"
+
+
+"""
+COPYRIGHT NOTICE
+
+This software is governed by the CeCILL  license under French law and
+abiding by the rules of distribution of free software.  You can  use,
+modify and/ or redistribute the software under the terms of the CeCILL
+license as circulated by CEA, CNRS and INRIA at the following URL
+"http://www.cecill.info".
+
+As a counterpart to the access to the source code and  rights to copy,
+modify and redistribute granted by the license, users are provided only
+with a limited warranty  and the software's author,  the holder of the
+economic rights,  and the successive licensors  have only  limited
+liability.
+
+In this respect, the user's attention is drawn to the risks associated
+with loading,  using,  modifying and/or developing or reproducing the
+software by the user in light of its specific status of free software,
+that may mean  that it is complicated to manipulate,  and  that  also
+therefore means  that it is reserved for developers  and  experienced
+professionals having in-depth computer knowledge. Users are therefore
+encouraged to load and test the software's suitability as regards their
+requirements in conditions enabling the security of their systems and/or
+data to be ensured and,  more generally, to use and operate it in the
+same conditions as regards security.
+
+The fact that you are presently reading this means that you have had
+knowledge of the CeCILL license and that you accept its terms.
+
+SEE LICENCE NOTICE: file README-LICENCE-utf8.txt at project source root.
+
+This software is being developed by Eric Debreuve, a CNRS employee and
+member of team Morpheme.
+Team Morpheme is a joint team between Inria, CNRS, and UniCA.
+It is hosted by the Centre Inria d'Université Côte d'Azur, Laboratory
+I3S, and Laboratory iBV.
+
+CNRS: https://www.cnrs.fr/index.php/en
+Inria: https://www.inria.fr/en/
+UniCA: https://univ-cotedazur.eu/
+Centre Inria d'Université Côte d'Azur: https://www.inria.fr/en/centre/sophia/
+I3S: https://www.i3s.unice.fr/en/
+iBV: http://ibv.unice.fr/
+Team Morpheme: https://team.inria.fr/morpheme/
+"""

str_to_obj/version.py

@@ -4,7 +4,7 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-__version__ = "2024.5"
+__version__ = "2024.6"
 
 
 """

{str_to_obj-2024.5.dist-info → str_to_obj-2024.6.dist-info}/METADATA

@@ -1,18 +1,18 @@
 Metadata-Version: 2.1
 Name: str-to-obj
-Version: 2024.5
+Version: 2024.6
 Summary: Convert strings to Python objects guided by (potentially annotated) type hints
 Home-page: https://src.koda.cnrs.fr/eric.debreuve/str-to-obj/
 Author: Eric Debreuve
 Author-email: eric.debreuve@cnrs.fr
 License: CeCILL-2.1
-Project-URL: Documentation, https://src.koda.cnrs.fr/eric.debreuve/str-to-obj//-/wikis/home
+Project-URL: Documentation, https://src.koda.cnrs.fr/eric.debreuve/str-to-obj/-/wikis/home
 Project-URL: Source, https://src.koda.cnrs.fr/eric.debreuve/str-to-obj/
 Keywords: str,character string,Python object,conversion,type hint,type annotation
 Classifier: Topic :: Software Development
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: CEA CNRS Inria Logiciel Libre License, version 2.1 (CeCILL-2.1)
-Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3
 Classifier: Development Status :: 4 - Beta
 Requires-Python: >=3.11
 Description-Content-Type: text/x-rst
@@ -34,6 +34,9 @@ Requires-Dist: rich
 .. |DOCUMENTATION_URL| replace:: https://src.koda.cnrs.fr/eric.debreuve/str-to-obj/-/wikis/home
 .. _DOCUMENTATION_URL: https://src.koda.cnrs.fr/eric.debreuve/str-to-obj/-/wikis/home
 
+.. |DEPENDENCIES_MANDATORY| replace:: logger_36, rich
+.. |DEPENDENCIES_OPTIONAL|  replace:: None
+
 
 
 ===================================
@@ -42,6 +45,13 @@ Requires-Dist: rich
 
 
 
+Documentation
+=============
+
+The documentation is available at |DOCUMENTATION_URL|_.
+
+
+
 Installation
 ============
 
@@ -51,14 +61,6 @@ at: |PYPI_PROJECT_URL|_.
 It should be installable from Python distribution platforms or Integrated Development Environments (IDEs).
 Otherwise, it can be installed from a command console using `pip <https://pip.pypa.io/>`_:
 
-..
-   - For all users, after acquiring administrative rights:
-       - First installation: ``pip install`` |PYPI_NAME_LITERAL|
-       - Installation update: ``pip install --upgrade`` |PYPI_NAME_LITERAL|
-   - For the current user (no administrative rights required):
-       - First installation: ``pip install --user`` |PYPI_NAME_LITERAL|
-       - Installation update: ``pip install --user --upgrade`` |PYPI_NAME_LITERAL|
-
 +--------------+-------------------------------------------------------+----------------------------------------------------------+
 |              | For all users (after acquiring administrative rights) | For the current user (no administrative rights required) |
 +==============+=======================================================+==========================================================+
@@ -69,27 +71,34 @@ Otherwise, it can be installed from a command console using `pip <https://pip.py
 
 
 
-Documentation
-=============
+Dependencies
+============
 
-The documentation is available at |DOCUMENTATION_URL|_.
+The development relies on several packages:
+
+- Mandatory: |DEPENDENCIES_MANDATORY|
+- Optional:  |DEPENDENCIES_OPTIONAL|
+
+The mandatory dependencies, if any, are installed automatically by `pip <https://pip.pypa.io/>`_, if they are not already, as part of the installation of |PROJECT_NAME|.
+Python distribution platforms or Integrated Development Environments (IDEs) should also take care of this.
+The optional dependencies, if any, must be installed independently by following the related instructions, for added functionalities of |PROJECT_NAME|.
 
 
 
 Acknowledgments
 ===============
 
-The project is developed with `PyCharm Community <https://www.jetbrains.com/pycharm/>`_.
+.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
+    :target: https://github.com/psf/black
+.. image:: https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336
+    :target: https://pycqa.github.io/isort/
 
-The development relies on several open-source packages
-(see ``install_requires`` in ``setup.py``, if present; otherwise ``import`` statements should be searched for).
+The project is developed with `PyCharm Community <https://www.jetbrains.com/pycharm/>`_.
 
 The code is formatted by `Black <https://github.com/psf/black/>`_, *The Uncompromising Code Formatter*.
 
 The imports are ordered by `isort <https://github.com/timothycrosley/isort/>`_... *your imports, so you don't have to*.
 
-
-
 ..
    COPYRIGHT NOTICE
 

str_to_obj-2024.6.dist-info/RECORD

@@ -0,0 +1,26 @@
+str_to_obj/__init__.py,sha256=PCxTXaZiI5pN2HqQPeS4q6r-QgwBrDGwGplHCWACQzA,2318
+str_to_obj/main.py,sha256=ebOat0qc3CQPGXC6RCOLGswDrGuobAziwSCawv6rSK4,3102
+str_to_obj/version.py,sha256=LBCw-ZZUoX13xuS_ZDbgVb5pOKJrbeI-M12p4irxEbU,2206
+str_to_obj/api/catalog.py,sha256=6ka6JciGdHFP93lg0yq2LO3iZBHfq0upZfXxQSg1izk,2521
+str_to_obj/api/type.py,sha256=yxD5wTtnh_h8Wa9_k1eex-nrkjtfh4ZJI6Db6hJHI9w,2468
+str_to_obj/catalog/boolean.py,sha256=7F0E36wQGkOxMMolqN5JF4zWOBJHLU9NDwOPt-LiFjQ,3489
+str_to_obj/catalog/callable.py,sha256=NCoogYzVBUSqiYEj_DoG-szqQdnYhvSj0xdyvg1W7Jw,3626
+str_to_obj/catalog/choices.py,sha256=YvRkgThmUhGVOl-SeNXrVC5Gwg9shCDdU0-dJ9Zk_zw,3798
+str_to_obj/catalog/collection.py,sha256=OkwsgiMFrdvIvLqp1e_bgjBix677knrCSo-vOes86pQ,6767
+str_to_obj/catalog/number.py,sha256=U__ZF9TYMuIlIyY1QHIK2f89cPPCvmrNMhK3sCA7n0E,5461
+str_to_obj/catalog/path.py,sha256=xBrQJ-RMH-y_oaWP-uUTSpIKcL2vrtXoqrSaaS4HRpg,3857
+str_to_obj/interface/console.py,sha256=t_prEhOHOOtsIld5orw2sIfaDjiy_kEO5Xy3Hr0Js3g,3037
+str_to_obj/runtime/type.py,sha256=IGgBgvYu5QrxWKiEEwg5Hn1DNLYZrm6VX7b1o6_OMCI,2288
+str_to_obj/runtime/value.py,sha256=l5I8_Aewu8Yzndnz03dUI_tfN0ZL-hMht2FmDYSUQL8,2268
+str_to_obj/task/casting.py,sha256=GXwnnKnv8420nqlMb5sWkiWula5ZH-UxvWTjyr2Ra98,9138
+str_to_obj/task/comparison.py,sha256=HBzv7gBtOnROsC6Sq-FYpgd_MKzVJreboNiqkza3vJ8,3178
+str_to_obj/task/inspection.py,sha256=M8YnYq4A_Zz7rC2kgTYSSSawTnG2dCug5FBoCOBJ5g8,3127
+str_to_obj/type/annotation.py,sha256=xXShME2Q344N3QlsqKtU6ttne54tTVC3b62CHU1TGUM,3838
+str_to_obj/type/hint.py,sha256=w-yos8eD4CHQsXPfnqeqAc-ozyDWqzw46FOWDtAh7dM,2810
+str_to_obj/type/hint_tree.py,sha256=hm0JbEXc5lPl0djiBj0tksmfmZaeFtpo_qtZv1uXe7s,6690
+str_to_obj/type/type.py,sha256=ywc7GpzM1BsoQ3F0qk4wZ2DG1KZllw-PNv_umIGt8hA,4147
+str_to_obj/type/value.py,sha256=r9Ko5HHant1JGbsO7vH1unRBr9guc61Jz2piuJT0BjM,2533
+str_to_obj-2024.6.dist-info/METADATA,sha256=uHOtXMI95EtKqHF57ML92wyg_GC6P_pepvKWKCYqWsE,6464
+str_to_obj-2024.6.dist-info/WHEEL,sha256=y4mX-SOX4fYIkonsAGA5N0Oy-8_gI4FXw5HNI1xqvWg,91
+str_to_obj-2024.6.dist-info/top_level.txt,sha256=h-6bR_TAnXRGVSLTeNPlivlaG64xYM3E__Xg7sCgeug,11
+str_to_obj-2024.6.dist-info/RECORD,,

str_to_obj-2024.5.dist-info/RECORD

@@ -1,24 +0,0 @@
-str_to_obj/__init__.py,sha256=kNBfT5wXbdCVGkV3X5dsFRQlyKOZNWkcQZ66qVQuOvM,2457
-str_to_obj/main.py,sha256=5XDr99VfwrHeK1cCbfsjRymYGVWhdTOX6zv37mw28uY,3112
-str_to_obj/version.py,sha256=NNneOcdXXTxq3qKXidOnjqxIrjRPEVAwvDcfyhRAkOg,2206
-str_to_obj/catalog/boolean.py,sha256=7F0E36wQGkOxMMolqN5JF4zWOBJHLU9NDwOPt-LiFjQ,3489
-str_to_obj/catalog/callable.py,sha256=NCoogYzVBUSqiYEj_DoG-szqQdnYhvSj0xdyvg1W7Jw,3626
-str_to_obj/catalog/choices.py,sha256=YvRkgThmUhGVOl-SeNXrVC5Gwg9shCDdU0-dJ9Zk_zw,3798
-str_to_obj/catalog/collection.py,sha256=rceqOpiTRX9YqYoZGr0DNlVxSEv5nVOQeQUCCk_aCVc,6809
-str_to_obj/catalog/number.py,sha256=U__ZF9TYMuIlIyY1QHIK2f89cPPCvmrNMhK3sCA7n0E,5461
-str_to_obj/catalog/path.py,sha256=xBrQJ-RMH-y_oaWP-uUTSpIKcL2vrtXoqrSaaS4HRpg,3857
-str_to_obj/interface/console.py,sha256=jiN5ffXfMo_N4Me2BHGZyau9yfR_H9xAnrJMMK3q6Dg,3038
-str_to_obj/runtime/type.py,sha256=IGgBgvYu5QrxWKiEEwg5Hn1DNLYZrm6VX7b1o6_OMCI,2288
-str_to_obj/runtime/value.py,sha256=l5I8_Aewu8Yzndnz03dUI_tfN0ZL-hMht2FmDYSUQL8,2268
-str_to_obj/task/casting.py,sha256=n_GffWFlNPlN9xhevq4_VOqaQsI-jWkXDTBTGhDNz7w,9232
-str_to_obj/task/comparison.py,sha256=UfAagi4dYtOstJYW9V4B3lZ3jwMVDMVZI1xk5hzrJ2I,3193
-str_to_obj/task/inspection.py,sha256=M8YnYq4A_Zz7rC2kgTYSSSawTnG2dCug5FBoCOBJ5g8,3127
-str_to_obj/type/annotation.py,sha256=dmLMtOnbP4NP7pPYEy9r7YhHF21EoTyz2BaO4vkB7qk,3216
-str_to_obj/type/hint.py,sha256=jlQgGosqoszkreJYFS_pga5RpqrUiLYALoxtzrB5rPU,2180
-str_to_obj/type/hint_tree.py,sha256=3q_XifljQPj4MVv5SIfggugTUNcq0KT5RJoXxJ3G_UQ,6126
-str_to_obj/type/type.py,sha256=6KZgHRKZi1zzJ9KiW2LLvUXVr0EALUM4Yz8cwvgFeBg,3459
-str_to_obj/type/value.py,sha256=9sXtYf0kVHVpcczS_ZtVZa9_M17pIlYSZjYYE33sS1Y,1904
-str_to_obj-2024.5.dist-info/METADATA,sha256=tT9oruU9zK7_KdbTNj-XPl4A9_wFvtjCvy4Pi9NFBwA,6130
-str_to_obj-2024.5.dist-info/WHEEL,sha256=y4mX-SOX4fYIkonsAGA5N0Oy-8_gI4FXw5HNI1xqvWg,91
-str_to_obj-2024.5.dist-info/top_level.txt,sha256=h-6bR_TAnXRGVSLTeNPlivlaG64xYM3E__Xg7sCgeug,11
-str_to_obj-2024.5.dist-info/RECORD,,