tefasfon 0.1.0__tar.gz

tefasfon-0.1.0/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 Uraz Akgül
+
+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.

tefasfon-0.1.0/PKG-INFO

@@ -0,0 +1,211 @@
+Metadata-Version: 2.1
+Name: tefasfon
+Version: 0.1.0
+Summary: Fetches fund data from the TEFAS website.
+Home-page: https://github.com/urazakgul/tefasfon
+Author: Uraz Akgül
+Author-email: urazdev@gmail.com
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# tefasfon v0.1.0
+
+## Türkçe tercih edenler için:
+
+***Those who prefer English can scroll down the page.***
+
+## Açıklama
+
+`tefasfon`, Türkiye Elektronik Fon Alım Satım Platformu'nun (TEFAS) resmi web sitesinde yayımlanan yatırım fonu ve emeklilik fonu verilerini programatik olarak çekmenizi sağlayan bir Python kütüphanesidir. Kütüphane, fon türü ve tarih aralığı seçimiyle esnek veri çekimi sunar. Mesajlar ve hata bildirimleri Türkçe/İngilizce desteklidir; çıktı doğrudan kullanıma hazır pandas DataFrame olarak döner ve isteğe bağlı olarak Excel dosyasına kaydedilebilir.
+
+## Özellikler
+
+* İstenilen tarih aralığında ve fon türüne göre TEFAS verilerini hızlıca çekebilirsiniz.
+* Fon bilgisi veya portföy dağılımı (iki farklı sekme) için veri alabilirsiniz.
+* Mesajlar ve hata uyarıları Türkçe/İngilizce gösterilir.
+* Kolay kullanım, çıktı olarak doğrudan `pandas.DataFrame` döner.
+* Çekilen verileri opsiyonel olarak Excel dosyasına kaydedebilirsiniz.
+* Selenium ile gerçek tarayıcı üzerinden veriler alınır, böylece web arayüzündeki tüm güncel verilere ulaşabilirsiniz.
+
+## Kurulum
+
+Kütüphaneyi yüklemek için şu adımları izleyin:
+
+1. Python'ı yükleyin: https://www.python.org/downloads/
+2. Terminal veya komut istemcisinde aşağıdaki komutu çalıştırın:
+
+```bash
+pip install tefasfon
+```
+
+Belirli bir versiyonu yüklemek için:
+
+```bash
+pip install tefasfon==0.1.0
+```
+
+Yüklü versiyonu görüntülemek için:
+
+```bash
+pip show tefasfon
+```
+
+## Fonksiyonlar
+
+### `fetch_tefas_data`
+
+TEFAS web sitesinden fon veya portföy verisi çeker.
+
+Parametreler:
+
+* `fund_type_code` (int): Fon tipi kodu
+  * 0: Menkul Kıymet Yatırım Fonları
+  * 1: Emeklilik Fonları
+  * 2: Borsa Yatırım Fonları
+  * 3: Gayrimenkul Yatırım Fonları
+  * 4: Girişim Sermayesi Yatırım Fonları
+* `tab_code` (int): Sekme kodu
+  * 0: Genel Bilgiler
+  * 1: Portföy Dağılımı
+* `start_date` (str): Başlangıç tarihi, 'gg.aa.yyyy' formatında (örn. '17.07.2025')
+* `end_date` (str): Bitiş tarihi, 'gg.aa.yyyy' formatında (örn. '18.07.2025')
+* `lang` (str): "tr" veya "en" (varsayılan "tr")
+* `save_to_excel` (bool): True verilirse, Excel dosyasına kaydeder (varsayılan: False)
+* `wait_seconds` (int): Web işlemleri arası bekleme süresi (varsayılan: 3)
+
+Dönüş:
+
+* `pandas.DataFrame` (veya veri yoksa boş DataFrame)
+
+## Örnek Kullanım
+
+```python
+from tefasfon import fetch_tefas_data
+
+df = fetch_tefas_data(
+    fund_type_code=0,
+    tab_code=0,
+    start_date="17.08.2025",
+    end_date="18.07.2025",
+    lang="tr",
+    save_to_excel=True
+)
+```
+
+## Notlar
+
+* Kütüphane, TEFAS'ın web sitesindeki verilere bağımlıdır. Herhangi bir değişiklikte veya bakımda, veri çekilemeyebilir. Lütfen [TEFAS](https://www.tefas.gov.tr/TarihselVeriler.aspx) adresinden veri durumu ve güncelliğini kontrol edin.
+* Selenium ve ChromeDriver kullanılır. Bilgisayarınızda Google Chrome kurulu olmalı ve güncel olmalıdır.
+* Kütüphanenin geliştirilmesi ve iyileştirilmesi için geri bildirimlerinizi bekliyorum. GitHub reposuna katkıda bulunun: [GitHub Repo](https://github.com/urazakgul/tefasfon)
+* Herhangi bir sorun veya öneride lütfen GitHub reposundaki "Issue" bölümünden yeni bir konu açarak bildirim sağlayın: [GitHub Issues](https://github.com/urazakgul/tefasfon/issues)
+
+## Sürüm Notları
+
+### v0.1.0 - 20/07/2025
+
+* İlk sürüm yayınlandı.
+
+## Lisans
+
+Bu proje MIT Lisansı altında lisanslanmıştır.
+
+## For those who prefer English:
+
+## Description
+
+`tefasfon` is a Python package that enables you to programmatically fetch investment fund and pension fund data published on the official TEFAS website. The library offers flexible data fetching by fund type and date range. All messages and errors are displayed in Turkish or English. The output is delivered as a ready-to-use pandas DataFrame and can optionally be saved as an Excel file.
+
+## Features
+
+* Easily fetch TEFAS data for any desired date range and fund type.
+* Fetch either general fund information or portfolio breakdown (two separate tabs).
+* Errors and status messages are shown in Turkish or English.
+* Simple usage; output is directly returned as a `pandas.DataFrame`.
+* Optionally save the fetched data as an Excel file.
+* Uses Selenium for browser automation, ensuring access to up-to-date data from the web interface.
+
+## Installation
+
+To use the package, follow these steps:
+
+1. Install Python: https://www.python.org/downloads/
+2. Open your terminal or command prompt and run:
+
+```bash
+pip install tefasfon
+```
+
+To install a specific version:
+
+```bash
+pip install tefasfon==0.1.0
+```
+
+To check the installed version:
+
+```bash
+pip show tefasfon
+```
+
+## Functions
+
+### `fetch_tefas_data`
+
+Fetches fund or portfolio data from the TEFAS website.
+
+Parameters:
+
+* `fund_type_code` (int): Fund type code
+  * 0: Securities Mutual Funds
+  * 1: Pension Funds
+  * 2: Exchange Traded Funds
+  * 3: Real Estate Investment Funds
+  * 4: Venture Capital Investment Funds
+* `tab_code` (int): Tab code
+  * 0: General Information
+  * 1: Portfolio Breakdown
+* `start_date` (str): Start date, in 'dd.mm.yyyy' format (e.g. '17.07.2025')
+* `end_date` (str): End date, in 'dd.mm.yyyy' format (e.g. '18.07.2025')
+* `lang` (str): "tr" or "en" (default "tr")
+* `save_to_excel` (bool): If True, saves the result to an Excel file (default: False)
+* `wait_seconds` (int): Wait time between web actions (default: 3)
+
+Returns:
+
+* `pandas.DataFrame` (or an empty DataFrame if no data)
+
+## Example
+
+```python
+from tefasfon import fetch_tefas_data
+
+df = fetch_tefas_data(
+    fund_type_code=0,
+    tab_code=0,
+    start_date="17.08.2025",
+    end_date="18.07.2025",
+    lang="en",
+    save_to_excel=True
+)
+```
+
+## Notes
+
+* The library depends on data from the [TEFAS](https://www.tefas.gov.tr/TarihselVeriler.aspx) official website. In case of any changes or maintenance, data fetching may not be possible. Please check the data status and availability on TEFAS.
+* Selenium and ChromeDriver are used. Google Chrome must be installed and up-to-date on your system.
+* I welcome your feedback to improve and develop the library. You can contribute to the GitHub repository: [GitHub Repo](https://github.com/urazakgul/tefasfon)
+* For any issues or suggestions, please open a new topic in the "Issue" section of the GitHub repository: [GitHub Issues](https://github.com/urazakgul/tefasfon/issues)
+
+## Release Notes
+
+### v0.1.0 - 20/07/2025
+
+* First release published.
+
+## License
+
+This project is licensed under the MIT License.

tefasfon-0.1.0/README.md

@@ -0,0 +1,197 @@
+# tefasfon v0.1.0
+
+## Türkçe tercih edenler için:
+
+***Those who prefer English can scroll down the page.***
+
+## Açıklama
+
+`tefasfon`, Türkiye Elektronik Fon Alım Satım Platformu'nun (TEFAS) resmi web sitesinde yayımlanan yatırım fonu ve emeklilik fonu verilerini programatik olarak çekmenizi sağlayan bir Python kütüphanesidir. Kütüphane, fon türü ve tarih aralığı seçimiyle esnek veri çekimi sunar. Mesajlar ve hata bildirimleri Türkçe/İngilizce desteklidir; çıktı doğrudan kullanıma hazır pandas DataFrame olarak döner ve isteğe bağlı olarak Excel dosyasına kaydedilebilir.
+
+## Özellikler
+
+* İstenilen tarih aralığında ve fon türüne göre TEFAS verilerini hızlıca çekebilirsiniz.
+* Fon bilgisi veya portföy dağılımı (iki farklı sekme) için veri alabilirsiniz.
+* Mesajlar ve hata uyarıları Türkçe/İngilizce gösterilir.
+* Kolay kullanım, çıktı olarak doğrudan `pandas.DataFrame` döner.
+* Çekilen verileri opsiyonel olarak Excel dosyasına kaydedebilirsiniz.
+* Selenium ile gerçek tarayıcı üzerinden veriler alınır, böylece web arayüzündeki tüm güncel verilere ulaşabilirsiniz.
+
+## Kurulum
+
+Kütüphaneyi yüklemek için şu adımları izleyin:
+
+1. Python'ı yükleyin: https://www.python.org/downloads/
+2. Terminal veya komut istemcisinde aşağıdaki komutu çalıştırın:
+
+```bash
+pip install tefasfon
+```
+
+Belirli bir versiyonu yüklemek için:
+
+```bash
+pip install tefasfon==0.1.0
+```
+
+Yüklü versiyonu görüntülemek için:
+
+```bash
+pip show tefasfon
+```
+
+## Fonksiyonlar
+
+### `fetch_tefas_data`
+
+TEFAS web sitesinden fon veya portföy verisi çeker.
+
+Parametreler:
+
+* `fund_type_code` (int): Fon tipi kodu
+  * 0: Menkul Kıymet Yatırım Fonları
+  * 1: Emeklilik Fonları
+  * 2: Borsa Yatırım Fonları
+  * 3: Gayrimenkul Yatırım Fonları
+  * 4: Girişim Sermayesi Yatırım Fonları
+* `tab_code` (int): Sekme kodu
+  * 0: Genel Bilgiler
+  * 1: Portföy Dağılımı
+* `start_date` (str): Başlangıç tarihi, 'gg.aa.yyyy' formatında (örn. '17.07.2025')
+* `end_date` (str): Bitiş tarihi, 'gg.aa.yyyy' formatında (örn. '18.07.2025')
+* `lang` (str): "tr" veya "en" (varsayılan "tr")
+* `save_to_excel` (bool): True verilirse, Excel dosyasına kaydeder (varsayılan: False)
+* `wait_seconds` (int): Web işlemleri arası bekleme süresi (varsayılan: 3)
+
+Dönüş:
+
+* `pandas.DataFrame` (veya veri yoksa boş DataFrame)
+
+## Örnek Kullanım
+
+```python
+from tefasfon import fetch_tefas_data
+
+df = fetch_tefas_data(
+    fund_type_code=0,
+    tab_code=0,
+    start_date="17.08.2025",
+    end_date="18.07.2025",
+    lang="tr",
+    save_to_excel=True
+)
+```
+
+## Notlar
+
+* Kütüphane, TEFAS'ın web sitesindeki verilere bağımlıdır. Herhangi bir değişiklikte veya bakımda, veri çekilemeyebilir. Lütfen [TEFAS](https://www.tefas.gov.tr/TarihselVeriler.aspx) adresinden veri durumu ve güncelliğini kontrol edin.
+* Selenium ve ChromeDriver kullanılır. Bilgisayarınızda Google Chrome kurulu olmalı ve güncel olmalıdır.
+* Kütüphanenin geliştirilmesi ve iyileştirilmesi için geri bildirimlerinizi bekliyorum. GitHub reposuna katkıda bulunun: [GitHub Repo](https://github.com/urazakgul/tefasfon)
+* Herhangi bir sorun veya öneride lütfen GitHub reposundaki "Issue" bölümünden yeni bir konu açarak bildirim sağlayın: [GitHub Issues](https://github.com/urazakgul/tefasfon/issues)
+
+## Sürüm Notları
+
+### v0.1.0 - 20/07/2025
+
+* İlk sürüm yayınlandı.
+
+## Lisans
+
+Bu proje MIT Lisansı altında lisanslanmıştır.
+
+## For those who prefer English:
+
+## Description
+
+`tefasfon` is a Python package that enables you to programmatically fetch investment fund and pension fund data published on the official TEFAS website. The library offers flexible data fetching by fund type and date range. All messages and errors are displayed in Turkish or English. The output is delivered as a ready-to-use pandas DataFrame and can optionally be saved as an Excel file.
+
+## Features
+
+* Easily fetch TEFAS data for any desired date range and fund type.
+* Fetch either general fund information or portfolio breakdown (two separate tabs).
+* Errors and status messages are shown in Turkish or English.
+* Simple usage; output is directly returned as a `pandas.DataFrame`.
+* Optionally save the fetched data as an Excel file.
+* Uses Selenium for browser automation, ensuring access to up-to-date data from the web interface.
+
+## Installation
+
+To use the package, follow these steps:
+
+1. Install Python: https://www.python.org/downloads/
+2. Open your terminal or command prompt and run:
+
+```bash
+pip install tefasfon
+```
+
+To install a specific version:
+
+```bash
+pip install tefasfon==0.1.0
+```
+
+To check the installed version:
+
+```bash
+pip show tefasfon
+```
+
+## Functions
+
+### `fetch_tefas_data`
+
+Fetches fund or portfolio data from the TEFAS website.
+
+Parameters:
+
+* `fund_type_code` (int): Fund type code
+  * 0: Securities Mutual Funds
+  * 1: Pension Funds
+  * 2: Exchange Traded Funds
+  * 3: Real Estate Investment Funds
+  * 4: Venture Capital Investment Funds
+* `tab_code` (int): Tab code
+  * 0: General Information
+  * 1: Portfolio Breakdown
+* `start_date` (str): Start date, in 'dd.mm.yyyy' format (e.g. '17.07.2025')
+* `end_date` (str): End date, in 'dd.mm.yyyy' format (e.g. '18.07.2025')
+* `lang` (str): "tr" or "en" (default "tr")
+* `save_to_excel` (bool): If True, saves the result to an Excel file (default: False)
+* `wait_seconds` (int): Wait time between web actions (default: 3)
+
+Returns:
+
+* `pandas.DataFrame` (or an empty DataFrame if no data)
+
+## Example
+
+```python
+from tefasfon import fetch_tefas_data
+
+df = fetch_tefas_data(
+    fund_type_code=0,
+    tab_code=0,
+    start_date="17.08.2025",
+    end_date="18.07.2025",
+    lang="en",
+    save_to_excel=True
+)
+```
+
+## Notes
+
+* The library depends on data from the [TEFAS](https://www.tefas.gov.tr/TarihselVeriler.aspx) official website. In case of any changes or maintenance, data fetching may not be possible. Please check the data status and availability on TEFAS.
+* Selenium and ChromeDriver are used. Google Chrome must be installed and up-to-date on your system.
+* I welcome your feedback to improve and develop the library. You can contribute to the GitHub repository: [GitHub Repo](https://github.com/urazakgul/tefasfon)
+* For any issues or suggestions, please open a new topic in the "Issue" section of the GitHub repository: [GitHub Issues](https://github.com/urazakgul/tefasfon/issues)
+
+## Release Notes
+
+### v0.1.0 - 20/07/2025
+
+* First release published.
+
+## License
+
+This project is licensed under the MIT License.

tefasfon-0.1.0/setup.cfg

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

tefasfon-0.1.0/setup.py

@@ -0,0 +1,31 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding = "utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="tefasfon",
+    version="0.1.0",
+    packages=find_packages(),
+    author="Uraz Akgül",
+    author_email="urazdev@gmail.com",
+    description="Fetches fund data from the TEFAS website.",
+    long_description=long_description,
+    long_description_content_type='text/markdown',
+    url="https://github.com/urazakgul/tefasfon",
+    license="MIT",
+    install_requires=[
+        "requests",
+        "pandas",
+        "openpyxl",
+        "selenium",
+        "rich",
+        "lxml",
+        "webdriver-manager",
+    ],
+    classifiers=[
+        'Programming Language :: Python :: 3',
+        'License :: OSI Approved :: MIT License',
+    ],
+    python_requires=">=3.8",
+)

tefasfon-0.1.0/tefasfon/__init__.py

@@ -0,0 +1,3 @@
+from .data_fetcher import fetch_tefas_data
+
+__all__ = ["fetch_tefas_data"]

tefasfon-0.1.0/tefasfon/data_fetcher.py

@@ -0,0 +1,128 @@
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support.ui import Select
+from selenium.common.exceptions import ElementClickInterceptedException
+import time
+import pandas as pd
+from datetime import timedelta
+from io import StringIO
+from rich.console import Console
+
+from .setup_webdriver import setup_webdriver
+from .utils import (
+    FUND_TYPE_CODES,
+    TAB_CODES,
+    get_localized_message,
+    parse_and_validate_dates,
+    print_rich_panel,
+    fix_date
+)
+
+def fetch_tefas_data(
+    fund_type_code: int,
+    tab_code: int,
+    start_date: str,
+    end_date: str,
+    lang: str = "tr",
+    save_to_excel: bool = False,
+    wait_seconds: int = 3
+) -> pd.DataFrame:
+    console = Console()
+
+    if fund_type_code not in FUND_TYPE_CODES:
+        raise ValueError(get_localized_message("invalid_fund_type", lang, fund_type_code, list(FUND_TYPE_CODES.keys())))
+    if tab_code not in TAB_CODES:
+        raise ValueError(get_localized_message("invalid_tab_type", lang, tab_code, list(TAB_CODES.keys())))
+
+    fund_type_label = FUND_TYPE_CODES[fund_type_code]
+    tab_label = TAB_CODES[tab_code]
+
+    start_date_dt, end_date_dt = parse_and_validate_dates(start_date, end_date, lang)
+    start_date_filename = start_date_dt.strftime("%Y%m%d")
+    end_date_filename = end_date_dt.strftime("%Y%m%d")
+    excel_filename = f"tefas_{fund_type_label}_{tab_label}_{start_date_filename}_{end_date_filename}.xlsx"
+
+    driver = setup_webdriver(lang)
+    driver.maximize_window()
+    driver.get("https://www.tefas.gov.tr/TarihselVeriler.aspx")
+    time.sleep(wait_seconds)
+    driver.minimize_window()
+    print_rich_panel(console, get_localized_message("browser_minimized", lang), lang)
+    time.sleep(wait_seconds)
+
+    tab_dropdown_table_map = {
+        "general_information": {
+            "tab_button_id": "ui-id-1",
+            "table_id": "table_general_info",
+            "next_button_id": "table_general_info_next",
+            "dropdown_name": "table_general_info_length"
+        },
+        "portfolio_breakdown": {
+            "tab_button_id": "ui-id-2",
+            "table_id": "table_allocation",
+            "next_button_id": "table_allocation_next",
+            "dropdown_name": "table_allocation_length"
+        }
+    }
+    tab_params = tab_dropdown_table_map[tab_label]
+
+    tab_button = driver.find_element(By.ID, tab_params["tab_button_id"])
+    tab_button.click()
+    time.sleep(wait_seconds)
+
+    all_rows = []
+    columns = None
+    current_date = start_date_dt
+    while current_date <= end_date_dt:
+        date_str = current_date.strftime("%d.%m.%Y")
+        start_date_input = driver.find_element(By.ID, "TextBoxStartDate")
+        start_date_input.clear()
+        start_date_input.send_keys(date_str)
+        end_date_input = driver.find_element(By.ID, "TextBoxEndDate")
+        end_date_input.clear()
+        end_date_input.send_keys(date_str)
+        view_button = driver.find_element(By.ID, "ButtonSearchDates")
+        view_button.click()
+        time.sleep(wait_seconds)
+
+        try:
+            select_element = driver.find_element(By.NAME, tab_params["dropdown_name"])
+            select_box = Select(select_element)
+            max_option = max([int(option.text) for option in select_box.options if option.text.isdigit()])
+            select_box.select_by_visible_text(str(max_option))
+            time.sleep(wait_seconds)
+        except Exception as e:
+            print(f"Dropdown selection error: {e}")
+
+        while True:
+            table_element = driver.find_element(By.ID, tab_params["table_id"])
+            table_html = table_element.get_attribute("outerHTML")
+            page_df = pd.read_html(StringIO(table_html), decimal=',', thousands='.')[0]
+            if "Tarih" in page_df.columns:
+                page_df["Tarih"] = page_df["Tarih"].apply(fix_date)
+            if columns is None:
+                columns = page_df.columns.tolist()
+            all_rows.extend(page_df.values.tolist())
+            try:
+                next_button = driver.find_element(By.ID, tab_params["next_button_id"])
+            except:
+                break
+            if "disabled" in next_button.get_attribute("class"):
+                break
+            if not (next_button.is_displayed() and next_button.is_enabled()):
+                break
+            try:
+                next_button.click()
+                time.sleep(wait_seconds)
+            except ElementClickInterceptedException:
+                break
+            time.sleep(wait_seconds)
+        current_date += timedelta(days=1)
+
+    final_df = pd.DataFrame(all_rows, columns=columns)
+    print_rich_panel(console, get_localized_message("rows_fetched", lang, final_df.shape[0]), lang, style="green")
+    if save_to_excel:
+        final_df.to_excel(excel_filename, index=False)
+        print_rich_panel(console, get_localized_message("saved_excel", lang, excel_filename), lang, style="bold cyan")
+    print_rich_panel(console, get_localized_message("all_done", lang), lang, style="bold green")
+    driver.quit()
+    return final_df

tefasfon-0.1.0/tefasfon/setup_webdriver.py

@@ -0,0 +1,41 @@
+import platform
+from selenium import webdriver
+from selenium.webdriver.chrome.service import Service
+from selenium.webdriver.chrome.options import Options
+from selenium.common.exceptions import SessionNotCreatedException
+from webdriver_manager.chrome import ChromeDriverManager
+
+from .utils import get_localized_message
+
+def setup_webdriver(lang) -> webdriver.Chrome:
+    driver = None
+    try:
+        chrome_options = Options()
+        system_platform = platform.system()
+        if system_platform == "Linux":
+            chrome_options.add_argument('--no-sandbox')
+            chrome_options.add_argument('--disable-dev-shm-usage')
+        elif system_platform == "Darwin":
+            chrome_options.add_argument('--disable-infobars')
+            chrome_options.add_argument('--disable-popup-blocking')
+        elif system_platform == "Windows":
+            chrome_options.add_argument('--disable-extensions')
+
+        service = Service(ChromeDriverManager().install())
+        driver = webdriver.Chrome(service=service, options=chrome_options)
+        return driver
+
+    except SessionNotCreatedException as e:
+        raise RuntimeError(
+            get_localized_message(
+                "webdriver_version_mismatch", lang, e
+            )
+        )
+    except Exception as e:
+        if driver:
+            driver.quit()
+        raise RuntimeError(
+            get_localized_message(
+                "webdriver_setup_failed", lang, e
+            )
+        )

tefasfon-0.1.0/tefasfon/utils.py

@@ -0,0 +1,82 @@
+import re
+from datetime import datetime
+from rich.panel import Panel
+from rich.text import Text
+
+LANGUAGES = {
+    "tr": {
+        "browser_minimized": "Tarayıcı küçültüldü! Lütfen kapatmayın. İşlem arka planda devam edecek. Bittiğinde bildirim alacaksınız.",
+        "info": "BİLGİ",
+        "rows_fetched": "{} satır çekildi.",
+        "saved_excel": "Excel dosyasına kaydedildi: {}",
+        "all_done": "Tüm işlemler başarıyla tamamlandı.",
+        "invalid_fund_type": "Geçersiz fon tipi kodu: '{}'. Geçerli kodlar: {}",
+        "invalid_tab_type": "Geçersiz sekme kodu: '{}'. Geçerli kodlar: {}",
+        "invalid_date_format": "Geçersiz {} formatı! Doğru format: 'gg.aa.yyyy'",
+        "start_date_gt_end": "Başlangıç tarihi, bitiş tarihinden sonra olamaz!",
+        "webdriver_version_mismatch": "WebDriver sürüm uyumsuzluğu: {}. Lütfen Chrome veya WebDriver'ı güncellemeyi deneyin.",
+        "webdriver_setup_failed": "WebDriver kurulumu başarısız oldu: {}. Lütfen Google Chrome'un kurulu ve WebDriver sürümünüzle uyumlu olduğundan emin olun.",
+    },
+    "en": {
+        "browser_minimized": "Browser minimized! Please do not close it. The process will continue in the background. You will get a notification when it finishes.",
+        "info": "INFO",
+        "rows_fetched": "{} rows fetched.",
+        "saved_excel": "Saved to Excel file: {}",
+        "all_done": "All operations completed successfully.",
+        "invalid_fund_type": "Invalid fund type code: '{}'. Valid codes: {}",
+        "invalid_tab_type": "Invalid tab code: '{}'. Valid codes: {}",
+        "invalid_date_format": "Invalid {} format! Correct format: 'dd.mm.yyyy'",
+        "start_date_gt_end": "Start date cannot be after end date!",
+        "webdriver_version_mismatch": "WebDriver version mismatch: {}. Please try updating Chrome or WebDriver.",
+        "webdriver_setup_failed": "WebDriver setup failed: {}. Please ensure Google Chrome is installed and compatible with the WebDriver version.",
+    }
+}
+
+FUND_TYPE_CODES = {
+    0: "securities_mutuals",
+    1: "pension",
+    2: "exchange_traded",
+    3: "real_estate_investment",
+    4: "venture_capital_investment"
+}
+FUND_TYPE_LABELS = {v: k for k, v in FUND_TYPE_CODES.items()}
+
+TAB_CODES = {
+    0: "general_information",
+    1: "portfolio_breakdown"
+}
+TAB_LABELS = {v: k for k, v in TAB_CODES.items()}
+
+def get_localized_message(key, lang, *args):
+    template = LANGUAGES.get(lang, LANGUAGES["en"]).get(key, key)
+    return template.format(*args) if args else template
+
+def parse_and_validate_dates(start_date_str, end_date_str, lang):
+    try:
+        start_date = datetime.strptime(start_date_str, "%d.%m.%Y")
+    except Exception:
+        raise ValueError(get_localized_message("invalid_date_format", lang, "start date"))
+    try:
+        end_date = datetime.strptime(end_date_str, "%d.%m.%Y")
+    except Exception:
+        raise ValueError(get_localized_message("invalid_date_format", lang, "end date"))
+    if start_date > end_date:
+        raise ValueError(get_localized_message("start_date_gt_end", lang))
+    return start_date, end_date
+
+def print_rich_panel(console, message, lang, style="bold yellow", title_key="info", border_style="bright_magenta"):
+    panel = Panel(
+        Text(message, style=style, justify="center"),
+        title=f"[cyan]{get_localized_message(title_key, lang)}",
+        border_style=border_style
+    )
+    console.print(panel)
+
+def fix_date(val):
+    if isinstance(val, str) and re.match(r"\d{2}\.\d{2}\.\d{4}", val):
+        return val
+    elif isinstance(val, (int, float, str)) and len(str(int(float(val)))) == 8:
+        s = str(int(float(val)))
+        return f"{s[:2]}.{s[2:4]}.{s[4:]}"
+    else:
+        return str(val)

tefasfon-0.1.0/tefasfon.egg-info/PKG-INFO

@@ -0,0 +1,211 @@
+Metadata-Version: 2.1
+Name: tefasfon
+Version: 0.1.0
+Summary: Fetches fund data from the TEFAS website.
+Home-page: https://github.com/urazakgul/tefasfon
+Author: Uraz Akgül
+Author-email: urazdev@gmail.com
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# tefasfon v0.1.0
+
+## Türkçe tercih edenler için:
+
+***Those who prefer English can scroll down the page.***
+
+## Açıklama
+
+`tefasfon`, Türkiye Elektronik Fon Alım Satım Platformu'nun (TEFAS) resmi web sitesinde yayımlanan yatırım fonu ve emeklilik fonu verilerini programatik olarak çekmenizi sağlayan bir Python kütüphanesidir. Kütüphane, fon türü ve tarih aralığı seçimiyle esnek veri çekimi sunar. Mesajlar ve hata bildirimleri Türkçe/İngilizce desteklidir; çıktı doğrudan kullanıma hazır pandas DataFrame olarak döner ve isteğe bağlı olarak Excel dosyasına kaydedilebilir.
+
+## Özellikler
+
+* İstenilen tarih aralığında ve fon türüne göre TEFAS verilerini hızlıca çekebilirsiniz.
+* Fon bilgisi veya portföy dağılımı (iki farklı sekme) için veri alabilirsiniz.
+* Mesajlar ve hata uyarıları Türkçe/İngilizce gösterilir.
+* Kolay kullanım, çıktı olarak doğrudan `pandas.DataFrame` döner.
+* Çekilen verileri opsiyonel olarak Excel dosyasına kaydedebilirsiniz.
+* Selenium ile gerçek tarayıcı üzerinden veriler alınır, böylece web arayüzündeki tüm güncel verilere ulaşabilirsiniz.
+
+## Kurulum
+
+Kütüphaneyi yüklemek için şu adımları izleyin:
+
+1. Python'ı yükleyin: https://www.python.org/downloads/
+2. Terminal veya komut istemcisinde aşağıdaki komutu çalıştırın:
+
+```bash
+pip install tefasfon
+```
+
+Belirli bir versiyonu yüklemek için:
+
+```bash
+pip install tefasfon==0.1.0
+```
+
+Yüklü versiyonu görüntülemek için:
+
+```bash
+pip show tefasfon
+```
+
+## Fonksiyonlar
+
+### `fetch_tefas_data`
+
+TEFAS web sitesinden fon veya portföy verisi çeker.
+
+Parametreler:
+
+* `fund_type_code` (int): Fon tipi kodu
+  * 0: Menkul Kıymet Yatırım Fonları
+  * 1: Emeklilik Fonları
+  * 2: Borsa Yatırım Fonları
+  * 3: Gayrimenkul Yatırım Fonları
+  * 4: Girişim Sermayesi Yatırım Fonları
+* `tab_code` (int): Sekme kodu
+  * 0: Genel Bilgiler
+  * 1: Portföy Dağılımı
+* `start_date` (str): Başlangıç tarihi, 'gg.aa.yyyy' formatında (örn. '17.07.2025')
+* `end_date` (str): Bitiş tarihi, 'gg.aa.yyyy' formatında (örn. '18.07.2025')
+* `lang` (str): "tr" veya "en" (varsayılan "tr")
+* `save_to_excel` (bool): True verilirse, Excel dosyasına kaydeder (varsayılan: False)
+* `wait_seconds` (int): Web işlemleri arası bekleme süresi (varsayılan: 3)
+
+Dönüş:
+
+* `pandas.DataFrame` (veya veri yoksa boş DataFrame)
+
+## Örnek Kullanım
+
+```python
+from tefasfon import fetch_tefas_data
+
+df = fetch_tefas_data(
+    fund_type_code=0,
+    tab_code=0,
+    start_date="17.08.2025",
+    end_date="18.07.2025",
+    lang="tr",
+    save_to_excel=True
+)
+```
+
+## Notlar
+
+* Kütüphane, TEFAS'ın web sitesindeki verilere bağımlıdır. Herhangi bir değişiklikte veya bakımda, veri çekilemeyebilir. Lütfen [TEFAS](https://www.tefas.gov.tr/TarihselVeriler.aspx) adresinden veri durumu ve güncelliğini kontrol edin.
+* Selenium ve ChromeDriver kullanılır. Bilgisayarınızda Google Chrome kurulu olmalı ve güncel olmalıdır.
+* Kütüphanenin geliştirilmesi ve iyileştirilmesi için geri bildirimlerinizi bekliyorum. GitHub reposuna katkıda bulunun: [GitHub Repo](https://github.com/urazakgul/tefasfon)
+* Herhangi bir sorun veya öneride lütfen GitHub reposundaki "Issue" bölümünden yeni bir konu açarak bildirim sağlayın: [GitHub Issues](https://github.com/urazakgul/tefasfon/issues)
+
+## Sürüm Notları
+
+### v0.1.0 - 20/07/2025
+
+* İlk sürüm yayınlandı.
+
+## Lisans
+
+Bu proje MIT Lisansı altında lisanslanmıştır.
+
+## For those who prefer English:
+
+## Description
+
+`tefasfon` is a Python package that enables you to programmatically fetch investment fund and pension fund data published on the official TEFAS website. The library offers flexible data fetching by fund type and date range. All messages and errors are displayed in Turkish or English. The output is delivered as a ready-to-use pandas DataFrame and can optionally be saved as an Excel file.
+
+## Features
+
+* Easily fetch TEFAS data for any desired date range and fund type.
+* Fetch either general fund information or portfolio breakdown (two separate tabs).
+* Errors and status messages are shown in Turkish or English.
+* Simple usage; output is directly returned as a `pandas.DataFrame`.
+* Optionally save the fetched data as an Excel file.
+* Uses Selenium for browser automation, ensuring access to up-to-date data from the web interface.
+
+## Installation
+
+To use the package, follow these steps:
+
+1. Install Python: https://www.python.org/downloads/
+2. Open your terminal or command prompt and run:
+
+```bash
+pip install tefasfon
+```
+
+To install a specific version:
+
+```bash
+pip install tefasfon==0.1.0
+```
+
+To check the installed version:
+
+```bash
+pip show tefasfon
+```
+
+## Functions
+
+### `fetch_tefas_data`
+
+Fetches fund or portfolio data from the TEFAS website.
+
+Parameters:
+
+* `fund_type_code` (int): Fund type code
+  * 0: Securities Mutual Funds
+  * 1: Pension Funds
+  * 2: Exchange Traded Funds
+  * 3: Real Estate Investment Funds
+  * 4: Venture Capital Investment Funds
+* `tab_code` (int): Tab code
+  * 0: General Information
+  * 1: Portfolio Breakdown
+* `start_date` (str): Start date, in 'dd.mm.yyyy' format (e.g. '17.07.2025')
+* `end_date` (str): End date, in 'dd.mm.yyyy' format (e.g. '18.07.2025')
+* `lang` (str): "tr" or "en" (default "tr")
+* `save_to_excel` (bool): If True, saves the result to an Excel file (default: False)
+* `wait_seconds` (int): Wait time between web actions (default: 3)
+
+Returns:
+
+* `pandas.DataFrame` (or an empty DataFrame if no data)
+
+## Example
+
+```python
+from tefasfon import fetch_tefas_data
+
+df = fetch_tefas_data(
+    fund_type_code=0,
+    tab_code=0,
+    start_date="17.08.2025",
+    end_date="18.07.2025",
+    lang="en",
+    save_to_excel=True
+)
+```
+
+## Notes
+
+* The library depends on data from the [TEFAS](https://www.tefas.gov.tr/TarihselVeriler.aspx) official website. In case of any changes or maintenance, data fetching may not be possible. Please check the data status and availability on TEFAS.
+* Selenium and ChromeDriver are used. Google Chrome must be installed and up-to-date on your system.
+* I welcome your feedback to improve and develop the library. You can contribute to the GitHub repository: [GitHub Repo](https://github.com/urazakgul/tefasfon)
+* For any issues or suggestions, please open a new topic in the "Issue" section of the GitHub repository: [GitHub Issues](https://github.com/urazakgul/tefasfon/issues)
+
+## Release Notes
+
+### v0.1.0 - 20/07/2025
+
+* First release published.
+
+## License
+
+This project is licensed under the MIT License.

tefasfon-0.1.0/tefasfon.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+setup.py
+tefasfon/__init__.py
+tefasfon/data_fetcher.py
+tefasfon/setup_webdriver.py
+tefasfon/utils.py
+tefasfon.egg-info/PKG-INFO
+tefasfon.egg-info/SOURCES.txt
+tefasfon.egg-info/dependency_links.txt
+tefasfon.egg-info/requires.txt
+tefasfon.egg-info/top_level.txt

tefasfon-0.1.0/tefasfon.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

tefasfon-0.1.0/tefasfon.egg-info/requires.txt

@@ -0,0 +1,7 @@
+requests
+pandas
+openpyxl
+selenium
+rich
+lxml
+webdriver-manager

tefasfon-0.1.0/tefasfon.egg-info/top_level.txt

@@ -0,0 +1 @@
+tefasfon