settfex 0.3.0__tar.gz → 0.4.0__tar.gz

{settfex-0.3.0 → settfex-0.4.0}/CHANGELOG.md

@@ -5,6 +5,36 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [0.4.0] - 2026-06-19
+
+### Added
+
+- **SET Earnings Call (Opportunity Day) service** (`get_earnings_calls`,
+  `get_earnings_calls_dataframe`, `EarningsCallService`, `EarningsCallItem`,
+  `EarningsCallResponse`, `EarningsCallDetail`, `FilterOption`): fetches the SET
+  "Earnings Call (OPPDAY)" calendar from the stateless opportunity-day backend
+  (`POST https://api.lcp.setgroup.or.th/api/v1/investor/search/archive`). Returns typed
+  Pydantic models with derived `company_name_clean` / `youtube_video_id` / `youtube_url`
+  fields, plus an optional pandas DataFrame (`to_dataframe()`) whose default columns are
+  `stock_name, company_name, earnings_call_date, video_clip_time, youtube_url`. Includes
+  bounded auto-pagination (`fetch_all_earnings_calls`), opt-in concurrent detail enrichment
+  (`enrich=True`), seven filter helpers, and a `*_raw` variant. This host needs no
+  cookies/Incapsula bypass, so it uses a plain sessionless fetcher. Not stock-scoped (not on
+  the `Stock` class). Adds the `docs/settfex/services/set/earnings_call.md` doc and the
+  `examples/set/12_earnings_call.ipynb` notebook.
+- **`AsyncDataFetcher` POST support**: `fetch()` / `fetch_json()` now accept keyword-only
+  `method="GET"` (default — fully backward compatible) and `json_body`. POST runs through the
+  standalone (sessionless) path and the same NaN-rejecting JSON decoder; POST via a persistent
+  session is intentionally unsupported (raises `NotImplementedError`).
+
+### Changed
+
+- pandas is now available as an optional `dataframe` extra
+  (`pip install "settfex[dataframe]"`); it is required only for the DataFrame convenience and
+  is imported lazily, so importing the library never requires pandas.
+
 ## [0.3.0] - 2026-06-17
 
 ### Added

{settfex-0.3.0 → settfex-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: settfex
-Version: 0.3.0
+Version: 0.4.0
 Summary: Async Python library for fetching real-time and historical data from the Stock Exchange of Thailand (SET) and Thailand Futures Exchange (TFEX)
 Project-URL: Homepage, https://github.com/lumduan/settfex
 Project-URL: Documentation, https://github.com/lumduan/settfex#readme
@@ -30,6 +30,8 @@ Requires-Dist: curl-cffi>=0.6.0
 Requires-Dist: diskcache>=5.6.0
 Requires-Dist: loguru>=0.7.0
 Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dataframe
+Requires-Dist: pandas>=2.0.0; extra == 'dataframe'
 Provides-Extra: examples
 Requires-Dist: jupyter>=1.0.0; extra == 'examples'
 Requires-Dist: matplotlib>=3.7.0; extra == 'examples'
@@ -122,6 +124,7 @@ Want to dig deeper? Check out our detailed guides:
 - **[Financial Service](docs/settfex/services/set/financial.md)** - Balance sheet, income statement, and cash flow data
 - **[Chart Quotation Service](docs/settfex/services/set/chart_quotation.md)** - Intraday and historical price chart data
 - **[Latest Historical Trading Service](docs/settfex/services/set/latest_historical_trading.md)** - Latest trading day summary with OHLCV and valuation metrics
+- **[Earnings Call (Opportunity Day) Service](docs/settfex/services/set/earnings_call.md)** - OPPDAY earnings-call calendar with YouTube links, as models or a DataFrame
 
 ### TFEX Services
 
@@ -418,6 +421,31 @@ print(f"Market Cap: {trading.market_cap:,.0f} THB")
 
 ---
 
+#### 🎤 Get Earnings Call (Opportunity Day) Calendar
+
+Fetch the SET Opportunity Day earnings-call calendar — symbol, company, date, clip duration,
+and a ready-to-use YouTube link — as typed models or a pandas DataFrame:
+
+```python
+from settfex.services.set import get_earnings_calls, get_earnings_calls_dataframe
+
+# Typed models
+response = await get_earnings_calls()
+for item in response.items[:5]:
+    print(item.symbol, item.company_name_clean, item.youtube_url)
+
+# …or straight to a DataFrame (requires: pip install "settfex[dataframe]")
+df = await get_earnings_calls_dataframe()
+# columns: stock_name, company_name, earnings_call_date, video_clip_time, youtube_url
+
+# Search one company, or filter by quarter/type
+hann = await get_earnings_calls(keyword="HANN")
+```
+
+**👉 [Learn more about the Earnings Call Service](docs/settfex/services/set/earnings_call.md)**
+
+---
+
 ### TFEX (Thailand Futures Exchange)
 
 #### 📋 Get TFEX Series List
@@ -609,6 +637,12 @@ stock_list = await get_stock_list()
 
 Great for debugging or monitoring in production. Default is ERROR level for clean output.
 
+## 📋 Changelog
+
+See **[CHANGELOG.md](CHANGELOG.md)** for the full, versioned release history (this project
+follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) and
+[Semantic Versioning](https://semver.org/)).
+
 ## 🤝 Contributing
 
 We'd love your help making settfex better! Here's how:

{settfex-0.3.0 → settfex-0.4.0}/README.md

@@ -83,6 +83,7 @@ Want to dig deeper? Check out our detailed guides:
 - **[Financial Service](docs/settfex/services/set/financial.md)** - Balance sheet, income statement, and cash flow data
 - **[Chart Quotation Service](docs/settfex/services/set/chart_quotation.md)** - Intraday and historical price chart data
 - **[Latest Historical Trading Service](docs/settfex/services/set/latest_historical_trading.md)** - Latest trading day summary with OHLCV and valuation metrics
+- **[Earnings Call (Opportunity Day) Service](docs/settfex/services/set/earnings_call.md)** - OPPDAY earnings-call calendar with YouTube links, as models or a DataFrame
 
 ### TFEX Services
 
@@ -379,6 +380,31 @@ print(f"Market Cap: {trading.market_cap:,.0f} THB")
 
 ---
 
+#### 🎤 Get Earnings Call (Opportunity Day) Calendar
+
+Fetch the SET Opportunity Day earnings-call calendar — symbol, company, date, clip duration,
+and a ready-to-use YouTube link — as typed models or a pandas DataFrame:
+
+```python
+from settfex.services.set import get_earnings_calls, get_earnings_calls_dataframe
+
+# Typed models
+response = await get_earnings_calls()
+for item in response.items[:5]:
+    print(item.symbol, item.company_name_clean, item.youtube_url)
+
+# …or straight to a DataFrame (requires: pip install "settfex[dataframe]")
+df = await get_earnings_calls_dataframe()
+# columns: stock_name, company_name, earnings_call_date, video_clip_time, youtube_url
+
+# Search one company, or filter by quarter/type
+hann = await get_earnings_calls(keyword="HANN")
+```
+
+**👉 [Learn more about the Earnings Call Service](docs/settfex/services/set/earnings_call.md)**
+
+---
+
 ### TFEX (Thailand Futures Exchange)
 
 #### 📋 Get TFEX Series List
@@ -570,6 +596,12 @@ stock_list = await get_stock_list()
 
 Great for debugging or monitoring in production. Default is ERROR level for clean output.
 
+## 📋 Changelog
+
+See **[CHANGELOG.md](CHANGELOG.md)** for the full, versioned release history (this project
+follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) and
+[Semantic Versioning](https://semver.org/)).
+
 ## 🤝 Contributing
 
 We'd love your help making settfex better! Here's how:

settfex-0.4.0/docs/settfex/services/set/earnings_call.md

@@ -0,0 +1,187 @@
+# SET Earnings Call (Opportunity Day) Service
+
+## Overview
+
+The Earnings Call Service fetches the SET **"Earnings Call (OPPDAY)"** calendar — the
+Opportunity Day presentations listed at
+<https://opportunity-day.setgroup.or.th/en/earnings-call>. It returns typed Pydantic models
+and an optional pandas DataFrame whose columns are exactly what an earnings-call dashboard
+needs: `stock_name`, `company_name`, `earnings_call_date`, `video_clip_time`, `youtube_url`.
+
+Unlike the main SET API, the opportunity-day backend (`https://api.lcp.setgroup.or.th/api/v1`)
+is **stateless** — no Incapsula bot wall, no cookies, no auth. The service therefore uses a
+plain sessionless fetcher (no cookie warm-up).
+
+## Quick Start
+
+```python
+import asyncio
+from settfex.services.set import get_earnings_calls, get_earnings_calls_dataframe
+
+async def main():
+    # Typed models
+    response = await get_earnings_calls()
+    for item in response.items:
+        print(item.symbol, item.company_name_clean, item.youtube_url)
+
+    # …or straight to a DataFrame (requires: pip install settfex[dataframe])
+    df = await get_earnings_calls_dataframe()
+    print(df)
+
+asyncio.run(main())
+```
+
+## The 5 DataFrame columns
+
+| Column | Source |
+|---|---|
+| `stock_name` | `symbol` (e.g. `HANN`) |
+| `company_name` | `company_name` with the leading `"<SYMBOL>: "` prefix stripped |
+| `earnings_call_date` | `meeting_date` (tz-aware UTC) as a `date` |
+| `video_clip_time` | `period` — the clip **duration** shown on the card, e.g. `"45:00"` |
+| `youtube_url` | derived from the thumbnail `image_path`, e.g. `https://www.youtube.com/watch?v=…` |
+
+`youtube_url` (and `youtube_video_id`) are `None` for upcoming items with no recording.
+
+> ⚠️ **The `period` field has two meanings.** In the **list** response (used for
+> `video_clip_time`) it is the clip **duration** (`"45:00"`, MM:SS). In the **detail**
+> response (enrichment) it is the meeting **clock-time range** (`"16:15 - 17:00"`), surfaced
+> separately as `EarningsCallDetail.meeting_time`. The list duration is authoritative and is
+> never overwritten by enrichment.
+
+## Models
+
+### `EarningsCallItem`
+
+- `id: int`, `name: str` (Thai presentation title), `symbol: str`, `industry: str`
+- `company_name: str` — raw, e.g. `"HANN: MUKDAHAN INTERNATIONAL HOSPITAL …"`
+- `meeting_date: datetime` — tz-aware UTC
+- `image_path: str | None`, `view_mode: bool | None`, `period: str | None`
+- **Derived** (computed): `company_name_clean: str`, `youtube_video_id: str | None`,
+  `youtube_url: str | None`
+- `detail: EarningsCallDetail | None` — populated only when `enrich=True`
+
+### `EarningsCallResponse`
+
+- `no_records: int` — total records across all pages
+- `items: list[EarningsCallItem]`, `count` property
+- `to_dataframe(columns=None) -> pandas.DataFrame` — defaults to the 5 columns above;
+  additional selectable columns: `company_name_raw`, `earnings_call_datetime`,
+  `youtube_video_id`, `id`, `name`, `industry`, `view_mode`. Unknown column → `ValueError`;
+  pandas missing → `ImportError`.
+
+### `EarningsCallDetail` (enrichment)
+
+`video_link`, `company_name_th`, `meeting_time` (the clock-time range), `document_link`,
+`snapshot_link`, `round_name`, `type`, `type_id`, `year`, `round`, `has_qa`, …
+
+### `FilterOption`
+
+`id: int | str`, `name: str` (ids are ints for types/years/trusts/stages, string codes for
+industries/markets/themes).
+
+## Service Class
+
+### `EarningsCallService(config: FetcherConfig | None = None)`
+
+`use_session` is always coerced to `False` for this stateless host; all other `FetcherConfig`
+settings (timeout, retries, impersonation, rate limit) are honored.
+
+#### `fetch_earnings_calls(...) -> EarningsCallResponse`
+
+```python
+response = await EarningsCallService().fetch_earnings_calls(
+    type_id=1,        # 1=Earnings Call/OPPDAY, 2=Digital Roadshow, 3=C-Sign
+    quarter_id=0,     # 0=all quarters; see fetch_filter_years()
+    keyword=None,     # free-text symbol/company search (normalized)
+    industries_id=None,
+    start=1,          # 1-based page number
+    page_size=12,
+    language="en",    # "en" or "th"
+    enrich=False,     # opt-in per-item detail (bounded concurrency)
+)
+```
+
+#### `fetch_all_earnings_calls(..., max_records=None, max_pages=None, throttle=0.3)`
+
+Auto-paginates, **bounded and polite** — reuses one fetcher, sleeps `throttle` seconds between
+pages, and stops at the first short page, once `no_records` is reached, or when a cap is hit.
+
+> The API honors `page_size` up to ~100 but **rejects very large values** (e.g. 500), which
+> surfaces as a clear `ResponseParseError`/`ValidationError`. The defaults (12 for a single
+> page, 50 for `fetch_all`) stay safely under the cap — prefer iterating pages over an
+> oversized `page_size`.
+
+```python
+service = EarningsCallService()
+response = await service.fetch_all_earnings_calls(max_records=200)  # at most 200, polite
+df = response.to_dataframe()
+```
+
+#### `fetch_earnings_calls_raw(...) -> dict`
+
+Raw JSON dict (no validation), for debugging.
+
+#### Filter helpers
+
+`fetch_filter_types()`, `fetch_filter_years()`, `fetch_filter_industries()`,
+`fetch_filter_markets()`, `fetch_filter_themes()`, `fetch_filter_trusts()`,
+`fetch_filter_stages()` → `list[FilterOption]`.
+
+## Convenience Functions
+
+- `get_earnings_calls(...) -> EarningsCallResponse`
+- `get_earnings_calls_dataframe(..., columns=None) -> pandas.DataFrame`
+
+Both fetch a **single page** by default (mirroring `get_stock_list`). For the full calendar,
+use `fetch_all_earnings_calls()` then `to_dataframe()`.
+
+## Usage Examples
+
+### Filter by quarter and type
+
+```python
+service = EarningsCallService()
+years = await service.fetch_filter_years()          # find the quarter id you want
+q1_2026 = next(y for y in years if y.name == "Quater 1/2026").id
+response = await service.fetch_earnings_calls(type_id=1, quarter_id=q1_2026, page_size=50)
+```
+
+### Search a single company
+
+```python
+response = await get_earnings_calls(keyword="HANN")
+for item in response.items:
+    print(item.meeting_date.date(), item.youtube_url)
+```
+
+### Enrich with detail (video link, Thai name, meeting time)
+
+```python
+response = await get_earnings_calls(page_size=10, enrich=True)
+for item in response.items:
+    if item.detail:
+        print(item.symbol, item.detail.meeting_time, item.detail.video_link)
+```
+
+## Optional dependency: pandas
+
+`to_dataframe()` / `get_earnings_calls_dataframe()` need pandas, which is an **optional**
+extra (the rest of the service works without it):
+
+```bash
+pip install "settfex[dataframe]"   # or: uv add pandas
+```
+
+## API Endpoints
+
+```
+POST https://api.lcp.setgroup.or.th/api/v1/investor/search/archive      # list (primary)
+GET  https://api.lcp.setgroup.or.th/api/v1/investor/vdo/{id}            # detail (enrich)
+GET  https://api.lcp.setgroup.or.th/api/v1/investor/filter/{name}       # filter options
+```
+
+## Related Services
+
+- [Stock List Service](list.md) — discover all SET/mai stocks
+- [AsyncDataFetcher](../../utils/data_fetcher.md) — low-level HTTP client (now supports POST)

{settfex-0.3.0 → settfex-0.4.0}/examples/README.md

@@ -21,8 +21,9 @@ Complete tutorial series covering all 11 SET services:
 9. **Trading Statistics** - Historical performance (multi-period)
 10. **Price Performance** - Stock vs sector vs market comparison
 11. **Financial Statements** - Balance sheet, income, cash flow
+12. **Earnings Call (Opportunity Day)** - OPPDAY calendar with YouTube links → DataFrame → CSV
 
-**Total**: 11 notebooks + comprehensive guide
+**Total**: 12 notebooks + comprehensive guide
 
 ## Quick Start
 

settfex-0.4.0/examples/set/12_earnings_call.ipynb

@@ -0,0 +1,217 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Earnings Call (Opportunity Day) Calendar\n",
+    "\n",
+    "Fetch the SET **Earnings Call (OPPDAY)** calendar with `settfex`: symbol, company, date,\n",
+    "video-clip duration, and a ready-to-use YouTube link — as typed models or a pandas DataFrame.\n",
+    "\n",
+    "> The opportunity-day backend is stateless (no cookies/bot wall), so these calls are fast and\n",
+    "> need no session warm-up."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Setup\n",
+    "\n",
+    "The DataFrame helpers need pandas, an optional extra:\n",
+    "\n",
+    "```bash\n",
+    "pip install \"settfex[dataframe]\"   # or: uv add pandas\n",
+    "```"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from settfex.services.set import (\n",
+    "    EarningsCallService,\n",
+    "    get_earnings_calls,\n",
+    "    get_earnings_calls_dataframe,\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## 1. Fetch the current OPPDAY list\n",
+    "\n",
+    "`get_earnings_calls()` returns one page of typed `EarningsCallItem`s."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "response = await get_earnings_calls(page_size=12)\n",
+    "\n",
+    "print(f\"This page: {response.count} items | total available: {response.no_records}\")\n",
+    "\n",
+    "\n",
+    "for item in response.items[:5]:\n",
+    "    print(f\"{item.symbol:8} {item.meeting_date.date()}  {item.period}  {item.company_name_clean}\")\n",
+    "\n",
+    "    print(f\"         {item.youtube_url}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## 2. As a pandas DataFrame\n",
+    "\n",
+    "The default columns are exactly `stock_name, company_name, earnings_call_date, video_clip_time, youtube_url`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "df = await get_earnings_calls_dataframe(page_size=12)\n",
+    "\n",
+    "df"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## 3. Search a single company (keyword)\n",
+    "\n",
+    "`keyword` is a free-text symbol/company search (normalized to uppercase)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "hann = await get_earnings_calls(keyword=\"HANN\")\n",
+    "\n",
+    "hann.to_dataframe()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## 4. Filter by quarter and type\n",
+    "\n",
+    "Use the filter helpers to discover valid ids. `type_id` 1 = Earnings Call (OPPDAY),\n",
+    "2 = Digital Roadshow, 3 = C-Sign. `quarter_id` 0 = all quarters."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "service = EarningsCallService()\n",
+    "\n",
+    "\n",
+    "years = await service.fetch_filter_years()\n",
+    "\n",
+    "print(\"Available quarters (first 5):\")\n",
+    "\n",
+    "for y in years[:5]:\n",
+    "    print(f\"  {y.id}  {y.name}\")\n",
+    "\n",
+    "\n",
+    "# Pick the most recent quarter and fetch its OPPDAY presentations\n",
+    "\n",
+    "latest_quarter = years[0].id\n",
+    "\n",
+    "by_quarter = await service.fetch_earnings_calls(type_id=1, quarter_id=latest_quarter, page_size=20)\n",
+    "\n",
+    "print(f\"\\n{by_quarter.count} item(s) for quarter id {latest_quarter}\")\n",
+    "\n",
+    "by_quarter.to_dataframe()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## 5. Fetch more pages (bounded) and export to CSV\n",
+    "\n",
+    "`fetch_all_earnings_calls` auto-paginates politely. Always cap it with `max_records` /\n",
+    "`max_pages` — the full archive is thousands of rows."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "full = await service.fetch_all_earnings_calls(max_records=100, throttle=0.3)\n",
+    "\n",
+    "df_full = full.to_dataframe()\n",
+    "\n",
+    "print(f\"Collected {len(df_full)} rows\")\n",
+    "\n",
+    "\n",
+    "df_full.to_csv(\"earnings_calls.csv\", index=False)\n",
+    "\n",
+    "print(\"Saved earnings_calls.csv\")\n",
+    "\n",
+    "df_full.head()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## 6. (Optional) Enrich with detail\n",
+    "\n",
+    "`enrich=True` fetches each item's detail concurrently (bounded), adding the YouTube embed\n",
+    "link, the Thai company name, and the meeting **clock-time range** (`detail.meeting_time`,\n",
+    "e.g. `\"16:15 - 17:00\"`). Note this is *different* from `video_clip_time`, which is the clip\n",
+    "**duration** (`\"45:00\"`) from the list endpoint."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "enriched = await get_earnings_calls(page_size=5, enrich=True)\n",
+    "\n",
+    "for item in enriched.items:\n",
+    "    if item.detail:\n",
+    "        print(f\"{item.symbol:8} duration={item.period}  meeting_time={item.detail.meeting_time}\")\n",
+    "\n",
+    "        print(f\"         {item.detail.video_link}\")"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "settfex",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "name": "python",
+   "version": "3.13.5"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}

{settfex-0.3.0 → settfex-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "settfex"
-version = "0.3.0"
+version = "0.4.0"
 description = "Async Python library for fetching real-time and historical data from the Stock Exchange of Thailand (SET) and Thailand Futures Exchange (TFEX)"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -110,6 +110,12 @@ warn_return_any = true
 warn_unused_configs = true
 disallow_untyped_defs = true
 
+# pandas is an optional, untyped runtime extra (used only in to_dataframe()); don't require
+# its stubs to keep the strict gate green.
+[[tool.mypy.overrides]]
+module = ["pandas", "pandas.*"]
+ignore_missing_imports = true
+
 [tool.bandit]
 exclude_dirs = ["tests", ".venv", "scripts"]
 
@@ -117,6 +123,10 @@ exclude_dirs = ["tests", ".venv", "scripts"]
 default-groups = ["dev"]
 
 [project.optional-dependencies]
+# Lightweight extra for the DataFrame convenience (EarningsCallResponse.to_dataframe()).
+dataframe = [
+    "pandas>=2.0.0",
+]
 examples = [
     "pandas>=2.0.0",
     "matplotlib>=3.7.0",
@@ -129,6 +139,9 @@ dev = [
     "bandit>=1.7",
     "build>=1.0.0",
     "mypy>=1.18.2",
+    # pandas is an optional runtime extra (see [project.optional-dependencies].dataframe);
+    # it lives in the dev group too so the to_dataframe() tests run in CI.
+    "pandas>=2.0.0",
     "pip-audit>=2.7",
     "pre-commit>=3.7",
     "pytest>=8.4.2",

{settfex-0.3.0 → settfex-0.4.0}/settfex/__init__.py

@@ -19,7 +19,7 @@ Usage:
     >>> asyncio.run(main())
 """
 
-__version__ = "0.3.0"
+__version__ = "0.4.0"
 __author__ = "batt"
 __license__ = "MIT"
 

{settfex-0.3.0 → settfex-0.4.0}/settfex/services/set/__init__.py

@@ -5,9 +5,13 @@ from settfex.services.set.constants import (
     SET_BOARD_OF_DIRECTOR_ENDPOINT,
     SET_COMPANY_PROFILE_ENDPOINT,
     SET_CORPORATE_ACTION_ENDPOINT,
+    SET_EARNINGS_CALL_DETAIL_ENDPOINT,
+    SET_EARNINGS_CALL_FILTER_ENDPOINT,
+    SET_EARNINGS_CALL_SEARCH_ENDPOINT,
     SET_FINANCIAL_BALANCE_SHEET_ENDPOINT,
     SET_FINANCIAL_CASH_FLOW_ENDPOINT,
     SET_FINANCIAL_INCOME_STATEMENT_ENDPOINT,
+    SET_LCP_BASE_URL,
     SET_NVDR_HOLDER_ENDPOINT,
     SET_PRICE_PERFORMANCE_ENDPOINT,
     SET_STOCK_HIGHLIGHT_DATA_ENDPOINT,
@@ -16,6 +20,15 @@ from settfex.services.set.constants import (
     SET_STOCK_SHAREHOLDER_ENDPOINT,
     SET_TRADING_STAT_ENDPOINT,
 )
+from settfex.services.set.earnings_call import (
+    EarningsCallDetail,
+    EarningsCallItem,
+    EarningsCallResponse,
+    EarningsCallService,
+    FilterOption,
+    get_earnings_calls,
+    get_earnings_calls_dataframe,
+)
 from settfex.services.set.list import (
     StockListResponse,
     StockListService,
@@ -80,11 +93,23 @@ __all__ = [
     "SET_FINANCIAL_BALANCE_SHEET_ENDPOINT",
     "SET_FINANCIAL_INCOME_STATEMENT_ENDPOINT",
     "SET_FINANCIAL_CASH_FLOW_ENDPOINT",
+    "SET_LCP_BASE_URL",
+    "SET_EARNINGS_CALL_SEARCH_ENDPOINT",
+    "SET_EARNINGS_CALL_DETAIL_ENDPOINT",
+    "SET_EARNINGS_CALL_FILTER_ENDPOINT",
     # Stock List Service
     "StockListService",
     "StockListResponse",
     "StockSymbol",
     "get_stock_list",
+    # Earnings Call (Opportunity Day) Service
+    "EarningsCallService",
+    "EarningsCallItem",
+    "EarningsCallDetail",
+    "EarningsCallResponse",
+    "FilterOption",
+    "get_earnings_calls",
+    "get_earnings_calls_dataframe",
     # Stock Class and Services
     "Stock",
     "StockHighlightDataService",