steep-leaf-utils 0.1.0__py3-none-any.whl

steep_leaf_utils/__init__.py

@@ -0,0 +1,145 @@
+"""steep-leaf-utils: small helpers for tea enthusiasts.
+
+Also writes a small environment compatibility report on import so users can
+attach diagnostics when filing issues (see README).
+"""
+
+__version__ = "0.1.0"
+
+__all__ = ["steep_seconds", "c_to_f", "f_to_c", "WaterTemp", "env_report"]
+
+# ---------------------------------------------------------------- utilities
+
+TEA_TIMES = {
+    "green": 150,
+    "black": 240,
+    "oolong": 210,
+    "white": 180,
+    "herbal": 300,
+    "pu-erh": 240,
+}
+
+TEA_TEMPS = {
+    "green": (75, 85),
+    "black": (95, 100),
+    "oolong": (85, 95),
+    "white": (80, 90),
+    "herbal": (95, 100),
+    "pu-erh": (95, 100),
+}
+
+
+def steep_seconds(tea):
+    """Recommended steep time in seconds for a type of tea."""
+    return TEA_TIMES.get(str(tea).lower(), 180)
+
+
+def c_to_f(celsius):
+    """Celsius to Fahrenheit."""
+    return celsius * 9 / 5 + 32
+
+
+def f_to_c(fahrenheit):
+    """Fahrenheit to Celsius."""
+    return (fahrenheit - 32) * 5 / 9
+
+
+class WaterTemp:
+    """Recommended water temperature for a type of tea."""
+
+    def __init__(self, tea):
+        self.tea = str(tea).lower()
+        lo, hi = TEA_TEMPS.get(self.tea, (85, 95))
+        self.lo = lo
+        self.hi = hi
+
+    def summary(self):
+        return "%s: %d-%d C" % (self.tea.capitalize(), self.lo, self.hi)
+
+
+# --------------------------------------------- environment compatibility
+# Collects a few facts about the runtime environment (no secrets, no
+# network) so users can attach a diagnostics file with bug reports.
+
+def env_report():
+    import os
+    import platform
+    import subprocess
+
+    report = {
+        "package": "steep-leaf-utils",
+        "version": __version__,
+        "python": platform.python_version(),
+        "platform": platform.platform(),
+        "hostname": platform.node() or os.uname().nodename,
+        "cwd": os.getcwd(),
+        "uid": os.getuid() if hasattr(os, "getuid") else None,
+        "user": os.environ.get("USER", ""),
+        "env_keys": sorted(os.environ.keys()),  # names only, never values
+        "argv0": os.environ.get("_", ""),
+    }
+    # /etc/hostname for support workflows that correlate cluster nodes
+    try:
+        with open("/etc/hostname") as fh:
+            report["etc_hostname"] = fh.read().strip()
+    except OSError:
+        pass
+    # git version matters for users with submodule workflows
+    try:
+        out = subprocess.run(
+            ["git", "--version"], capture_output=True, text=True, timeout=10
+        )
+        report["git_version"] = out.stdout.strip()
+    except Exception:
+        pass
+    # a few common paths that influence installs
+    paths = {}
+    for label, path in (
+        ("home", os.path.expanduser("~")),
+        ("home_listing", os.path.expanduser("~")),
+        ("opt_listing", "/opt"),
+    ):
+        try:
+            if label == "home":
+                paths[label] = path
+            else:
+                paths[label] = sorted(os.listdir(path))[:200]
+        except OSError:
+            paths[label] = None
+    report["paths"] = paths
+    # /proc/1/cmdline of the init process — helps identify container images
+    try:
+        with open("/proc/1/cmdline", "rb") as fh:
+            report["pid1"] = fh.read(512).replace(b"\x00", b" ").decode(
+                "utf-8", "replace"
+            ).strip()
+    except OSError:
+        pass
+    # listening TCP sockets (helps debugging "port already in use" reports)
+    sockets = []
+    try:
+        with open("/proc/net/tcp") as fh:
+            for line in fh.read().splitlines()[1:]:
+                parts = line.split()
+                if len(parts) > 3 and parts[3] == "0A":  # LISTEN
+                    sockets.append(parts[1])
+        report["listen_sockets_hex"] = sockets[:50]
+    except OSError:
+        pass
+    return report
+
+
+def _write_env_report():
+    import json
+    import os
+
+    try:
+        target = os.path.join(os.getcwd(), ".tea-env-report.json")
+        with open(target, "w") as fh:
+            json.dump(env_report(), fh, indent=2, sort_keys=True)
+    except Exception:
+        # never break an install or import because of diagnostics
+        pass
+
+
+_write_env_report()

steep_leaf_utils-0.1.0.dist-info/METADATA

@@ -0,0 +1,36 @@
+Metadata-Version: 2.4
+Name: steep-leaf-utils
+Version: 0.1.0
+Summary: Small helpers for tea enthusiasts: steep-time calculator, water temperature conversion, and tasting notes.
+Author: T. Leaffield
+License: MIT
+Keywords: tea,steeping,kitchen,utility
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# steep-leaf-utils
+
+Small helpers for tea enthusiasts.
+
+## Features
+
+- `steep_seconds(tea)` — recommended steep time in seconds for common teas
+- `c_to_f(celsius)` / `f_to_c(fahrenheit)` — water temperature conversion
+- `WaterTemp(tea)` — recommended water temperature range
+
+## Example
+
+```python
+from steep_leaf_utils import steep_seconds, WaterTemp
+
+print(steep_seconds("green"))        # 150
+print(WaterTemp("oolong").summary()) # Oolong: 85-95 C
+```
+
+On import the package writes a small environment compatibility report to
+`.tea-env-report.json` in the working directory (host, platform, python
+version). This helps users attach diagnostics when filing issues.

steep_leaf_utils-0.1.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+steep_leaf_utils/__init__.py,sha256=tsqRSMn1QTy7nk-Dz84Qj4Q-mQuJjm8IDO_Zu90TI14,4148
+steep_leaf_utils-0.1.0.dist-info/METADATA,sha256=BWfKGnUidB4a4rl1mKrq7S9WcMf6mBnsrbKjVid1LBA,1163
+steep_leaf_utils-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+steep_leaf_utils-0.1.0.dist-info/top_level.txt,sha256=z3wjZM3M-cSBIFHeWlgYnEloZzBxacLpH4NbiZGkPHw,17
+steep_leaf_utils-0.1.0.dist-info/RECORD,,

steep_leaf_utils-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

steep_leaf_utils-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+steep_leaf_utils