umt-python 0.1.1__tar.gz → 0.3.0__tar.gz

{umt_python-0.1.1/umt_python.egg-info → umt_python-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: umt_python
-Version: 0.1.1
+Version: 0.3.0
 Summary: A collection of useful utility functions for various tasks in Python, focusing on string manipulation and formatting.
 Author-email: riya-amemiya <riyaamemiya@gmail.com>
 License-Expression: MIT
@@ -8,14 +8,15 @@ Project-URL: Bug Tracker, https://github.com/riya-amemiya/UMT/issues
 Project-URL: Homepage, https://github.com/riya-amemiya/UMT
 Project-URL: Repository, https://github.com/riya-amemiya/UMT
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Utilities
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: license-file
@@ -100,6 +101,14 @@ print(encoded)  # "SGVsbG8gV29ybGQ="
 |----------|------|-------------|---------|
 | `has_no_letters` | `(text: str) -> bool` | Check if string contains no letters (only numbers, emojis, special chars) | `has_no_letters("123!@#")  # True` / `has_no_letters("abc123")  # False` |
 
+### Number Functions
+
+| Function | Type | Description | Example |
+|----------|------|-------------|---------|
+| `format_number` | `(value: float \| int, *, locale: str \| None = None, minimum_fraction_digits: int \| None = None, maximum_fraction_digits: int \| None = None, style: Literal["decimal", "currency", "percent"] = "decimal", currency: str \| None = None) -> str` | Format a number with locale-aware separators, fraction-digit controls, and decimal/percent/currency styles. Mirrors `Intl.NumberFormat` from the TypeScript source. | `format_number(1234567.89)  # "1,234,567.89"` / `format_number(1234567.89, locale="de-DE")  # "1.234.567,89"` / `format_number(0.75, style="percent")  # "75%"` / `format_number(1234.5, style="currency", currency="USD")  # "$1,234.50"` |
+| `to_ordinal` | `(value: int \| float) -> str` | Convert a number to its English ordinal string (handles 11th/12th/13th specially) | `to_ordinal(1)  # "1st"` / `to_ordinal(11)  # "11th"` / `to_ordinal(21)  # "21st"` |
+| `to_percentage` | `(value: float \| int, total: float \| int, decimals: int = 2) -> float` | Calculate the percentage of a value relative to a total (returns 0 when total is 0) | `to_percentage(1, 3)  # 33.33` / `to_percentage(25, 100)  # 25.0` |
+
 ## Constants
 
 - `DEFAULT_RANDOM_STRING_CHARS`: Default character pool for random string generation (ASCII letters + digits)

{umt_python-0.1.1 → umt_python-0.3.0}/README.md

@@ -78,6 +78,14 @@ print(encoded)  # "SGVsbG8gV29ybGQ="
 |----------|------|-------------|---------|
 | `has_no_letters` | `(text: str) -> bool` | Check if string contains no letters (only numbers, emojis, special chars) | `has_no_letters("123!@#")  # True` / `has_no_letters("abc123")  # False` |
 
+### Number Functions
+
+| Function | Type | Description | Example |
+|----------|------|-------------|---------|
+| `format_number` | `(value: float \| int, *, locale: str \| None = None, minimum_fraction_digits: int \| None = None, maximum_fraction_digits: int \| None = None, style: Literal["decimal", "currency", "percent"] = "decimal", currency: str \| None = None) -> str` | Format a number with locale-aware separators, fraction-digit controls, and decimal/percent/currency styles. Mirrors `Intl.NumberFormat` from the TypeScript source. | `format_number(1234567.89)  # "1,234,567.89"` / `format_number(1234567.89, locale="de-DE")  # "1.234.567,89"` / `format_number(0.75, style="percent")  # "75%"` / `format_number(1234.5, style="currency", currency="USD")  # "$1,234.50"` |
+| `to_ordinal` | `(value: int \| float) -> str` | Convert a number to its English ordinal string (handles 11th/12th/13th specially) | `to_ordinal(1)  # "1st"` / `to_ordinal(11)  # "11th"` / `to_ordinal(21)  # "21st"` |
+| `to_percentage` | `(value: float \| int, total: float \| int, decimals: int = 2) -> float` | Calculate the percentage of a value relative to a total (returns 0 when total is 0) | `to_percentage(1, 3)  # 33.33` / `to_percentage(25, 100)  # 25.0` |
+
 ## Constants
 
 - `DEFAULT_RANDOM_STRING_CHARS`: Default character pool for random string generation (ASCII letters + digits)

{umt_python-0.1.1 → umt_python-0.3.0}/pyproject.toml

@@ -3,19 +3,18 @@ build-backend = "setuptools.build_meta"
 requires = ["setuptools>=61.0", "wheel"]
 
 [tool.setuptools]
-package-dir = {"umt_python" = "src"}
+package-dir = { "umt_python" = "src" }
 packages = ["umt_python"]
 
 [project]
-authors = [
-  {name = "riya-amemiya", email = "riyaamemiya@gmail.com"},
-]
+authors = [{ name = "riya-amemiya", email = "riyaamemiya@gmail.com" }]
 classifiers = [
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Operating System :: OS Independent",
   "Topic :: Software Development :: Libraries :: Python Modules",
   "Topic :: Utilities",
@@ -24,8 +23,8 @@ description = "A collection of useful utility functions for various tasks in Pyt
 license = "MIT"
 name = "umt_python"
 readme = "README.md"
-requires-python = ">=3.9"
-version = "0.1.1"
+requires-python = ">=3.10"
+version = "0.3.0"
 
 [project.urls]
 "Bug Tracker" = "https://github.com/riya-amemiya/UMT/issues"
@@ -34,7 +33,38 @@ version = "0.1.1"
 
 [dependency-groups]
 dev = [
-  "pyright==1.1.402",
-  "pytest==8.4.1",
-  "ruff==0.12.2",
+  "pyright==1.1.410",
+  "pytest==9.0.3",
+  "pytest-cov==7.1.0",
+  "ruff==0.15.15",
+]
+
+[tool.ruff.lint]
+select = [
+  "ANN",
+  "ARG",
+  "A",
+  "C4",
+  "DTZ",
+  "E",
+  "W",
+  "F",
+  "FIX",
+  "UP",
+  "B",
+  "SIM",
+  "I",
+  "RET",
+  "PT",
+  "N",
+  "PERF",
+  "PL",
+  "FURB",
+  "RUF",
 ]
+ignore = ["E501", "FBT003", "A005", "PLR2004", "PLR0911","PLR0912","PLR0913"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = ["ALL"]
+"src/string/to_half_width.py" = ["RUF"]
+"src/string/to_full_width.py" = ["RUF"]