thordata-sdk 1.5.0__py3-none-any.whl → 1.6.0__py3-none-any.whl

thordata/tools/travel.py

@@ -0,0 +1,100 @@
+"""
+Travel & Real Estate Scraper Tools (Booking, Zillow, Airbnb)
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from .base import ToolRequest
+
+
+class Booking:
+    """Namespace for Booking.com tools."""
+
+    @dataclass
+    class HotelByUrl(ToolRequest):
+        """Booking Hotel Information Scraper by URL"""
+
+        SPIDER_ID = "booking_hotellist_by-url"
+        SPIDER_NAME = "booking.com"
+        url: str
+
+
+class Zillow:
+    """Namespace for Zillow tools."""
+
+    @dataclass
+    class PriceByUrl(ToolRequest):
+        """Zillow Property Price History Information Scraper by URL"""
+
+        SPIDER_ID = "zillow_price_by-url"
+        SPIDER_NAME = "zillow.com"
+        url: str
+
+    @dataclass
+    class ProductByUrl(ToolRequest):
+        """Zillow Property Details Information Scraper by URL"""
+
+        SPIDER_ID = "zillow_product_by-url"
+        SPIDER_NAME = "zillow.com"
+        url: str
+
+    @dataclass
+    class ProductByFilter(ToolRequest):
+        """Zillow Property Details Information Scraper by Filter"""
+
+        SPIDER_ID = "zillow_product_by-filter"
+        SPIDER_NAME = "zillow.com"
+        keywords_location: str
+        listingCategory: str | None = None  # For Rent, For Sale
+        HomeType: str | None = None  # Houses
+        days_on_zillow: str | None = None  # Any
+        maximum: int | None = None
+
+    @dataclass
+    class ProductByListUrl(ToolRequest):
+        """Zillow Property Details Information Scraper by List URL"""
+
+        SPIDER_ID = "zillow_product_by-listurl"
+        SPIDER_NAME = "zillow.com"
+        url: str
+        maximum: int | None = None
+
+
+class Airbnb:
+    """Namespace for Airbnb tools."""
+
+    @dataclass
+    class ProductBySearchUrl(ToolRequest):
+        """Airbnb Properties Information Scraper by Search URL"""
+
+        SPIDER_ID = "airbnb_product_by-searchurl"
+        SPIDER_NAME = "airbnb.com"
+        searchurl: str
+        country: str | None = None
+
+    @dataclass
+    class ProductByLocation(ToolRequest):
+        """Airbnb Properties Information Scraper by Location"""
+
+        SPIDER_ID = "airbnb_product_by-location"
+        SPIDER_NAME = "airbnb.com"
+        location: str
+        check_in: str | None = None
+        check_out: str | None = None
+        num_of_adults: str | None = None
+        num_of_children: str | None = None
+        num_of_infants: str | None = None
+        num_of_pets: str | None = None
+        country: str | None = None
+        currency: str | None = None
+
+    @dataclass
+    class ProductByUrl(ToolRequest):
+        """Airbnb Properties Information Scraper by URL"""
+
+        SPIDER_ID = "airbnb_product_by-url"
+        SPIDER_NAME = "airbnb.com"
+        url: str
+        country: str | None = None

thordata/tools/video.py

@@ -46,14 +46,23 @@ class YouTube:
 
     @dataclass
     class Profile(VideoToolRequest):
-        """YouTube Profile Scraper. Uses video_builder."""
+        """YouTube Profile Scraper by Keyword. Uses video_builder."""
 
         SPIDER_ID = "youtube_profiles_by-keyword"
         SPIDER_NAME = "youtube.com"
 
-        url: str  # Channel URL
+        keyword: str
         page_turning: int = 1
-        keyword: str | None = None
+        common_settings: CommonSettings = field(default_factory=CommonSettings)
+
+    @dataclass
+    class ProfileByUrl(VideoToolRequest):
+        """YouTube Profile Scraper by URL. Uses video_builder."""
+
+        SPIDER_ID = "youtube_profiles_by-url"
+        SPIDER_NAME = "youtube.com"
+
+        url: str  # Channel URL
         common_settings: CommonSettings = field(default_factory=CommonSettings)
 
     @dataclass
@@ -69,13 +78,77 @@ class YouTube:
         common_settings: CommonSettings = field(default_factory=CommonSettings)
 
     @dataclass
-    class VideoInfo(ToolRequest):
-        """YouTube Video Post Scraper (Metadata only). Standard builder."""
+    class VideoInfo(VideoToolRequest):
+        """YouTube Video Basic Information Scraper. Uses video_builder."""
+
+        SPIDER_ID = "youtube_product_by-id"
+        SPIDER_NAME = "youtube.com"
+
+        video_id: str
+        common_settings: CommonSettings = field(default_factory=CommonSettings)
+
+    @dataclass
+    class VideoPostByUrl(ToolRequest):
+        """YouTube Video Post Scraper by URL. Uses standard builder."""
 
-        # Note: This one does NOT inherit from VideoToolRequest because it uses the standard builder
-        # and doesn't support common_settings in the same way.
         SPIDER_ID = "youtube_video-post_by-url"
         SPIDER_NAME = "youtube.com"
 
         url: str  # Channel Video URL
+        order_by: str | None = None
+        start_index: str | None = None
         num_of_posts: str | None = None
+
+    @dataclass
+    class VideoPostBySearchFilters(ToolRequest):
+        """YouTube Video Post Scraper by Search Filters. Uses standard builder."""
+
+        SPIDER_ID = "youtube_video-post_by-search-filters"
+        SPIDER_NAME = "youtube.com"
+
+        keyword_search: str
+        features: str | None = None
+        type: str | None = None  # Videos
+        duration: str | None = None
+        upload_date: str | None = None
+        num_of_posts: str | None = None
+
+    @dataclass
+    class VideoPostByHashtag(ToolRequest):
+        """YouTube Video Post Scraper by Hashtag. Uses standard builder."""
+
+        SPIDER_ID = "youtube_video-post_by-hashtag"
+        SPIDER_NAME = "youtube.com"
+
+        hashtag: str
+        num_of_posts: str | None = None
+
+    @dataclass
+    class VideoPostByPodcastUrl(ToolRequest):
+        """YouTube Video Post Scraper by Podcast URL. Uses standard builder."""
+
+        SPIDER_ID = "youtube_video-post_by-podcast-url"
+        SPIDER_NAME = "youtube.com"
+
+        url: str  # Playlist URL
+        num_of_posts: str | None = None
+
+    @dataclass
+    class VideoPostByKeyword(ToolRequest):
+        """YouTube Video Post Scraper by Keyword. Uses standard builder."""
+
+        SPIDER_ID = "youtube_video-post_by-keyword"
+        SPIDER_NAME = "youtube.com"
+
+        keyword: str
+        num_of_posts: str | None = None
+
+    @dataclass
+    class VideoPostByExplore(ToolRequest):
+        """YouTube Video Post Scraper by Explore URL. Uses standard builder."""
+
+        SPIDER_ID = "youtube_video-post_by-explore"
+        SPIDER_NAME = "youtube.com"
+
+        url: str
+        all_tabs: str | None = None

thordata/types/task.py

@@ -54,16 +54,22 @@ class ScraperTaskConfig(ThordataBaseConfig):
     file_name: str
     spider_id: str
     spider_name: str
-    parameters: dict[str, Any]
+    parameters: dict[str, Any] | list[dict[str, Any]]
     universal_params: dict[str, Any] | None = None
     include_errors: bool = True
 
     def to_payload(self) -> dict[str, Any]:
+        # Handle batch parameters: if list, use as is; if dict, wrap in list
+        if isinstance(self.parameters, list):
+            params_json = json.dumps(self.parameters)
+        else:
+            params_json = json.dumps([self.parameters])
+
         payload: dict[str, Any] = {
             "file_name": self.file_name,
             "spider_id": self.spider_id,
             "spider_name": self.spider_name,
-            "spider_parameters": json.dumps([self.parameters]),
+            "spider_parameters": params_json,
             "spider_errors": "true" if self.include_errors else "false",
         }
         if self.universal_params:
@@ -76,16 +82,22 @@ class VideoTaskConfig(ThordataBaseConfig):
     file_name: str
     spider_id: str
     spider_name: str
-    parameters: dict[str, Any]
+    parameters: dict[str, Any] | list[dict[str, Any]]
     common_settings: CommonSettings
     include_errors: bool = True
 
     def to_payload(self) -> dict[str, Any]:
+        # Handle batch parameters
+        if isinstance(self.parameters, list):
+            params_json = json.dumps(self.parameters)
+        else:
+            params_json = json.dumps([self.parameters])
+
         payload: dict[str, Any] = {
             "file_name": self.file_name,
             "spider_id": self.spider_id,
             "spider_name": self.spider_name,
-            "spider_parameters": json.dumps([self.parameters]),
+            "spider_parameters": params_json,
             "spider_errors": "true" if self.include_errors else "false",
             # v2.0 Doc explicitly requires 'spider_universal' key for video tasks too sometimes,
             # but usually it's passed as 'common_settings' or 'spider_universal'.

{thordata_sdk-1.5.0.dist-info → thordata_sdk-1.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: thordata-sdk
-Version: 1.5.0
+Version: 1.6.0
 Summary: The Official Python SDK for Thordata - AI Data Infrastructure & Proxy Network.
 Author-email: Thordata Developer Team <support@thordata.com>
 License: MIT
@@ -63,9 +63,9 @@ Dynamic: license-file
 
 ## 📖 Introduction
 
-The **Thordata Python SDK v1.5.0** is a production-ready wrapper for Thordata's AI data infrastructure. It is architected for high reliability, strict type safety, and maximum performance.
+The **Thordata Python SDK v1.6.0** is a production-ready wrapper for Thordata's AI data infrastructure. It is architected for high reliability, strict type safety, and maximum performance.
 
-**Why v1.5.0?**
+**Why v1.6.0?**
 *   **🛡️ Bulletproof Networking**: Custom core handles `HTTP`, `HTTPS`, and `SOCKS5h` (Remote DNS) tunneling, solving common SSL/TLS handshake issues in complex network environments.
 *   **⚡ Async First**: First-class `asyncio` support with `aiohttp` for high-concurrency scraping (1000+ RPS).
 *   **🧩 100% API Coverage**: Every endpoint documented by Thordata (including Hourly Usage, Server Monitor, and Task Management) is implemented.
@@ -83,7 +83,7 @@ pip install thordata-sdk
 
 ## 🔐 Configuration
 
-Set environment variables to avoid hardcoding credentials.
+Set environment variables to avoid hardcoding credentials. **Full reference:** copy [.env.example](.env.example) to `.env` and fill in values.
 
 ```bash
 # [Scraping APIs]
@@ -93,13 +93,19 @@ export THORDATA_SCRAPER_TOKEN="your_scraper_token"
 export THORDATA_PUBLIC_TOKEN="your_public_token"
 export THORDATA_PUBLIC_KEY="your_public_key"
 
-# [Proxy Network]
+# [Proxy: Residential / Unlimited / Datacenter / Mobile / ISP]
 export THORDATA_RESIDENTIAL_USERNAME="your_username"
 export THORDATA_RESIDENTIAL_PASSWORD="your_password"
-# Optional: Set upstream proxy for local dev (e.g., Clash)
-# export THORDATA_UPSTREAM_PROXY="http://127.0.0.1:7890"
+# Optional: Unlimited (high-bandwidth) if your plan has separate credentials
+# export THORDATA_UNLIMITED_USERNAME="..."
+# export THORDATA_UNLIMITED_PASSWORD="..."
+
+# Optional: Upstream proxy when behind firewall (e.g. Clash Verge port 7897)
+# export THORDATA_UPSTREAM_PROXY="http://127.0.0.1:7897"
 ```
 
+Default proxy port is **9999** (residential); other products use different ports (see `.env.example`).
+
 ---
 
 ## 🚀 Quick Start
@@ -199,6 +205,48 @@ if status == "finished":
     print(f"Download: {data_url}")
 ```
 
+### Web Scraper Tools (120+ Pre-built Tools)
+
+Use pre-built tools for popular platforms. See [Tool Coverage Matrix](docs/TOOL_COVERAGE_MATRIX.md) for full list.
+
+```python
+from thordata import ThordataClient
+from thordata.tools import Amazon, GoogleMaps, YouTube, TikTok, eBay, Walmart
+
+client = ThordataClient()
+
+# Amazon Product by ASIN
+task_id = client.run_tool(Amazon.ProductByAsin(asin="B0BZYCJK89"))
+
+# Google Maps by Place ID
+task_id = client.run_tool(GoogleMaps.DetailsByPlaceId(place_id="ChIJPTacEpBQwokRKwIlDXelxkA"))
+
+# YouTube Video Download
+from thordata import CommonSettings
+settings = CommonSettings(resolution="<=360p", video_codec="vp9")
+task_id = client.run_tool(YouTube.VideoDownload(
+    url="https://www.youtube.com/watch?v=jNQXAC9IVRw",
+    common_settings=settings
+))
+
+# Wait and get results
+status = client.wait_for_task(task_id, max_wait=300)
+if status == "ready":
+    download_url = client.get_task_result(task_id)
+    print(f"Results: {download_url}")
+```
+
+**Available Platforms:**
+- **E-Commerce**: Amazon, eBay, Walmart
+- **Social Media**: TikTok, Instagram, Facebook, Twitter/X, Reddit, LinkedIn
+- **Search**: Google Maps, Google Shopping, Google Play
+- **Video**: YouTube (download, info, subtitles)
+- **Code**: GitHub
+- **Professional**: Indeed, Glassdoor, Crunchbase
+- **Travel/Real Estate**: Booking, Airbnb, Zillow
+
+See `examples/tools/` for more examples.
+
 ---
 
 ## 🛠️ Management APIs
@@ -226,6 +274,14 @@ monitor = client.unlimited.get_server_monitor(
 
 ---
 
+## 🧪 Development & Testing
+
+- **Full env reference**: Copy [.env.example](.env.example) to `.env` and fill in credentials.
+- **Unit tests** (no network): `pytest` or `python -m coverage run -m pytest -p no:cov tests && python -m coverage report -m`
+- **Integration tests** (live API/proxy): Set `THORDATA_INTEGRATION=true` in `.env`; optional `THORDATA_UPSTREAM_PROXY` (e.g. Clash) if behind a firewall. See [CONTRIBUTING.md](CONTRIBUTING.md#-testing-guidelines).
+
+---
+
 ## 📄 License
 
 MIT License. See [LICENSE](LICENSE) for details.

thordata_sdk-1.6.0.dist-info/RECORD

@@ -0,0 +1,35 @@
+thordata/__init__.py,sha256=FMOku6d17GrFjiJlRhvkx-JmhLLD7VlaADLC3FP6hHg,2287
+thordata/_utils.py,sha256=Acr_6sHgdZXU7SQozd6FEYTZV6iHw__nlhpBTDwb66U,4917
+thordata/async_client.py,sha256=F_t5EeYUM8BYM9tOQb2lzrcO81whGfO1g53Qagxcyq8,39713
+thordata/async_unlimited.py,sha256=kzTksFkN21rDM21Pwy3hcayjfyGYNGGyGR3fRLtZC6I,4510
+thordata/client.py,sha256=fG7X9JpFS0HKlWZl_6R_Phzt_o2hV25rVUUyCXhioYM,56991
+thordata/enums.py,sha256=dO5QWpPFLpYP2GfLAdoFtxMTemhGNdr_NPqBoYfSFkk,764
+thordata/exceptions.py,sha256=foAtH5U2pLUXM6u1C_63AVVh4-afuwt5y5MO7jDF0s8,11585
+thordata/models.py,sha256=7GshQklo5aqke_ZQ2QIXiz9Ac5v6IRtvjWIjsBKEq6A,853
+thordata/retry.py,sha256=X6Sa5IIb5EWD5fUJjKyhvWJyWQGPVgxLB3-vKoWfa5Q,11453
+thordata/serp_engines.py,sha256=iuMWncelcGOskCHXFzpcPMMTL5qfiLkazHB1uj3zpZo,5985
+thordata/unlimited.py,sha256=RzrtwcotYlbOWuSLysDyI75IkMVL7ygdfE9HKNoe02M,6087
+thordata/core/__init__.py,sha256=EFT6mZpSdec_7uFUpSpDDHVwbTxy314uxJC_uprR6J4,500
+thordata/core/async_http_client.py,sha256=KKsmhXN6bWRTDFvqa0H-WRf4R-TWH8WSgpDBRv6TEvg,3052
+thordata/core/http_client.py,sha256=8lSwclmVweM-Go1qMW36zYnMKAUT_9RyDdPF7qMS4-Y,2280
+thordata/core/tunnel.py,sha256=rbM_4zGwY4FXqdxYmCOURQw2s1EuAWFBVBM-1joNjGI,8373
+thordata/tools/__init__.py,sha256=_Sr042bW-OMMj-WruA93YeQ6FfeIXvWmHoHMAFQ72a8,840
+thordata/tools/base.py,sha256=fHuCp53y8eB59DuCdA1wHcbMVmsd5ikL9KlT5m_jJn0,1006
+thordata/tools/code.py,sha256=fGuLEn_CydIq79XgMw5-EJDcp-nq2fenWVp7hKpsRNw,930
+thordata/tools/ecommerce.py,sha256=8iZ7f46CYovPDfAS3lZhRXpXEyJ9PSFBw9w99-Zw8Qs,6584
+thordata/tools/professional.py,sha256=2RJ76Sx1seftFpwgD4VRfRinoo-HAqYZucTnuIdV4Kw,4350
+thordata/tools/search.py,sha256=2HLQaYK6JiGvzOFF9or9ORXNrzv6nDQUaEt83YbqiQA,2903
+thordata/tools/social.py,sha256=6gcj1GUWJvDALpBMeobohIn6yPVo-LsqDsuUroNpHG8,10465
+thordata/tools/travel.py,sha256=vRJAU-uzFVvLQ5Tc58vp3CY7OPWd2lcWh_9MvWMc1fs,2725
+thordata/tools/video.py,sha256=HUFqdue-dtWmTVlYtmf5ffzuYDIzw5l3wk3Vr7AXQW0,4689
+thordata/types/__init__.py,sha256=hlLt5UCVm7QdeOCN5_YWXS4Vy8tJUhIp0XbWjAoQiQg,1357
+thordata/types/common.py,sha256=hkTZ1QtokpE1yT9BvTmYfQz9AUjeCIIPvjib2pnq_Ag,2818
+thordata/types/proxy.py,sha256=IU45wQHCBOIlbdcCN9veypAkDT0q9NIikLu674CudOU,10438
+thordata/types/serp.py,sha256=NO52I1NprjVBgKQe4o2xEp82a3Oy9wCBYG-2Q0oegnU,5817
+thordata/types/task.py,sha256=b9TzcFigWUJDsr2t1hvaDv_CU1xk2d2cMrthmwPn7VU,4602
+thordata/types/universal.py,sha256=Kw8lf_2ElXIfylsNfVosLE1MvlEQkryv4fWEaQw6ecg,2161
+thordata_sdk-1.6.0.dist-info/licenses/LICENSE,sha256=bAxpWgQIzb-5jl3nhLdOwOJ_vlbHLtSG7yev2B7vioY,1088
+thordata_sdk-1.6.0.dist-info/METADATA,sha256=bBy6xzDLWZ9l5bGLu0Jh91X9GtYVjlKCtpp13OZchmU,9308
+thordata_sdk-1.6.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+thordata_sdk-1.6.0.dist-info/top_level.txt,sha256=Z8R_07m0lXCCSb1hapL9_nxMtyO3rf_9wOvq4n9u2Hg,9
+thordata_sdk-1.6.0.dist-info/RECORD,,

{thordata_sdk-1.5.0.dist-info → thordata_sdk-1.6.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.10.1)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

thordata/_example_utils.py

@@ -1,77 +0,0 @@
-from __future__ import annotations
-
-import json
-import os
-from collections.abc import Iterable
-from pathlib import Path
-from typing import Any
-
-try:
-    from dotenv import load_dotenv
-except Exception:  # pragma: no cover
-    load_dotenv = None
-
-
-def load_env() -> None:
-    """Load .env from repo root if python-dotenv is installed."""
-    if load_dotenv is None:
-        return
-    repo_root = Path(__file__).resolve().parents[2]
-    load_dotenv(dotenv_path=repo_root / ".env")
-
-
-def env(name: str) -> str:
-    return (os.getenv(name) or "").strip()
-
-
-def skip_if_missing(required: Iterable[str], *, tip: str | None = None) -> bool:
-    missing = [k for k in required if not env(k)]
-    if not missing:
-        return False
-    print("Skipping live example: missing env:", ", ".join(missing))
-    if tip:
-        print(tip)
-    else:
-        print("Tip: copy .env.example to .env and fill values, then re-run.")
-    return True
-
-
-def parse_json_env(name: str, default: str = "{}") -> Any:
-    raw = env(name) or default
-    return json.loads(raw)
-
-
-def normalize_task_parameters(raw: Any) -> dict[str, Any]:
-    """Accept {..} or [{..}] and return a single dict for create_scraper_task(parameters=...)."""
-    if isinstance(raw, list):
-        if not raw:
-            raise ValueError("Task parameters JSON array must not be empty")
-        raw = raw[0]
-    if not isinstance(raw, dict):
-        raise ValueError("Task parameters must be a JSON object (or array of objects)")
-    return raw
-
-
-def output_dir() -> Path:
-    """Return output dir for examples; defaults to examples/output (ignored by git)."""
-    repo_root = Path(__file__).resolve().parents[2]
-    d = env("THORDATA_OUTPUT_DIR") or str(repo_root / "examples" / "output")
-    p = Path(d)
-    p.mkdir(parents=True, exist_ok=True)
-    return p
-
-
-def write_text(filename: str, content: str) -> Path:
-    p = output_dir() / filename
-    p.write_text(content, encoding="utf-8", errors="replace")
-    return p
-
-
-def write_json(filename: str, data: Any) -> Path:
-    p = output_dir() / filename
-    p.write_text(
-        json.dumps(data, ensure_ascii=False, indent=2),
-        encoding="utf-8",
-        errors="replace",
-    )
-    return p

thordata/demo.py

@@ -1,138 +0,0 @@
-"""
-Unified demo entrypoint for the Thordata Python SDK.
-
-This module runs the example scripts from the repository's `examples/` directory
-using `runpy`, so it does not require `examples/` to be an importable package.
-
-Usage:
-    python -m thordata.demo serp
-    python -m thordata.demo universal
-    python -m thordata.demo scraper
-    python -m thordata.demo concurrency
-
-Notes:
-- This entrypoint is primarily intended for repository usage (dev/demo).
-- When installed from PyPI, the `examples/` directory is typically not included.
-"""
-
-from __future__ import annotations
-
-import runpy
-import sys
-from pathlib import Path
-
-
-def _configure_stdio() -> None:
-    # Avoid UnicodeEncodeError on Windows consoles with legacy encodings.
-    if hasattr(sys.stdout, "reconfigure"):
-        sys.stdout.reconfigure(encoding="utf-8", errors="replace")  # type: ignore[attr-defined]
-    if hasattr(sys.stderr, "reconfigure"):
-        sys.stderr.reconfigure(encoding="utf-8", errors="replace")  # type: ignore[attr-defined]
-
-
-def _load_env() -> None:
-    # Optional .env support for local development
-    try:
-        from dotenv import load_dotenv
-    except ImportError:
-        return
-    load_dotenv()
-
-
-def _repo_root() -> Path:
-    """
-    Resolve repository root based on src layout:
-    <repo>/src/thordata/demo.py -> parents[2] == <repo>
-    """
-    return Path(__file__).resolve().parents[2]
-
-
-def _examples_dir() -> Path:
-    return _repo_root() / "examples"
-
-
-def _demo_map() -> dict[str, Path]:
-    ex = _examples_dir()
-    return {
-        "serp": ex / "demo_serp_api.py",
-        "universal": ex / "demo_universal.py",
-        "scraper": ex / "demo_web_scraper_api.py",
-        "concurrency": ex / "async_high_concurrency.py",
-    }
-
-
-def _usage() -> str:
-    names = ", ".join(sorted(_demo_map().keys()))
-    return f"Usage: python -m thordata.demo [{names}]"
-
-
-def _run_demo(path: Path) -> int:
-    if not path.exists():
-        print(f"Error: demo script not found: {path}")
-        return 2
-
-    # Ensure examples dir is on sys.path (helpful if demo imports local helpers).
-    examples_dir = str(path.parent.resolve())
-    if examples_dir not in sys.path:
-        sys.path.insert(0, examples_dir)
-
-    try:
-        # Load without triggering `if __name__ == "__main__": ...`
-        ns = runpy.run_path(str(path), run_name="__thordata_demo__")
-
-        main_func = ns.get("main")
-        if callable(main_func):
-            return int(main_func())  # type: ignore[arg-type]
-
-        # Fallback: run as __main__ for scripts without main()
-        runpy.run_path(str(path), run_name="__main__")
-        return 0
-
-    except KeyboardInterrupt:
-        raise
-    except SystemExit as e:
-        # In case fallback run as __main__ triggered SystemExit
-        code = e.code
-        if code is None:
-            return 0
-        if isinstance(code, int):
-            return code
-        return 1
-    except Exception as e:
-        import traceback
-
-        print()
-        print("-" * 60)
-        print("[thordata.demo] The demo script raised an exception.")
-        print(f"[thordata.demo] Script: {path.name}")
-        print(f"[thordata.demo] Error:  {type(e).__name__}: {e}")
-        print()
-        print("Note: This is a failure within the demo script itself,")
-        print("      not an issue with the thordata.demo entrypoint.")
-        print("-" * 60)
-        traceback.print_exc()
-        return 1
-
-
-def main() -> int:
-    _configure_stdio()
-    _load_env()
-
-    if len(sys.argv) < 2:
-        print(_usage())
-        return 2
-
-    name = sys.argv[1].strip().lower()
-    mapping = _demo_map()
-
-    path = mapping.get(name)
-    if path is None:
-        print(f"Unknown demo: {name}")
-        print(_usage())
-        return 2
-
-    return _run_demo(path)
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())

thordata_sdk-1.5.0.dist-info/RECORD

@@ -1,35 +0,0 @@
-thordata/__init__.py,sha256=-2bXx3LckBWrJ_E5HqFTOj7sm45AgrOnSWV4QN6f-7U,2287
-thordata/_example_utils.py,sha256=T9QtVq9BHhubOShgtGp2GSusYYd-ZFUJFJAw7ubIsa4,2199
-thordata/_utils.py,sha256=Acr_6sHgdZXU7SQozd6FEYTZV6iHw__nlhpBTDwb66U,4917
-thordata/async_client.py,sha256=zN59ZQfFVCuAGnGcyj-C_S9MbHzb17QbUISm46n6gpY,39439
-thordata/async_unlimited.py,sha256=kzTksFkN21rDM21Pwy3hcayjfyGYNGGyGR3fRLtZC6I,4510
-thordata/client.py,sha256=eA6jav_aAw2CQdSyrg3P59rELKo13K5tHqmSjEw3L_8,56717
-thordata/demo.py,sha256=DojJRFqUm9XAMBkjmk03WGeiUdLCbXguMIwtMOzfN6M,3822
-thordata/enums.py,sha256=_pahGhcq9Eh2ptL_WiNU2WlqKrydV_6e4U9G4erV9-s,774
-thordata/exceptions.py,sha256=P9czrxkFhT439DxW3LE5W-koS595ObH4-mAQOfaDM18,9976
-thordata/models.py,sha256=wozvlpS-Uv1DgkM_CEKOvldQ2InicxhIN0QiezIXPE4,853
-thordata/retry.py,sha256=5kRwULl3X68Nx8PlSzr9benfyCL0nRSpVQXrwjWr45M,11456
-thordata/serp_engines.py,sha256=iuMWncelcGOskCHXFzpcPMMTL5qfiLkazHB1uj3zpZo,5985
-thordata/unlimited.py,sha256=RzrtwcotYlbOWuSLysDyI75IkMVL7ygdfE9HKNoe02M,6087
-thordata/core/__init__.py,sha256=EFT6mZpSdec_7uFUpSpDDHVwbTxy314uxJC_uprR6J4,500
-thordata/core/async_http_client.py,sha256=KKsmhXN6bWRTDFvqa0H-WRf4R-TWH8WSgpDBRv6TEvg,3052
-thordata/core/http_client.py,sha256=8lSwclmVweM-Go1qMW36zYnMKAUT_9RyDdPF7qMS4-Y,2280
-thordata/core/tunnel.py,sha256=rbM_4zGwY4FXqdxYmCOURQw2s1EuAWFBVBM-1joNjGI,8373
-thordata/tools/__init__.py,sha256=ROryBBlCfq9cydaKXEPtnevjhg6GdFioAjdnp2VTR0M,606
-thordata/tools/base.py,sha256=fHuCp53y8eB59DuCdA1wHcbMVmsd5ikL9KlT5m_jJn0,1006
-thordata/tools/code.py,sha256=opYMG7LdR90VjW5tn8wnRCwDT-zUC0uteMKW01TMPTI,580
-thordata/tools/ecommerce.py,sha256=u-s-RGMSAGifsMnyMrwtJ3yVDgu3n74bv8yyX6TbMNU,1560
-thordata/tools/search.py,sha256=toWMOnnfQXgafyndHs23Yn049vpPlGPHdZA7SpiJJTE,1724
-thordata/tools/social.py,sha256=VbujfbA5Man6Shsik4QYBpf9z2FJhhJkZLNKll09Ots,4886
-thordata/tools/video.py,sha256=WikUOYPSVtHdrS0Z7VVexlUPyFZRv9v7cerkpzzO5jU,2549
-thordata/types/__init__.py,sha256=hlLt5UCVm7QdeOCN5_YWXS4Vy8tJUhIp0XbWjAoQiQg,1357
-thordata/types/common.py,sha256=hkTZ1QtokpE1yT9BvTmYfQz9AUjeCIIPvjib2pnq_Ag,2818
-thordata/types/proxy.py,sha256=IU45wQHCBOIlbdcCN9veypAkDT0q9NIikLu674CudOU,10438
-thordata/types/serp.py,sha256=NO52I1NprjVBgKQe4o2xEp82a3Oy9wCBYG-2Q0oegnU,5817
-thordata/types/task.py,sha256=f5xGeH4BrE7sHIgWhRJuMr3iuPooxJlg7ztr8lwcSx8,4139
-thordata/types/universal.py,sha256=Kw8lf_2ElXIfylsNfVosLE1MvlEQkryv4fWEaQw6ecg,2161
-thordata_sdk-1.5.0.dist-info/licenses/LICENSE,sha256=bAxpWgQIzb-5jl3nhLdOwOJ_vlbHLtSG7yev2B7vioY,1088
-thordata_sdk-1.5.0.dist-info/METADATA,sha256=VqsfaJsguO-KSMOjWjPodO1nIa510qpjNBdVzCMHshQ,7026
-thordata_sdk-1.5.0.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
-thordata_sdk-1.5.0.dist-info/top_level.txt,sha256=Z8R_07m0lXCCSb1hapL9_nxMtyO3rf_9wOvq4n9u2Hg,9
-thordata_sdk-1.5.0.dist-info/RECORD,,