nithilan 0.1.0__tar.gz

nithilan-0.1.0/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: nithilan
+Version: 0.1.0
+Summary: Small Python utilities for everyday programs
+Author: Nithilan Vivek
+Project-URL: Homepage, https://nithi.land
+Keywords: utilities,factorial,terminal
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# nithilan
+
+`nithilan` is a small collection of Python utilities for everyday programs.
+
+## Installation
+
+```bash
+python -m pip install nithilan
+```
+
+## Usage
+
+```python
+from nithilan import ask, factorial
+
+print(factorial(5))
+
+if ask("Continue?"):
+    print("Continuing")
+```
+
+`factorial` supports non-negative integers and real values supported by the gamma function. `ask` reads a single `y` or `n` response from an interactive Windows, macOS, or Linux terminal.

nithilan-0.1.0/README.md

@@ -0,0 +1,22 @@
+# nithilan
+
+`nithilan` is a small collection of Python utilities for everyday programs.
+
+## Installation
+
+```bash
+python -m pip install nithilan
+```
+
+## Usage
+
+```python
+from nithilan import ask, factorial
+
+print(factorial(5))
+
+if ask("Continue?"):
+    print("Continuing")
+```
+
+`factorial` supports non-negative integers and real values supported by the gamma function. `ask` reads a single `y` or `n` response from an interactive Windows, macOS, or Linux terminal.

nithilan-0.1.0/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["setuptools>=77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "nithilan"
+version = "0.1.0"
+description = "Small Python utilities for everyday programs"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [
+    { name = "Nithilan Vivek" }
+]
+keywords = ["utilities", "factorial", "terminal"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://nithi.land"
+
+[tool.setuptools.packages.find]
+where = ["src"]

nithilan-0.1.0/setup.cfg

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

nithilan-0.1.0/src/nithilan/__init__.py

@@ -0,0 +1,4 @@
+from .core import ask, factorial
+
+__all__ = ["ask", "factorial"]
+__version__ = "0.1.0"

nithilan-0.1.0/src/nithilan/core.py

@@ -0,0 +1,51 @@
+import io
+import math
+import sys
+
+
+def factorial(x: float) -> int | float:
+    if x < 0:
+        raise ValueError("factorial is not defined for negative numbers")
+    if x % 1 == 0:
+        count = int(x)
+        result = 1
+        while count > 0:
+            result *= count
+            count -= 1
+        return result
+    return math.gamma(x + 1)
+
+
+def ask(prompt: str) -> bool | None:
+    print(prompt + " (y/n): ", end="", flush=True)
+
+    if sys.platform == "win32":
+        import msvcrt
+
+        char = msvcrt.getch().decode("utf-8", errors="ignore")
+    else:
+        import termios
+        import tty
+
+        try:
+            file_descriptor = sys.stdin.fileno()
+            previous_settings = termios.tcgetattr(file_descriptor)
+            try:
+                tty.setraw(file_descriptor)
+                char = sys.stdin.read(1)
+            finally:
+                termios.tcsetattr(
+                    file_descriptor,
+                    termios.TCSADRAIN,
+                    previous_settings,
+                )
+        except (io.UnsupportedOperation, OSError):
+            char = input()
+
+    char = char.lower()
+    if char == "y":
+        return True
+    if char == "n":
+        return False
+    print("Incorrect argument")
+    return None

nithilan-0.1.0/src/nithilan.egg-info/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: nithilan
+Version: 0.1.0
+Summary: Small Python utilities for everyday programs
+Author: Nithilan Vivek
+Project-URL: Homepage, https://nithi.land
+Keywords: utilities,factorial,terminal
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# nithilan
+
+`nithilan` is a small collection of Python utilities for everyday programs.
+
+## Installation
+
+```bash
+python -m pip install nithilan
+```
+
+## Usage
+
+```python
+from nithilan import ask, factorial
+
+print(factorial(5))
+
+if ask("Continue?"):
+    print("Continuing")
+```
+
+`factorial` supports non-negative integers and real values supported by the gamma function. `ask` reads a single `y` or `n` response from an interactive Windows, macOS, or Linux terminal.

nithilan-0.1.0/src/nithilan.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+src/nithilan/__init__.py
+src/nithilan/core.py
+src/nithilan.egg-info/PKG-INFO
+src/nithilan.egg-info/SOURCES.txt
+src/nithilan.egg-info/dependency_links.txt
+src/nithilan.egg-info/top_level.txt
+tests/test_core.py

nithilan-0.1.0/src/nithilan.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

nithilan-0.1.0/src/nithilan.egg-info/top_level.txt

@@ -0,0 +1 @@
+nithilan

nithilan-0.1.0/tests/test_core.py

@@ -0,0 +1,42 @@
+import io
+import math
+import unittest
+from unittest.mock import patch
+
+from nithilan import ask, factorial
+
+
+class FactorialTests(unittest.TestCase):
+    def test_integer(self):
+        self.assertEqual(factorial(5), 120)
+
+    def test_zero(self):
+        self.assertEqual(factorial(0), 1)
+
+    def test_fraction(self):
+        self.assertAlmostEqual(factorial(0.5), math.gamma(1.5))
+
+    def test_negative_number(self):
+        with self.assertRaisesRegex(ValueError, "negative numbers"):
+            factorial(-1)
+
+
+class AskTests(unittest.TestCase):
+    def check_answer(self, answer, expected):
+        fake_input = io.StringIO(answer + "\n")
+        fake_output = io.StringIO()
+        with patch("sys.stdin", fake_input), patch("sys.stdout", fake_output):
+            self.assertIs(ask("Continue?"), expected)
+
+    def test_yes(self):
+        self.check_answer("y", True)
+
+    def test_no(self):
+        self.check_answer("n", False)
+
+    def test_invalid_answer(self):
+        self.check_answer("maybe", None)
+
+
+if __name__ == "__main__":
+    unittest.main()