qazaqify 0.1.0__tar.gz

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

@@ -0,0 +1,22 @@
+name: ci
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - run: ruff check
+      - run: mypy src
+      - run: pytest

qazaqify-0.1.0/.gitignore

@@ -0,0 +1,26 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.eggs/
+dist/
+build/
+.venv/
+venv/
+.env
+
+# Tools
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+.coverage
+htmlcov/
+coverage.xml
+
+# OS / IDE
+.DS_Store
+.idea/
+.vscode/
+*.swp
+*~

qazaqify-0.1.0/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.1.0
+
+Initial Python port of qazaqify-go: dates, numbers, currency, relative time, units, and UI formatting for Kazakh.

qazaqify-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nurdaulet Rakhymberdi
+
+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.

qazaqify-0.1.0/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.5
+Name: qazaqify
+Version: 0.1.0
+Summary: Kazakh formatting and localization for Python
+Project-URL: Homepage, https://github.com/Rnurdaulet/qazaqify-python
+Project-URL: Repository, https://github.com/Rnurdaulet/qazaqify-python
+Author: Nurdaulet Rakhymberdi
+License: MIT
+License-File: LICENSE
+Keywords: formatting,i18n,kazakh,l10n,locale,qazaq
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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: Typing :: Typed
+Requires-Python: >=3.10
+Provides-Extra: dev
+Requires-Dist: mypy>=1.13; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# qazaqify
+
+[![Python](https://img.shields.io/badge/python-3.10+-3776AB?logo=python&logoColor=white)](https://www.python.org/downloads/)
+[![CI](https://github.com/Rnurdaulet/qazaqify-python/actions/workflows/ci.yml/badge.svg)](https://github.com/Rnurdaulet/qazaqify-python/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![PyPI](https://img.shields.io/pypi/v/qazaqify)](https://pypi.org/project/qazaqify/)
+
+Kazakh formatting and localization for Python.
+
+Dates, numbers, currency, relative time, units, and UI formatting for Python.
+
+You don't have to build Kazakh UI text with `f"{days} күн бұрын"`. Call a function and get ready-to-use text.
+
+## Installation
+
+```bash
+pip install qazaqify
+```
+
+## Usage
+
+```python
+from datetime import datetime, timezone
+
+from qazaqify import (
+    DateStyle,
+    TimeStyle,
+    format_date,
+    format_time,
+    format_datetime,
+    relative_time,
+    calendar,
+    format_interval,
+    number,
+    currency,
+    currency_words,
+    percent,
+    unit,
+    bytes,
+    duration,
+    human_duration,
+    ordinal,
+    words,
+    join,
+    join_or,
+    message,
+)
+
+t = datetime(2026, 9, 4, 14, 30, tzinfo=timezone.utc)
+
+format_date(t, DateStyle.LONG)
+# "2026 ж. 4 қыркүйек"
+
+format_time(t, TimeStyle.SHORT)
+# "14:30"
+
+format_datetime(t)
+# "4 қыркүйек 2026, 14:30"
+
+relative_time(t)
+# "5 минут бұрын"
+
+calendar(t, now)
+# "бүгін, 14:30"
+
+format_interval(start, end)
+# "2026 ж. 4–10 қыркүйек"
+
+number(1234567.89)
+# "1 234 567,89"
+
+currency(12500, "KZT")
+# "12 500 ₸"
+
+currency_words(12500)
+# "он екі мың бес жүз теңге"
+
+percent(0.75)
+# "75%"
+
+unit(1500, "meter")
+# "1,5 км"
+
+bytes(1536000)
+# "1,5 МБ"
+
+duration(3665)
+# "1 сағат 1 минут 5 секунд"
+
+human_duration(3665)
+# "шамамен 1 сағат"
+
+ordinal(21)
+# "21-ші"
+
+words(123)
+# "жүз жиырма үш"
+
+join(["Алма", "алмұрт", "өрік"])
+# "Алма, алмұрт және өрік"
+
+join_or(["Алма", "алмұрт", "өрік"])
+# "Алма, алмұрт немесе өрік"
+
+message("{count} жаңа хабарлама", count=5)
+# "5 жаңа хабарлама"
+```
+
+`DateStyle` / `TimeStyle` also accept strings: `format_date(t, "long")`.
+
+`bytes` shadows the builtin when imported by name. Use `from qazaqify import bytes as format_bytes` if you still need the builtin in the same scope.
+
+## Features
+
+* Date and time formatting
+* Relative time
+* Date and time intervals
+* Calendar helpers
+* Number formatting
+* Numbers in words
+* Ordinal numbers
+* Currency formatting
+* Percentages
+* Units and byte sizes
+* Durations
+* List formatting
+* Simple message formatting
+* Kazakh locale data
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT License

qazaqify-0.1.0/README.md

@@ -0,0 +1,139 @@
+# qazaqify
+
+[![Python](https://img.shields.io/badge/python-3.10+-3776AB?logo=python&logoColor=white)](https://www.python.org/downloads/)
+[![CI](https://github.com/Rnurdaulet/qazaqify-python/actions/workflows/ci.yml/badge.svg)](https://github.com/Rnurdaulet/qazaqify-python/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![PyPI](https://img.shields.io/pypi/v/qazaqify)](https://pypi.org/project/qazaqify/)
+
+Kazakh formatting and localization for Python.
+
+Dates, numbers, currency, relative time, units, and UI formatting for Python.
+
+You don't have to build Kazakh UI text with `f"{days} күн бұрын"`. Call a function and get ready-to-use text.
+
+## Installation
+
+```bash
+pip install qazaqify
+```
+
+## Usage
+
+```python
+from datetime import datetime, timezone
+
+from qazaqify import (
+    DateStyle,
+    TimeStyle,
+    format_date,
+    format_time,
+    format_datetime,
+    relative_time,
+    calendar,
+    format_interval,
+    number,
+    currency,
+    currency_words,
+    percent,
+    unit,
+    bytes,
+    duration,
+    human_duration,
+    ordinal,
+    words,
+    join,
+    join_or,
+    message,
+)
+
+t = datetime(2026, 9, 4, 14, 30, tzinfo=timezone.utc)
+
+format_date(t, DateStyle.LONG)
+# "2026 ж. 4 қыркүйек"
+
+format_time(t, TimeStyle.SHORT)
+# "14:30"
+
+format_datetime(t)
+# "4 қыркүйек 2026, 14:30"
+
+relative_time(t)
+# "5 минут бұрын"
+
+calendar(t, now)
+# "бүгін, 14:30"
+
+format_interval(start, end)
+# "2026 ж. 4–10 қыркүйек"
+
+number(1234567.89)
+# "1 234 567,89"
+
+currency(12500, "KZT")
+# "12 500 ₸"
+
+currency_words(12500)
+# "он екі мың бес жүз теңге"
+
+percent(0.75)
+# "75%"
+
+unit(1500, "meter")
+# "1,5 км"
+
+bytes(1536000)
+# "1,5 МБ"
+
+duration(3665)
+# "1 сағат 1 минут 5 секунд"
+
+human_duration(3665)
+# "шамамен 1 сағат"
+
+ordinal(21)
+# "21-ші"
+
+words(123)
+# "жүз жиырма үш"
+
+join(["Алма", "алмұрт", "өрік"])
+# "Алма, алмұрт және өрік"
+
+join_or(["Алма", "алмұрт", "өрік"])
+# "Алма, алмұрт немесе өрік"
+
+message("{count} жаңа хабарлама", count=5)
+# "5 жаңа хабарлама"
+```
+
+`DateStyle` / `TimeStyle` also accept strings: `format_date(t, "long")`.
+
+`bytes` shadows the builtin when imported by name. Use `from qazaqify import bytes as format_bytes` if you still need the builtin in the same scope.
+
+## Features
+
+* Date and time formatting
+* Relative time
+* Date and time intervals
+* Calendar helpers
+* Number formatting
+* Numbers in words
+* Ordinal numbers
+* Currency formatting
+* Percentages
+* Units and byte sizes
+* Durations
+* List formatting
+* Simple message formatting
+* Kazakh locale data
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT License

qazaqify-0.1.0/pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "qazaqify"
+version = "0.1.0"
+description = "Kazakh formatting and localization for Python"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [{ name = "Nurdaulet Rakhymberdi" }]
+keywords = ["kazakh", "qazaq", "i18n", "l10n", "formatting", "locale"]
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Typing :: Typed",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8",
+    "ruff>=0.8",
+    "mypy>=1.13",
+]
+
+[project.urls]
+Homepage = "https://github.com/Rnurdaulet/qazaqify-python"
+Repository = "https://github.com/Rnurdaulet/qazaqify-python"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/qazaqify"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+mypy_path = "src"
+files = ["src/qazaqify"]

qazaqify-0.1.0/src/qazaqify/__init__.py

@@ -0,0 +1,257 @@
+from .calendar import (
+    AM,
+    ERA_BCE_SHORT,
+    ERA_BCE_WIDE,
+    ERA_CE_SHORT,
+    ERA_CE_WIDE,
+    PM,
+    DayPeriod,
+    Season,
+    ampm,
+    day_period_at,
+    day_period_name,
+    first_weekday,
+    month,
+    months,
+    quarter_name,
+    quarter_of,
+    season_of,
+    weekday,
+    weekday_locative,
+    weekdays,
+    weekdays_monday_first,
+)
+from .currency import (
+    CURRENCY_CODE,
+    CURRENCY_SYMBOL,
+    TENGE,
+    TIYN,
+    Money,
+    currency,
+    currency_kzt,
+    currency_major_words,
+    currency_words,
+    currency_words_mixed,
+    currency_words_tiyn,
+    money_from_tiyn,
+)
+from .dates import DATE_PATTERNS, format_date, format_datetime, year_label
+from .duration import duration, duration_words, format_duration_units, human_duration
+from .icu import icu, icu_float
+from .interval import format_datetime_interval, format_interval, format_time_interval
+from .lists import join, join_or
+from .message import message
+from .numbers import (
+    DECIMAL_SEPARATOR,
+    GROUP_SEPARATOR,
+    NAN,
+    PERCENT_SIGN,
+    integer,
+    number,
+    ordinal,
+    percent,
+)
+from .plural import count, plural, plural_category, plural_category_float, plural_float
+from .relative import (
+    DAY_AFTER_TOMORR,
+    DAY_BEFORE_YEST,
+    DAY_BEFORE_YEST_SHORT,
+    JUST_NOW,
+    LAST_MONTH,
+    LAST_WEEK,
+    LAST_YEAR,
+    NEXT_MONTH,
+    NEXT_WEEK,
+    NEXT_YEAR,
+    NOW,
+    THIS_MONTH,
+    THIS_WEEK,
+    THIS_YEAR,
+    TODAY,
+    TOMORROW,
+    YESTERDAY,
+    ago,
+    calendar,
+    calendar_relative,
+    distance,
+    duration_relative,
+    later,
+    named_day,
+    named_day_width,
+    named_month,
+    named_week,
+    named_year,
+    relative_at,
+    relative_time,
+    relative_time_at,
+    relative_to,
+    relative_weekday,
+    since,
+    since_at,
+    until,
+    until_at,
+)
+from .styles import ByteBase, Cardinal, DateStyle, Form, TimeStyle, UnitKind, Width
+from .times import TIME_PATTERNS, format_time
+from .units import (
+    data_size,
+    data_size_iec,
+    data_size_si,
+    format_bytes,
+    format_unit,
+    unit,
+    unit_name,
+)
+from .words import (
+    NumberError,
+    must_words_string,
+    ordinal_word,
+    words,
+    words_float,
+    words_string,
+    words_uint,
+)
+from .year import (
+    YEAR_OF_WORD,
+    YEAR_WORD,
+    year_of,
+    year_ordinal_words,
+    year_words,
+    year_words_of,
+)
+
+bytes = format_bytes
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "AM",
+    "CURRENCY_CODE",
+    "CURRENCY_SYMBOL",
+    "DATE_PATTERNS",
+    "DAY_AFTER_TOMORR",
+    "DAY_BEFORE_YEST",
+    "DAY_BEFORE_YEST_SHORT",
+    "DECIMAL_SEPARATOR",
+    "ERA_BCE_SHORT",
+    "ERA_BCE_WIDE",
+    "ERA_CE_SHORT",
+    "ERA_CE_WIDE",
+    "GROUP_SEPARATOR",
+    "JUST_NOW",
+    "LAST_MONTH",
+    "LAST_WEEK",
+    "LAST_YEAR",
+    "NAN",
+    "NEXT_MONTH",
+    "NEXT_WEEK",
+    "NEXT_YEAR",
+    "NOW",
+    "PERCENT_SIGN",
+    "PM",
+    "TENGE",
+    "THIS_MONTH",
+    "THIS_WEEK",
+    "THIS_YEAR",
+    "TIME_PATTERNS",
+    "TIYN",
+    "TODAY",
+    "TOMORROW",
+    "YEAR_OF_WORD",
+    "YEAR_WORD",
+    "YESTERDAY",
+    "ByteBase",
+    "Cardinal",
+    "DateStyle",
+    "DayPeriod",
+    "Form",
+    "Money",
+    "NumberError",
+    "Season",
+    "TimeStyle",
+    "UnitKind",
+    "Width",
+    "ago",
+    "ampm",
+    "bytes",
+    "calendar",
+    "calendar_relative",
+    "count",
+    "currency",
+    "currency_kzt",
+    "currency_major_words",
+    "currency_words",
+    "currency_words_mixed",
+    "currency_words_tiyn",
+    "data_size",
+    "data_size_iec",
+    "data_size_si",
+    "day_period_at",
+    "day_period_name",
+    "distance",
+    "duration",
+    "duration_relative",
+    "duration_words",
+    "first_weekday",
+    "format_bytes",
+    "format_date",
+    "format_datetime",
+    "format_datetime_interval",
+    "format_duration_units",
+    "format_interval",
+    "format_time",
+    "format_time_interval",
+    "format_unit",
+    "human_duration",
+    "icu",
+    "icu_float",
+    "integer",
+    "join",
+    "join_or",
+    "later",
+    "message",
+    "money_from_tiyn",
+    "month",
+    "months",
+    "must_words_string",
+    "named_day",
+    "named_day_width",
+    "named_month",
+    "named_week",
+    "named_year",
+    "number",
+    "ordinal",
+    "ordinal_word",
+    "percent",
+    "plural",
+    "plural_category",
+    "plural_category_float",
+    "plural_float",
+    "quarter_name",
+    "quarter_of",
+    "relative_at",
+    "relative_time",
+    "relative_time_at",
+    "relative_to",
+    "relative_weekday",
+    "season_of",
+    "since",
+    "since_at",
+    "unit",
+    "unit_name",
+    "until",
+    "until_at",
+    "weekday",
+    "weekday_locative",
+    "weekdays",
+    "weekdays_monday_first",
+    "words",
+    "words_float",
+    "words_string",
+    "words_uint",
+    "year_label",
+    "year_of",
+    "year_ordinal_words",
+    "year_words",
+    "year_words_of",
+]