kkpyutil 1.37.0__py3-none-any.whl → 1.38.0__py3-none-any.whl

{kkpyutil-1.37.0.dist-info → kkpyutil-1.38.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: kkpyutil
-Version: 1.37.0
+Version: 1.38.0
 Summary: Building blocks for sysadmin and DevOps
 Home-page: https://github.com/kakyoism/kkpyutil/
 License: MIT

kkpyutil-1.38.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+kkpyutil.py,sha256=Va9Q71B9N_mLQwIcHVImOiX-fDe-eubclrN-x-kGFPQ,110580
+kkpyutil_helper/windows/kkttssave.ps1,sha256=xa3-WzqNh2rGYlOx_I4ewOuCE94gkTO5cEwYH0M67_0,446
+kkpyutil_helper/windows/kkttsspeak.ps1,sha256=7WUUHMmjTQroUWA2Mvdt4JtSt475nZUHQx-qP-7rS6o,305
+kkpyutil-1.38.0.dist-info/LICENSE,sha256=uISevGnCxB5QOU0ftbofN75_yUtd6E2h_MWE1zqagC8,1065
+kkpyutil-1.38.0.dist-info/METADATA,sha256=9y_yLvL1dVSRzeDiF4VmrOrqZWu5D6PQaAxDDNCwkyI,1136
+kkpyutil-1.38.0.dist-info/WHEEL,sha256=kLuE8m1WYU0Ig0_YEGrXyTtiJvKPpLpDEiChiNyei5Y,88
+kkpyutil-1.38.0.dist-info/RECORD,,

kkpyutil.py

@@ -1698,6 +1698,48 @@ def is_number_text(text):
     return False
 
 
+def is_bool_text(text):
+    return text.lower() in ('true', 'false')
+
+
+def create_parameter(name, default: str, val_range=None, step=0.1, precision: int = 2, delim=' '):
+    """
+    - a single user text input may carry polymorphic primitive data types
+    - so we need to convert it to a good enough data record that a frontend can understand
+    - step is for numbers only, and precision is for floats only
+    - some frontend may offer fine-tuning, a good practice is to use step/10 for that, but this low-level API does not offer fine-tuning for minimalism
+    - for numbers, null xrange or null component means no range limit
+    - for options, range is a tuple of options; single-selection uses a literal str as default; multi-selection uses a space-separated str 'opt1 opt2'
+    """
+    if options := isinstance(val_range, tuple):
+        assert len(val_range)
+        try:
+            i_default = val_range.index(default)
+            # single-select
+            default_opts = default
+        except ValueError:
+            # multi-select
+            default_opts = tuple([opt.strip() for opt in default.split(delim)])
+        return {'name': name, 'type': 'option', 'default': default_opts, 'range': val_range}
+    if is_bool_text(default):
+        return {'name': name, 'type': 'bool', 'default': default.lower() == 'true'}
+    if is_number_text(default):
+        # edge cases: None, (None, 1.0), (1.0, None), (None, None)
+        if val_range is None:
+            val_range = [float('-inf'), float('inf')]
+        else:
+            assert len(val_range) == 2
+            if val_range[0] is None:
+                val_range[0] = '-inf'
+            if val_range[1] is None:
+                val_range[1] = 'inf'
+            val_range = [float(val_range[0]), float(val_range[1])]
+        if is_float_text(default):
+            return {'name': name, 'type': 'float', 'default': float(default), 'range': val_range, 'step': step, 'precision': precision}
+        return {'name': name, 'type': 'int', 'default': int(default), 'range': val_range, 'step': max(int(step), 1)}
+    return {'name': name, 'type': 'str', 'default': default}
+
+
 def compare_dsv_lines(line1, line2, delim=' ', float_rel_tol=1e-6, float_abs_tol=1e-6, striptext=True, randomidok=False, logger=None):
     """
     - compare two lines of delimiter-separated values, with numerical and uuid comparison in mind

kkpyutil-1.37.0.dist-info/RECORD

@@ -1,7 +0,0 @@
-kkpyutil.py,sha256=5Y6u9Pd8xD5U7W0HgUhRnspRV5mgobg_WKG7_xACgK8,108444
-kkpyutil_helper/windows/kkttssave.ps1,sha256=xa3-WzqNh2rGYlOx_I4ewOuCE94gkTO5cEwYH0M67_0,446
-kkpyutil_helper/windows/kkttsspeak.ps1,sha256=7WUUHMmjTQroUWA2Mvdt4JtSt475nZUHQx-qP-7rS6o,305
-kkpyutil-1.37.0.dist-info/LICENSE,sha256=uISevGnCxB5QOU0ftbofN75_yUtd6E2h_MWE1zqagC8,1065
-kkpyutil-1.37.0.dist-info/METADATA,sha256=wy2EZE2TnwEctYAHNT6pq3Xde-pOArlN9ehgyl_OzwQ,1136
-kkpyutil-1.37.0.dist-info/WHEEL,sha256=kLuE8m1WYU0Ig0_YEGrXyTtiJvKPpLpDEiChiNyei5Y,88
-kkpyutil-1.37.0.dist-info/RECORD,,