preparse 1.0.14.dev3__tar.gz → 1.0.16__tar.gz

preparse-1.0.16/PKG-INFO

@@ -0,0 +1,38 @@
+Metadata-Version: 2.4
+Name: preparse
+Version: 1.0.16
+Summary: This project preparses args for further parsing later on.
+Author-email: Johannes <johannes.programming@gmail.com>
+License-Expression: MIT
+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: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/x-rst
+License-File: LICENSE.txt
+Requires-Dist: click<9,>=8.2
+Requires-Dist: cmp3<2,>=1.0
+Requires-Dist: copyable<2,>=1.0
+Requires-Dist: datahold<4,>=3.0
+Requires-Dist: datarepr<2,>=1.1
+Requires-Dist: frozendict<3,>=2.4.7
+Requires-Dist: overloadable<2,>=1.1
+Requires-Dist: setdoc<2,>=1.2.10
+Requires-Dist: tofunc<2,>=1.0
+Dynamic: license-file
+
+========
+preparse
+========
+
+Each minor version has its own documentation.
+These docs can be found as rst-files in the ``docs/`` directory of this project.
+They can also be viewed on the website `https://preparse.johannes-programming.online/ <https://preparse.johannes-programming.online/>`_.

preparse-1.0.16/README.rst

@@ -0,0 +1,7 @@
+========
+preparse
+========
+
+Each minor version has its own documentation.
+These docs can be found as rst-files in the ``docs/`` directory of this project.
+They can also be viewed on the website `https://preparse.johannes-programming.online/ <https://preparse.johannes-programming.online/>`_.

{preparse-1.0.14.dev3 → preparse-1.0.16}/pyproject.toml

@@ -1,7 +1,7 @@
 [build-system]
 build-backend = "setuptools.build_meta"
 requires = [
-    "setuptools>=64.0",
+    "setuptools>=77.0",
 ]
 
 [project]
@@ -9,8 +9,7 @@ authors = [
     { email = "johannes.programming@gmail.com", name = "Johannes" },
 ]
 classifiers = [
-    "Development Status :: 3 - Alpha",
-    "License :: OSI Approved :: MIT License",
+    "Development Status :: 5 - Production/Stable",
     "Natural Language :: English",
     "Operating System :: OS Independent",
     "Programming Language :: Python",
@@ -31,13 +30,14 @@ dependencies = [
 ]
 description = "This project preparses args for further parsing later on."
 keywords = []
+license = "MIT"
+license-files = [
+    "LICENSE.txt",
+]
 name = "preparse"
 readme = "README.rst"
 requires-python = ">=3.11"
-version = "1.0.14.dev3"
-
-[project.license]
-file = "LICENSE.txt"
+version = "1.0.16"
 
 [project.urls]
 Download = "https://pypi.org/project/preparse/#files"

{preparse-1.0.14.dev3 → preparse-1.0.16}/src/preparse/_processing/__init__.py

@@ -28,20 +28,13 @@ def process(
     warn: FunctionType,
 ) -> list[str]:
     "This method parses args."
-    abbr: Optional[Tuning]
     items: list[Item]
-    if not expectsabbr:
-        abbr = None
-    elif expandsabbr:
-        abbr = Tuning.MINIMIZE
-    else:
-        abbr = Tuning.MAINTAIN
     items = pull(args)
     items = parse(
         items,
-        abbr=abbr,
         allowslong=allowslong,
         allowsshort=allowsshort,
+        expectsabbr=expectsabbr,
         expectsposix=expectsposix,
         optdict=optdict,
         prog=prog,
@@ -51,6 +44,7 @@ def process(
         items,
         allowslong=allowslong,
         bundling=bundling,
+        expandsabbr=expandsabbr,
         expectsposix=expectsposix,
         reconcilesorders=reconcilesorders,
         special=special,

{preparse-1.0.14.dev3 → preparse-1.0.16}/src/preparse/_processing/digesting.py

@@ -2,6 +2,7 @@ from typing import *
 
 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
@@ -16,13 +17,17 @@ def digest(
     *,
     allowslong: bool,
     bundling: Tuning,
+    expandsabbr: bool,
     expectsposix: bool,
     reconcilesorders: bool,
     special: Tuning,
 ) -> list[Item]:
     ans: list[Item]
     ans = list(items)
-
+    ans = digest_abbr(
+        ans,
+        expandsabbr=expandsabbr,
+    )
     ans = digest_special(
         ans,
         expectsposix=expectsposix,
@@ -42,6 +47,22 @@ def digest(
     return ans
 
 
+def digest_abbr(
+    items: list[Item],
+    *,
+    expandsabbr: bool,
+) -> list[Item]:
+    ans: list[Item]
+    item: Item
+    ans = list(items)
+    if not expandsabbr:
+        return ans
+    for item in ans:
+        if isinstance(item, Long):
+            item.abbrlen = None
+    return ans
+
+
 def digest_bundling(
     items: list[Item],
     *,

{preparse-1.0.14.dev3 → preparse-1.0.16}/src/preparse/_processing/parsing.py

@@ -18,10 +18,7 @@ PUAW = warnings.PreparseUnallowedArgumentWarning
 PRAW = warnings.PreparseRequiredArgumentWarning
 
 
-def parse(
-    args: list[str],
-    **kwargs: Any,
-) -> list[Item]:
+def parse(args: list[str], **kwargs: Any) -> list[Item]:
     return list(parse_generator(args, **kwargs))
 
 
@@ -67,9 +64,9 @@ def parse_cause(
 def parse_generator(
     items: list[Positional],
     *,
-    abbr: Optional[Tuning],
     allowslong: bool,
     allowsshort: bool,
+    expectsabbr: bool,
     expectsposix: bool,
     optdict: dict,
     prog: str,
@@ -105,10 +102,10 @@ def parse_generator(
             continue
         last = parse_option(
             item.value,
-            abbr=abbr,
             allowslong=allowslong,
             allowsshort=allowsshort,
             cause=cause,
+            expectsabbr=expectsabbr,
             optdict=optdict,
         )
         if not last.ishungry():
@@ -139,8 +136,8 @@ def parse_islong(
 def parse_long(
     arg: str,
     *,
-    abbr: Optional[Tuning],
     cause: FunctionType,
+    expectsabbr: bool,
     optdict: dict,
 ) -> Long:
     ans: Long
@@ -153,7 +150,7 @@ def parse_long(
     ans.abbrlen = len(ans.fullkey)
     if ans.fullkey in optdict.keys():
         parts = [ans.fullkey]
-    elif abbr is not None:
+    elif expectsabbr:
         parts = parse_long_startswith(ans.abbr, keys=optdict.keys())
     else:
         parts = list()  # can be assumed
@@ -166,8 +163,6 @@ def parse_long(
         cause(PAOW, option=arg, possibilities=parts)
         return ans
     (ans.fullkey,) = parts
-    if abbr == Tuning.MINIMIZE:
-        ans.abbrlen = len(ans.fullkey)
     ans.nargs = optdict[ans.fullkey]
     if (ans.nargs == Nargs.NO_ARGUMENT) and (ans.right is not None):
         cause(PUAW, option=ans.fullkey)
@@ -191,16 +186,16 @@ def parse_long_startswith(
 def parse_option(
     arg: str,
     *,
-    abbr: Optional[Tuning],
     cause: FunctionType,
+    expectsabbr: bool,
     optdict: dict,
     **kwargs: Any,
 ) -> Option:
     if parse_islong(arg, **kwargs):
         return parse_long(
             arg,
-            abbr=abbr,
             cause=cause,
+            expectsabbr=expectsabbr,
             optdict=optdict,
         )
     else:

{preparse-1.0.14.dev3 → preparse-1.0.16}/src/preparse/tests/test_data_toml.py

@@ -31,24 +31,10 @@ class TestDataToml(unittest.TestCase):
         data: dict[str, Any]
         name: str
         kwargs: dict
-        kwargs_: dict
         data = utils.get_data()
         for name, kwargs in data.items():
             with self.subTest(msg=name, **kwargs):
-                kwargs_ = self.convert(**kwargs)
-                self.parse(**kwargs_)
-
-    def convert(self: Self, **kwargs: Any) -> dict:
-        ans: dict
-        x: str
-        y: Any
-        ans = dict()
-        for x, y in kwargs.items():
-            if utils.istestable(y):
-                ans[x] = y
-            else:
-                ans[x] = None
-        return ans
+                self.parse(**kwargs)
 
     def parse(
         self: Self,
@@ -88,7 +74,7 @@ class TestDataToml(unittest.TestCase):
         self.assertEqual(answer, superanswer, msg=msg)
         msg = "\n\ndata=%s,\nanswer=%s,\nsolution=%s,\n\n" % (data, answer, solution)
         self.assertEqual(answer, solution, msg=msg)
-        if warnings is None:
+        if not utils.istestable(warnings):
             return
         msg = "\n\ndata=%s,\nerranswer=%s,\nwarnings=%s,\n\n" % (
             data,

preparse-1.0.16/src/preparse.egg-info/PKG-INFO

@@ -0,0 +1,38 @@
+Metadata-Version: 2.4
+Name: preparse
+Version: 1.0.16
+Summary: This project preparses args for further parsing later on.
+Author-email: Johannes <johannes.programming@gmail.com>
+License-Expression: MIT
+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: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/x-rst
+License-File: LICENSE.txt
+Requires-Dist: click<9,>=8.2
+Requires-Dist: cmp3<2,>=1.0
+Requires-Dist: copyable<2,>=1.0
+Requires-Dist: datahold<4,>=3.0
+Requires-Dist: datarepr<2,>=1.1
+Requires-Dist: frozendict<3,>=2.4.7
+Requires-Dist: overloadable<2,>=1.1
+Requires-Dist: setdoc<2,>=1.2.10
+Requires-Dist: tofunc<2,>=1.0
+Dynamic: license-file
+
+========
+preparse
+========
+
+Each minor version has its own documentation.
+These docs can be found as rst-files in the ``docs/`` directory of this project.
+They can also be viewed on the website `https://preparse.johannes-programming.online/ <https://preparse.johannes-programming.online/>`_.

{preparse-1.0.14.dev3 → preparse-1.0.16}/src/preparse.egg-info/SOURCES.txt

@@ -3,7 +3,6 @@ MANIFEST.in
 README.rst
 pyproject.toml
 setup.cfg
-docs/v1.0.rst
 src/preparse/__init__.py
 src/preparse.egg-info/PKG-INFO
 src/preparse.egg-info/SOURCES.txt
@@ -25,7 +24,6 @@ src/preparse/_processing/pulling.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/__init__.py

preparse-1.0.14.dev3/PKG-INFO

@@ -1,57 +0,0 @@
-Metadata-Version: 2.4
-Name: preparse
-Version: 1.0.14.dev3
-Summary: This project preparses args for further parsing later on.
-Author-email: Johannes <johannes.programming@gmail.com>
-License: The MIT License (MIT)
-        
-        Copyright (c) 2024 Johannes
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-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 :: 3 - Alpha
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Natural Language :: English
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Typing :: Typed
-Requires-Python: >=3.11
-Description-Content-Type: text/x-rst
-License-File: LICENSE.txt
-Requires-Dist: click<9,>=8.2
-Requires-Dist: cmp3<2,>=1.0
-Requires-Dist: copyable<2,>=1.0
-Requires-Dist: datahold<4,>=3.0
-Requires-Dist: datarepr<2,>=1.1
-Requires-Dist: frozendict<3,>=2.4.7
-Requires-Dist: overloadable<2,>=1.1
-Requires-Dist: setdoc<2,>=1.2.10
-Requires-Dist: tofunc<2,>=1.0
-Dynamic: license-file
-
-========
-preparse
-========
-
-Visit the website `https://preparse.johannes-programming.online/ <https://preparse.johannes-programming.online/>`_ for more information.

preparse-1.0.14.dev3/README.rst

@@ -1,5 +0,0 @@
-========
-preparse
-========
-
-Visit the website `https://preparse.johannes-programming.online/ <https://preparse.johannes-programming.online/>`_ for more information.

preparse-1.0.14.dev3/docs/v1.0.rst

@@ -1,303 +0,0 @@
-Overview
---------
-
-The preparse project allows to preparse arguments before the main parsing. 
-Its ability to deabbreviate options is especially useful for use with ``click``.
-
-Links
------
-
-- Download: https://pypi.org/project/preparse/#files
-- Index: https://pypi.org/project/preparse/
-- Source: https://github.com/johannes-programming/preparse/
-- Website: https://preparse.johannes-programming.online/
-
-Installation
-------------
-
-To install preparse, you can use pip. Open your terminal and run:
-
-.. code-block:: shell
-
-    pip install preparse
-
-Introduction
-------------
-
-The preparse project allows for preprocessing a list of arguments so that they can be parsed definitively in a later step. This way, the functionality of another parsing system can be modified. The project is especially adapted to work with the click project.
-
-The project preparse is strongly inspired by the getopt and getopt_long libraries within C.
-
-Here is the implementation of the ``expit`` project (Version 1.0.13) to illustrate how preparse can be used to modify click.
-
-.. code-block:: python
-
-    import math
-
-    import click
-    import preparse
-
-    __all__ = ["function", "main"]
-
-
-    def function(x: float) -> float:
-        "This function is the logistical sigmoid, i.e. the expit function."
-        try:
-            p = math.exp(-x)
-        except OverflowError:
-            p = float("+inf")
-        return 1 / (1 + p)
-
-
-    @preparse.PreParser().click()
-    @click.command(add_help_option=False)
-    @click.help_option("-h", "--help")
-    @click.version_option(None, "-V", "--version")
-    @click.argument("x", type=float)
-    def main(x: float) -> None:
-        "This command applies the expit function to x."
-        click.echo(function(x))
-
-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 = preparse.Tuning.MAINTAIN, warn: Callable = str)``
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-This class is the centerpiece of the preparse. Its behaviour follows the principles of getopt from C.
-
-``allowslong: bool``
-""""""""""""""""""""
-
-This boolean property determines whether long options are allowed.
-
-``allowsshort: bool``
-"""""""""""""""""""""
-
-This boolean property determines whether short options are allowed.
-
-``bundling: preparse.Tuning``
-"""""""""""""""""""""""""""""
-
-This ``preparse.Tuning`` property determines the approach to bundling of short option.
-
-``click(cmd: Any = True, ctx: Any = True) -> preparse.Click``
-"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-
-This method returns a decorator that infuses the current instance into ``parse_args``.
-
-``copy() -> Self``
-""""""""""""""""""
-
-This method returns a copy of the current instance.
-
-``expandsabbr: bool``
-"""""""""""""""""""""
-
-This boolean property determines whether recognized abbreviations of long options are to be expanded to their full length.
-
-``expectsabbr: bool``
-"""""""""""""""""""""
-
-This boolean property determines whether abbreviations of long options are expected.
-
-``expectsposix: bool``
-""""""""""""""""""""""
-
-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: preparse.Optdict``
-"""""""""""""""""""""""""""""
-
-This property holds a dict-like object. 
-Its keys are the options. 
-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]``
-""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-
-This method is at the core of the class. 
-It returns a preparsed list of arguments. 
-If ``None`` is passed as args then ``sys.argv[1:]`` is used. 
-If the method is applied repeatedly to a list there will be no changes after the first run.
-
-``prog: str``
-"""""""""""""
-
-This ``str`` property represents the name of the program. 
-If the value passed to the property is ``None`` then ``str(sys.argv[0])`` is saved.
-
-``reconcilesorders: bool``
-""""""""""""""""""""""""""
-
-This boolean property determines whether compatibility with both orders, 
-POSIX and the interleaving of options with positonal arguments, should be enforced.
-
-``reflectClickCommand(cmd: click.Command) -> None``
-"""""""""""""""""""""""""""""""""""""""""""""""""""
-
-This method alters the current instance to reflect a ``click.Command`` object. 
-Concretely the optdict property is changed.
-
-``reflectClickContext(ctx: click.Context) -> None``
-"""""""""""""""""""""""""""""""""""""""""""""""""""
-
-This method alters the current instance to reflect a ``click.Context`` object. 
-Concretely the prog property is changed.
-
-``special: preparse.Tuning``
-""""""""""""""""""""""""""""
-
-This ``preparse.Tuning`` property determines the approach to the special argument ``'--'``.
-
-``todict() -> dict``
-""""""""""""""""""""
-
-This method a dict representing the current instance.
-
-``warn: types.FunctionType``
-""""""""""""""""""""""""""""
-
-This property holds a function that is called whenever ``parse_args`` encounters a warning. 
-The warning is given as the only positional arguments. 
-No keyword arguments are given. 
-Its return value is discarded. 
-Therefore, ``str`` is used to discard the warnings.
-
-The Click class
-~~~~~~~~~~~~~~~
-
-``class preparse.Click(parser: preparse.PreParser, cmd: Any = True, ctx: Any = True)``
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-This dataclass provides decorators for embedding a ``PreParser`` object.
-
-``__call__(target: Any) -> Any``
-""""""""""""""""""""""""""""""""
-
-This magic method implements ``self(target)``.
-It works as a decorator that embeds its parser into a given target from the library click.
-
-``cmd: Any``
-""""""""""""
-
-This property determines if the ``reflectClickCommand`` method of parser is to be called.
-
-``copy() -> Self``
-""""""""""""""""""
-
-``ctx: Any``
-""""""""""""
-
-This property determines if the ``reflectClickContext`` method of parser is to be called.
-
-``parser: preparse.PreParser``
-""""""""""""""""""""""""""""""
-
-This property holds the parser to be embedded.
-
-The Optdict class
-~~~~~~~~~~~~~~~~~
-
-``class preparse.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
-~~~~~~~~~
-
-These classes are subclasses of ``enum.IntEnum``. 
-Any value different from ``0`` (meaning no) and ``1`` (meaning yes) is interpreted as ``2`` (meaning intermediate).
-
-``class preparse.Tuning``
-^^^^^^^^^^^^^^^^^^^^^^^^^
-
-+--------------+-------+-----------------------------------------------------------------------------+
-| Name         | Value | Explanation                                                                 |
-+==============+=======+=============================================================================+
-| ``MINIMIZE`` | ``0`` | The PreParser minimizes the aspect in question.                             |
-+--------------+-------+-----------------------------------------------------------------------------+
-| ``MAXIMIZE`` | ``1`` | The PreParser maximizes the aspect in question.                             |
-+--------------+-------+-----------------------------------------------------------------------------+
-| ``MAINTAIN`` | ``2`` | The PreParser does not make any unforced changes to the aspect in question. |
-+--------------+-------+-----------------------------------------------------------------------------+
-
-``class preparse.Nargs``
-^^^^^^^^^^^^^^^^^^^^^^^^
-
-+-------------------+-------+----------------------------------------------+
-| Name              | Value | Explanation                                  |
-+===================+=======+==============================================+
-| NO_ARGUMENT       | ``0`` | The option does not take an argument.        |
-+-------------------+-------+----------------------------------------------+
-| REQUIRED_ARGUMENT | ``1`` | The option requires an argument.             |
-+-------------------+-------+----------------------------------------------+
-| OPTIONAL_ARGUMENT | ``2`` | The option may take an argument.             |
-+-------------------+-------+----------------------------------------------+
-
-The Warnings
-~~~~~~~~~~~~
-
-These classes are subclasses of ``Warning`` that are specifically designed to communicate issues with parsing.
-
-``class preparse.PreparseWarning``
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-This abstract base class is the base for all other warning types.
-
-``class preparse.PreparseAmbiguousOptionWarning(prog: Any, option: Any, possibilities: Any)``
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-This class warns about ambiguous options. This can only happen for long options.
-
-``class preparse.PreparseInvalidOptionWarning(prog: Any, option: Any, islong: Any)``
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-This class warns about invalid options.
-
-``class preparse.PreparseRequiredArgumentWarning(prog: Any, option: Any, islong: Any)``
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-This class warns about missing required arguments.
-
-``class preparse.PreparseUnallowedArgumentWarning(prog: Any, option: Any)``
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-This class warns about unallowed arguments. This can only happen for long options.
-
-The Tests
-~~~~~~~~~
-
-``preparse.test() -> unittest.TextTestResult``
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-This project can be tested through its test function.
-
-.. code-block:: python
-
-    import preparse
-    preparse.test()
-
-License
--------
-
-This project is licensed under the MIT License.
-
-Impressum
----------
-
-**Johannes Programming**
-
-- Name: Johannes
-- Email: johannes.programming@gmail.com
-- Homepage: https://www.johannes-programming.online/
-- Gravatar: https://www.johannes-programming.fyi/

preparse-1.0.14.dev3/src/preparse.egg-info/PKG-INFO

@@ -1,57 +0,0 @@
-Metadata-Version: 2.4
-Name: preparse
-Version: 1.0.14.dev3
-Summary: This project preparses args for further parsing later on.
-Author-email: Johannes <johannes.programming@gmail.com>
-License: The MIT License (MIT)
-        
-        Copyright (c) 2024 Johannes
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-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 :: 3 - Alpha
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Natural Language :: English
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Typing :: Typed
-Requires-Python: >=3.11
-Description-Content-Type: text/x-rst
-License-File: LICENSE.txt
-Requires-Dist: click<9,>=8.2
-Requires-Dist: cmp3<2,>=1.0
-Requires-Dist: copyable<2,>=1.0
-Requires-Dist: datahold<4,>=3.0
-Requires-Dist: datarepr<2,>=1.1
-Requires-Dist: frozendict<3,>=2.4.7
-Requires-Dist: overloadable<2,>=1.1
-Requires-Dist: setdoc<2,>=1.2.10
-Requires-Dist: tofunc<2,>=1.0
-Dynamic: license-file
-
-========
-preparse
-========
-
-Visit the website `https://preparse.johannes-programming.online/ <https://preparse.johannes-programming.online/>`_ for more information.