preparse 1.1.5__tar.gz → 1.1.7__tar.gz

{preparse-1.1.5 → preparse-1.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: preparse
-Version: 1.1.5
+Version: 1.1.7
 Summary: This project preparses args for further parsing later on.
 Author-email: Johannes <johannes.programming@gmail.com>
 License-Expression: MIT
@@ -24,7 +24,7 @@ Requires-Dist: copyable<2,>=1.1
 Requires-Dist: datahold<4,>=3.0
 Requires-Dist: datarepr<2,>=1.2
 Requires-Dist: frozendict<3,>=2.4.7
-Requires-Dist: setdoc<2,>=1.3
+Requires-Dist: setdoc<2,>=1.3.11
 Requires-Dist: tofunc<2,>=1.1
 Dynamic: license-file
 

{preparse-1.1.5 → preparse-1.1.7}/docs/v1.1.rst

@@ -17,7 +17,7 @@ Open your terminal and run:
 Typing
 ------
 
-The typing conforms (not strictly) to ``mypy``.
+The typing conforms strictly to ``mypy``.
 
 .. container:: versionadded
 

{preparse-1.1.5 → preparse-1.1.7}/pyproject.toml

@@ -24,7 +24,7 @@ dependencies = [
     "datahold>=3.0,<4",
     "datarepr>=1.2,<2",
     "frozendict>=2.4.7,<3",
-    "setdoc>=1.3,<2",
+    "setdoc>=1.3.11,<2",
     "tofunc>=1.1,<2",
 ]
 description = "This project preparses args for further parsing later on."
@@ -36,7 +36,7 @@ license-files = [
 name = "preparse"
 readme = "README.rst"
 requires-python = ">=3.11"
-version = "1.1.5"
+version = "1.1.7"
 
 [project.urls]
 Download = "https://pypi.org/project/preparse/#files"
@@ -49,4 +49,4 @@ files = [
     ".",
 ]
 python_version = "3.11"
-strict = false
+strict = true

preparse-1.1.7/src/preparse/__init__.py

@@ -0,0 +1,16 @@
+from preparse.core.PreParser import PreParser
+from preparse.enums.Nargs import Nargs
+from preparse.enums.Tuning import Tuning
+from preparse.warnings.PreparseAmbiguousOptionWarning import (
+    PreparseAmbiguousOptionWarning,
+)
+from preparse.warnings.PreparseInvalidOptionWarning import (
+    PreparseInvalidOptionWarning,
+)
+from preparse.warnings.PreparseRequiredArgumentWarning import (
+    PreparseRequiredArgumentWarning,
+)
+from preparse.warnings.PreparseUnallowedArgumentWarning import (
+    PreparseUnallowedArgumentWarning,
+)
+from preparse.warnings.PreparseWarning import PreparseWarning

{preparse-1.1.5 → preparse-1.1.7}/src/preparse/_items/Bundle.py

@@ -1,10 +1,9 @@
-from typing import *
+from typing import Any, Optional, Self
 
 import setdoc
 
-from preparse._items.Item import Item
 from preparse._items.Option import Option
-from preparse.core.enums import *
+from preparse.enums.Nargs import Nargs
 
 __all__ = ["Bundle"]
 

{preparse-1.1.5 → preparse-1.1.7}/src/preparse/_items/Item.py

@@ -1,11 +1,9 @@
 import abc
-from typing import *
+from typing import Any, Self
 
 import setdoc
 from copyable import Copyable
 
-from preparse.core.enums import *
-
 __all__ = ["Item"]
 
 
@@ -29,9 +27,9 @@ class Item(Copyable):
 
     @classmethod
     @abc.abstractmethod
-    def sortkey(cls: type) -> int: ...
+    def sortkey(cls: type[Self]) -> int: ...
 
-    def todict(self: Self) -> dict:
+    def todict(self: Self) -> dict[str, Any]:
         "This method returns a dict representing the current instance."
         ans: dict[str, Any]
         x: str

{preparse-1.1.5 → preparse-1.1.7}/src/preparse/_items/Long.py

@@ -1,10 +1,9 @@
 import operator
-from typing import *
+from typing import Any, Optional, Self, SupportsIndex
 
 import setdoc
 
 from preparse._items.Option import Option
-from preparse.core.enums import *
 
 __all__ = ["Long"]
 

{preparse-1.1.5 → preparse-1.1.7}/src/preparse/_items/Option.py

@@ -1,8 +1,8 @@
 import operator
-from typing import *
+from typing import Optional, Self, SupportsIndex
 
 from preparse._items.Item import Item
-from preparse.core.enums import *
+from preparse.enums.Nargs import Nargs
 
 __all__ = ["Option"]
 
@@ -11,9 +11,9 @@ class Option(Item):
 
     __slots__ = ()
 
-    _joined: Any
-    _nargs: Any
-    _right: Any
+    _joined: bool
+    _nargs: Nargs
+    _right: Optional[str]
 
     def ishungry(self: Self) -> bool:
         return (self.right is None) and (self.nargs == Nargs.REQUIRED_ARGUMENT)
@@ -23,28 +23,25 @@ class Option(Item):
         return self._joined
 
     @joined.setter
-    def joined(self: Self, x: SupportsIndex) -> None:
-        self._joined = bool(operator.index(x))
+    def joined(self: Self, x: SupportsIndex, /) -> None:
+        self._joined = bool(operator.index(x))  # type: ignore[misc]
 
     @property
     def nargs(self: Self) -> Nargs:
         return self._nargs
 
     @nargs.setter
-    def nargs(self: Self, x: Any) -> None:
-        self._nargs = Nargs(x)
+    def nargs(self: Self, x: int, /) -> None:
+        self._nargs = Nargs(x)  # type: ignore[misc]
 
     @property
     def right(self: Self) -> Optional[str]:
         return self._right
 
     @right.setter
-    def right(self: Self, x: Any) -> None:
-        if x is None:
-            self._right = None
-        else:
-            self._right = str(x)
+    def right(self: Self, x: object, /) -> None:
+        self._right = None if x is None else str(x)  # type: ignore[misc]
 
     @classmethod
-    def sortkey(cls: type) -> int:
+    def sortkey(cls: type[Self]) -> int:
         return 0

{preparse-1.1.5 → preparse-1.1.7}/src/preparse/_items/Positional.py

@@ -1,9 +1,8 @@
-from typing import *
+from typing import Any, Self
 
 import setdoc
 
 from preparse._items.Item import Item
-from preparse.core.enums import *
 
 __all__ = ["Positional"]
 
@@ -27,7 +26,7 @@ class Positional(Item):
         return self.value == "-" or not self.value.startswith("-")
 
     @classmethod
-    def sortkey(cls: type) -> int:
+    def sortkey(cls: type[Self]) -> int:
         return 2
 
     @property
@@ -35,5 +34,5 @@ class Positional(Item):
         return self._value
 
     @value.setter
-    def value(self: Self, x: Any) -> None:
+    def value(self: Self, x: object) -> None:
         self._value = str(x)

{preparse-1.1.5 → preparse-1.1.7}/src/preparse/_items/Special.py

@@ -1,9 +1,8 @@
-from typing import *
+from typing import Self
 
 import setdoc
 
 from preparse._items.Item import Item
-from preparse.core.enums import *
 
 __all__ = ["Special"]
 

{preparse-1.1.5 → preparse-1.1.7}/src/preparse/_processing/__init__.py

@@ -1,14 +1,13 @@
 from collections.abc import Iterable
 from types import FunctionType
-from typing import Optional
+from typing import Any, Optional
 
-from preparse._items import *
-from preparse._processing.deparsing import *
-from preparse._processing.digesting import *
-from preparse._processing.parsing import *
-from preparse._processing.pulling import *
-from preparse._utils import *
-from preparse.core.enums import *
+from preparse._items.Item import Item
+from preparse._processing.deparsing import deparse
+from preparse._processing.digesting import digest
+from preparse._processing.parsing import parse
+from preparse._processing.pulling import pull
+from preparse.enums.Tuning import Tuning
 
 __all__ = ["process"]
 
@@ -22,7 +21,7 @@ def process(
     expandsabbr: bool,
     expectsabbr: bool,
     expectsposix: bool,
-    optdict: dict,
+    optdict: dict[Any, Any],
     prog: str,
     reconcilesorders: bool,
     special: Tuning,

{preparse-1.1.5 → preparse-1.1.7}/src/preparse/_processing/deparsing.py

@@ -1,5 +1,3 @@
-from typing import *
-
 from preparse._items.Item import Item
 
 __all__ = ["deparse"]

{preparse-1.1.5 → preparse-1.1.7}/src/preparse/_processing/digesting.py

@@ -1,4 +1,4 @@
-from typing import *
+from typing import Any
 
 from preparse._items.Bundle import Bundle
 from preparse._items.Item import Item
@@ -6,8 +6,7 @@ from preparse._items.Long import Long
 from preparse._items.Option import Option
 from preparse._items.Positional import Positional
 from preparse._items.Special import Special
-from preparse.core.enums import *
-from preparse.core.warnings import *
+from preparse.enums.Tuning import Tuning
 
 __all__ = ["digest"]
 

{preparse-1.1.5 → preparse-1.1.7}/src/preparse/_processing/parsing.py

@@ -6,18 +6,23 @@ from preparse._items.Bundle import Bundle
 from preparse._items.Item import Item
 from preparse._items.Long import Long
 from preparse._items.Option import Option
-from preparse._items.Positional import Positional
 from preparse._items.Special import Special
-from preparse.core import warnings
-from preparse.core.enums import *
+from preparse.enums.Nargs import Nargs
+from preparse.warnings.PreparseAmbiguousOptionWarning import (
+    PreparseAmbiguousOptionWarning as PAOW,
+)
+from preparse.warnings.PreparseInvalidOptionWarning import (
+    PreparseInvalidOptionWarning as PIOW,
+)
+from preparse.warnings.PreparseRequiredArgumentWarning import (
+    PreparseRequiredArgumentWarning as PRAW,
+)
+from preparse.warnings.PreparseUnallowedArgumentWarning import (
+    PreparseUnallowedArgumentWarning as PUAW,
+)
 
 __all__ = ["parse"]
 
-PAOW = warnings.PreparseAmbiguousOptionWarning
-PIOW = warnings.PreparseInvalidOptionWarning
-PUAW = warnings.PreparseUnallowedArgumentWarning
-PRAW = warnings.PreparseRequiredArgumentWarning
-
 
 def parse(args: list[Item], **kwargs: Any) -> list[Item]:
     return list(parse_generator(args, **kwargs))

{preparse-1.1.5 → preparse-1.1.7}/src/preparse/_tests/expit.py

@@ -1,9 +1,8 @@
 import math
-from typing import *
 
 import click
 
-from preparse.core import *
+from preparse.core.PreParser import PreParser
 
 __all__ = ["function", "main"]
 

{preparse-1.1.5 → preparse-1.1.7}/src/preparse/core/Click.py

@@ -44,7 +44,7 @@ class Click(Copyable):
         return ans
 
     def _call_method(self: Self, target: types.MethodType) -> types.MethodType:
-        func: Callable
+        func: Callable[..., Any]
         func = self(target.__func__)
         return types.MethodType(func, target.__self__)
 

{preparse-1.1.5 → preparse-1.1.7}/src/preparse/core/Optdict.py

@@ -1,5 +1,5 @@
 from collections.abc import Hashable
-from typing import Any, Optional, Self
+from typing import Any, Optional, Self, cast
 
 import cmp3
 import datahold
@@ -7,7 +7,7 @@ import setdoc
 from datarepr import datarepr
 from frozendict import frozendict
 
-from preparse.core.enums import Nargs
+from preparse.enums.Nargs import Nargs
 
 __all__ = ["Optdict"]
 
@@ -27,9 +27,14 @@ class Optdict(cmp3.CmpABC, datahold.HoldDict[str, Nargs]):
     @setdoc.basic
     def __cmp__(self: Self, other: Any, /) -> Optional[int]:
         if type(self) is type(other):
-            return cmp3.cmp(self._data, other._data, mode="eq_strict")
+            return cast(
+                Optional[int],
+                cmp3.cmp(self._data, other._data, mode="eq_strict"),
+            )
         else:
-            return cmp3.cmp(self._data, other, mode="eq_strict")
+            return cast(
+                Optional[int], cmp3.cmp(self._data, other, mode="eq_strict")
+            )
 
     __format__ = object.__format__
 
@@ -50,8 +55,8 @@ class Optdict(cmp3.CmpABC, datahold.HoldDict[str, Nargs]):
     @data.setter
     def data(self: Self, value: Any) -> None:
         a: frozendict[Hashable, object]
-        x: map
-        y: map
+        x: map[str]
+        y: map[Nargs]
         a = frozendict(value)
         x = map(str, a.keys())
         y = map(nargs, a.values())

{preparse-1.1.5 → preparse-1.1.7}/src/preparse/core/PreParser.py

@@ -8,15 +8,15 @@ from typing import Any, Optional, Self, cast
 import click as cl
 import setdoc
 from copyable import Copyable
-from datarepr import datarepr  # type: ignore[attr-defined]
-from tofunc import tofunc  # type: ignore[attr-defined]
+from datarepr import datarepr
+from tofunc import tofunc
 
-from preparse._processing import *
-from preparse._utils.dataprop import dataprop
+from preparse._processing import process
 from preparse.core.Click import Click
-from preparse.core.enums import *
 from preparse.core.Optdict import Optdict
-from preparse.core.warnings import PreparseWarning
+from preparse.enums.Nargs import Nargs
+from preparse.enums.Tuning import Tuning
+from preparse.warnings.PreparseWarning import PreparseWarning
 
 __all__ = ["PreParser"]
 
@@ -36,7 +36,7 @@ class PreParser(Copyable):
         expectsabbr: Any = True,
         expectsposix: Any = False,
         optdict: Any = (),
-        prog: Any = None,
+        prog: object = None,
         reconcilesorders: Any = True,
         special: Any = Tuning.MAINTAIN,
         warn: Callable = str,  # type: ignore[type-arg]
@@ -59,18 +59,31 @@ class PreParser(Copyable):
     def __repr__(self: Self) -> str:
         return datarepr(type(self).__name__, **self.todict())
 
-    @dataprop
-    def allowslong(self: Self, value: Any) -> bool:
-        return bool(value)
+    @property
+    def allowslong(self: Self) -> bool:
+        return cast(bool, self._data["allowslong"])
 
-    @dataprop
-    def allowsshort(self: Self, value: Any) -> bool:
-        return bool(value)
+    @allowslong.setter
+    def allowslong(self: Self, value: Any) -> None:
+        self._data["allowslong"] = bool(value)
 
-    @dataprop
-    def bundling(self: Self, value: int) -> Tuning:
+    @property
+    def allowsshort(self: Self) -> bool:
+        return cast(bool, self._data["allowsshort"])
+
+    @allowsshort.setter
+    def allowsshort(self: Self, value: Any) -> None:
+        self._data["allowsshort"] = bool(value)
+
+    @property
+    def bundling(self: Self) -> Tuning:
+        "This property decides how to approach the bundling of short options."
+        return cast(Tuning, self._data["bundling"])
+
+    @bundling.setter
+    def bundling(self: Self, value: int) -> None:
         "This property decides how to approach the bundling of short options."
-        return Tuning(value)
+        self._data["bundling"] = Tuning(value)
 
     def click(self: Self, cmd: Any = True, ctx: Any = True) -> Click:
         "This method returns a decorator that infuses the current instance into parse_args."
@@ -80,31 +93,49 @@ class PreParser(Copyable):
     def copy(self: Self) -> Self:
         return type(self)(**self.todict())
 
-    @dataprop
-    def expandsabbr(self: Self, value: Any) -> bool:
-        return bool(value)
+    @property
+    def expandsabbr(self: Self) -> bool:
+        return cast(bool, self._data["expandsabbr"])
+
+    @expandsabbr.setter
+    def expandsabbr(self: Self, value: Any, /) -> None:
+        self._data["expandsabbr"] = bool(value)
+
+    @property
+    def expectsabbr(self: Self) -> bool:
+        return cast(bool, self._data["expectsabbr"])
 
-    @dataprop
-    def expectsabbr(self: Self, value: Any) -> bool:
-        return bool(value)
+    @expectsabbr.setter
+    def expectsabbr(self: Self, value: Any) -> None:
+        self._data["expectsabbr"] = bool(value)
 
-    @dataprop
-    def expectsposix(self: Self, value: Any) -> bool:
+    @property
+    def expectsposix(self: Self) -> bool:
+        return cast(bool, self._data["expectsposix"])
+
+    @expectsposix.setter
+    def expectsposix(self: Self, value: Any) -> None:
+        value_: Any
         if value == "infer":
-            return bool(os.environ.get("POSIXLY_CORRECT"))
+            value_ = os.environ.get("POSIXLY_CORRECT")
         else:
-            return bool(value)
+            value_ = value
+        self._data["expectsposix"] = bool(value_)
+
+    @property
+    def optdict(self: Self) -> Optdict:
+        "This property gives a dictionary of options."
+        return cast(Optdict, self._data["optdict"])
 
-    @dataprop
-    def optdict(self: Self, value: Any) -> Optdict:
+    @optdict.setter
+    def optdict(self: Self, value: Any) -> None:
         "This property gives a dictionary of options."
-        dataA: Optdict
+        value_: Optdict
         if "optdict" not in self._data.keys():
             self._data["optdict"] = Optdict()
-        dataA = Optdict(value)
+        value_ = Optdict(value)
         self._data["optdict"].clear()
-        self._data["optdict"].update(dataA)
-        return cast(Optdict, self._data["optdict"])
+        self._data["optdict"].update(value_)
 
     def parse_args(
         self: Self,
@@ -113,17 +144,26 @@ class PreParser(Copyable):
         "This method parses args."
         return process(args, **self.todict())
 
-    @dataprop
-    def prog(self: Self, value: Any) -> str:
+    @property
+    def prog(self: Self) -> str:
+        "This property represents the name of the program."
+        return cast(str, self._data["prog"])
+
+    @prog.setter
+    def prog(self: Self, value: object, /) -> None:
         "This property represents the name of the program."
         if value is None:
-            return str(os.path.basename(sys.argv[0]))
+            self._data["prog"] = str(os.path.basename(sys.argv[0]))
         else:
-            return str(value)
+            self._data["prog"] = str(value)
+
+    @property
+    def reconcilesorders(self: Self) -> bool:
+        return cast(bool, self._data["reconcilesorders"])
 
-    @dataprop
-    def reconcilesorders(self: Self, value: Any) -> bool:
-        return bool(value)
+    @reconcilesorders.setter
+    def reconcilesorders(self: Self, value: Any, /) -> None:
+        self._data["reconcilesorders"] = bool(value)
 
     def reflectClickCommand(self: Self, cmd: cl.Command) -> None:
         "This method causes the current instance to reflect a click.Command object."
@@ -150,10 +190,15 @@ class PreParser(Copyable):
         "This method causes the current instance to reflect a click.Context object."
         self.prog = ctx.info_name
 
-    @dataprop
-    def special(self: Self, value: int) -> Tuning:
+    @property
+    def special(self: Self) -> Tuning:
+        "This Tuning property determines the approach towards the special argument."
+        return cast(Tuning, self._data["special"])
+
+    @special.setter
+    def special(self: Self, value: int, /) -> None:
         "This Tuning property determines the approach towards the special argument."
-        return Tuning(value)
+        self._data["special"] = Tuning(value)
 
     def todict(self: Self) -> dict[str, Any]:
         "This method returns a dict representing the current instance."
@@ -166,10 +211,17 @@ class PreParser(Copyable):
         else:
             return dict(ans)
 
-    @dataprop
+    @property
     def warn(
         self: Self,
-        value: Callable[[PreparseWarning], Any],
     ) -> Callable[[PreparseWarning], Any]:
         "This property gives a function that takes in the warnings."
-        return tofunc(value)
+        return cast(Callable[[PreparseWarning], Any], self._data["warn"])
+
+    @warn.setter
+    def warn(
+        self: Self,
+        value: Callable[[PreparseWarning], Any],
+    ) -> None:
+        "This property gives a function that takes in the warnings."
+        self._data["warn"] = tofunc(value)

preparse-1.1.7/src/preparse/enums/BaseEnum.py

@@ -0,0 +1,10 @@
+import enum
+from typing import Self
+
+__all__ = ["BaseEnum"]
+
+
+class BaseEnum(enum.IntEnum):
+    @classmethod
+    def _missing_(cls: type[Self], value: object) -> Self:
+        return cls(2)

preparse-1.1.7/src/preparse/enums/Nargs.py

@@ -0,0 +1,9 @@
+from ..enums.BaseEnum import BaseEnum
+
+__all__ = ["Nargs"]
+
+
+class Nargs(BaseEnum):
+    NO_ARGUMENT = 0
+    REQUIRED_ARGUMENT = 1
+    OPTIONAL_ARGUMENT = 2

preparse-1.1.7/src/preparse/enums/Tuning.py

@@ -0,0 +1,9 @@
+from ..enums.BaseEnum import BaseEnum
+
+__all__ = ["Tuning"]
+
+
+class Tuning(BaseEnum):
+    MINIMIZE = 0
+    MAXIMIZE = 1
+    MAINTAIN = 2

preparse-1.1.7/src/preparse/enums/__init__.py

@@ -0,0 +1,4 @@
+"""This module holds the enums for the project. \
+Following the precedent of getopt, \
+the value of two represents always an intermediary answer \
+between the values zero, meaning no, and one, meaning yes."""

{preparse-1.1.5 → preparse-1.1.7}/src/preparse/tests/test_data_toml.py

@@ -3,9 +3,9 @@ import math
 import tomllib
 import unittest
 from importlib import resources
-from typing import *
+from typing import Any, Self
 
-from preparse.core import *
+from preparse.core.PreParser import PreParser
 
 __all__ = ["TestDataToml"]
 

{preparse-1.1.5 → preparse-1.1.7}/src/preparse/tests/test_enums.py

@@ -1,7 +1,7 @@
 import unittest
 from typing import Self
 
-from preparse.core.enums import *
+from preparse.enums.Nargs import Nargs
 
 __all__ = ["TestEnums"]
 

{preparse-1.1.5 → preparse-1.1.7}/src/preparse/tests/test_expit_toml.py

@@ -8,7 +8,6 @@ from typing import Any, Self
 from click.testing import CliRunner
 
 from preparse._tests import expit
-from preparse.core import *
 
 __all__ = ["TestMainFunction"]
 

{preparse-1.1.5 → preparse-1.1.7}/src/preparse/tests/test_optdict.py

@@ -1,9 +1,7 @@
 import unittest
 from typing import Self
 
-from preparse.core.enums import *
 from preparse.core.Optdict import Optdict
-from preparse.core.warnings import *
 
 __all__ = ["TestPreparse"]
 

{preparse-1.1.5 → preparse-1.1.7}/src/preparse/tests/test_preparser.py

@@ -2,9 +2,7 @@ import unittest
 from typing import Any, Self
 
 from preparse.core.Click import Click
-from preparse.core.enums import *
 from preparse.core.PreParser import PreParser
-from preparse.core.warnings import *
 
 __all__ = ["TestPreparse"]
 

preparse-1.1.7/src/preparse/warnings/PreparseAmbiguousOptionWarning.py

@@ -0,0 +1,40 @@
+from collections.abc import Iterable
+from typing import Any, Self, cast
+
+import setdoc
+
+from preparse.warnings.PreparseLongonlyWarning import PreparseLongonlyWarning
+
+__all__ = ["PreparseAmbiguousOptionWarning"]
+
+
+class PreparseAmbiguousOptionWarning(PreparseLongonlyWarning):
+
+    @setdoc.basic
+    def __post_init__(
+        self: Self,
+        *,
+        prog: Any,
+        option: Any,
+        possibilities: Iterable[object],
+    ) -> None:
+        self.prog = prog
+        self.option = option
+        self.possibilities = possibilities
+
+    def getmsg(self: Self) -> str:
+        "This method returns the core message."
+        ans: str
+        x: Any
+        ans = "option '%s' is ambiguous; possibilities:" % self.option
+        for x in self.possibilities:
+            ans += " '%s'" % x
+        return ans
+
+    @property
+    def possibilities(self: Self) -> tuple[str, ...]:
+        return cast(tuple[str, ...], self._data["possibilities"])
+
+    @possibilities.setter
+    def possibilities(self: Self, value: Iterable[object]) -> None:
+        self._data["possibilities"] = tuple(map(str, value))

preparse-1.1.7/src/preparse/warnings/PreparseDualWarning.py

@@ -0,0 +1,42 @@
+from abc import abstractmethod
+from typing import Any, Self, cast
+
+import setdoc
+
+from preparse.warnings.PreparseWarning import PreparseWarning
+
+__all__ = ["PreparseDualWarning"]
+
+
+class PreparseDualWarning(PreparseWarning):
+
+    @setdoc.basic
+    def __post_init__(
+        self: Self, *, prog: Any, option: Any, islong: Any
+    ) -> None:
+        self.prog = prog
+        self.option = option
+        self.islong = islong
+
+    @classmethod
+    @abstractmethod
+    def _longmsg(cls: type[Self]) -> str: ...
+
+    @classmethod
+    @abstractmethod
+    def _shortmsg(cls: type[Self]) -> str: ...
+
+    def getmsg(self: Self) -> str:
+        "This method returns the core message."
+        if self.islong:
+            return self._longmsg() % self.option
+        else:
+            return self._shortmsg() % self.option
+
+    @property
+    def islong(self: Self) -> bool:
+        return cast(bool, self._data["islong"])
+
+    @islong.setter
+    def islong(self: Self, value: Any) -> None:
+        self._data["islong"] = bool(value)

preparse-1.1.7/src/preparse/warnings/PreparseInvalidOptionWarning.py

@@ -0,0 +1,16 @@
+from typing import Self
+
+from preparse.warnings.PreparseDualWarning import PreparseDualWarning
+
+__all__ = ["PreparseInvalidOptionWarning"]
+
+
+class PreparseInvalidOptionWarning(PreparseDualWarning):
+
+    @classmethod
+    def _longmsg(cls: type[Self]) -> str:
+        return "unrecognized option '%s'"
+
+    @classmethod
+    def _shortmsg(cls: type[Self]) -> str:
+        return "invalid option -- '%s'"

preparse-1.1.7/src/preparse/warnings/PreparseLongonlyWarning.py

@@ -0,0 +1,7 @@
+from preparse.warnings.PreparseWarning import PreparseWarning
+
+__all__ = ["PreparseLongonlyWarning"]
+
+
+class PreparseLongonlyWarning(PreparseWarning):
+    pass  # only possible for long options

preparse-1.1.7/src/preparse/warnings/PreparseRequiredArgumentWarning.py

@@ -0,0 +1,16 @@
+from typing import Self
+
+from preparse.warnings.PreparseDualWarning import PreparseDualWarning
+
+__all__ = ["PreparseRequiredArgumentWarning"]
+
+
+class PreparseRequiredArgumentWarning(PreparseDualWarning):
+
+    @classmethod
+    def _longmsg(cls: type[Self]) -> str:
+        return "option '%s' requires an argument"
+
+    @classmethod
+    def _shortmsg(cls: type[Self]) -> str:
+        return "option requires an argument -- '%s'"

preparse-1.1.7/src/preparse/warnings/PreparseUnallowedArgumentWarning.py

@@ -0,0 +1,21 @@
+from typing import Any, Self
+
+import setdoc
+
+from preparse.warnings.PreparseLongonlyWarning import PreparseLongonlyWarning
+
+__all__ = ["PreparseUnallowedArgumentWarning"]
+
+
+class PreparseUnallowedArgumentWarning(PreparseLongonlyWarning):
+
+    # option is always full key without value
+
+    @setdoc.basic
+    def __post_init__(self: Self, *, prog: Any, option: Any) -> None:
+        self.prog = prog
+        self.option = option
+
+    def getmsg(self: Self) -> str:
+        "This method returns the core message."
+        return "option '%s' doesn't allow an argument" % self.option

preparse-1.1.7/src/preparse/warnings/PreparseWarning.py

@@ -0,0 +1,65 @@
+from abc import abstractmethod
+from typing import Any, Self, cast
+
+import setdoc
+from copyable import Copyable
+from datarepr import datarepr
+
+__all__ = ["PreparseWarning"]
+
+
+class PreparseWarning(Warning, Copyable):
+
+    _data: dict[str, Any]
+
+    @setdoc.basic
+    def __init__(self: Self, **kwargs: Any) -> None:
+        Warning.__init__(self)
+        self._data = dict()
+        self.__post_init__(**kwargs)
+
+    @abstractmethod
+    @setdoc.basic
+    def __post_init__(self: Self, **kwargs: Any) -> None: ...
+
+    @setdoc.basic
+    def __repr__(self: Self) -> str:
+        return datarepr(type(self).__name__, **self.todict())
+
+    @setdoc.basic
+    def __str__(self: Self) -> str:
+        return f"{self.prog}: {self.getmsg()}"
+
+    @setdoc.basic
+    def copy(self: Self) -> Self:
+        return type(self)(**self.todict())
+
+    @abstractmethod
+    def getmsg(self: Self) -> str: ...
+
+    @property
+    def option(self: Self) -> str:
+        return cast(str, self._data["option"])
+
+    @option.setter
+    def option(self: Self, value: object) -> None:
+        self._data["option"] = str(value)
+
+    @property
+    def prog(self: Self) -> str:
+        return cast(str, self._data["prog"])
+
+    @prog.setter
+    def prog(self: Self, value: object) -> None:
+        self._data["prog"] = str(value)
+
+    def todict(self: Self) -> dict[str, Any]:
+        "This method returns a dict representing the current instance."
+        ans: dict[str, Any]
+        try:
+            ans = self._data
+        except AttributeError:
+            self._data = dict()
+            return dict()
+        else:
+            return dict(ans)

{preparse-1.1.5 → preparse-1.1.7}/src/preparse.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: preparse
-Version: 1.1.5
+Version: 1.1.7
 Summary: This project preparses args for further parsing later on.
 Author-email: Johannes <johannes.programming@gmail.com>
 License-Expression: MIT
@@ -24,7 +24,7 @@ Requires-Dist: copyable<2,>=1.1
 Requires-Dist: datahold<4,>=3.0
 Requires-Dist: datarepr<2,>=1.2
 Requires-Dist: frozendict<3,>=2.4.7
-Requires-Dist: setdoc<2,>=1.3
+Requires-Dist: setdoc<2,>=1.3.11
 Requires-Dist: tofunc<2,>=1.1
 Dynamic: license-file
 

{preparse-1.1.5 → preparse-1.1.7}/src/preparse.egg-info/SOURCES.txt

@@ -26,14 +26,14 @@ src/preparse/_processing/parsing.py
 src/preparse/_processing/pulling.py
 src/preparse/_tests/__init__.py
 src/preparse/_tests/expit.py
-src/preparse/_utils/__init__.py
-src/preparse/_utils/dataprop.py
 src/preparse/core/Click.py
 src/preparse/core/Optdict.py
 src/preparse/core/PreParser.py
 src/preparse/core/__init__.py
-src/preparse/core/enums.py
-src/preparse/core/warnings.py
+src/preparse/enums/BaseEnum.py
+src/preparse/enums/Nargs.py
+src/preparse/enums/Tuning.py
+src/preparse/enums/__init__.py
 src/preparse/tests/__init__.py
 src/preparse/tests/data.toml
 src/preparse/tests/expit.toml
@@ -41,4 +41,12 @@ src/preparse/tests/test_data_toml.py
 src/preparse/tests/test_enums.py
 src/preparse/tests/test_expit_toml.py
 src/preparse/tests/test_optdict.py
-src/preparse/tests/test_preparser.py
+src/preparse/tests/test_preparser.py
+src/preparse/warnings/PreparseAmbiguousOptionWarning.py
+src/preparse/warnings/PreparseDualWarning.py
+src/preparse/warnings/PreparseInvalidOptionWarning.py
+src/preparse/warnings/PreparseLongonlyWarning.py
+src/preparse/warnings/PreparseRequiredArgumentWarning.py
+src/preparse/warnings/PreparseUnallowedArgumentWarning.py
+src/preparse/warnings/PreparseWarning.py
+src/preparse/warnings/__init__.py

{preparse-1.1.5 → preparse-1.1.7}/src/preparse.egg-info/requires.txt

@@ -4,5 +4,5 @@ copyable<2,>=1.1
 datahold<4,>=3.0
 datarepr<2,>=1.2
 frozendict<3,>=2.4.7
-setdoc<2,>=1.3
+setdoc<2,>=1.3.11
 tofunc<2,>=1.1

preparse-1.1.5/src/preparse/__init__.py

@@ -1,2 +0,0 @@
-from preparse.core import *
-from preparse.tests import *

preparse-1.1.5/src/preparse/_utils/__init__.py

@@ -1 +0,0 @@
-from preparse._utils.dataprop import *

preparse-1.1.5/src/preparse/_utils/dataprop.py

@@ -1,21 +0,0 @@
-from typing import *
-
-__all__ = ["dataprop"]
-
-
-def dataprop(func: Callable) -> property:
-    "This magic method implements calling the current instance."
-
-    def fget(self: Any) -> Any:
-        return self._data[func.__name__]
-
-    def fset(self: Any, value: Any) -> None:
-        self._data = getattr(self, "_data", dict())
-        self._data[func.__name__] = func(self, value)
-
-    kwargs: dict[str, Any]
-    kwargs = dict()
-    kwargs["doc"] = func.__doc__
-    kwargs["fget"] = fget
-    kwargs["fset"] = fset
-    return property(**kwargs)

preparse-1.1.5/src/preparse/core/__init__.py

@@ -1,5 +0,0 @@
-from preparse.core.Click import *
-from preparse.core.enums import *
-from preparse.core.Optdict import *
-from preparse.core.PreParser import *
-from preparse.core.warnings import *

preparse-1.1.5/src/preparse/core/enums.py

@@ -1,31 +0,0 @@
-"""This module holds the enums for the project. \
-Following the precedent of getopt, \
-the value of two represents always an intermediary answer \
-between the values zero, meaning no, and one, meaning yes."""
-
-import enum
-import operator
-from typing import Self
-
-__all__ = [
-    "Tuning",
-    "Nargs",
-]
-
-
-class BaseEnum(enum.IntEnum):
-    @classmethod
-    def _missing_(cls: type[Self], value: object) -> Self:
-        return cls(2)
-
-
-class Tuning(BaseEnum):
-    MINIMIZE = 0
-    MAXIMIZE = 1
-    MAINTAIN = 2
-
-
-class Nargs(BaseEnum):
-    NO_ARGUMENT = 0
-    REQUIRED_ARGUMENT = 1
-    OPTIONAL_ARGUMENT = 2

preparse-1.1.5/src/preparse/core/warnings.py

@@ -1,148 +0,0 @@
-from abc import abstractmethod
-from collections.abc import Iterable
-from typing import Any, Self
-
-import setdoc
-from copyable import Copyable
-from datarepr import datarepr
-
-from preparse._utils import *
-
-__all__ = [
-    "PreparseAmbiguousOptionWarning",
-    "PreparseInvalidOptionWarning",
-    "PreparseRequiredArgumentWarning",
-    "PreparseUnallowedArgumentWarning",
-    "PreparseWarning",
-]
-
-
-class PreparseWarning(Warning, Copyable):
-
-    _data: dict[str, Any]
-
-    @setdoc.basic
-    def __repr__(self: Self) -> str:
-        return datarepr(type(self).__name__, **self.todict())
-
-    @setdoc.basic
-    def __str__(self: Self) -> str:
-        return f"{self.prog}: {self.getmsg()}"
-
-    @setdoc.basic
-    def copy(self: Self) -> Self:
-        return type(self)(**self.todict())
-
-    @abstractmethod
-    def getmsg(self: Self) -> str: ...
-
-    @dataprop
-    def option(self: Self, value: Any) -> str:
-        return str(value)
-
-    @dataprop
-    def prog(self: Self, value: Any) -> str:
-        return str(value)
-
-    def todict(self: Self) -> dict:
-        "This method returns a dict representing the current instance."
-        ans: dict
-        try:
-            ans = self._data
-        except AttributeError:
-            self._data = dict()
-            return dict()
-        else:
-            return dict(ans)
-
-
-class PreparseDualWarning(PreparseWarning):
-
-    @setdoc.basic
-    def __init__(self: Self, *, prog: Any, option: Any, islong: Any) -> None:
-        self.prog = prog
-        self.option = option
-        self.islong = islong
-
-    @classmethod
-    @abstractmethod
-    def _longmsg(cls: type[Self]) -> str: ...
-
-    @classmethod
-    @abstractmethod
-    def _shortmsg(cls: type[Self]) -> str: ...
-
-    def getmsg(self: Self) -> str:
-        "This method returns the core message."
-        if self.islong:
-            return self._longmsg() % self.option
-        else:
-            return self._shortmsg() % self.option
-
-    @dataprop
-    def islong(self: Self, value: Any) -> bool:
-        return bool(value)
-
-
-class PreparseInvalidOptionWarning(PreparseDualWarning):
-
-    @classmethod
-    def _longmsg(cls: type[Self]) -> str:
-        return "unrecognized option '%s'"
-
-    @classmethod
-    def _shortmsg(cls: type[Self]) -> str:
-        return "invalid option -- '%s'"
-
-
-class PreparseRequiredArgumentWarning(PreparseDualWarning):
-
-    @classmethod
-    def _longmsg(cls: type[Self]) -> str:
-        return "option '%s' requires an argument"
-
-    @classmethod
-    def _shortmsg(cls: type[Self]) -> str:
-        return "option requires an argument -- '%s'"
-
-
-class PreparseLongonlyWarning(PreparseWarning):
-    pass  # only possible for long options
-
-
-class PreparseAmbiguousOptionWarning(PreparseLongonlyWarning):
-
-    @setdoc.basic
-    def __init__(
-        self: Self, *, prog: Any, option: Any, possibilities: Iterable[object]
-    ) -> None:
-        self.prog = prog
-        self.option = option
-        self.possibilities = possibilities
-
-    def getmsg(self: Self) -> str:
-        "This method returns the core message."
-        ans: str
-        x: Any
-        ans = "option '%s' is ambiguous; possibilities:" % self.option
-        for x in self.possibilities:
-            ans += " '%s'" % x
-        return ans
-
-    @dataprop
-    def possibilities(self: Self, value: Iterable[object]) -> tuple[str, ...]:
-        return tuple(map(str, value))
-
-
-class PreparseUnallowedArgumentWarning(PreparseLongonlyWarning):
-
-    # option is always full key without value
-
-    @setdoc.basic
-    def __init__(self: Self, *, prog: Any, option: Any) -> None:
-        self.prog = prog
-        self.option = option
-
-    def getmsg(self: Self) -> str:
-        "This method returns the core message."
-        return "option '%s' doesn't allow an argument" % self.option