khmer-time-format 0.1.0__tar.gz

khmer_time_format-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,15 @@
+name: CI
+on: [push, pull_request]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - run: python -m pip install -U pip
+      - run: pip install -e ".[dev]"
+      - run: ruff check .
+      - run: mypy src
+      - run: pytest

khmer_time_format-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,25 @@
+name: Publish to PyPI
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+permissions:
+  id-token: write
+  contents: read
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - run: python -m pip install -U build
+      - run: python -m build
+      - run: python -m pip install -U twine
+      - run: python -m twine check dist/*
+      - name: Publish
+        uses: pypa/gh-action-pypi-publish@release/v1

khmer_time_format-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.pyc
+dist/
+build/
+*.egg-info/
+.venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/

khmer_time_format-0.1.0/CHANGELOG.md

@@ -0,0 +1,4 @@
+# Changelog
+
+## 0.1.0
+- Initial release

khmer_time_format-0.1.0/LICENSE

@@ -0,0 +1,3 @@
+MIT License
+
+Copyright (c) 2026

khmer_time_format-0.1.0/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: khmer-time-format
+Version: 0.1.0
+Summary: Format 12/24 hour time into Khmer (digits or words).
+Author: Kon Thaina
+License: MIT
+Project-URL: Homepage, https://github.com/Konthaina/khmer-time-format-py
+Project-URL: Repository, https://github.com/Konthaina/khmer-time-format-py
+Keywords: khmer,time,format
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Dynamic: license-file
+
+# khmer-time-format (Python)
+
+Format 12-hour / 24-hour time (e.g. `1:22 PM`, `13:22`) into Khmer with **two options**:
+
+1) **Khmer numerals (digits)**  
+`ម៉ោង១ និង ២២ នាទី រសៀល`
+
+2) **Khmer words (no digits)**  
+`ម៉ោងមួយ និង ម្ភៃពីរ នាទី រសៀល`
+
+## Install
+
+```bash
+pip install khmer-time-format
+```
+
+## Usage
+
+```python
+from khmer_time_format import format_time
+
+print(format_time("1:22 PM", mode="digits"))
+print(format_time("13:22", mode="words"))
+```
+
+## Development
+
+```bash
+python -m venv .venv
+# Windows: .venv\Scripts\activate
+# macOS/Linux: source .venv/bin/activate
+pip install -e ".[dev]"
+pytest
+ruff check .
+mypy src
+```
+
+## Build & publish (PyPI)
+
+```bash
+python -m build
+python -m twine check dist/*
+```
+
+Push a version tag to publish to PyPI via GitHub Actions:
+
+```bash
+# tag value becomes package version
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+Tag pushes matching `v*` trigger `.github/workflows/publish.yml`.
+
+With this setup, you do not need to edit the version in `pyproject.toml` for each release.

khmer_time_format-0.1.0/README.md

@@ -0,0 +1,55 @@
+# khmer-time-format (Python)
+
+Format 12-hour / 24-hour time (e.g. `1:22 PM`, `13:22`) into Khmer with **two options**:
+
+1) **Khmer numerals (digits)**  
+`ម៉ោង១ និង ២២ នាទី រសៀល`
+
+2) **Khmer words (no digits)**  
+`ម៉ោងមួយ និង ម្ភៃពីរ នាទី រសៀល`
+
+## Install
+
+```bash
+pip install khmer-time-format
+```
+
+## Usage
+
+```python
+from khmer_time_format import format_time
+
+print(format_time("1:22 PM", mode="digits"))
+print(format_time("13:22", mode="words"))
+```
+
+## Development
+
+```bash
+python -m venv .venv
+# Windows: .venv\Scripts\activate
+# macOS/Linux: source .venv/bin/activate
+pip install -e ".[dev]"
+pytest
+ruff check .
+mypy src
+```
+
+## Build & publish (PyPI)
+
+```bash
+python -m build
+python -m twine check dist/*
+```
+
+Push a version tag to publish to PyPI via GitHub Actions:
+
+```bash
+# tag value becomes package version
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+Tag pushes matching `v*` trigger `.github/workflows/publish.yml`.
+
+With this setup, you do not need to edit the version in `pyproject.toml` for each release.

khmer_time_format-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=68", "setuptools-scm[toml]>=8", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "khmer-time-format"
+dynamic = ["version"]
+description = "Format 12/24 hour time into Khmer (digits or words)."
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [{name = "Kon Thaina"}]
+keywords = ["khmer", "time", "format"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent"
+]
+
+[project.urls]
+Homepage = "https://github.com/Konthaina/khmer-time-format-py"
+Repository = "https://github.com/Konthaina/khmer-time-format-py"
+
+[project.optional-dependencies]
+dev = ["pytest>=7", "ruff>=0.5", "mypy>=1.10"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 88
+target-version = "py38"
+
+[tool.mypy]
+python_version = "3.8"
+strict = true
+mypy_path = ["src"]
+
+[tool.setuptools_scm]
+fallback_version = "0.0.0"
+local_scheme = "no-local-version"

khmer_time_format-0.1.0/setup.cfg

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

khmer_time_format-0.1.0/src/khmer_time_format/__init__.py

@@ -0,0 +1,10 @@
+from importlib.metadata import PackageNotFoundError, version
+
+from .formatter import format_time
+
+__all__ = ["format_time", "__version__"]
+
+try:
+    __version__ = version("khmer-time-format")
+except PackageNotFoundError:
+    __version__ = "0.0.0"

khmer_time_format-0.1.0/src/khmer_time_format/formatter.py

@@ -0,0 +1,104 @@
+from __future__ import annotations
+
+import re
+from typing import Literal, Tuple
+
+Mode = Literal["digits", "words"]
+
+_KHMER_DIGITS = str.maketrans(
+    {"0": "០", "1": "១", "2": "២", "3": "៣", "4": "៤", "5": "៥", "6": "៦", "7": "៧", "8": "៨", "9": "៩"}
+)
+
+_UNITS = {
+    0: "សូន្យ",
+    1: "មួយ",
+    2: "ពីរ",
+    3: "បី",
+    4: "បួន",
+    5: "ប្រាំ",
+    6: "ប្រាំមួយ",
+    7: "ប្រាំពីរ",
+    8: "ប្រាំបី",
+    9: "ប្រាំបួន",
+}
+
+_TENS = {10: "ដប់", 20: "ម្ភៃ", 30: "សាមសិប", 40: "សែសិប", 50: "ហាសិប"}
+
+_TIME_RE = re.compile(r"^\s*(\d{1,2})\s*:\s*(\d{2})\s*(AM|PM)?\s*$", re.IGNORECASE)
+
+
+def _number_to_khmer_words(n: int) -> str:
+    if n < 0 or n > 59:
+        raise ValueError("number out of supported range (0-59)")
+    if n < 10:
+        return _UNITS[n]
+    if n < 20:
+        if n == 10:
+            return _TENS[10]
+        return _TENS[10] + _UNITS[n - 10]
+    tens = (n // 10) * 10
+    ones = n % 10
+    if ones == 0:
+        return _TENS[tens]
+    return _TENS[tens] + _UNITS[ones]
+
+
+def _number_to_khmer_digits(n: int) -> str:
+    return str(n).translate(_KHMER_DIGITS)
+
+
+def _period_km(hour24: int) -> str:
+    if 0 <= hour24 <= 5:
+        return "យប់"
+    if 6 <= hour24 <= 11:
+        return "ព្រឹក"
+    if 12 <= hour24 <= 17:
+        return "រសៀល"
+    return "ល្ងាច"
+
+
+def _to_12h(hour24: int) -> int:
+    h = hour24 % 12
+    return 12 if h == 0 else h
+
+
+def _parse_time(time_str: str) -> Tuple[int, int]:
+    m = _TIME_RE.match(time_str)
+    if not m:
+        raise ValueError("Invalid time format. Use 'H:MM', 'HH:MM', or 'H:MM AM/PM'.")
+    hour = int(m.group(1))
+    minute = int(m.group(2))
+    ampm = m.group(3)
+    if minute < 0 or minute > 59:
+        raise ValueError("Minute must be 00-59.")
+    if ampm:
+        if hour < 1 or hour > 12:
+            raise ValueError("Hour must be 1-12 when using AM/PM.")
+        ap = ampm.upper()
+        if ap == "AM":
+            hour24 = 0 if hour == 12 else hour
+        else:
+            hour24 = 12 if hour == 12 else hour + 12
+    else:
+        if hour < 0 or hour > 23:
+            raise ValueError("Hour must be 0-23 for 24-hour input.")
+        hour24 = hour
+    return hour24, minute
+
+
+def format_time(time_str: str, mode: Mode = "digits") -> str:
+    hour24, minute = _parse_time(time_str)
+    hour12 = _to_12h(hour24)
+    period = _period_km(hour24)
+
+    if mode == "digits":
+        h = _number_to_khmer_digits(hour12)
+        m = _number_to_khmer_digits(minute)
+        return f"ម៉ោង{h} និង {m} នាទី {period}"
+
+    if mode == "words":
+        h = _number_to_khmer_words(hour12)
+        m = _number_to_khmer_words(minute)
+        return f"ម៉ោង{h} និង {m} នាទី {period}"
+
+    raise ValueError("mode must be 'digits' or 'words'")

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

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: khmer-time-format
+Version: 0.1.0
+Summary: Format 12/24 hour time into Khmer (digits or words).
+Author: Kon Thaina
+License: MIT
+Project-URL: Homepage, https://github.com/Konthaina/khmer-time-format-py
+Project-URL: Repository, https://github.com/Konthaina/khmer-time-format-py
+Keywords: khmer,time,format
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Dynamic: license-file
+
+# khmer-time-format (Python)
+
+Format 12-hour / 24-hour time (e.g. `1:22 PM`, `13:22`) into Khmer with **two options**:
+
+1) **Khmer numerals (digits)**  
+`ម៉ោង១ និង ២២ នាទី រសៀល`
+
+2) **Khmer words (no digits)**  
+`ម៉ោងមួយ និង ម្ភៃពីរ នាទី រសៀល`
+
+## Install
+
+```bash
+pip install khmer-time-format
+```
+
+## Usage
+
+```python
+from khmer_time_format import format_time
+
+print(format_time("1:22 PM", mode="digits"))
+print(format_time("13:22", mode="words"))
+```
+
+## Development
+
+```bash
+python -m venv .venv
+# Windows: .venv\Scripts\activate
+# macOS/Linux: source .venv/bin/activate
+pip install -e ".[dev]"
+pytest
+ruff check .
+mypy src
+```
+
+## Build & publish (PyPI)
+
+```bash
+python -m build
+python -m twine check dist/*
+```
+
+Push a version tag to publish to PyPI via GitHub Actions:
+
+```bash
+# tag value becomes package version
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+Tag pushes matching `v*` trigger `.github/workflows/publish.yml`.
+
+With this setup, you do not need to edit the version in `pyproject.toml` for each release.

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

@@ -0,0 +1,15 @@
+.gitignore
+CHANGELOG.md
+LICENSE
+README.md
+pyproject.toml
+.github/workflows/ci.yml
+.github/workflows/publish.yml
+src/khmer_time_format/__init__.py
+src/khmer_time_format/formatter.py
+src/khmer_time_format.egg-info/PKG-INFO
+src/khmer_time_format.egg-info/SOURCES.txt
+src/khmer_time_format.egg-info/dependency_links.txt
+src/khmer_time_format.egg-info/requires.txt
+src/khmer_time_format.egg-info/top_level.txt
+tests/test_formatter.py

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

@@ -0,0 +1 @@
+

khmer_time_format-0.1.0/src/khmer_time_format.egg-info/requires.txt

@@ -0,0 +1,5 @@
+
+[dev]
+pytest>=7
+ruff>=0.5
+mypy>=1.10

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

@@ -0,0 +1 @@
+khmer_time_format

khmer_time_format-0.1.0/tests/test_formatter.py

@@ -0,0 +1,13 @@
+from khmer_time_format import format_time
+
+def test_digits_12h_pm():
+    assert format_time("1:22 PM", mode="digits") == "ម៉ោង១ និង ២២ នាទី រសៀល"
+
+def test_words_12h_pm():
+    assert format_time("1:22 PM", mode="words") == "ម៉ោងមួយ និង ម្ភៃពីរ នាទី រសៀល"
+
+def test_digits_24h():
+    assert format_time("13:22", mode="digits") == "ម៉ោង១ និង ២២ នាទី រសៀល"
+
+def test_words_24h():
+    assert format_time("13:22", mode="words") == "ម៉ោងមួយ និង ម្ភៃពីរ នាទី រសៀល"