preparse 1.0.10__tar.gz → 2.0.0.dev0__tar.gz

{preparse-1.0.10/src/preparse.egg-info → preparse-2.0.0.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: preparse
-Version: 1.0.10
+Version: 2.0.0.dev0
 Summary: This project preparses args for further parsing later on.
 Author-email: Johannes <johannes.programming@gmail.com>
 License: The MIT License (MIT)
@@ -28,7 +28,7 @@ Project-URL: Download, https://pypi.org/project/preparse/#files
 Project-URL: Index, https://pypi.org/project/preparse/
 Project-URL: Source, https://github.com/johannes-programming/preparse/
 Project-URL: Website, https://preparse.johannes-programming.online/
-Classifier: Development Status :: 5 - Production/Stable
+Classifier: Development Status :: 3 - Alpha
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent

{preparse-1.0.10 → preparse-2.0.0.dev0}/docs/v1.0.rst

@@ -64,7 +64,7 @@ Features
 The PreParser class
 ~~~~~~~~~~~~~~~~~~~
 
-``class preparse.PreParser(*, allowslong: Any = True, allowsshort: Any = True, bundling: Any = Tuning.MAINTAIN, expandsabbr: Any = True, expectsabbr: Any = True, expectsposix: Any = False, optdict: Any = (), prog: Any = None, reconcilesorders: Any = True, special: Any = Tuning.MAINTAIN, warn: Callable = str)``
+``class preparse.PreParser(*, allowslong: Any = True, allowsshort: Any = True, bundling: Any = Tuning.MAINTAIN, expandsabbr: Any = True, expectsabbr: Any = True, expectsposix: Any = False, optdict: Any = (), prog: Any = None, reconcilesorders: Any = True, special: Any = preparse.Tuning.MAINTAIN, warn: Callable = str)``
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 This class is the centerpiece of the preparse. Its behaviour follows the principles of getopt from C.
@@ -79,10 +79,10 @@ This boolean property determines whether long options are allowed.
 
 This boolean property determines whether short options are allowed.
 
-``bundling: Tuning``
-""""""""""""""""""""
+``bundling: preparse.Tuning``
+"""""""""""""""""""""""""""""
 
-This ``Tuning`` property determines the approach to bundling of short option.
+This ``preparse.Tuning`` property determines the approach to bundling of short option.
 
 ``click(cmd: Any = True, ctx: Any = True) -> preparse.Click``
 """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
@@ -109,13 +109,15 @@ This boolean property determines whether abbreviations of long options are expec
 
 This boolean property determines whether the order of arguments to conform to the POSIX standard, i.e. all arguments after the first positional argument also being positonal.
 
-``optdict: Optdict``
-""""""""""""""""""""
+``optdict: preparse.Optdict``
+"""""""""""""""""""""""""""""
 
-This property holds a dictionary. 
+This property holds a dict-like object. 
 Its keys are the options. 
-Its values specify ``Nargs``. 
-Options not found within the dictionary cause a PreparseInvalidOptionWarning and are then assumed to have no arguments.
+Its values specify ``preparse.Nargs``. 
+Options not found within the dictionary 
+cause a ``preparse.PreparseInvalidOptionWarning`` 
+and are then assumed to have no arguments.
 
 ``parse_args(args: Optional[Iterable] = None) -> list[str]``
 """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""
@@ -149,10 +151,10 @@ Concretely the optdict property is changed.
 This method alters the current instance to reflect a ``click.Context`` object. 
 Concretely the prog property is changed.
 
-``special: Tuning``
-"""""""""""""""""""
+``special: preparse.Tuning``
+""""""""""""""""""""""""""""
 
-This ``Tuning`` property determines the approach to the special argument ``'--'``.
+This ``preparse.Tuning`` property determines the approach to the special argument ``'--'``.
 
 ``todict() -> dict``
 """"""""""""""""""""
@@ -171,8 +173,8 @@ Therefore, ``str`` is used to discard the warnings.
 The Click class
 ~~~~~~~~~~~~~~~
 
-``class preparse.Click(parser: Any, cmd: Any = True, ctx: Any = True)``
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+``class preparse.Click(parser: preparse.PreParser, cmd: Any = True, ctx: Any = True)``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 This dataclass provides decorators for embedding a ``PreParser`` object.
 
@@ -195,8 +197,8 @@ This property determines if the ``reflectClickCommand`` method of parser is to b
 
 This property determines if the ``reflectClickContext`` method of parser is to be called.
 
-``parser: Any``
-"""""""""""""""
+``parser: preparse.PreParser``
+""""""""""""""""""""""""""""""
 
 This property holds the parser to be embedded.
 
@@ -206,8 +208,9 @@ The Optdict class
 ``class preparse.Optdict``
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-This class is a subclass of ``datahold.HoldDict`` with strings as keys and with ``Nargs`` as values. 
-It is designed for ``PreParser.optdict``.
+This class is a subclass of ``datahold.HoldDict[str, preparse.Nargs]``
+with strings as keys and with ``preparse.Nargs`` as values.
+It is designed for ``preparse.PreParser.optdict``.
 
 The Enums
 ~~~~~~~~~

{preparse-1.0.10 → preparse-2.0.0.dev0}/pyproject.toml

@@ -9,7 +9,7 @@ authors = [
     { email = "johannes.programming@gmail.com", name = "Johannes" },
 ]
 classifiers = [
-    "Development Status :: 5 - Production/Stable",
+    "Development Status :: 3 - Alpha",
     "License :: OSI Approved :: MIT License",
     "Natural Language :: English",
     "Operating System :: OS Independent",
@@ -34,7 +34,7 @@ keywords = []
 name = "preparse"
 readme = "README.rst"
 requires-python = ">=3.11"
-version = "1.0.10"
+version = "2.0.0.dev0"
 
 [project.license]
 file = "LICENSE.txt"

{preparse-1.0.10/src/preparse/_processing/items → preparse-2.0.0.dev0/src/preparse/_items}/Bundle.py

@@ -2,8 +2,8 @@ from typing import *
 
 import setdoc
 
-from preparse._processing.items.Item import Item
-from preparse._processing.items.Option import Option
+from preparse._items.Item import Item
+from preparse._items.Option import Option
 from preparse._utils.dataprop import dataprop
 from preparse.core.enums import *
 

{preparse-1.0.10/src/preparse/_processing/items → preparse-2.0.0.dev0/src/preparse/_items}/Long.py

@@ -3,7 +3,7 @@ from typing import *
 
 import setdoc
 
-from preparse._processing.items.Option import Option
+from preparse._items.Option import Option
 from preparse._utils.dataprop import dataprop
 from preparse.core.enums import *
 

{preparse-1.0.10/src/preparse/_processing/items → preparse-2.0.0.dev0/src/preparse/_items}/Option.py

@@ -1,7 +1,7 @@
 import operator
 from typing import *
 
-from preparse._processing.items.Item import Item
+from preparse._items.Item import Item
 from preparse._utils.dataprop import dataprop
 from preparse.core.enums import *
 

{preparse-1.0.10/src/preparse/_processing/items → preparse-2.0.0.dev0/src/preparse/_items}/Positional.py

@@ -2,7 +2,7 @@ from typing import *
 
 import setdoc
 
-from preparse._processing.items.Item import Item
+from preparse._items.Item import Item
 from preparse._utils.dataprop import dataprop
 from preparse.core.enums import *
 

{preparse-1.0.10/src/preparse/_processing/items → preparse-2.0.0.dev0/src/preparse/_items}/Special.py

@@ -1,6 +1,6 @@
 from typing import *
 
-from preparse._processing.items.Item import Item
+from preparse._items.Item import Item
 from preparse.core.enums import *
 
 __all__ = ["Special"]

preparse-2.0.0.dev0/src/preparse/_items/__init__.py

@@ -0,0 +1,6 @@
+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

{preparse-1.0.10 → preparse-2.0.0.dev0}/src/preparse/_processing/__init__.py

@@ -1,9 +1,9 @@
 from types import FunctionType
 from typing import *
 
+from preparse._items import *
 from preparse._processing.deparsing import *
 from preparse._processing.digesting import *
-from preparse._processing.items import *
 from preparse._processing.parsing import *
 from preparse._processing.pulling import *
 from preparse._utils import *

{preparse-1.0.10 → preparse-2.0.0.dev0}/src/preparse/_processing/deparsing.py

@@ -1,6 +1,6 @@
 from typing import *
 
-from preparse._processing.items.Item import Item
+from preparse._items.Item import Item
 
 __all__ = ["deparse"]
 

{preparse-1.0.10 → preparse-2.0.0.dev0}/src/preparse/_processing/digesting.py

@@ -1,13 +1,12 @@
 from typing import *
 
-from preparse._processing.items.Bundle import Bundle
-from preparse._processing.items.Item import Item
-from preparse._processing.items.Long import Long
-from preparse._processing.items.Option import Option
-from preparse._processing.items.Positional import Positional
-from preparse._processing.items.Special import Special
+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.enums import *
-from preparse.core.warnings import *
 
 __all__ = ["digest"]
 

{preparse-1.0.10 → preparse-2.0.0.dev0}/src/preparse/_processing/parsing.py

@@ -1,22 +1,20 @@
 from types import FunctionType
 from typing import *
 
-from preparse._processing.items.Bundle import Bundle
-from preparse._processing.items.Item import Item
-from preparse._processing.items.Long import Long
-from preparse._processing.items.Option import Option
-from preparse._processing.items.Positional import Positional
-from preparse._processing.items.Special import Special
-from preparse.core import warnings
+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.enums import *
+from preparse.warners.AmbiguousOptionWarner import AmbiguousOptionWarner as PAOW
+from preparse.warners.InvalidOptionWarner import InvalidOptionWarner as PIOW
+from preparse.warners.RequiredArgumentWarner import RequiredArgumentWarner as PRAW
+from preparse.warners.UnallowedArgumentWarner import UnallowedArgumentWarner as PUAW
 
 __all__ = ["parse"]
 
-PAOW = warnings.PreparseAmbiguousOptionWarning
-PIOW = warnings.PreparseInvalidOptionWarning
-PUAW = warnings.PreparseUnallowedArgumentWarning
-PRAW = warnings.PreparseRequiredArgumentWarning
-
 
 def parse(args: list[str], **kwargs: Any) -> list[Item]:
     return list(parse_generator(args, **kwargs))

{preparse-1.0.10 → preparse-2.0.0.dev0}/src/preparse/_processing/pulling.py

@@ -1,7 +1,7 @@
 import sys
 from typing import *
 
-from preparse._processing.items.Positional import Positional
+from preparse._items.Positional import Positional
 
 __all__ = ["pull"]
 

{preparse-1.0.10 → preparse-2.0.0.dev0}/src/preparse/core/Optdict.py

@@ -7,7 +7,6 @@ from datarepr import datarepr
 from frozendict import frozendict
 
 from preparse.core.enums import *
-from preparse.core.warnings import *
 
 __all__ = ["Optdict"]
 

{preparse-1.0.10 → preparse-2.0.0.dev0}/src/preparse/core/PreParser.py

@@ -16,7 +16,7 @@ from preparse._utils.dataprop import dataprop
 from preparse.core.Click import Click
 from preparse.core.enums import *
 from preparse.core.Optdict import *
-from preparse.core.warnings import *
+from preparse.warners import *
 
 __all__ = ["PreParser"]
 
@@ -33,7 +33,7 @@ class PreParser(Copyable):
     prog: str
     reconcilesorders: bool
     special: Tuning
-    warn: types.FunctionType
+    warn: Callable
 
     __slots__ = ("_data",)
 
@@ -51,7 +51,7 @@ class PreParser(Copyable):
         prog: Any = None,
         reconcilesorders: Any = True,
         special: Any = Tuning.MAINTAIN,
-        warn: Callable = str,
+        warn: types.FunctionType = str,
     ) -> None:
         self.allowslong = allowslong
         self.allowsshort = allowsshort

preparse-2.0.0.dev0/src/preparse/core/PreparseWarning.py

@@ -0,0 +1,6 @@
+from typing import *
+
+__all__ = ["PreparseWarning"]
+
+
+class PreparseWarning(Warning): ...

{preparse-1.0.10 → preparse-2.0.0.dev0}/src/preparse/core/__init__.py

@@ -2,4 +2,3 @@ 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.0.10 → preparse-2.0.0.dev0}/src/preparse/tests/__init__.py

@@ -8,9 +8,7 @@ def test() -> unittest.TextTestResult:
     loader: unittest.TestLoader
     tests: unittest.TestSuite
     runner: unittest.TextTestRunner
-    result: unittest.TextTestResult
     loader = unittest.TestLoader()
     tests = loader.discover(start_dir="preparse.tests")
     runner = unittest.TextTestRunner()
-    result = runner.run(tests)
-    return result
+    return runner.run(tests)

{preparse-1.0.10 → preparse-2.0.0.dev0}/src/preparse/tests/test_optdict.py

@@ -1,11 +1,8 @@
 import unittest
 from typing import *
 
-from preparse.core.Click import Click
 from preparse.core.enums import *
 from preparse.core.Optdict import Optdict
-from preparse.core.PreParser import PreParser
-from preparse.core.warnings import *
 
 __all__ = ["TestPreparse"]
 

{preparse-1.0.10 → preparse-2.0.0.dev0}/src/preparse/tests/test_preparser.py

@@ -4,7 +4,6 @@ from typing import *
 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-2.0.0.dev0/src/preparse/warners/AmbiguousOptionWarner.py

@@ -0,0 +1,38 @@
+from abc import abstractmethod
+from typing import *
+
+import setdoc
+
+from preparse._utils import *
+from preparse.warners.LongonlyWarner import LongonlyWarner
+
+__all__ = ["AmbiguousOptionWarner"]
+
+
+class AmbiguousOptionWarner(LongonlyWarner):
+    __slots__ = ()
+    args: tuple[str]
+    option: str
+    possibilities: tuple[str, ...]
+    prog: str
+
+    @setdoc.basic
+    def __init__(
+        self: Self, *, prog: Any, option: Any, possibilities: Iterable
+    ) -> 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) -> tuple[str, ...]:
+        return tuple(map(str, value))

preparse-2.0.0.dev0/src/preparse/warners/DualWarner.py

@@ -0,0 +1,33 @@
+from typing import *
+
+import setdoc
+
+from preparse._utils import *
+from preparse.warners.WarnerABC import WarnerABC
+
+__all__ = ["DualWarner"]
+
+
+class DualWarner(WarnerABC):
+    __slots__ = ()
+
+    args: tuple[str]
+    option: str
+    prog: str
+
+    @setdoc.basic
+    def __init__(self: Self, *, prog: Any, option: Any, islong: Any) -> None:
+        self.prog = prog
+        self.option = option
+        self.islong = islong
+
+    def getmsg(self: Self) -> str:
+        "This method returns the core message."
+        if self.islong:
+            return type(self)._longmsg % self.option
+        else:
+            return type(self)._shortmsg % self.option
+
+    @dataprop
+    def islong(self: Self, value: Any) -> bool:
+        return bool(value)

preparse-2.0.0.dev0/src/preparse/warners/InvalidOptionWarner.py

@@ -0,0 +1,14 @@
+from typing import *
+
+from preparse.warners.DualWarner import DualWarner
+
+__all__ = ["InvalidOptionWarner"]
+
+
+class InvalidOptionWarner(DualWarner):
+    __slots__ = ()
+    args: tuple[str]
+    option: str
+    prog: str
+    _longmsg = "unrecognized option '%s'"
+    _shortmsg = "invalid option -- '%s'"

preparse-2.0.0.dev0/src/preparse/warners/LongonlyWarner.py

@@ -0,0 +1,13 @@
+from typing import *
+
+from preparse.warners.WarnerABC import WarnerABC
+
+__all__ = ["LongonlyWarner"]
+
+
+class LongonlyWarner(WarnerABC):
+    __slots__ = ()
+    args: tuple[str]
+    option: str
+    prog: str
+    # only possible for long options

preparse-2.0.0.dev0/src/preparse/warners/RequiredArgumentWarner.py

@@ -0,0 +1,14 @@
+from typing import *
+
+from preparse.warners.DualWarner import DualWarner
+
+__all__ = ["RequiredArgumentWarner"]
+
+
+class RequiredArgumentWarner(DualWarner):
+    __slots__ = ()
+    args: tuple[str]
+    option: str
+    prog: str
+    _longmsg = "option '%s' requires an argument"
+    _shortmsg = "option requires an argument -- '%s'"

preparse-2.0.0.dev0/src/preparse/warners/UnallowedArgumentWarner.py

@@ -0,0 +1,25 @@
+from typing import *
+
+import setdoc
+
+from preparse._utils import *
+from preparse.warners.LongonlyWarner import LongonlyWarner
+
+__all__ = ["UnallowedArgumentWarner"]
+
+
+class UnallowedArgumentWarner(LongonlyWarner):
+    __slots__ = ()
+    args: tuple[str]
+    option: str
+    prog: str
+    # 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

preparse-2.0.0.dev0/src/preparse/warners/WarnerABC.py

@@ -0,0 +1,60 @@
+from abc import abstractmethod
+from typing import *
+
+import setdoc
+from copyable import Copyable
+from datarepr import datarepr
+
+from preparse._utils import dataprop
+from preparse.core.PreparseWarning import PreparseWarning
+
+__all__ = ["WarnerABC"]
+
+
+class WarnerABC(Copyable):
+    __slots__ = ("_data",)
+    args: tuple[str]
+    option: str
+    prog: str
+
+    @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()}"
+
+    @property
+    def args(self: Self) -> tuple[str]:
+        "This property returns (str(self),)."
+        return (str(self),)
+
+    @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[str, Any]:
+        "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)
+
+    def warning(self: Self) -> PreparseWarning:
+        return PreparseWarning(str(self))

{preparse-1.0.10 → preparse-2.0.0.dev0/src/preparse.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: preparse
-Version: 1.0.10
+Version: 2.0.0.dev0
 Summary: This project preparses args for further parsing later on.
 Author-email: Johannes <johannes.programming@gmail.com>
 License: The MIT License (MIT)
@@ -28,7 +28,7 @@ Project-URL: Download, https://pypi.org/project/preparse/#files
 Project-URL: Index, https://pypi.org/project/preparse/
 Project-URL: Source, https://github.com/johannes-programming/preparse/
 Project-URL: Website, https://preparse.johannes-programming.online/
-Classifier: Development Status :: 5 - Production/Stable
+Classifier: Development Status :: 3 - Alpha
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent

{preparse-1.0.10 → preparse-2.0.0.dev0}/src/preparse.egg-info/SOURCES.txt

@@ -10,26 +10,27 @@ src/preparse.egg-info/SOURCES.txt
 src/preparse.egg-info/dependency_links.txt
 src/preparse.egg-info/requires.txt
 src/preparse.egg-info/top_level.txt
+src/preparse/_items/Bundle.py
+src/preparse/_items/Item.py
+src/preparse/_items/Long.py
+src/preparse/_items/Option.py
+src/preparse/_items/Positional.py
+src/preparse/_items/Special.py
+src/preparse/_items/__init__.py
 src/preparse/_processing/__init__.py
 src/preparse/_processing/deparsing.py
 src/preparse/_processing/digesting.py
 src/preparse/_processing/parsing.py
 src/preparse/_processing/pulling.py
-src/preparse/_processing/items/Bundle.py
-src/preparse/_processing/items/Item.py
-src/preparse/_processing/items/Long.py
-src/preparse/_processing/items/Option.py
-src/preparse/_processing/items/Positional.py
-src/preparse/_processing/items/Special.py
-src/preparse/_processing/items/__init__.py
 src/preparse/_utils/__init__.py
 src/preparse/_utils/dataprop.py
 src/preparse/core/Click.py
+src/preparse/core/OptDict.py
 src/preparse/core/Optdict.py
 src/preparse/core/PreParser.py
+src/preparse/core/PreparseWarning.py
 src/preparse/core/__init__.py
 src/preparse/core/enums.py
-src/preparse/core/warnings.py
 src/preparse/tests/__init__.py
 src/preparse/tests/data.toml
 src/preparse/tests/expit.toml
@@ -37,4 +38,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/warners/AmbiguousOptionWarner.py
+src/preparse/warners/DualWarner.py
+src/preparse/warners/InvalidOptionWarner.py
+src/preparse/warners/LongonlyWarner.py
+src/preparse/warners/RequiredArgumentWarner.py
+src/preparse/warners/UnallowedArgumentWarner.py
+src/preparse/warners/WarnerABC.py
+src/preparse/warners/__init__.py

preparse-1.0.10/src/preparse/_processing/items/__init__.py

@@ -1,6 +0,0 @@
-from preparse._processing.items.Bundle import Bundle
-from preparse._processing.items.Item import Item
-from preparse._processing.items.Long import Long
-from preparse._processing.items.Option import Option
-from preparse._processing.items.Positional import Positional
-from preparse._processing.items.Special import Special

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

@@ -1,152 +0,0 @@
-from abc import abstractmethod
-from typing import *
-
-import setdoc
-from copyable import Copyable
-from datarepr import datarepr
-
-from preparse._utils import *
-
-__all__ = [
-    "PreparseAmbiguousOptionWarning",
-    "PreparseInvalidOptionWarning",
-    "PreparseRequiredArgumentWarning",
-    "PreparseUnallowedArgumentWarning",
-    "PreparseWarning",
-]
-
-
-class PreparseWarning(Warning, Copyable):
-    args: tuple[str]
-    option: str
-    prog: str
-
-    @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()}"
-
-    @property
-    def args(self: Self) -> tuple[str]:
-        "This property returns (str(self),)."
-        return (str(self),)
-
-    @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):
-
-    args: tuple[str]
-    option: str
-    prog: str
-
-    @setdoc.basic
-    def __init__(self: Self, *, prog: Any, option: Any, islong: Any) -> None:
-        self.prog = prog
-        self.option = option
-        self.islong = islong
-
-    def getmsg(self: Self) -> str:
-        "This method returns the core message."
-        if self.islong:
-            return type(self)._longmsg % self.option
-        else:
-            return type(self)._shortmsg % self.option
-
-    @dataprop
-    def islong(self: Self, value: Any) -> bool:
-        return bool(value)
-
-
-class PreparseInvalidOptionWarning(PreparseDualWarning):
-    args: tuple[str]
-    option: str
-    prog: str
-    _longmsg = "unrecognized option '%s'"
-    _shortmsg = "invalid option -- '%s'"
-
-
-class PreparseRequiredArgumentWarning(PreparseDualWarning):
-    args: tuple[str]
-    option: str
-    prog: str
-    _longmsg = "option '%s' requires an argument"
-    _shortmsg = "option requires an argument -- '%s'"
-
-
-class PreparseLongonlyWarning(PreparseWarning):
-    args: tuple[str]
-    option: str
-    prog: str
-    # only possible for long options
-
-
-class PreparseAmbiguousOptionWarning(PreparseLongonlyWarning):
-    args: tuple[str]
-    option: str
-    possibilities: tuple[str, ...]
-    prog: str
-
-    @setdoc.basic
-    def __init__(
-        self: Self, *, prog: Any, option: Any, possibilities: Iterable
-    ) -> 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) -> tuple[str, ...]:
-        return tuple(map(str, value))
-
-
-class PreparseUnallowedArgumentWarning(PreparseLongonlyWarning):
-    args: tuple[str]
-    option: str
-    prog: str
-    # 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