zafather 0.4.1__tar.gz

zafather-0.4.1/CHANGELOG.md

@@ -0,0 +1,55 @@
+# O'zgarishlar tarixi
+
+Format: [Keep a Changelog](https://keepachangelog.com/), versiyalash: [SemVer](https://semver.org/).
+
+## [0.4.1]
+### Qo'shildi
+- **PyPI nashri**: `pyproject.toml` to'ldirildi (classifiers, urls, authors),
+  `py.typed` (PEP 561), `MANIFEST.in`.
+- GitHub Actions: `ci.yml` (3.9–3.13 da testlar), `publish.yml` (tag qo'yilganda
+  PyPI Trusted Publishing orqali avtomatik nashr).
+- `CONTRIBUTING.md` — loyiha ochiq, PR va takliflar qabul qilinadi.
+- README: muallif (**ismoilov299**), hissa qo'shish va muhokama bo'limlari,
+  PyPI/Python/litsenziya badge'lari, "Buy Me A Coffee" qo'llab-quvvatlash.
+- `.github/FUNDING.yml` — GitHub Sponsor tugmasi.
+
+### O'zgardi
+- `CLAUDE.md` git kuzatuvidan chiqarildi (lokal ishlab chiqish fayli);
+  hissa qo'shish qo'llanmasi to'liq `CONTRIBUTING.md` da.
+- `__author__`, `__license__` `zafather/__init__.py` da.
+
+## [0.4.0]
+### Qo'shildi
+- **Rich Messages** (Bot API 10.1/10.2): `RichMessage` HTML quruvchisi
+  (sarlavha, ro'yxat, checklist, jadval, kod, yig'iladigan bo'lim, thinking),
+  `RichStream` — AI javobini oqim bilan yuborish (`sendRichMessageDraft`).
+- `Message.answer_rich()`, `Message.edit_rich()`, `Bot.send_rich()`, `Bot.stream_rich()`.
+- `markdown_rich()` — markdown orqali rich message.
+- `SafeHTML` — ikki marta ekranlashning oldini oladi.
+
+## [0.3.0]
+### Qo'shildi
+- **Mini App**: `validate()` (HMAC-SHA256), `validate_third_party()` (Ed25519),
+  `parse_init_data()`, `direct_link()`, `main_app_link()`, `attach_link()`.
+- `MiniAppServer` — static fayllar + avtomatik tekshiriladigan JSON API + webhook.
+- `MiniApp` — menyu tugmasi, `answerWebAppQuery`, tayyor xabar/tugmalar, emoji status.
+- `WebAppData` filtri; `examples/miniapp/` to'liq namunasi.
+
+## [0.2.0]
+### Qo'shildi
+- Bot API 10.2 darajasi: 26 ta update turi, `allowed_updates` avtomatik to'liq.
+- **Rangli tugmalar** (9.4+): `.primary()`, `.success()`, `.danger()`, `icon=`.
+- **Premium emoji**: `emoji()`, `TextBuilder` (entity orqali, `date_time` bilan).
+- **Managed bots** (9.6+): `ManagedBots`, `BotFarm`, `Zafather.spawn()`.
+- Ephemeral xabarlar, reaksiyalar (`m.react()`), guest mode, obunalar.
+- Yangi dekoratorlar: `@bot.managed_bot`, `@bot.guest`, `@bot.subscription`,
+  `@bot.reaction`, `@bot.business_message`, `@bot.boost`, `@bot.service`.
+- Yangi filtrlar: `Service`, `Ephemeral`, `Premium`, `HasCustomEmoji`.
+
+## [0.1.0]
+### Qo'shildi
+- Yadro: `Zafather` (polling, dispatch, hooks, webhook), `Bot` (dinamik API
+  metodlari, retry, 429, fayl yuklash), `Router` (middleware, sub-router).
+- Filtrlar: `Command`, `Text`, `Regex`, `ChatType`, `ContentType`, `UserFilter`.
+- `F` sehrli filtri, FSM (`StatesGroup`, `FSMContext`, Memory/JSON storage).
+- Klaviaturalar, CLI (`python -m zafather new`), 3 ta namuna.

zafather-0.4.1/CONTRIBUTING.md

@@ -0,0 +1,49 @@
+# Zafather'ga hissa qo'shish
+
+Loyiha ochiq — **pull request va takliflar mamnuniyat bilan qabul qilinadi.**
+
+## Taklif yoki xatolik
+
+[Issues](https://github.com/ismoilov299/zafather/issues) da yozing. Xatolik bo'lsa:
+qanday takrorlash mumkinligini, kutilgan va haqiqiy natijani yozing.
+
+## Kod yuborish
+
+1. Repozitoriyni fork qiling, `main` dan alohida branch oching
+   (`feat/callback-data`, `fix/regex-caption` kabi).
+2. **Har bir yangi imkoniyat uchun test majburiy** — `test_zafather.py`,
+   `test_miniapp.py`, `test_rich.py` uslubida (Telegram'ga ulanmasdan,
+   `app.bot.request` / `app.bot.call` soxta funksiya bilan almashtiriladi).
+3. Tekshiring:
+   ```bash
+   python -m compileall -q zafather
+   python test_zafather.py
+   python test_miniapp.py
+   python test_rich.py
+   ```
+   Testlar soni kamaymasin.
+4. Yangi modul qo'shsangiz: `zafather/__init__.py` ga eksport + `__all__` ga
+   nom + `README.md` da bo'lim + `CHANGELOG.md` ga qator + versiya ko'tarish
+   (`pyproject.toml` va `zafather/__init__.py` bir vaqtda).
+5. Commit xabari: `feat:`, `fix:`, `docs:`, `test:`, `refactor:` + o'zbekcha
+   tavsif. Har bir imkoniyat alohida commit.
+6. `main` ga pull request oching.
+
+## Kod uslubi
+
+- Izohlar va docstring'lar — **o'zbekcha**, kod nomlari — inglizcha.
+- Public API uchun type hint majburiy.
+- Kutubxona kodida `print()` yo'q — `logging.getLogger("zafather.<modul>")`.
+- Satr uzunligi ~100 belgi.
+- Yangi majburiy bog'liqlik qo'shilmaydi (`aiohttp` dan boshqa;
+  `cryptography` — ixtiyoriy).
+- Bot API maydon nomlarini taxmin qilib kodga qotirmang — noaniq bo'lsa
+  `**params` orqali o'tkazing va docstring'da belgilang.
+- `Bot.__getattr__` snake_case→camelCase, filtr `dict` qaytarsa handlerga
+  argument bo'ladi, `UNSET` sentinel `state=None` dan farqlanadi — mavjud
+  namunalarga qarab yozing.
+
+## Muhokama
+
+Savol yoki g'oya uchun: [regnad299@gmail.com](mailto:regnad299@gmail.com)
+yoki Issues'da `question` yorlig'i bilan.

zafather-0.4.1/LICENSE

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

zafather-0.4.1/MANIFEST.in

@@ -0,0 +1,8 @@
+include LICENSE
+include README.md
+include CHANGELOG.md
+include CONTRIBUTING.md
+include zafather/py.typed
+recursive-include examples *.py *.html
+exclude zafather.bundle
+global-exclude __pycache__ *.py[cod]