miska 0.0.1__tar.gz

miska-0.0.1/LICENSE

@@ -0,0 +1,23 @@
+Copyright (c) 2023-2024 Dmitry Burmistrov
+
+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.
+
+Except as contained in this notice, the name(s) of the above copyright holders
+shall not be used in advertising or otherwise to promote the sale, use or other
+dealings in this Software without prior written authorization.

miska-0.0.1/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.1
+Name: miska
+Version: 0.0.1
+Summary: An exceptional library
+Author-email: Dima Burmistrov <pyctrl.dev@gmail.com>
+License: Copyright (c) 2023-2024 Dmitry Burmistrov
+        
+        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.
+        
+        Except as contained in this notice, the name(s) of the above copyright holders
+        shall not be used in advertising or otherwise to promote the sale, use or other
+        dealings in this Software without prior written authorization.
+        
+Project-URL: Homepage, https://gitlab.com/pyctrl/miska
+Project-URL: Bug Tracker, https://gitlab.com/pyctrl/miska/-/issues
+Keywords: misc,miska
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+
+Miska
+#####
+
+Package with **miska**-llaneous code, tools and stuff
+
+
+Versioning
+**********
+
+`SemVer <http://semver.org/>`__ used for versioning.
+For available versions see the repository
+`tags <https://gitlab.com/pyctrl/miska/-/tags>`__
+and `releases <https://gitlab.com/pyctrl/miska/-/releases>`__.
+
+
+Authors
+*******
+
+-  **Dima Burmistrov** - *Initial work* -
+   `pyctrl <https://gitlab.com/pyctrl/>`__
+
+
+License
+*******
+
+This project is licensed under the X11 License (extended MIT) - see the
+`LICENSE <https://gitlab.com/pyctrl/miska/-/blob/main/LICENSE>`__ file for details

miska-0.0.1/README.rst

@@ -0,0 +1,27 @@
+Miska
+#####
+
+Package with **miska**-llaneous code, tools and stuff
+
+
+Versioning
+**********
+
+`SemVer <http://semver.org/>`__ used for versioning.
+For available versions see the repository
+`tags <https://gitlab.com/pyctrl/miska/-/tags>`__
+and `releases <https://gitlab.com/pyctrl/miska/-/releases>`__.
+
+
+Authors
+*******
+
+-  **Dima Burmistrov** - *Initial work* -
+   `pyctrl <https://gitlab.com/pyctrl/>`__
+
+
+License
+*******
+
+This project is licensed under the X11 License (extended MIT) - see the
+`LICENSE <https://gitlab.com/pyctrl/miska/-/blob/main/LICENSE>`__ file for details

miska-0.0.1/miska/mixins.py

@@ -0,0 +1,8 @@
+class KwargsOnly:
+
+    def __new__(cls, *args, **kwargs):
+        if args:
+            raise TypeError("%s only accepts kwargs" % cls)
+        inst = super().__new__(cls)
+        inst.__kwargs = kwargs
+        return inst

miska-0.0.1/miska/registry.py

@@ -0,0 +1,24 @@
+import typing as t
+
+
+class RegistryNotFoundError(Exception):
+    pass
+
+
+class BaseRegistry:
+
+    __repo_map: dict[str, dict[str, type]] = {}
+
+    __repo_type__: str
+
+    def __init_subclass__(cls, **kwargs: t.Any):
+        super().__init_subclass__(**kwargs)
+        BaseRegistry.__repo_map.setdefault(cls.__repo_type__, {}
+                                           )[cls.__name__] = cls
+
+    @classmethod
+    def get_repo_by_name(cls, class_name: str) -> type:
+        mapping = cls.__repo_map[cls.__repo_type__]
+        if class_name not in mapping:
+            raise RegistryNotFoundError(class_name)
+        return mapping[class_name]

miska-0.0.1/miska/types/network/bgp.py

@@ -0,0 +1,116 @@
+import contextlib
+import typing as t
+
+
+# class Community:
+#     def __init__(self, value: int):  # ???
+#         ...
+#
+#     @classmethod
+#     def from_string(cls, val: str):
+#         ...
+
+
+class ASN:
+
+    """BGP ASN data type
+
+    https://networklessons.com/bgp/bgp-4-byte-number
+    """
+
+    _SEP = "."
+    _ZERO = 0
+    _TWO_BYTES = 2 ** 16
+    _FOUR_BYTES = 2 ** 32
+
+    def __init__(self, number: int):
+        if not isinstance(number, int):
+            raise TypeError(f"int expected, got: {type(number)}")
+
+        if not (self._ZERO <= number < self._FOUR_BYTES):
+            msg = f"Value must be in range {self._ZERO}-{self._FOUR_BYTES - 1}"
+            raise ValueError(msg)
+
+        self._number = number
+
+    @classmethod
+    def from_plain(cls, string: str) -> t.Self:
+        if not isinstance(string, str):
+            raise TypeError(f"str expected, got: {type(string)}")
+
+        return cls(int(string))
+
+    def to_plain(self) -> str:
+        return str(self._number)
+
+    @classmethod
+    def from_asdot(cls, string: str) -> t.Self:
+        with contextlib.suppress(Exception):
+            result = cls.from_plain(string)
+            if int(result) < cls._TWO_BYTES:
+                return result
+        return cls.from_asdotplus(string)
+
+    def to_asdot(self) -> str:
+        if self._number < self._TWO_BYTES:
+            return self.to_plain()
+        return self.to_asdotplus()
+
+    @classmethod
+    def from_asdotplus(cls, string: str) -> t.Self:
+        if not isinstance(string, str):
+            raise TypeError(f"str expected, got: {type(string)}")
+
+        high, low = map(int, string.split(cls._SEP, maxsplit=1))
+        return cls(high * cls._TWO_BYTES + low)
+
+    def to_asdotplus(self) -> str:
+        return self._SEP.join(map(str, divmod(self._number, self._TWO_BYTES)))
+
+    @classmethod
+    def parse(cls, data: int | str) -> t.Self:
+        with contextlib.suppress(Exception):
+            return cls(t.cast(int, data))
+        data = t.cast(str, data)
+        with contextlib.suppress(Exception):
+            return cls.from_plain(data)
+        with contextlib.suppress(Exception):
+            return cls.from_asdotplus(data)
+        raise ValueError(f"Unable to parse data into {cls}")
+
+    def __int__(self) -> int:
+        return self._number
+
+    def __str__(self) -> str:
+        return f"<{self.__class__.__name__}: {self.to_asdotplus()}>"
+
+    def __repr__(self) -> str:
+        return f"{self.__class__.__name__}({self._number})"
+
+    def __copy__(self):
+        return type(self)(self._number)
+
+    def __deepcopy__(self, memo: dict[int, t.Any]):
+        _id = id(self)
+        if _id not in memo:
+            memo[_id] = type(self)(self._number)
+        return memo[_id]
+
+    def __reduce__(self) -> tuple[t.Any, ...]:
+        return self.__class__, (self._number,)
+
+    def __hash__(self) -> int:
+        return hash(self._number)
+
+    def __eq__(self, other) -> bool:
+        return (isinstance(other, self.__class__)
+                and (int(other) == self._number))
+
+
+# print(ASN(6541))   # 0.6541
+# print(ASN(54233))  # 0.54233
+# print(ASN(544))    # 0.544
+#
+# print(ASN(65536))    # 1.0
+# print(ASN(65537))    # 1.1
+# print(ASN(65538))    # 1.2

miska-0.0.1/miska.egg-info/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.1
+Name: miska
+Version: 0.0.1
+Summary: An exceptional library
+Author-email: Dima Burmistrov <pyctrl.dev@gmail.com>
+License: Copyright (c) 2023-2024 Dmitry Burmistrov
+        
+        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.
+        
+        Except as contained in this notice, the name(s) of the above copyright holders
+        shall not be used in advertising or otherwise to promote the sale, use or other
+        dealings in this Software without prior written authorization.
+        
+Project-URL: Homepage, https://gitlab.com/pyctrl/miska
+Project-URL: Bug Tracker, https://gitlab.com/pyctrl/miska/-/issues
+Keywords: misc,miska
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+
+Miska
+#####
+
+Package with **miska**-llaneous code, tools and stuff
+
+
+Versioning
+**********
+
+`SemVer <http://semver.org/>`__ used for versioning.
+For available versions see the repository
+`tags <https://gitlab.com/pyctrl/miska/-/tags>`__
+and `releases <https://gitlab.com/pyctrl/miska/-/releases>`__.
+
+
+Authors
+*******
+
+-  **Dima Burmistrov** - *Initial work* -
+   `pyctrl <https://gitlab.com/pyctrl/>`__
+
+
+License
+*******
+
+This project is licensed under the X11 License (extended MIT) - see the
+`LICENSE <https://gitlab.com/pyctrl/miska/-/blob/main/LICENSE>`__ file for details

miska-0.0.1/miska.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.rst
+pyproject.toml
+miska/__init__.py
+miska/mixins.py
+miska/registry.py
+miska.egg-info/PKG-INFO
+miska.egg-info/SOURCES.txt
+miska.egg-info/dependency_links.txt
+miska.egg-info/top_level.txt
+miska/types/__init__.py
+miska/types/network/__init__.py
+miska/types/network/bgp.py
+tests/test_registry.py

miska-0.0.1/miska.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

miska-0.0.1/miska.egg-info/top_level.txt

@@ -0,0 +1 @@
+miska

miska-0.0.1/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "miska"
+version = "0.0.1"
+authors = [
+  { name="Dima Burmistrov", email="pyctrl.dev@gmail.com" },
+]
+description = "An exceptional library"
+readme = "README.rst"
+license = {file = "LICENSE"}
+
+requires-python = ">=3.11"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+keywords = ["misc", "miska"]
+
+[project.urls]
+"Homepage" = "https://gitlab.com/pyctrl/miska"
+"Bug Tracker" = "https://gitlab.com/pyctrl/miska/-/issues"

miska-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

miska-0.0.1/tests/test_registry.py

@@ -0,0 +1,10 @@
+from miska import registry
+
+
+def test_registry():
+    class Registry(registry.BaseRegistry):
+        __repo_type__ = "things"
+
+    result = Registry.get_repo_by_name("Registry")
+
+    assert result == Registry