openbrewing 0.0.1a0__tar.gz

openbrewing-0.0.1a0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,32 @@
+# 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/pyproject.toml

@@ -0,0 +1,19 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "openbrewing"
+version = "0.0.1a0"
+description = "Experimental OpenBrewing utilities for brewing temperature and volume conversions."
+readme = "README.md"
+requires-python = ">=3.10"
+keywords = ["brewing", "homebrewing", "units", "conversion"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3",
+    "Topic :: Scientific/Engineering",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]

openbrewing-0.0.1a0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

openbrewing-0.0.1a0/src/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/src/openbrewing.egg-info/PKG-INFO

@@ -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/src/openbrewing.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+pyproject.toml
+src/openbrewing/__init__.py
+src/openbrewing.egg-info/PKG-INFO
+src/openbrewing.egg-info/SOURCES.txt
+src/openbrewing.egg-info/dependency_links.txt
+src/openbrewing.egg-info/top_level.txt
+tests/test_units.py

openbrewing-0.0.1a0/src/openbrewing.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

openbrewing-0.0.1a0/src/openbrewing.egg-info/top_level.txt

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

openbrewing-0.0.1a0/tests/test_units.py

@@ -0,0 +1,34 @@
+import unittest
+
+import openbrewing as units
+
+
+class UnitConversionsTest(unittest.TestCase):
+    def test_temperature_reference_points(self):
+        self.assertEqual(units.celsius_to_fahrenheit(0), 32)
+        self.assertEqual(units.celsius_to_fahrenheit(100), 212)
+        self.assertEqual(units.fahrenheit_to_celsius(-40), -40)
+
+    def test_us_liquid_gallon_definition(self):
+        self.assertEqual(units.us_gallons_to_litres(1), 3.785411784)
+        self.assertEqual(units.litres_to_us_gallons(3.785411784), 1)
+        self.assertAlmostEqual(units.us_gallons_to_litres(5), 18.92705892)
+
+    def test_round_trip(self):
+        for value in [-40, 0, 20, 65.5, 100]:
+            self.assertAlmostEqual(units.fahrenheit_to_celsius(units.celsius_to_fahrenheit(value)), value)
+            self.assertAlmostEqual(units.litres_to_us_gallons(units.us_gallons_to_litres(value)), value)
+
+    def test_invalid_inputs(self):
+        for name in units.__all__:
+            convert = getattr(units, name)
+            for value in [None, True, "20", []]:
+                with self.assertRaises(TypeError):
+                    convert(value)
+            for value in [float("nan"), float("inf"), float("-inf"), 10**1000]:
+                with self.assertRaises(ValueError):
+                    convert(value)
+
+
+if __name__ == "__main__":
+    unittest.main()