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

lockss/pybasic/__init__.py

@@ -1,5 +1,9 @@
 #!/usr/bin/env python3
 
+"""
+Basic Python utilities.
+"""
+
 __copyright__ = '''
 Copyright (c) 2000-2025, Board of Trustees of Leland Stanford Jr. University
 '''.strip()
@@ -32,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.1.0-dev8'
+__version__ = '0.1.0-dev10'

lockss/pybasic/cliutil.py

@@ -28,13 +28,13 @@
 # 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 typing import Any, Dict, Generic, List, Optional, TypeVar
 
 from pydantic.v1 import BaseModel, Field
 from pydantic_argparse import ArgumentParser
@@ -96,13 +96,12 @@ 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)
+        self.args: ModelT = None
+        self.parser: ArgumentParser = None
+        self.extra: Dict[str, Any] = dict(**extra)
 
     def run(self):
         self.parser: ArgumentParser = ArgumentParser(model=self.extra.get('model'),
@@ -116,10 +115,27 @@ class BaseCli(Generic[ModelT], ABC):
         pass
 
 
-def exactly_one(values: Dict[str, Any], *names: List[str]):
-    if (length := len([values[name] for name in names if values[name]])) != 1:
+def _matchy_length(values: Dict[str, Any], *names: str) -> int:
+    return len([values[name] for name in names if values[name]])
+
+
+def at_most_one(values: Dict[str, Any], *names: str):
+    if (length := _matchy_length(values, names)) > 1:
+        raise ValueError(f'at most one of {', '.join([option_name(name) for name in names])} is allowed, got {length}')
+    return values
+
+
+def exactly_one(values: Dict[str, Any], *names: str):
+    if (length := _matchy_length(values, names)) != 1:
         raise ValueError(f'exactly one of {', '.join([option_name(name) for name in names])} is required, got {length}')
     return values
 
+
+def one_or_more(values: Dict[str, Any], *names: str):
+    if _matchy_length(values, names) == 0:
+        raise ValueError(f'one or more of {', '.join([option_name(name) for name in names])} is required')
+    return values
+
+
 def option_name(name: str):
     return f'{('-' if len(name) == 1 else '--')}{name.replace('_', '-')}'

lockss/pybasic/errorutil.py

@@ -28,9 +28,9 @@
 # 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):
 

lockss/pybasic/fileutil.py

@@ -28,9 +28,9 @@
 # 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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: lockss-pybasic
-Version: 0.1.0.dev8
+Version: 0.1.0.dev10
 Summary: Basic Python utilities
 License: BSD-3-Clause
 Author: Thib Guicherd-Callin

lockss_pybasic-0.1.0.dev10.dist-info/RECORD

@@ -0,0 +1,8 @@
+lockss/pybasic/__init__.py,sha256=Fr8krz-LyQE4qPlFrf7qbRYjO8M4DqEh3MBw-5WLiXE,1679
+lockss/pybasic/cliutil.py,sha256=M-czaxARe_skgRyorUePFvVz3NYIQMS2wPjZWB-YR1Q,4562
+lockss/pybasic/errorutil.py,sha256=SD0kZtQt_lyVqqlLeo5K6ihkgQ1sm1rtvwI_pST-7ns,1746
+lockss/pybasic/fileutil.py,sha256=hr4RtAaalEKwXx1kjGBReLOcmlbml1cwG9K5zcbreSw,2199
+lockss_pybasic-0.1.0.dev10.dist-info/LICENSE,sha256=O9ONND4uDxY_jucI4jZDf2liAk05ScEJaYu-Al7EOdQ,1506
+lockss_pybasic-0.1.0.dev10.dist-info/METADATA,sha256=SdUiZFJGc2FKapkEA5aMvbCRZghAcRXyd0qR2NOt9CI,696
+lockss_pybasic-0.1.0.dev10.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
+lockss_pybasic-0.1.0.dev10.dist-info/RECORD,,

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

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

lockss_pybasic-0.1.0.dev8.dist-info/RECORD

@@ -1,8 +0,0 @@
-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,,