taygedo 0.2.3

Unofficial async Python client & CLI for bbs-api.tajiduo.com (异环 / 幻塔 BBS)

taygedo — an unofficial Python client & CLI for the bbs-api.tajiduo.com platform.
Query game data, manage your account, and automate monthly sign-ins for Tower of Fantasy and 异环.

---

✨ Features

• 🔐 Account auth — login, session management, and credential storage
• 🗂️ CLI config — TOML-based configuration via taygedo conf
• 🗼 Tower of Fantasy — fetch in-game data (tof / ht commands, gameId=1256)
• 🌀 异环 (NTE) — fetch game data and automate monthly sign-ins (nte / yh commands, gameId=1289)
• 🔍 Debug mode — print every HTTP request/response to stderr with --debug
• 🧩 Typed SDK — py.typed marker included; fully type-checked with mypy strict mode
• ⚡ Async-ready — built on curl-cffi for high-performance HTTP

---

🚀 Getting Started

Prerequisites

• Python 3.13+
• uv (recommended) or pip

Installation

With uv (recommended):

uv tool install taygedo

With pip:

pip install taygedo

Quick Usage

# Show help
taygedo --help

# Log in to your account
taygedo auth login

# Fetch Tower of Fantasy data
taygedo tof <subcommand>

# Fetch 异环 data and trigger monthly sign-in
taygedo nte sign-in

# Enable debug output
taygedo --debug tof <subcommand>

CLI Reference

Usage: taygedo [OPTIONS] COMMAND [ARGS]...

  taygedo — bbs-api.tajiduo.com client.

Options:
  --version  Show the version and exit.
  --debug    Print every HTTP request/response to stderr.
  --help     Show this message and exit.

Commands:
  auth  Account login and management.
  conf  CLI configuration (config.toml).
  ht    Tower of Fantasy (gameId=1256) data.
  nte   异环 (gameId=1289) data + monthly sign-in.
  tof   Tower of Fantasy (gameId=1256) data.
  yh    异环 (gameId=1289) data + monthly sign-in.

---

🛠️ Development

Setup

git clone https://github.com/1shin-7/taygedo.py.git
cd taygedo.py

# Install dependencies (including dev extras)
uv sync

Running Tests

uv run pytest

Linting & Type Checking

# Lint with ruff
uv run ruff check .

# Format
uv run ruff format .

# Type-check with mypy
uv run mypy src/

Project Structure

taygedo.py/
├── src/
│   └── taygedo/
│       ├── cli/          # Click-based CLI commands
│       ├── client.py     # HTTP client (curl-cffi)
│       ├── core/         # Core logic
│       ├── crypto/       # Signing / cryptography helpers
│       ├── device/       # Device fingerprint generation
│       ├── models/       # Pydantic response models
│       ├── services/     # Game-specific service modules
│       ├── signers/      # Request signers
│       └── utils/        # Shared utilities
├── tests/
├── scripts/
└── pyproject.toml