augrim 0.0.1__py3-none-any.whl

augrim/__init__.py

@@ -0,0 +1,63 @@
+"""Augrim Labs (https://augrim.ai).
+
+"Augrim" is the Middle English word for reckoning with Hindu-Arabic
+numerals, the system that replaced Roman numerals in Europe. Until the
+official SDK ships under this name, the package does exactly that.
+"""
+
+from __future__ import annotations
+
+import sys
+
+__all__ = ["to_roman", "from_roman", "__version__"]
+__version__ = "0.0.1"
+
+_NUMERALS = (
+    (1000, "M"), (900, "CM"), (500, "D"), (400, "CD"),
+    (100, "C"), (90, "XC"), (50, "L"), (40, "XL"),
+    (10, "X"), (9, "IX"), (5, "V"), (4, "IV"), (1, "I"),
+)
+
+
+def to_roman(n: int) -> str:
+    """Convert an integer from 1 to 3999 to a Roman numeral."""
+    if isinstance(n, bool) or not isinstance(n, int):
+        raise TypeError("expected an int")
+    if not 1 <= n <= 3999:
+        raise ValueError("Roman numerals cover 1 to 3999")
+    out = []
+    for value, symbol in _NUMERALS:
+        count, n = divmod(n, value)
+        out.append(symbol * count)
+    return "".join(out)
+
+
+def from_roman(s: str) -> int:
+    """Convert a Roman numeral (canonical form, any case) to an integer."""
+    if not isinstance(s, str):
+        raise TypeError("expected a str")
+    text = s.strip().upper()
+    total, i = 0, 0
+    for value, symbol in _NUMERALS:
+        while text.startswith(symbol, i):
+            total += value
+            i += len(symbol)
+    if not text or i != len(text) or not 1 <= total <= 3999 or to_roman(total) != text:
+        raise ValueError(f"not a valid Roman numeral: {s!r}")
+    return total
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = sys.argv[1:] if argv is None else argv
+    if not args:
+        print(f"augrim {__version__}, Augrim Labs, https://augrim.ai")
+        print("usage: augrim <number or numeral> ...")
+        return 0
+    status = 0
+    for arg in args:
+        try:
+            print(to_roman(int(arg)) if arg.lstrip("-").isdigit() else from_roman(arg))
+        except ValueError as e:
+            print(f"augrim: {e}", file=sys.stderr)
+            status = 1
+    return status

augrim-0.0.1.dist-info/METADATA

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: augrim
+Version: 0.0.1
+Summary: Augrim Labs. Reserved for the official Augrim SDK; for now, Roman to Arabic numeral conversion.
+Author: Augrim Labs
+Author-email: Augrim Labs <hello@augrim.ai>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 1 - Planning
+Classifier: Programming Language :: Python :: 3
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Project-URL: Homepage, https://augrim.ai
+Description-Content-Type: text/markdown
+
+# augrim
+
+The official Python package name for [Augrim Labs](https://augrim.ai). The Augrim SDK will be published here.
+
+Until then it does one small thing. "Augrim" is the Middle English word for reckoning with Hindu-Arabic numerals, the system that replaced Roman numerals in Europe, so this package converts between the two.
+
+```
+pip install augrim
+```
+
+```python
+from augrim import to_roman, from_roman
+
+to_roman(2026)      # 'MMXXVI'
+from_roman("XLII")  # 42
+```
+
+```
+$ augrim 1999 MMXXVI
+MCMXCIX
+2026
+```
+
+Contact: hello@augrim.ai

augrim-0.0.1.dist-info/RECORD

@@ -0,0 +1,7 @@
+augrim/__init__.py,sha256=bPGoBC_DdfLgEZZyc2nl9Be3URTxNc5U1XDXHlr1Zjo,2025
+augrim/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+augrim-0.0.1.dist-info/licenses/LICENSE,sha256=lAa2NvIVV0ymapt9jiwg94eSbe1kAmktCb_3Mb-3udU,1068
+augrim-0.0.1.dist-info/WHEEL,sha256=EmLkUISDECbcUx3FMCYOqokNOJqNp2r0d4mJzjErvvs,80
+augrim-0.0.1.dist-info/entry_points.txt,sha256=gvrJYimWTIRDRv-aM9EeESAx4PHoT954s6g4deFwEFk,40
+augrim-0.0.1.dist-info/METADATA,sha256=ZNAM36Y55eJ_ldl19voreCetovjdjSGWrtdKpQx2nAk,1030
+augrim-0.0.1.dist-info/RECORD,,

augrim-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.12.3
+Root-Is-Purelib: true
+Tag: py3-none-any

augrim-0.0.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+augrim = augrim:main
+

augrim-0.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Augrim Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.