openbrewing 0.0.1a0__py3-none-any.whl

openbrewing/__init__.py

@@ -0,0 +1,45 @@
+"""Experimental, dependency-free brewing unit conversions."""
+
+import math
+
+__version__ = "0.0.1a0"
+__all__ = [
+    "litres_to_us_gallons",
+    "us_gallons_to_litres",
+    "celsius_to_fahrenheit",
+    "fahrenheit_to_celsius",
+]
+
+_LITRES_PER_US_GALLON = 3.785411784
+
+
+def _finite_number(value: float) -> float:
+    if isinstance(value, bool) or not isinstance(value, (int, float)):
+        raise TypeError("value must be an int or float")
+    try:
+        converted = float(value)
+    except OverflowError:
+        raise ValueError("value must be finite") from None
+    if not math.isfinite(converted):
+        raise ValueError("value must be finite")
+    return converted
+
+
+def litres_to_us_gallons(value: float) -> float:
+    """Convert litres to US liquid gallons, without rounding."""
+    return _finite_number(value) / _LITRES_PER_US_GALLON
+
+
+def us_gallons_to_litres(value: float) -> float:
+    """Convert US liquid gallons to litres, without rounding."""
+    return _finite_number(value) * _LITRES_PER_US_GALLON
+
+
+def celsius_to_fahrenheit(value: float) -> float:
+    """Convert degrees Celsius to degrees Fahrenheit, without rounding."""
+    return _finite_number(value) * 9 / 5 + 32
+
+
+def fahrenheit_to_celsius(value: float) -> float:
+    """Convert degrees Fahrenheit to degrees Celsius, without rounding."""
+    return (_finite_number(value) - 32) * 5 / 9

openbrewing-0.0.1a0.dist-info/METADATA

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: openbrewing
+Version: 0.0.1a0
+Summary: Experimental OpenBrewing utilities for brewing temperature and volume conversions.
+Keywords: brewing,homebrewing,units,conversion
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# OpenBrewing
+
+OpenBrewing is a work in progress. This experimental first release provides
+dependency-free temperature and volume conversions for brewing tools. The API
+may change in future releases.
+
+```sh
+python -m pip install --pre openbrewing
+```
+
+```python
+from openbrewing import celsius_to_fahrenheit, us_gallons_to_litres
+
+celsius_to_fahrenheit(20)  # 68.0
+us_gallons_to_litres(5)   # 18.92705892
+```
+
+## Functions
+
+- `litres_to_us_gallons(value)`
+- `us_gallons_to_litres(value)`
+- `celsius_to_fahrenheit(value)`
+- `fahrenheit_to_celsius(value)`
+
+All functions accept finite `int` or `float` values (excluding booleans) and
+return floats without rounding. Other types raise `TypeError`; non-finite or
+unrepresentable inputs raise `ValueError`.
+Gallons always mean **US liquid gallons** (one gallon is exactly
+3.785411784 litres). Signed values are supported; these helpers convert units,
+not physical validity.
+
+Licensing has not yet been selected. All rights reserved.

openbrewing-0.0.1a0.dist-info/RECORD

@@ -0,0 +1,5 @@
+openbrewing/__init__.py,sha256=AzFhQw3ZSRwVxRa_QcHrehvREHZff-rcXa9AJQzP7_U,1366
+openbrewing-0.0.1a0.dist-info/METADATA,sha256=zqXbiLS43-l1GVXVFpFyYT5vVclw7G9AFhdJaMhunsU,1418
+openbrewing-0.0.1a0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+openbrewing-0.0.1a0.dist-info/top_level.txt,sha256=_CEKUR0SVYUi-YqFLZ9oGAusvKsbT2r2HTmfPtXajs4,12
+openbrewing-0.0.1a0.dist-info/RECORD,,

openbrewing-0.0.1a0.dist-info/WHEEL

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

openbrewing-0.0.1a0.dist-info/top_level.txt

@@ -0,0 +1 @@
+openbrewing