lockss-pybasic 0.3.0.dev3__py3-none-any.whl → 0.3.0.dev4__py3-none-any.whl

lockss/pybasic/__init__.py

@@ -36,4 +36,4 @@ ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 POSSIBILITY OF SUCH DAMAGE.
 '''.strip()
 
-__version__ = '0.3.0-dev3'
+__version__ = '0.3.0-dev4'

lockss/pybasic/nodeutil.py

@@ -35,33 +35,35 @@ LOCKSS node utilities.
 from enum import Enum
 from re import Match, Pattern
 import re
-from typing import Annotated, ClassVar, Literal, Optional, Union
+from typing import Annotated, Any, ClassVar, Literal, Optional, Union
 
 from annotated_types import Ge, Le
-from pydantic import BaseModel, Field, TypeAdapter
-
-from .errorutil import InternalError
-
-
-RE_NODE_REFERENCE: Pattern[str] = re.compile(r'((?P<protocol>https?)://)?(?P<host>[^:]+)(:(?P<repository>\d+|(?=:))(:(?P<configuration>\d+|(?=:))(:(?P<poller>\d+|(?=:))(:(?P<crawler>\d+|(?=:))(:(?P<metadata>\d+|(?=:))(:(?P<soap>\d+))?)?)?)?)?)?')
+from pydantic import BaseModel, BeforeValidator, Field, TypeAdapter, model_validator
 
 
+#: An annotated type for port numbers (0-65535)
 PortNumber = Annotated[int, Ge(0), Le(65535)]
 
 
 class NodeTypeEnum(Enum):
+    """An enumerated type representing LOCKSS node types."""
+    #: An enumerated constant representing LOCKSS 1.x nodes.
     V1 = 'v1'
+    #: An enumerated constant representing LOCKSS 2.x nodes.
     V2 = 'v2'
 
 
 class NodeProtocolEnum(Enum):
+    """An enumerated type representing protocols for reaching LOCKSS nodes."""
+    #: An enumerated constant representing HTTP.
     HTTP = 'http'
+    #: An enumerated constant representing HTTPS.
     HTTPS = 'https'
 
 
 class BaseNodeSpec(BaseModel):
 
-    DEFAULT_PROTOCOL: ClassVar[NodeProtocolEnum] = NodeProtocolEnum.HTTPS
+    DEFAULT_PROTOCOL: ClassVar[NodeProtocolEnum] = NodeProtocolEnum.HTTP
 
     TYPE_FIELD: ClassVar[dict[str, str]] = dict(title='Type',
                                                 description="The node's type")
@@ -126,21 +128,15 @@ class NodeSpec2(BaseNodeSpec):
                              description="The node's SOAP Compatibility Service REST API Port")
 
 
-NodeSpec = Annotated[Union[NodeSpec1, NodeSpec2], Field(discriminator='type')]
-
-
-_node_spec_adapter: TypeAdapter[NodeSpec] = TypeAdapter(NodeSpec)
-
-
-def get_node_spec_adapter() -> TypeAdapter[NodeSpec]:
-    return _node_spec_adapter
+_RE_NODE_REFERENCE: Pattern[str] = re.compile(r'((?P<protocol>https?)://)?(?P<host>[^:]+)(:(?P<repository>\d+|(?=:))(:(?P<configuration>\d+|(?=:))(:(?P<poller>\d+|(?=:))(:(?P<crawler>\d+|(?=:))(:(?P<metadata>\d+|(?=:))(:(?P<soap>\d+))?)?)?)?)?)?')
 
 
+#: A type for LOCKSS node specification strings.
 NodeSpecStr = str
 
 
-def make_node_spec(node_spec_string: NodeSpecStr) -> NodeSpec:
-    mat: Optional[Match[str]] = RE_NODE_REFERENCE.fullmatch(node_spec_string)
+def _parse_node_spec_string(node_spec_string: NodeSpecStr) -> dict[str, str]:
+    mat: Optional[Match[str]] = _RE_NODE_REFERENCE.fullmatch(node_spec_string)
     if mat is None:
         raise ValueError(f'Invalid node specification string: {node_spec_string}')
     d = dict(host=mat.group('host'))
@@ -164,4 +160,57 @@ def make_node_spec(node_spec_string: NodeSpecStr) -> NodeSpec:
     for k in five:
         if p := mat.group(k):
             d[k] = p # string okay, will be coerced to int
-    return get_node_spec_adapter().validate_python(d)
+    return d
+
+
+def _maybe_deserialize_node_spec_string(value: Any) -> Any:
+    if isinstance(value, NodeSpecStr) and not value.startswith('{'):
+        return _parse_node_spec_string(value)
+    return value
+
+
+#: A type for LOCKSS node specifications, that also accepts a compact LOCKSS
+#: node specification string.
+NodeSpec = Annotated[
+    Annotated[Union[NodeSpec1, NodeSpec2], Field(discriminator='type')],
+    BeforeValidator(_maybe_deserialize_node_spec_string)
+]
+
+
+#: A type adapter for the NodeSpec type.
+_node_spec_adapter: TypeAdapter[NodeSpec] = TypeAdapter(NodeSpec)
+
+
+def get_node_spec_adapter() -> TypeAdapter[NodeSpec]:
+    """
+    Gets a type adapter for the NodeSpec type, which is a union type and cannot
+    be instantiated directly.
+
+    :return: A type adapter for the NodeSpec type.
+    """
+    return _node_spec_adapter
+
+
+NodeSetKind = Literal['NodeSet']
+
+
+NodeSetIdentifier = str
+
+
+NodeIdentifier = str
+
+
+class NodeSet(BaseModel):
+
+    kind: NodeSetKind = Field(title='Kind',
+                              description="This object's kind")
+
+    id: NodeSetIdentifier = Field(title='Node Set Identifier',
+                                  description='An identifier for the node set')
+
+    name: str = Field(title='Node Set Name',
+                      description='A name for the node set')
+
+    nodes: dict[NodeIdentifier, NodeSpec] = Field(min_length=1,
+                                                  title='Nodes',
+                                                  description='A non-empty list of nodes')

{lockss_pybasic-0.3.0.dev3.dist-info → lockss_pybasic-0.3.0.dev4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lockss-pybasic
-Version: 0.3.0.dev3
+Version: 0.3.0.dev4
 Summary: Basic Python utilities
 License: BSD-3-Clause
 License-File: LICENSE
@@ -26,7 +26,7 @@ Description-Content-Type: text/x-rst
 lockss-pybasic
 ==============
 
-.. |RELEASE| replace:: 0.3.0-dev3
+.. |RELEASE| replace:: 0.3.0-dev4
 .. |RELEASE_DATE| replace:: NOT YET RELEASED
 
 **Latest release:** |RELEASE| (|RELEASE_DATE|)

lockss_pybasic-0.3.0.dev4.dist-info/RECORD

@@ -0,0 +1,10 @@
+lockss/pybasic/__init__.py,sha256=NWFBmNQ6XEuQOYE0WVIYhe0Ci5wIxmzBewZ_oY8u-G8,1678
+lockss/pybasic/auidutil.py,sha256=Q4vjjGfymiXVwPu35RyyLZBnViv8mDJKCjOyJb-sbS8,13921
+lockss/pybasic/cliutil.py,sha256=F970MhLcQCYS3INLQT1Ij8nKt_ICmttiS3nSnuWuN7s,8106
+lockss/pybasic/errorutil.py,sha256=4EaO0a1yIG1DbWltASeT15bg1bGg5kOYspsW0iJdVLc,1951
+lockss/pybasic/fileutil.py,sha256=IIS2AFDgYtmBLPVHqQi1AkIFj6da04b6NQtjX9bIVqQ,2958
+lockss/pybasic/nodeutil.py,sha256=snBT7OPttThBJXVxgLC6Onmuoa8Z-jOOM1LWdhIb-js,7928
+lockss_pybasic-0.3.0.dev4.dist-info/METADATA,sha256=eZ1B2T-R5rn4u2ZXTkcWZFEGChVqOxbbV5FT-pusIpw,2338
+lockss_pybasic-0.3.0.dev4.dist-info/WHEEL,sha256=eY7nduwzv-ldUxpzbRlxwvC693Hg6PX8bWDjEHjZ_dk,88
+lockss_pybasic-0.3.0.dev4.dist-info/licenses/LICENSE,sha256=EOxPunNz3XP6AjgbPFolu-d9BS_AF9TtKn1WXgeYPsE,1506
+lockss_pybasic-0.3.0.dev4.dist-info/RECORD,,

lockss_pybasic-0.3.0.dev3.dist-info/RECORD

@@ -1,10 +0,0 @@
-lockss/pybasic/__init__.py,sha256=wBkseM3G1zUhxYaKUdsw7FygMFNiaPmwpPmDRGCEIsA,1678
-lockss/pybasic/auidutil.py,sha256=Q4vjjGfymiXVwPu35RyyLZBnViv8mDJKCjOyJb-sbS8,13921
-lockss/pybasic/cliutil.py,sha256=F970MhLcQCYS3INLQT1Ij8nKt_ICmttiS3nSnuWuN7s,8106
-lockss/pybasic/errorutil.py,sha256=4EaO0a1yIG1DbWltASeT15bg1bGg5kOYspsW0iJdVLc,1951
-lockss/pybasic/fileutil.py,sha256=IIS2AFDgYtmBLPVHqQi1AkIFj6da04b6NQtjX9bIVqQ,2958
-lockss/pybasic/nodeutil.py,sha256=MUd8JoJmn_cZSN8iwG5KOLSRorIfHIEySeYhojm5rlw,6206
-lockss_pybasic-0.3.0.dev3.dist-info/METADATA,sha256=aTqzPE7mJFwwc8oZtYtZGdp4JVuEpBKHk-1K0Rn1BpU,2338
-lockss_pybasic-0.3.0.dev3.dist-info/WHEEL,sha256=eY7nduwzv-ldUxpzbRlxwvC693Hg6PX8bWDjEHjZ_dk,88
-lockss_pybasic-0.3.0.dev3.dist-info/licenses/LICENSE,sha256=EOxPunNz3XP6AjgbPFolu-d9BS_AF9TtKn1WXgeYPsE,1506
-lockss_pybasic-0.3.0.dev3.dist-info/RECORD,,