fintables 0.1.0__tar.gz

fintables-0.1.0/LICENSE

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

fintables-0.1.0/PKG-INFO

@@ -0,0 +1,194 @@
+Metadata-Version: 2.4
+Name: fintables
+Version: 0.1.0
+Summary: Fintables mobile API client and CLI tool
+Author: Sinan Erdinç
+License: MIT
+Project-URL: Homepage, https://github.com/sinanerdinc/fintables
+Project-URL: Repository, https://github.com/sinanerdinc/fintables
+Project-URL: Issues, https://github.com/sinanerdinc/fintables/issues
+Keywords: fintables,finance,borsa,bist,cli,api,stock-market
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: curl-cffi>=0.7.0
+Requires-Dist: pydantic>=2.7.0
+Requires-Dist: pydantic-settings>=2.2.0
+Requires-Dist: typer>=0.12.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Dynamic: license-file
+
+# Fintables
+
+Fintables mobil API'si için Python paketi ve CLI aracı.
+
+## Özellikler
+- **Public Endpointler**: Şirket detayları (`company`), sembol özetleri (`symbol summary`), analist değerlendirmeleri (`analyst`), çoklu arama (`search`).
+- **Authenticated Endpointler**: Finansal tablolar (`symbol sheets`), haber akışı (`feed`), favoriler (`watchlist`), notlar (`memo`).
+- **Zengin Terminal Görünümü**: `rich` destekli tablolar, renkli kartlar, rozetler ve ikonlar.
+- **JSON Çıktı Desteği**: Otomasyonlar ve scriptler için `--output json`.
+- **Async-First Mimari**: `httpx` ve `pydantic v2` tabanlı.
+
+## Kurulum
+```bash
+pip install -e .
+# veya test paketleri ile:
+pip install -e ".[dev]"
+```
+
+## Yapılandırma
+`.env.example` dosyasını `.env` olarak kopyalayın ve kimlik bilgilerinizi girin:
+```bash
+cp .env.example .env
+```
+
+## Python SDK Kullanımı
+
+Paketi başka bir Python projesinde kütüphane/SDK olarak kullanmak isterseniz `FintablesClient` istemcisini ve endpoint fonksiyonlarını doğrudan import edebilirsiniz:
+
+```python
+import asyncio
+from fintables import FintablesClient
+from fintables.api.endpoints import get_company, get_symbol_summary, add_favorite
+
+async def main():
+    async with FintablesClient() as client:
+        # Şirket detayları (Public)
+        company = await get_company(client, "ASELS")
+        print(f"Şirket Kodu: {company.code} | Ünvan: {company.title}")
+
+        # Sembol özeti (Public)
+        summary = await get_symbol_summary(client, "ASELS")
+        print(f"Sektör Sayısı: {len(summary.data.sectors)}")
+
+        # Favori ekleme (Authenticated - .env bilgilerini kullanır)
+        # res = await add_favorite(client, "ASELS")
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## CLI Kullanımı
+```bash
+# Şirket bilgisi
+fintables company ASELS
+
+# Sembol özeti
+fintables symbol ASELS summary
+
+# Analist tahminleri
+fintables analyst ASELS
+fintables analyst ASELS --model-portfolio
+
+# Çoklu arama
+fintables search Polyester
+
+# Finansal tablolar (Authenticated)
+fintables symbol FROTO sheets
+fintables symbol FROTO sheets --sheet balance --periods 5
+
+# Haber akışı (Authenticated)
+fintables feed
+fintables feed FROTO
+
+# Favori hisseler (Authenticated)
+fintables watchlist add FROTO
+fintables watchlist remove FROTO
+
+# Notlar (Authenticated)
+fintables memo list
+fintables memo add FROTO "Beklentim pozitif"
+fintables memo update 42212 "Güncellenmiş not"
+fintables memo delete 42212
+
+# Fonlar
+fintables fund TLY
+fintables fund MAC
+
+# Araştırma Yazıları & Şirket Notları (Authenticated)
+fintables post list                                          # tüm yazıları listele
+fintables post list --filter "Şirket Notları"               # kategori filtresi
+fintables post list --page 2                                 # sayfa ilerle
+fintables post read altny-analist-toplantisi-notlari-2026-6 # yazıyı oku (+ benzer yazılar)
+fintables post read <slug> --output json                    # JSON çıktı
+
+# Bültenler (Authenticated)
+fintables newsletter list                                    # tüm bültenleri listele
+fintables newsletter list --category bist                   # kategori filtresi
+fintables newsletter list --filter "Günlük"                 # başlık/kategori filtresi
+fintables newsletter list --page 2                          # sayfa ilerle
+fintables newsletter read endekslerde-tarihi-degisim        # bülten içeriğini oku
+fintables newsletter read <slug> --output json              # JSON çıktı
+
+# Videolar (YouTube & Borsa Programları)
+fintables video list                                         # videoları listele
+fintables video list --series "Haftalık Sohbetler"           # seriye göre filtrele
+fintables video list --series "Halka Arz Oluyor"             # halka arz videoları
+fintables video list --filter "Bilanço"                      # başlığa göre filtrele
+fintables video list --page 2                                # sayfa ilerle
+fintables video show bilanco-donemini-kapatiyoruz-fintables-haftalik-sohbetler-149 # detay & bölümler
+fintables video show <slug> --output json                    # JSON formatında çıktı
+
+# Ajanda / Ekonomik Takvim (Authenticated)
+fintables agenda                         # bugünün ajandası (varsayılan)
+fintables agenda today                   # bugün
+fintables agenda thisWeek                # bu hafta
+fintables agenda nextWeek                # gelecek hafta
+fintables agenda thisWeek --type dividend  # sadece temettüler
+fintables agenda thisWeek --type macro     # sadece makro veriler
+fintables agenda thisWeek --output json    # JSON çıktı
+
+# Sanal Portföy (Authenticated)
+fintables portfolio list                                                # tüm portföyleri listele
+fintables portfolio create "Benim Portföyüm"                           # yeni portföy oluştur
+fintables portfolio show "Benim Portföyüm"                             # pozisyonları göster
+fintables portfolio buy  "Benim Portföyüm" SASA 250000 2.76 --date 2026-09-22   # alış ekle
+fintables portfolio sell "Benim Portföyüm" SASA 100000 3.10 --date 2026-09-22   # satış ekle
+fintables portfolio delete "Benim Portföyüm"                           # portföyü sil (onay yok)
+fintables portfolio rename "Benim Portföyüm" "Yeni İsim"               # portföy adını değiştir
+
+# UUID ile de kullanılabilir (isimsiz veya belirsiz durumlarda)
+fintables portfolio show ad857c49-d902-4f58-a57a-6429e7b40460
+
+# Bildirimler (Authenticated)
+fintables notification list                   # bildirimleri listele
+fintables notification list --page-size 50    # sayfa boyutu ile listele
+fintables notification unread                 # okunmamış bildirim durumu ve son okuma tarihi
+fintables notification mark-read              # tüm bildirimleri okundu olarak işaretle
+fintables notification list --output json     # JSON çıktısı
+
+# Dil Desteği (i18n)
+fintables --lang tr [KOMUT]                   # Türkçe CLI ve çıktılar (varsayılan: sistem dili veya tr)
+fintables --lang en [COMMAND]                 # İngilizce CLI ve çıktılar
+# Veya ortam değişkeni:
+export FINTABLES_LANG=tr  # ya da en
+```
+
+## Yasal Uyarı (Disclaimer)
+
+> **Önemli:** Bu proje tamamen **eğitim ve kişisel kullanım amacıyla** geliştirilmiş açık kaynaklı gayriresmi bir araçtır. 
+> 
+> - Fintables (Fintables Bilişim Teknolojileri A.Ş.) ile hiçbir resmi bağı, ortaklığı veya sponsorluğu yoktur.
+> - Bu araç finansal tavsiye, yatırım tavsiyesi veya alım-satım önerisi sunmaz.
+> - Verilerin doğruluğu, güncelliği veya eksiksizliği konusunda herhangi bir garanti verilmez. Veri sağlayıcısından alınan verilerin kullanımında doğabilecek her türlü sorumluluk kullanıcıya aittir.
+> - Yazılım "olduğu gibi" (AS IS) sunulmaktadır; yazar ve geliştiriciler doğabilecek doğrudan veya dolaylı hiçbir zarardan sorumlu tutulamaz.
+
+## Lisans
+
+Bu proje [MIT Lisansı](LICENSE) altında lisanslanmıştır.
+
+
+

fintables-0.1.0/README.md

@@ -0,0 +1,161 @@
+# Fintables
+
+Fintables mobil API'si için Python paketi ve CLI aracı.
+
+## Özellikler
+- **Public Endpointler**: Şirket detayları (`company`), sembol özetleri (`symbol summary`), analist değerlendirmeleri (`analyst`), çoklu arama (`search`).
+- **Authenticated Endpointler**: Finansal tablolar (`symbol sheets`), haber akışı (`feed`), favoriler (`watchlist`), notlar (`memo`).
+- **Zengin Terminal Görünümü**: `rich` destekli tablolar, renkli kartlar, rozetler ve ikonlar.
+- **JSON Çıktı Desteği**: Otomasyonlar ve scriptler için `--output json`.
+- **Async-First Mimari**: `httpx` ve `pydantic v2` tabanlı.
+
+## Kurulum
+```bash
+pip install -e .
+# veya test paketleri ile:
+pip install -e ".[dev]"
+```
+
+## Yapılandırma
+`.env.example` dosyasını `.env` olarak kopyalayın ve kimlik bilgilerinizi girin:
+```bash
+cp .env.example .env
+```
+
+## Python SDK Kullanımı
+
+Paketi başka bir Python projesinde kütüphane/SDK olarak kullanmak isterseniz `FintablesClient` istemcisini ve endpoint fonksiyonlarını doğrudan import edebilirsiniz:
+
+```python
+import asyncio
+from fintables import FintablesClient
+from fintables.api.endpoints import get_company, get_symbol_summary, add_favorite
+
+async def main():
+    async with FintablesClient() as client:
+        # Şirket detayları (Public)
+        company = await get_company(client, "ASELS")
+        print(f"Şirket Kodu: {company.code} | Ünvan: {company.title}")
+
+        # Sembol özeti (Public)
+        summary = await get_symbol_summary(client, "ASELS")
+        print(f"Sektör Sayısı: {len(summary.data.sectors)}")
+
+        # Favori ekleme (Authenticated - .env bilgilerini kullanır)
+        # res = await add_favorite(client, "ASELS")
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## CLI Kullanımı
+```bash
+# Şirket bilgisi
+fintables company ASELS
+
+# Sembol özeti
+fintables symbol ASELS summary
+
+# Analist tahminleri
+fintables analyst ASELS
+fintables analyst ASELS --model-portfolio
+
+# Çoklu arama
+fintables search Polyester
+
+# Finansal tablolar (Authenticated)
+fintables symbol FROTO sheets
+fintables symbol FROTO sheets --sheet balance --periods 5
+
+# Haber akışı (Authenticated)
+fintables feed
+fintables feed FROTO
+
+# Favori hisseler (Authenticated)
+fintables watchlist add FROTO
+fintables watchlist remove FROTO
+
+# Notlar (Authenticated)
+fintables memo list
+fintables memo add FROTO "Beklentim pozitif"
+fintables memo update 42212 "Güncellenmiş not"
+fintables memo delete 42212
+
+# Fonlar
+fintables fund TLY
+fintables fund MAC
+
+# Araştırma Yazıları & Şirket Notları (Authenticated)
+fintables post list                                          # tüm yazıları listele
+fintables post list --filter "Şirket Notları"               # kategori filtresi
+fintables post list --page 2                                 # sayfa ilerle
+fintables post read altny-analist-toplantisi-notlari-2026-6 # yazıyı oku (+ benzer yazılar)
+fintables post read <slug> --output json                    # JSON çıktı
+
+# Bültenler (Authenticated)
+fintables newsletter list                                    # tüm bültenleri listele
+fintables newsletter list --category bist                   # kategori filtresi
+fintables newsletter list --filter "Günlük"                 # başlık/kategori filtresi
+fintables newsletter list --page 2                          # sayfa ilerle
+fintables newsletter read endekslerde-tarihi-degisim        # bülten içeriğini oku
+fintables newsletter read <slug> --output json              # JSON çıktı
+
+# Videolar (YouTube & Borsa Programları)
+fintables video list                                         # videoları listele
+fintables video list --series "Haftalık Sohbetler"           # seriye göre filtrele
+fintables video list --series "Halka Arz Oluyor"             # halka arz videoları
+fintables video list --filter "Bilanço"                      # başlığa göre filtrele
+fintables video list --page 2                                # sayfa ilerle
+fintables video show bilanco-donemini-kapatiyoruz-fintables-haftalik-sohbetler-149 # detay & bölümler
+fintables video show <slug> --output json                    # JSON formatında çıktı
+
+# Ajanda / Ekonomik Takvim (Authenticated)
+fintables agenda                         # bugünün ajandası (varsayılan)
+fintables agenda today                   # bugün
+fintables agenda thisWeek                # bu hafta
+fintables agenda nextWeek                # gelecek hafta
+fintables agenda thisWeek --type dividend  # sadece temettüler
+fintables agenda thisWeek --type macro     # sadece makro veriler
+fintables agenda thisWeek --output json    # JSON çıktı
+
+# Sanal Portföy (Authenticated)
+fintables portfolio list                                                # tüm portföyleri listele
+fintables portfolio create "Benim Portföyüm"                           # yeni portföy oluştur
+fintables portfolio show "Benim Portföyüm"                             # pozisyonları göster
+fintables portfolio buy  "Benim Portföyüm" SASA 250000 2.76 --date 2026-09-22   # alış ekle
+fintables portfolio sell "Benim Portföyüm" SASA 100000 3.10 --date 2026-09-22   # satış ekle
+fintables portfolio delete "Benim Portföyüm"                           # portföyü sil (onay yok)
+fintables portfolio rename "Benim Portföyüm" "Yeni İsim"               # portföy adını değiştir
+
+# UUID ile de kullanılabilir (isimsiz veya belirsiz durumlarda)
+fintables portfolio show ad857c49-d902-4f58-a57a-6429e7b40460
+
+# Bildirimler (Authenticated)
+fintables notification list                   # bildirimleri listele
+fintables notification list --page-size 50    # sayfa boyutu ile listele
+fintables notification unread                 # okunmamış bildirim durumu ve son okuma tarihi
+fintables notification mark-read              # tüm bildirimleri okundu olarak işaretle
+fintables notification list --output json     # JSON çıktısı
+
+# Dil Desteği (i18n)
+fintables --lang tr [KOMUT]                   # Türkçe CLI ve çıktılar (varsayılan: sistem dili veya tr)
+fintables --lang en [COMMAND]                 # İngilizce CLI ve çıktılar
+# Veya ortam değişkeni:
+export FINTABLES_LANG=tr  # ya da en
+```
+
+## Yasal Uyarı (Disclaimer)
+
+> **Önemli:** Bu proje tamamen **eğitim ve kişisel kullanım amacıyla** geliştirilmiş açık kaynaklı gayriresmi bir araçtır. 
+> 
+> - Fintables (Fintables Bilişim Teknolojileri A.Ş.) ile hiçbir resmi bağı, ortaklığı veya sponsorluğu yoktur.
+> - Bu araç finansal tavsiye, yatırım tavsiyesi veya alım-satım önerisi sunmaz.
+> - Verilerin doğruluğu, güncelliği veya eksiksizliği konusunda herhangi bir garanti verilmez. Veri sağlayıcısından alınan verilerin kullanımında doğabilecek her türlü sorumluluk kullanıcıya aittir.
+> - Yazılım "olduğu gibi" (AS IS) sunulmaktadır; yazar ve geliştiriciler doğabilecek doğrudan veya dolaylı hiçbir zarardan sorumlu tutulamaz.
+
+## Lisans
+
+Bu proje [MIT Lisansı](LICENSE) altında lisanslanmıştır.
+
+
+

fintables-0.1.0/pyproject.toml

@@ -0,0 +1,61 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "fintables"
+version = "0.1.0"
+description = "Fintables mobile API client and CLI tool"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.11"
+authors = [
+    {name = "Sinan Erdinç"}
+]
+keywords = ["fintables", "finance", "borsa", "bist", "cli", "api", "stock-market"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Office/Business :: Financial :: Investment",
+]
+
+dependencies = [
+    "httpx>=0.27.0",
+    "curl-cffi>=0.7.0",
+    "pydantic>=2.7.0",
+    "pydantic-settings>=2.2.0",
+    "typer>=0.12.0",
+    "rich>=13.7.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/sinanerdinc/fintables"
+Repository = "https://github.com/sinanerdinc/fintables"
+Issues = "https://github.com/sinanerdinc/fintables/issues"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "pytest-cov>=4.1.0",
+]
+
+[project.scripts]
+fintables = "fintables.cli.main:app"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+pythonpath = ["."]
+
+[tool.pyright]
+include = ["src", "tests"]
+extraPaths = ["."]

fintables-0.1.0/setup.cfg

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

fintables-0.1.0/src/fintables/__init__.py

@@ -0,0 +1,8 @@
+"""Fintables Python Client & CLI."""
+
+from fintables.api.client import FintablesClient
+
+__version__ = "0.1.0"
+
+__all__ = ["FintablesClient", "__version__"]
+

fintables-0.1.0/src/fintables/api/__init__.py

@@ -0,0 +1,3 @@
+from fintables.api.client import FintablesClient
+
+__all__ = ["FintablesClient"]

fintables-0.1.0/src/fintables/api/auth.py

@@ -0,0 +1,87 @@
+from typing import Any
+from fintables.exceptions import AuthError
+
+
+async def login(
+    client: Any,
+    email: str,
+    password: str,
+    base_url: str = "https://api.fintables.com",
+    headers: dict[str, str] | None = None,
+) -> tuple[str, str]:
+    """Logs in using email/password and returns (access_token, refresh_token)."""
+    req_headers = {
+        "User-Agent": "fintables-mobile/323 (2.28.2)",
+        "Content-Type": "application/json",
+        "Accept": "application/json",
+    }
+    if headers:
+        req_headers.update(headers)
+
+    payload = {"email": email, "password": password}
+    try:
+        resp = await client.post(
+            f"{base_url}/auth/token/",
+            json=payload,
+            headers=req_headers,
+        )
+        if resp.status_code == 200:
+            data = resp.json()
+            access = data.get("access") or data.get("access_token")
+            refresh = data.get("refresh") or data.get("refresh_token", "")
+            if access:
+                return access, refresh
+        elif resp.status_code == 400 and "username" in getattr(resp, "text", ""):
+            resp2 = await client.post(
+                f"{base_url}/auth/token/",
+                json={"username": email, "password": password},
+                headers=req_headers,
+            )
+            if resp2.status_code == 200:
+                data = resp2.json()
+                access = data.get("access") or data.get("access_token")
+                refresh = data.get("refresh") or data.get("refresh_token", "")
+                if access:
+                    return access, refresh
+    except Exception as e:
+        if isinstance(e, AuthError):
+            raise
+        raise AuthError(f"Giriş isteği sırasında hata oluştu: {type(e).__name__}") from e
+
+    error_msg = resp.text if "resp" in locals() and hasattr(resp, "text") else "Bilinmeyen hata"
+    raise AuthError(
+        f"Giriş yapılamadı: {error_msg}. "
+        "Lütfen FINTABLES_USERNAME/FINTABLES_EMAIL ve FINTABLES_PASSWORD ayarlarınızı kontrol edin."
+    )
+
+
+async def refresh_token(
+    client: Any,
+    refresh: str,
+    base_url: str = "https://api.fintables.com",
+    headers: dict[str, str] | None = None,
+) -> str:
+    """Refreshes access_token using refresh_token."""
+    req_headers = {
+        "User-Agent": "fintables-mobile/323 (2.28.2)",
+        "Content-Type": "application/json",
+        "Accept": "application/json",
+    }
+    if headers:
+        req_headers.update(headers)
+
+    try:
+        resp = await client.post(
+            f"{base_url}/auth/token/refresh/",
+            json={"refresh": refresh},
+            headers=req_headers,
+        )
+        if resp.status_code == 200:
+            data = resp.json()
+            access = data.get("access") or data.get("access_token")
+            if access:
+                return access
+    except Exception as e:
+        raise AuthError(f"Token yenileme sırasında hata oluştu: {type(e).__name__}") from e
+
+    raise AuthError("Token yenilenemedi. Lütfen tekrar giriş yapın.")