lockss-pybasic 0.1.0.dev6__py3-none-any.whl → 0.1.0.dev8__py3-none-any.whl

lockss/pybasic/__init__.py

@@ -32,4 +32,4 @@ ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 POSSIBILITY OF SUCH DAMAGE.
 '''.strip()
 
-__version__ = '0.1.0-dev6'
+__version__ = '0.1.0-dev8'

lockss/pybasic/cliutil.py

@@ -28,22 +28,98 @@
 # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 # POSSIBILITY OF SUCH DAMAGE.
 
+'''
+Command line utilities.
+'''
+
+from abc import ABC, abstractmethod
 import sys
+from typing import Any, Dict, Generic, List, TypeVar
 
 from pydantic.v1 import BaseModel, Field
+from pydantic_argparse import ArgumentParser
 
-class VersionCommand:
+
+class Printable(ABC):
+
+    def print(self, file=sys.stdout):
+        print(self.get_display(), file=file)
+
+    @abstractmethod
+    def get_display(self):
+        pass
+
+
+class CopyrightCommand:
 
     @staticmethod
-    def make(version):
-        class VersionModel(BaseModel):
+    def make(copyright):
+        class CopyrightModel(Printable, BaseModel):
+            def get_display(self):
+                return copyright
+        return CopyrightModel
+
+    @staticmethod
+    def field():
+        return Field(description='print the copyright and exit')
+
+
+class LicenseCommand:
+
+    @staticmethod
+    def make(license):
+        class LicenseModel(Printable, BaseModel):
+            def get_display(self):
+                return license
+        return LicenseModel
+
+    @staticmethod
+    def field():
+        return Field(description='print the software license and exit')
 
-            def print_version(self, file=sys.stdout):
-                print(version, file=file)
-                sys.exit(0)
 
+class VersionCommand:
+
+    @staticmethod
+    def make(version):
+        class VersionModel(Printable, BaseModel):
+            def get_display(self):
+                return version
         return VersionModel
 
     @staticmethod
     def field():
         return Field(description='print the version number and exit')
+
+
+ModelT = TypeVar('ModelT')
+
+
+class BaseCli(Generic[ModelT], ABC):
+    args: ModelT
+    extra: Dict[str, Any]
+    parser: ArgumentParser
+
+    def __init__(self, **extra):
+        super().__init__()
+        self.extra = dict(**extra)
+
+    def run(self):
+        self.parser: ArgumentParser = ArgumentParser(model=self.extra.get('model'),
+                                                     prog=self.extra.get('prog'),
+                                                     description=self.extra.get('description'))
+        self.args = self.parser.parse_typed_args()
+        self.dispatch()
+
+    @abstractmethod
+    def dispatch(self):
+        pass
+
+
+def exactly_one(values: Dict[str, Any], *names: List[str]):
+    if (length := len([values[name] for name in names if values[name]])) != 1:
+        raise ValueError(f'exactly one of {', '.join([option_name(name) for name in names])} is required, got {length}')
+    return values
+
+def option_name(name: str):
+    return f'{('-' if len(name) == 1 else '--')}{name.replace('_', '-')}'

lockss/pybasic/errorutil.py

@@ -0,0 +1,38 @@
+#!/usr/bin/env python3
+
+# Copyright (c) 2000-2025, Board of Trustees of Leland Stanford Jr. University
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer.
+#
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+# this list of conditions and the following disclaimer in the documentation
+# and/or other materials provided with the distribution.
+#
+# 3. Neither the name of the copyright holder nor the names of its contributors
+# may be used to endorse or promote products derived from this software without
+# specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+'''
+Error and exception utilities.
+'''
+
+class InternalError(RuntimeError):
+
+    def __init__(self, *args: object) -> None:
+        super().__init__('internal error')

lockss/pybasic/fileutil.py

@@ -0,0 +1,53 @@
+#!/usr/bin/env python3
+
+# Copyright (c) 2000-2025, Board of Trustees of Leland Stanford Jr. University
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer.
+#
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+# this list of conditions and the following disclaimer in the documentation
+# and/or other materials provided with the distribution.
+#
+# 3. Neither the name of the copyright holder nor the names of its contributors
+# may be used to endorse or promote products derived from this software without
+# specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+'''
+File and path utilities.
+'''
+
+from pathlib import Path, PurePath
+import sys
+from typing import Union
+
+
+def file_lines(fpath: Path):
+    f = None
+    try:
+        f = open(path(fpath), 'r') if fpath != '-' else sys.stdin
+        return [line for line in [line.partition('#')[0].strip() for line in f] if len(line) > 0]
+    finally:
+        if f is not None and path != '-':
+            f.close()
+
+
+def path(purepath_or_string: Union[PurePath, str]):
+    if not issubclass(type(purepath_or_string), PurePath):
+        purepath_or_string = Path(purepath_or_string)
+    return purepath_or_string.expanduser().resolve()

{lockss_pybasic-0.1.0.dev6.dist-info → lockss_pybasic-0.1.0.dev8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: lockss-pybasic
-Version: 0.1.0.dev6
+Version: 0.1.0.dev8
 Summary: Basic Python utilities
 License: BSD-3-Clause
 Author: Thib Guicherd-Callin
@@ -14,6 +14,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Dist: pydantic (>=2.11.3,<3.0.0)
+Requires-Dist: pydantic-argparse (>=0.10.0,<0.11.0)
 Description-Content-Type: text/x-rst
 
 

lockss_pybasic-0.1.0.dev8.dist-info/RECORD

@@ -0,0 +1,8 @@
+lockss/pybasic/__init__.py,sha256=S_imeto8t47j8ETAJvdZ2Jl1WMSmdVlzt-0pDzD1SVg,1645
+lockss/pybasic/cliutil.py,sha256=z85gaLAn4M4Y3uBQGrJDgvDEmJ51V2M5JP1CzRLExSc,3956
+lockss/pybasic/errorutil.py,sha256=8MdEaIpbzotsEzTN4hW8_VPEZcVfoti1C-Fueord7JU,1746
+lockss/pybasic/fileutil.py,sha256=FVKP7CXjtC69G9-wJ_3javZt1FO3NCc21o-6w6QNL-Y,2199
+lockss_pybasic-0.1.0.dev8.dist-info/LICENSE,sha256=O9ONND4uDxY_jucI4jZDf2liAk05ScEJaYu-Al7EOdQ,1506
+lockss_pybasic-0.1.0.dev8.dist-info/METADATA,sha256=23jhPGwyNi4I4OLRc-AggJp0Uq7Rj01FjvI4PP9TYPE,695
+lockss_pybasic-0.1.0.dev8.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+lockss_pybasic-0.1.0.dev8.dist-info/RECORD,,

{lockss_pybasic-0.1.0.dev6.dist-info → lockss_pybasic-0.1.0.dev8.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.1.2
+Generator: poetry-core 2.1.1
 Root-Is-Purelib: true
 Tag: py3-none-any

lockss_pybasic-0.1.0.dev6.dist-info/RECORD

@@ -1,6 +0,0 @@
-lockss/pybasic/__init__.py,sha256=rwuIboTuiRE-y9wGaTQSXwI1Mywjjl2ZtuDJJcIZVeM,1645
-lockss/pybasic/cliutil.py,sha256=3mH20MHVrDe5SQp1zbVDPs2l0tF4xlPERpfIKbPATug,1997
-lockss_pybasic-0.1.0.dev6.dist-info/LICENSE,sha256=O9ONND4uDxY_jucI4jZDf2liAk05ScEJaYu-Al7EOdQ,1506
-lockss_pybasic-0.1.0.dev6.dist-info/METADATA,sha256=pkkJ5ldDFBYzEN5bUCU4mYNPGgOJ1m0crgY0vKKGerA,643
-lockss_pybasic-0.1.0.dev6.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
-lockss_pybasic-0.1.0.dev6.dist-info/RECORD,,