batutils 2.1.0__tar.gz → 2.2.1__tar.gz

{batutils-2.1.0 → batutils-2.2.1}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024-2025 Thordur Matthiasson
+Copyright (c) 2024-2026 Thordur Matthiasson
 Copyright (c) 2013-2024 CCP Games
 
 Permission is hereby granted, free of charge, to any person obtaining a copy

batutils-2.2.1/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: batutils
+Version: 2.2.1
+Summary: Team Batcave's utilities for date and/or time objects and values and messing with types and so much more.
+Author-email: Thordur Matthiasson <doddi79@gmail.com>, John Aldis <johnaldis@ccpgames.com>
+License: MIT License
+        
+        Copyright (c) 2024-2026 Thordur Matthiasson
+        Copyright (c) 2013-2024 CCP Games
+        
+        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: Homepage, https://github.com/doddi79/batutils
+Project-URL: Documentation, https://github.com/doddi79/batutils/blob/main/README.md
+Project-URL: Repository, https://github.com/doddi79/batutils.git
+Project-URL: Issues, https://github.com/doddi79/batutils/issues
+Project-URL: Changelog, https://github.com/doddi79/batutils/blob/main/CHANGELOG.md
+Keywords: datetimeutils,datetime,typeutils,type,singleton,date,time,timespan,tools,batcave,utils
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# batutils - Team Batcave Python Toolkit
+
+[![PyPI](https://img.shields.io/pypi/v/batutils)](https://pypi.org/project/batutils/)
+
+A grab-bag of small, dependency-free Python utilities for working with dates
+and times and for everyday type juggling, originally written by Team Batcave
+at CCP Games.
+
+This is a fork of [`ccptools`](https://github.com/ccpgames/ccptools), kept alive
+beyond the original team's lifespan. Our two most commonly used internal packages,
+`datetimeutils` and `typeutils`, had names that were too generic for PyPI and were
+used in 80-90% of our other projects, so they were smooshed together into one
+package.
+
+```bash
+pip install batutils
+```
+
+Requires Python 3.10 or newer.
+
+## What's inside
+
+| Submodule | Formerly | What it is | Docs |
+|-----------|----------|------------|------|
+| `batutils.dtu` | `datetimeutils` | Casting, parsing, formatting and shortcuts for date/time values | [Date/Time Utils](batutils/dtu/README.md) |
+| `batutils.tpu` | `typeutils` | Safe type evaluation, nested dict/list helpers, enums, singletons, serializers and more | [Type Utils](batutils/tpu/README.md) |
+| `batutils.structs` | | One-line "usual imports" for your modules | [below](#common-imports) |
+
+**Looking for a specific function?** Use the task-oriented
+[Public API index](docs/api-index.md).
+
+## Quick taste
+
+```python
+from batutils import dtu
+from batutils.tpu.casting import int_eval, bool_eval
+from batutils.tpu.iters import nested_get
+
+dtu.any_to_datetime('2024-04-02 13:47:25')   # datetime(2024, 4, 2, 13, 47, 25)
+dtu.agostr(dtu.ago(days=5))                  # '5 days'
+int_eval('0x10')                             # 16
+bool_eval('Yes')                             # True
+nested_get({'a': {'b': [1, 2, 3]}}, ('a', 'b', -1))   # 3
+```
+
+## Common imports
+
+`from batutils.structs import *` pulls in the imports that nearly every file in
+our projects needs:
+
+```python
+from typing import *       # for type annotations
+import abc                 # interfaces (Abstract Base Classes)
+import dataclasses         # dataclass structs
+import decimal             # anything involving money
+import enum                # also used for struct creation
+import logging             # used pretty much everywhere
+import re                  # used surprisingly frequently
+import time                # very commonly used
+```
+
+`datetime` itself is not included. Instead you get the date/time aliases from
+`batutils.dtu.structs.aliases`:
+
+```python
+Date = datetime.date
+Time = datetime.time
+Datetime = datetime.datetime
+TimeDelta = datetime.timedelta
+TzInfo = datetime.tzinfo
+TimeZone = datetime.timezone
+```
+
+Plus a few of the most commonly used helpers from the type utils:
+
+- the `Singleton` metaclass
+- `Empty`, `EmptyDict` and `if_empty`
+- the `EnumEx` base class for enums (adds the `from_any` class method)
+
+So one line covers roughly 90% of the imports we need in any given file:
+
+```python
+from batutils.structs import *
+```
+
+## Changes from `ccptools`
+
+The `legacyapi` submodule has been removed. See the [changelog](CHANGELOG.md)
+for the full history.
+
+## Contributing and license
+
+Issues and pull requests are welcome at
+[github.com/doddi79/batutils](https://github.com/doddi79/batutils). Released
+under the [MIT License](LICENSE).

batutils-2.2.1/README.md

@@ -0,0 +1,95 @@
+# batutils - Team Batcave Python Toolkit
+
+[![PyPI](https://img.shields.io/pypi/v/batutils)](https://pypi.org/project/batutils/)
+
+A grab-bag of small, dependency-free Python utilities for working with dates
+and times and for everyday type juggling, originally written by Team Batcave
+at CCP Games.
+
+This is a fork of [`ccptools`](https://github.com/ccpgames/ccptools), kept alive
+beyond the original team's lifespan. Our two most commonly used internal packages,
+`datetimeutils` and `typeutils`, had names that were too generic for PyPI and were
+used in 80-90% of our other projects, so they were smooshed together into one
+package.
+
+```bash
+pip install batutils
+```
+
+Requires Python 3.10 or newer.
+
+## What's inside
+
+| Submodule | Formerly | What it is | Docs |
+|-----------|----------|------------|------|
+| `batutils.dtu` | `datetimeutils` | Casting, parsing, formatting and shortcuts for date/time values | [Date/Time Utils](batutils/dtu/README.md) |
+| `batutils.tpu` | `typeutils` | Safe type evaluation, nested dict/list helpers, enums, singletons, serializers and more | [Type Utils](batutils/tpu/README.md) |
+| `batutils.structs` | | One-line "usual imports" for your modules | [below](#common-imports) |
+
+**Looking for a specific function?** Use the task-oriented
+[Public API index](docs/api-index.md).
+
+## Quick taste
+
+```python
+from batutils import dtu
+from batutils.tpu.casting import int_eval, bool_eval
+from batutils.tpu.iters import nested_get
+
+dtu.any_to_datetime('2024-04-02 13:47:25')   # datetime(2024, 4, 2, 13, 47, 25)
+dtu.agostr(dtu.ago(days=5))                  # '5 days'
+int_eval('0x10')                             # 16
+bool_eval('Yes')                             # True
+nested_get({'a': {'b': [1, 2, 3]}}, ('a', 'b', -1))   # 3
+```
+
+## Common imports
+
+`from batutils.structs import *` pulls in the imports that nearly every file in
+our projects needs:
+
+```python
+from typing import *       # for type annotations
+import abc                 # interfaces (Abstract Base Classes)
+import dataclasses         # dataclass structs
+import decimal             # anything involving money
+import enum                # also used for struct creation
+import logging             # used pretty much everywhere
+import re                  # used surprisingly frequently
+import time                # very commonly used
+```
+
+`datetime` itself is not included. Instead you get the date/time aliases from
+`batutils.dtu.structs.aliases`:
+
+```python
+Date = datetime.date
+Time = datetime.time
+Datetime = datetime.datetime
+TimeDelta = datetime.timedelta
+TzInfo = datetime.tzinfo
+TimeZone = datetime.timezone
+```
+
+Plus a few of the most commonly used helpers from the type utils:
+
+- the `Singleton` metaclass
+- `Empty`, `EmptyDict` and `if_empty`
+- the `EnumEx` base class for enums (adds the `from_any` class method)
+
+So one line covers roughly 90% of the imports we need in any given file:
+
+```python
+from batutils.structs import *
+```
+
+## Changes from `ccptools`
+
+The `legacyapi` submodule has been removed. See the [changelog](CHANGELOG.md)
+for the full history.
+
+## Contributing and license
+
+Issues and pull requests are welcome at
+[github.com/doddi79/batutils](https://github.com/doddi79/batutils). Released
+under the [MIT License](LICENSE).

{batutils-2.1.0 → batutils-2.2.1}/batutils/__init__.py

@@ -1,5 +1,5 @@
-__version__ = '2.1.0'
+__version__ = '2.2.1'
 
 __author__ = 'Thordur Matthiasson <doddi79@gmail.com>'
 __license__ = 'MIT License'
-__copyright__ = 'Copyright 2024-2025 - Thordur Matthiasson, Copyright 2013-2024 - CCP Games ehf'
+__copyright__ = 'Copyright 2024-2026 - Thordur Matthiasson, Copyright 2013-2024 - CCP Games ehf'

{batutils-2.1.0 → batutils-2.2.1}/batutils/dtu/casting/_any.py

@@ -90,7 +90,7 @@ def any_to_datetime(temporal_object: T_TEMPORAL_VALUE,
                 # This range means that the number, if treated as an instant,
                 # represents a datetime within 1000 years to/from now so it's the
                 # second most likely bet!
-                return timestamp_to_datetime(temporal_object)
+                return instant_to_datetime(temporal_object)
 
             # This number is so large that it's most likely a filetime!
             return filetime_to_datetime(temporal_object)

{batutils-2.1.0 → batutils-2.2.1}/batutils/dtu/casting/_instant.py

@@ -16,7 +16,12 @@ def instant_to_datetime(milliseconds_since_epoch: T_NUMBER, minmax_on_fail: bool
                            negative)
     :return: A Python Datetime
     """
-    return timestamp_to_datetime(milliseconds_since_epoch / 1000., minmax_on_fail)
+    try:
+        return Datetime(1970, 1, 1) + TimeDelta(milliseconds=milliseconds_since_epoch)
+    except OverflowError:
+        if minmax_on_fail:
+            return Datetime.max if milliseconds_since_epoch > 0 else Datetime.min
+        raise
 
 
 def datetime_to_instant(dt: T_DATE_VALUE) -> int:

{batutils-2.1.0 → batutils-2.2.1}/batutils/dtu/casting/_timestamp.py

@@ -17,18 +17,11 @@ def timestamp_to_datetime(seconds_since_epoch: T_NUMBER, minmax_on_fail: bool =
     :return: A Python Datetime
     """
     try:
-        return Datetime.fromtimestamp(seconds_since_epoch)
-    except OSError:
-        try:
-            return Datetime(1970, 1, 1, 0, 0, 0, 0) + TimeDelta(seconds=seconds_since_epoch)
-        except OverflowError:
-            if minmax_on_fail:
-                if seconds_since_epoch > 0:
-                    return Datetime.max
-                else:
-                    return Datetime.min
-            else:
-                raise
+        return Datetime(1970, 1, 1) + TimeDelta(seconds=seconds_since_epoch)
+    except OverflowError:
+        if minmax_on_fail:
+            return Datetime.max if seconds_since_epoch > 0 else Datetime.min
+        raise
 
 
 def datetime_to_timestamp(dt: T_DATE_VALUE) -> float:

{batutils-2.1.0 → batutils-2.2.1}/batutils/tpu/casting/_evals.py

@@ -4,6 +4,8 @@ __all__ = [
     'bool_eval',
     'enum_eval',
 
+    'enum_value_lookup_map',
+
     'decode_bytes',
 ]
 
@@ -223,9 +225,24 @@ def enum_eval(value: Any,
             return default
 
     if isinstance(value, str):
+        # First we check the member name (normalized)
         hit = {n.lower(): m for n, m in enum_class.__members__.items()}.get(value.strip().lower(), None)
         if hit is not None:
             return hit
+
+    try:
+        value_lookup = enum_value_lookup_map(enum_class, allow_collision=False)
+    except KeyError:
+        if raise_on_fail:
+            raise
+        return default
+
+    # This covers just about everything, except where a numeric value was given as a string
+    hit = value_lookup.get(value, None)
+    if hit is not None:
+        return hit
+
+    if isinstance(value, str):
         try:
             value = int(value, base=0)
         except ValueError:
@@ -233,15 +250,53 @@ def enum_eval(value: Any,
                 raise ValueError(f'{value!r} is not a valid {enum_class.__name__}')
             return default
 
-    if isinstance(value, int):
-        try:
-            return enum_class(value)
-        except ValueError:
-            if raise_on_fail:
-                raise
-            return default
+        # Retry after casting
+        hit = value_lookup.get(value, None)
+        if hit is not None:
+            return hit
 
     if raise_on_fail:
         raise ValueError(f'{value!r} is not a valid {enum_class.__name__}')
 
     return default
+
+
+def enum_value_lookup_map(enum_class: Type[_T_ENUM_CLASS], allow_collision: bool = False) -> Dict[Any, _T_ENUM_CLASS]:
+    """Returns a dict of all the values of an enum class as keys and their respective members as values for reverse
+    value lookups.
+
+    This also breaks down the individual values in the value tuple of a multi-value enum and includes each of those as
+    a lookup key as well. By default, this will raise a `KeyError` if any individual value is repeated with a different
+    member as its target but this can be suppressed by setting `allow_collision=True`
+
+    Example:
+    ```python
+    import enum
+
+    class MyGoodEnum(enum.Enum):
+        FOO = ('one', 'one'),  # This is fine
+        BAR = ('something', 'else'),
+
+    class MyBadEnum(enum.Enum):
+        FOO = ('one', 'something'),
+        BAR = ('one', 'else'),  # This will result in a collision with FOO's 'one' and raise a KeyError by default
+    ```
+    """
+    d = {}
+
+    def _collision_free_add(value: Any, enum_member: _T_ENUM_CLASS):
+        if allow_collision:
+            d[value] = enum_member
+        else:
+            if value in d:
+                if d[value] != enum_member:
+                    raise KeyError(f'value lookup map for {enum_class.__name__} resulted in a collision between {d[value]} and {enum_member} for the value {value!r}')
+            else:
+                d[value] = enum_member
+
+    for _, member in enum_class.__members__.items():
+        _collision_free_add(member.value, member)
+        if isinstance(member.value, tuple):
+            for v in member.value:
+                _collision_free_add(v, member)
+    return d

batutils-2.2.1/batutils.egg-info/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: batutils
+Version: 2.2.1
+Summary: Team Batcave's utilities for date and/or time objects and values and messing with types and so much more.
+Author-email: Thordur Matthiasson <doddi79@gmail.com>, John Aldis <johnaldis@ccpgames.com>
+License: MIT License
+        
+        Copyright (c) 2024-2026 Thordur Matthiasson
+        Copyright (c) 2013-2024 CCP Games
+        
+        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: Homepage, https://github.com/doddi79/batutils
+Project-URL: Documentation, https://github.com/doddi79/batutils/blob/main/README.md
+Project-URL: Repository, https://github.com/doddi79/batutils.git
+Project-URL: Issues, https://github.com/doddi79/batutils/issues
+Project-URL: Changelog, https://github.com/doddi79/batutils/blob/main/CHANGELOG.md
+Keywords: datetimeutils,datetime,typeutils,type,singleton,date,time,timespan,tools,batcave,utils
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# batutils - Team Batcave Python Toolkit
+
+[![PyPI](https://img.shields.io/pypi/v/batutils)](https://pypi.org/project/batutils/)
+
+A grab-bag of small, dependency-free Python utilities for working with dates
+and times and for everyday type juggling, originally written by Team Batcave
+at CCP Games.
+
+This is a fork of [`ccptools`](https://github.com/ccpgames/ccptools), kept alive
+beyond the original team's lifespan. Our two most commonly used internal packages,
+`datetimeutils` and `typeutils`, had names that were too generic for PyPI and were
+used in 80-90% of our other projects, so they were smooshed together into one
+package.
+
+```bash
+pip install batutils
+```
+
+Requires Python 3.10 or newer.
+
+## What's inside
+
+| Submodule | Formerly | What it is | Docs |
+|-----------|----------|------------|------|
+| `batutils.dtu` | `datetimeutils` | Casting, parsing, formatting and shortcuts for date/time values | [Date/Time Utils](batutils/dtu/README.md) |
+| `batutils.tpu` | `typeutils` | Safe type evaluation, nested dict/list helpers, enums, singletons, serializers and more | [Type Utils](batutils/tpu/README.md) |
+| `batutils.structs` | | One-line "usual imports" for your modules | [below](#common-imports) |
+
+**Looking for a specific function?** Use the task-oriented
+[Public API index](docs/api-index.md).
+
+## Quick taste
+
+```python
+from batutils import dtu
+from batutils.tpu.casting import int_eval, bool_eval
+from batutils.tpu.iters import nested_get
+
+dtu.any_to_datetime('2024-04-02 13:47:25')   # datetime(2024, 4, 2, 13, 47, 25)
+dtu.agostr(dtu.ago(days=5))                  # '5 days'
+int_eval('0x10')                             # 16
+bool_eval('Yes')                             # True
+nested_get({'a': {'b': [1, 2, 3]}}, ('a', 'b', -1))   # 3
+```
+
+## Common imports
+
+`from batutils.structs import *` pulls in the imports that nearly every file in
+our projects needs:
+
+```python
+from typing import *       # for type annotations
+import abc                 # interfaces (Abstract Base Classes)
+import dataclasses         # dataclass structs
+import decimal             # anything involving money
+import enum                # also used for struct creation
+import logging             # used pretty much everywhere
+import re                  # used surprisingly frequently
+import time                # very commonly used
+```
+
+`datetime` itself is not included. Instead you get the date/time aliases from
+`batutils.dtu.structs.aliases`:
+
+```python
+Date = datetime.date
+Time = datetime.time
+Datetime = datetime.datetime
+TimeDelta = datetime.timedelta
+TzInfo = datetime.tzinfo
+TimeZone = datetime.timezone
+```
+
+Plus a few of the most commonly used helpers from the type utils:
+
+- the `Singleton` metaclass
+- `Empty`, `EmptyDict` and `if_empty`
+- the `EnumEx` base class for enums (adds the `from_any` class method)
+
+So one line covers roughly 90% of the imports we need in any given file:
+
+```python
+from batutils.structs import *
+```
+
+## Changes from `ccptools`
+
+The `legacyapi` submodule has been removed. See the [changelog](CHANGELOG.md)
+for the full history.
+
+## Contributing and license
+
+Issues and pull requests are welcome at
+[github.com/doddi79/batutils](https://github.com/doddi79/batutils). Released
+under the [MIT License](LICENSE).

{batutils-2.1.0 → batutils-2.2.1}/batutils.egg-info/top_level.txt

@@ -1 +1,2 @@
 batutils
+docs

{batutils-2.1.0 → batutils-2.2.1}/pyproject.toml

@@ -22,11 +22,11 @@ classifiers = [
 
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
 
     "Topic :: Software Development",
     "Topic :: Software Development :: Libraries",

batutils-2.1.0/PKG-INFO

@@ -1,125 +0,0 @@
-Metadata-Version: 2.1
-Name: batutils
-Version: 2.1.0
-Summary: Team Batcave's utilities for date and/or time objects and values and messing with types and so much more.
-Author-email: Thordur Matthiasson <doddi79@gmail.com>, John Aldis <johnaldis@ccpgames.com>
-License: MIT License
-        
-        Copyright (c) 2024-2025 Thordur Matthiasson
-        Copyright (c) 2013-2024 CCP Games
-        
-        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: Homepage, https://github.com/doddi79/batutils
-Project-URL: Documentation, https://github.com/doddi79/batutils/blob/main/README.md
-Project-URL: Repository, https://github.com/doddi79/batutils.git
-Project-URL: Issues, https://github.com/doddi79/batutils/issues
-Project-URL: Changelog, https://github.com/doddi79/batutils/blob/main/CHANGELOG.md
-Keywords: datetimeutils,datetime,typeutils,type,singleton,date,time,timespan,tools,batcave,utils
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Utilities
-Description-Content-Type: text/markdown
-License-File: LICENSE
-
-# Team Batcave Python Toolkit
-
-The `batutils` is a fork of the `batutils` package in order to continue its 
-development and maintenance beyond Team Batcave's lifespan.  
-
-It is a smooshup of a few Python packages from the CCP Tools Team of old (Team 
-Batcave).
-
-Our two most commonly used internal packages, called `datetimeutils` and 
-`typeutils` were too _generically_ named for Pypi.org and since they were 
-both used in something like 80-90% of our other projects, it made sense to 
-just smoosh them together in one module, and thus, the `batutils` package 
-was born.
-
-Here's the README of the [Date Time Utils](batutils/dtu/README.md) submodule.
-
-Here's the README of the [Type Utils](batutils/tpu/README.md) submodule.
-
-
-### Changes from `ccptools`
-
-The `legacyapi` submodule has been removed.
-
-
-## Date-Time Utils
-
-The old `datetimeutils` package is now included here as the `dtu` submodule.
-
-```python
-from batutils import dtu
-```
-
-## Structs
-
-Importing `*` from the `structs` submodule will import all of the most 
-commonly used imports in our projects:
-```python
-from typing import *  # For type annotation
-
-import abc  # For interfaces (Abstract Base Classes)
-import dataclasses  # For dataclass structs
-import decimal  # Used whenever we're handling money
-import enum  # Also used for struct creation
-import logging  # Used pretty much everywhere
-import re  # Used surprisingly frequently
-import time  # Very commonly used
-```
-
-Note that datetime is not included in this. That's because tt'll also import 
-the aliases from the Datetime Utils (`batutils.dtu.structs.aliases`) 
-package instead:
-
-```python
-Date = datetime.date
-Time = datetime.time
-Datetime = datetime.datetime
-TimeDelta = datetime.timedelta
-TzInfo = datetime.tzinfo
-TimeZone = datetime.timezone
-```
-
-Furthermore, it'll also include a few of the most commonly used utility 
-classes from the Type Utils submodule:
-
-- The `Singleton` Meta Class 
-- The `Empty` and `EmptyDict` classes as well as the `if_empty` method
-- The `EnumEx` base class for Enums with the `from_any` class method
-
-So in most cases we can cover something like 90% of any imports we tend to 
-need in every Python file with a single line:
-
-```python
-from batutils.structs import *
-```

batutils-2.1.0/README.md

@@ -1,74 +0,0 @@
-# Team Batcave Python Toolkit
-
-The `batutils` is a fork of the `batutils` package in order to continue its 
-development and maintenance beyond Team Batcave's lifespan.  
-
-It is a smooshup of a few Python packages from the CCP Tools Team of old (Team 
-Batcave).
-
-Our two most commonly used internal packages, called `datetimeutils` and 
-`typeutils` were too _generically_ named for Pypi.org and since they were 
-both used in something like 80-90% of our other projects, it made sense to 
-just smoosh them together in one module, and thus, the `batutils` package 
-was born.
-
-Here's the README of the [Date Time Utils](batutils/dtu/README.md) submodule.
-
-Here's the README of the [Type Utils](batutils/tpu/README.md) submodule.
-
-
-### Changes from `ccptools`
-
-The `legacyapi` submodule has been removed.
-
-
-## Date-Time Utils
-
-The old `datetimeutils` package is now included here as the `dtu` submodule.
-
-```python
-from batutils import dtu
-```
-
-## Structs
-
-Importing `*` from the `structs` submodule will import all of the most 
-commonly used imports in our projects:
-```python
-from typing import *  # For type annotation
-
-import abc  # For interfaces (Abstract Base Classes)
-import dataclasses  # For dataclass structs
-import decimal  # Used whenever we're handling money
-import enum  # Also used for struct creation
-import logging  # Used pretty much everywhere
-import re  # Used surprisingly frequently
-import time  # Very commonly used
-```
-
-Note that datetime is not included in this. That's because tt'll also import 
-the aliases from the Datetime Utils (`batutils.dtu.structs.aliases`) 
-package instead:
-
-```python
-Date = datetime.date
-Time = datetime.time
-Datetime = datetime.datetime
-TimeDelta = datetime.timedelta
-TzInfo = datetime.tzinfo
-TimeZone = datetime.timezone
-```
-
-Furthermore, it'll also include a few of the most commonly used utility 
-classes from the Type Utils submodule:
-
-- The `Singleton` Meta Class 
-- The `Empty` and `EmptyDict` classes as well as the `if_empty` method
-- The `EnumEx` base class for Enums with the `from_any` class method
-
-So in most cases we can cover something like 90% of any imports we tend to 
-need in every Python file with a single line:
-
-```python
-from batutils.structs import *
-```

batutils-2.1.0/batutils.egg-info/PKG-INFO

@@ -1,125 +0,0 @@
-Metadata-Version: 2.1
-Name: batutils
-Version: 2.1.0
-Summary: Team Batcave's utilities for date and/or time objects and values and messing with types and so much more.
-Author-email: Thordur Matthiasson <doddi79@gmail.com>, John Aldis <johnaldis@ccpgames.com>
-License: MIT License
-        
-        Copyright (c) 2024-2025 Thordur Matthiasson
-        Copyright (c) 2013-2024 CCP Games
-        
-        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: Homepage, https://github.com/doddi79/batutils
-Project-URL: Documentation, https://github.com/doddi79/batutils/blob/main/README.md
-Project-URL: Repository, https://github.com/doddi79/batutils.git
-Project-URL: Issues, https://github.com/doddi79/batutils/issues
-Project-URL: Changelog, https://github.com/doddi79/batutils/blob/main/CHANGELOG.md
-Keywords: datetimeutils,datetime,typeutils,type,singleton,date,time,timespan,tools,batcave,utils
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Utilities
-Description-Content-Type: text/markdown
-License-File: LICENSE
-
-# Team Batcave Python Toolkit
-
-The `batutils` is a fork of the `batutils` package in order to continue its 
-development and maintenance beyond Team Batcave's lifespan.  
-
-It is a smooshup of a few Python packages from the CCP Tools Team of old (Team 
-Batcave).
-
-Our two most commonly used internal packages, called `datetimeutils` and 
-`typeutils` were too _generically_ named for Pypi.org and since they were 
-both used in something like 80-90% of our other projects, it made sense to 
-just smoosh them together in one module, and thus, the `batutils` package 
-was born.
-
-Here's the README of the [Date Time Utils](batutils/dtu/README.md) submodule.
-
-Here's the README of the [Type Utils](batutils/tpu/README.md) submodule.
-
-
-### Changes from `ccptools`
-
-The `legacyapi` submodule has been removed.
-
-
-## Date-Time Utils
-
-The old `datetimeutils` package is now included here as the `dtu` submodule.
-
-```python
-from batutils import dtu
-```
-
-## Structs
-
-Importing `*` from the `structs` submodule will import all of the most 
-commonly used imports in our projects:
-```python
-from typing import *  # For type annotation
-
-import abc  # For interfaces (Abstract Base Classes)
-import dataclasses  # For dataclass structs
-import decimal  # Used whenever we're handling money
-import enum  # Also used for struct creation
-import logging  # Used pretty much everywhere
-import re  # Used surprisingly frequently
-import time  # Very commonly used
-```
-
-Note that datetime is not included in this. That's because tt'll also import 
-the aliases from the Datetime Utils (`batutils.dtu.structs.aliases`) 
-package instead:
-
-```python
-Date = datetime.date
-Time = datetime.time
-Datetime = datetime.datetime
-TimeDelta = datetime.timedelta
-TzInfo = datetime.tzinfo
-TimeZone = datetime.timezone
-```
-
-Furthermore, it'll also include a few of the most commonly used utility 
-classes from the Type Utils submodule:
-
-- The `Singleton` Meta Class 
-- The `Empty` and `EmptyDict` classes as well as the `if_empty` method
-- The `EnumEx` base class for Enums with the `from_any` class method
-
-So in most cases we can cover something like 90% of any imports we tend to 
-need in every Python file with a single line:
-
-```python
-from batutils.structs import *
-```