IDKit 1.0.2__tar.gz → 1.0.3__tar.gz

{idkit-1.0.2 → idkit-1.0.3}/IDKit.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: IDKit
-Version: 1.0.2
+Version: 1.0.3
 Summary: A typed, dot-notation identifier system for Python 3.12+.
 Author: Ryan Kohl
 License-Expression: MIT

{idkit-1.0.2 → idkit-1.0.3}/IDKit.egg-info/SOURCES.txt

@@ -13,6 +13,7 @@ idkit/protocols.py
 idkit/py.typed
 idkit/namespaces/__init__.py
 idkit/namespaces/group.py
+idkit/namespaces/namespace.py
 idkit/namespaces/operation.py
 idkit/namespaces/role.py
 idkit/namespaces/source.py

{idkit-1.0.2 → idkit-1.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: IDKit
-Version: 1.0.2
+Version: 1.0.3
 Summary: A typed, dot-notation identifier system for Python 3.12+.
 Author: Ryan Kohl
 License-Expression: MIT

{idkit-1.0.2 → idkit-1.0.3}/idkit/id.py

@@ -12,9 +12,10 @@ from .namespaces import (
     SourceNamespace,
 )
 
-
 type Identifier = Identity[GroupNamespace, SourceNamespace, RoleNamespace]
 
+IDSpace = IdentityNamespace[GroupNamespace, SourceNamespace, RoleNamespace]
+
 type OperationIdentifier = Identity[GroupNamespace, SourceNamespace, OperationNamespace]
 
 type IDLike = IDKitIdentityLike[GroupNamespace, SourceNamespace, RoleNamespace]
@@ -40,11 +41,7 @@ and can be used as dictionary keys, registry identifiers,
 event topics, metric names, cache keys, and logging 
 namespaces.
 """
-ID: Identifier = IdentityNamespace(
-    group=GroupNamespace,
-    source=SourceNamespace,
-    role=RoleNamespace,
-)
+ID = IDSpace(group=GroupNamespace, source=SourceNamespace, role=RoleNamespace)
 
 
 __all__ = [

{idkit-1.0.2 → idkit-1.0.3}/idkit/identity.py

@@ -4,7 +4,7 @@ from dataclasses import dataclass, field
 from enum import StrEnum
 from typing import Any, Iterator, Self
 
-from .namespaces import Namespace
+from .namespaces.namespace import Namespace
 
 
 @dataclass(frozen=True)
@@ -215,9 +215,7 @@ class Identity[GN: Namespace, SN: Namespace, RN: Namespace]:
 
     def unique(self, unique_id: str) -> Self:
         if self.role is None:
-            raise IdentifierValidationError(
-                "Cannot set unique id before role."
-            )
+            raise IdentifierValidationError("Cannot set unique id before role.")
 
         if self.unique_id is not None:
             raise IdentifierValidationError("Identifier already has a unique id.")
@@ -579,7 +577,7 @@ class Identity[GN: Namespace, SN: Namespace, RN: Namespace]:
         )
 
 
-class IdentityNamespace[G: Namespace, S: Namespace, R: Namespace]:
+class IdentityNamespace[GN: Namespace, SN: Namespace, RN: Namespace]:
     """
     Entry point for constructing strongly typed identities.
 
@@ -638,15 +636,15 @@ class IdentityNamespace[G: Namespace, S: Namespace, R: Namespace]:
     def __init__(
         self,
         *,
-        group: type[G],
-        source: type[S],
-        role: type[R],
+        group: type[GN],
+        source: type[SN],
+        role: type[RN],
     ):
         self.group = group
         self.source = source
         self.role = role
 
-    def __getattr__(self, name: str) -> Identity[G, S, R]:
+    def __getattr__(self, name: str) -> Identity[GN, SN, RN]:
         if name in self.group.__members__:
             return Identity(
                 group=self.group[name],
@@ -656,7 +654,7 @@ class IdentityNamespace[G: Namespace, S: Namespace, R: Namespace]:
 
         raise AttributeError(name)
 
-    def parse(self, value: str) -> Identity[G, S, R]:
+    def parse(self, value: str) -> Identity[GN, SN, RN]:
         return Identity.parse(
             value,
             group_enum=self.group,
@@ -665,9 +663,6 @@ class IdentityNamespace[G: Namespace, S: Namespace, R: Namespace]:
         )
 
 
-IDSpace = IdentityNamespace
-
-
 class IdentifierError(Exception):
     """Base identifier exception."""
 

idkit-1.0.3/idkit/namespaces/__init__.py

@@ -0,0 +1,12 @@
+from .group import GroupNamespace
+from .source import SourceNamespace
+from .role import RoleNamespace
+from .operation import OperationNamespace
+
+
+__all__ = [
+    "GroupNamespace",
+    "SourceNamespace",
+    "RoleNamespace",
+    "OperationNamespace",
+]

{idkit-1.0.2 → idkit-1.0.3}/idkit/namespaces/group.py

@@ -1,7 +1,9 @@
-from enum import StrEnum, auto
+from enum import auto
 
+from .namespace import Namespace
 
-class GroupNamespace(StrEnum):
+
+class GroupNamespace(Namespace):
     """
     The `Group` defines the primary classification or architectural domain of the `identifier` in the first segment. It represents the highest level of organization (e.g., `system`, `service`, `manage`).
 
@@ -13,6 +15,8 @@ class GroupNamespace(StrEnum):
     Action — What does it do?
     """
 
+    # value: str
+
     system = auto()
     service = auto()
     core = auto()
@@ -76,7 +80,7 @@ class GroupNamespace(StrEnum):
     script = auto()
 
 
-class Architecture(StrEnum):
+class Architecture(Namespace):
     system = auto()
     service = auto()
     core = auto()
@@ -90,7 +94,7 @@ class Architecture(StrEnum):
     runtime = auto()
 
 
-class Infrastructure(StrEnum):
+class Infrastructure(Namespace):
     database = auto()
     storage = auto()
     cache = auto()
@@ -104,7 +108,7 @@ class Infrastructure(StrEnum):
     container = auto()
 
 
-class Data(StrEnum):
+class Data(Namespace):
     source = auto()
     stream = auto()
     pipeline = auto()
@@ -113,7 +117,7 @@ class Data(StrEnum):
     reporting = auto()
 
 
-class Interface(StrEnum):
+class Interface(Namespace):
     api = auto()
     web = auto()
     cli = auto()
@@ -123,7 +127,7 @@ class Interface(StrEnum):
     ui = auto()
 
 
-class Business(StrEnum):
+class Business(Namespace):
     domain = auto()
     business = auto()
     user = auto()
@@ -134,7 +138,7 @@ class Business(StrEnum):
     workspace = auto()
 
 
-class Automation(StrEnum):
+class Automation(Namespace):
     workflow = auto()
     scheduler = auto()
     worker = auto()
@@ -147,7 +151,7 @@ class Automation(StrEnum):
     ai = auto()
 
 
-class Development(StrEnum):
+class Development(Namespace):
     testing = auto()
     development = auto()
     staging = auto()

idkit-1.0.3/idkit/namespaces/namespace.py

@@ -0,0 +1,13 @@
+from enum import StrEnum
+
+"""
+The Namespace is a declarative value that provides a scope for the Identifier by organizing into logical segments.
+
+If subclasses `StrEnum` to provide a typed safe approach.
+
+Group — Where does it belong?
+Source — What is it?
+Component — Which part of it?
+Action — What does it do?
+"""
+Namespace = StrEnum

{idkit-1.0.2 → idkit-1.0.3}/idkit/namespaces/operation.py

@@ -1,7 +1,9 @@
-from enum import StrEnum, auto
+from enum import auto
 
+from .namespace import Namespace
 
-class OperationNamespace(StrEnum):
+
+class OperationNamespace(Namespace):
     """
     An operation describes what is being performed.
 
@@ -50,7 +52,6 @@ class OperationNamespace(StrEnum):
     track = auto()
     scan = auto()
     search = auto()
-    index = auto()
     discover = auto()
     authenticate = auto()
     authorize = auto()
@@ -67,14 +68,14 @@ class OperationNamespace(StrEnum):
     route = auto()
 
 
-class Lifecycle(StrEnum):
+class Lifecycle(Namespace):
     create = auto()
     delete = auto()
     initialize = auto()
     destroy = auto()
 
 
-class CURD(StrEnum):
+class CURD(Namespace):
     read = auto()
     write = auto()
     update = auto()
@@ -83,7 +84,7 @@ class CURD(StrEnum):
     delete = auto()
 
 
-class Process(StrEnum):
+class Process(Namespace):
     analyze = auto()
     process = auto()
     transform = auto()
@@ -94,7 +95,7 @@ class Process(StrEnum):
     deserialize = auto()
 
 
-class Validation(StrEnum):
+class Validation(Namespace):
     validate = auto()
     verify = auto()
     authorize = auto()
@@ -102,7 +103,7 @@ class Validation(StrEnum):
     confirm = auto()
 
 
-class Communication(StrEnum):
+class Communication(Namespace):
     send = auto()
     receive = auto()
     publish = auto()
@@ -112,22 +113,20 @@ class Communication(StrEnum):
     post = auto()
 
 
-class Discovery(StrEnum):
+class Discovery(Namespace):
     discover = auto()
     scan = auto()
     search = auto()
-    index = auto()
-    find = auto()
 
 
-class Monitoring(StrEnum):
+class Monitoring(Namespace):
     monitor = auto()
     observe = auto()
     track = auto()
     watch = auto()
 
 
-class Execution(StrEnum):
+class Execution(Namespace):
     execute = auto()
     run = auto()
     invoke = auto()

{idkit-1.0.2 → idkit-1.0.3}/idkit/namespaces/role.py

@@ -1,7 +1,9 @@
-from enum import StrEnum, auto
+from enum import auto
 
+from .namespace import Namespace
 
-class RoleNamespace(StrEnum):
+
+class RoleNamespace(Namespace):
     """
     A role describes what an identifier represents as a stable responsibility.
 

{idkit-1.0.2 → idkit-1.0.3}/idkit/namespaces/source.py

@@ -1,7 +1,9 @@
-from enum import StrEnum, auto
+from enum import auto
 
+from .namespace import Namespace
 
-class SourceNamespace(StrEnum):
+
+class SourceNamespace(Namespace):
     """
     The `Source` identifies the primary object, resource, or subsystem that the `identifier` represents (e.g., `runtime`, `data`, `workflow`).
 
@@ -128,7 +130,7 @@ class SourceNamespace(StrEnum):
     template = auto()
 
 
-class CoreObjects(StrEnum):
+class CoreObjects(Namespace):
     resource = auto()
     manager = auto()
     service = auto()
@@ -143,7 +145,7 @@ class CoreObjects(StrEnum):
     server = auto()
 
 
-class Data(StrEnum):
+class Data(Namespace):
     data = auto()
     dataset = auto()
     record = auto()
@@ -158,7 +160,7 @@ class Data(StrEnum):
     snapshot = auto()
 
 
-class Runtime(StrEnum):
+class Runtime(Namespace):
     runtime = auto()
     engine = auto()
     process = auto()
@@ -173,7 +175,7 @@ class Runtime(StrEnum):
     session = auto()
 
 
-class Configuration(StrEnum):
+class Configuration(Namespace):
     config = auto()
     setting = auto()
     option = auto()
@@ -184,7 +186,7 @@ class Configuration(StrEnum):
     environment = auto()
 
 
-class Integration(StrEnum):
+class Integration(Namespace):
     connector = auto()
     gateway = auto()
     bridge = auto()
@@ -195,7 +197,7 @@ class Integration(StrEnum):
     stream = auto()
 
 
-class AI(StrEnum):
+class AI(Namespace):
     agent = auto()
     tool = auto()
     prompt = auto()
@@ -207,7 +209,7 @@ class AI(StrEnum):
     conversation = auto()
 
 
-class Security(StrEnum):
+class Security(Namespace):
     identity = auto()
     credential = auto()
     token = auto()
@@ -219,7 +221,7 @@ class Security(StrEnum):
     secret = auto()
 
 
-class Web(StrEnum):
+class Web(Namespace):
     request = auto()
     response = auto()
     route = auto()

{idkit-1.0.2 → idkit-1.0.3}/idkit/protocols.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from .namespaces import Namespace
+from .namespaces.namespace import Namespace
 from typing import Any, Protocol, Self
 import uuid
 

{idkit-1.0.2 → idkit-1.0.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "IDKit"
-version = "1.0.2"
+version = "1.0.3"
 description = "A typed, dot-notation identifier system for Python 3.12+."
 requires-python = ">=3.12"
 readme = "README.md"

idkit-1.0.2/idkit/namespaces/__init__.py

@@ -1,29 +0,0 @@
-from .group import GroupNamespace
-from .source import SourceNamespace
-from .role import RoleNamespace
-from .operation import OperationNamespace
-from typing import Protocol
-
-
-class Namespace(Protocol):
-    """
-    The Namespace is a declarative value that provides a scope for the Identifier by organizing into logical segments.
-
-    If subclasses `StrEnum` to provide a typed safe approach.
-
-    Group — Where does it belong?
-    Source — What is it?
-    Component — Which part of it?
-    Action — What does it do?
-    """
-
-    value: str
-
-
-__all__ = [
-    "GroupNamespace",
-    "SourceNamespace",
-    "RoleNamespace",
-    "OperationNamespace",
-    "Namespace",
-]