yoghurt 0.1.1__tar.gz

yoghurt-0.1.1/.gitignore

@@ -0,0 +1,31 @@
+# Byte-compiled / optimized files
+__pycache__/
+
+# Test and coverage output
+.pytest_cache/
+.coverage
+coverage.xml
+junit*.xml
+htmlcov/
+
+# Virtual environments and uv cache
+.venv/
+.uv-cache/
+
+# Tool caches
+.ruff_cache/
+.tox/
+.mypy_cache/
+node_modules/
+
+# Editors
+.vscode/
+
+# Local session/cache material
+yahoo-session.json
+.playwright-cli
+.playwright-mcp
+docs/MISSING_ENDPOINTS.md
+docs/plans/
+.worktrees/
+output/

yoghurt-0.1.1/AGENTS.md

@@ -0,0 +1,75 @@
+# AGENTS.md
+
+## Project
+Yoghurt exposes Yahoo Finance HTTP endpoints as an LLM-friendly CLI that prints the raw JSON Yahoo returns.
+
+## Stack
+Python 3.10+, uv, httpx, argparse, pytest, pytest-httpx, ruff, pyright, tox, hatchling.
+
+## Commands
+- Install/sync: `uv sync --all-groups`
+- Run CLI: `uv run yoghurt --help`
+- Test single: `uv run pytest path/to/test_file.py`
+- Test all: `uv run pytest`
+- Lint: `uv run ruff check .`
+- Format: `uv run ruff format .`
+- Type check: `uv run pyright`
+- Spell check: `npm run spell` or `make spell`
+- Spell changed files: `npm run spell:changed` or `make spell-changed`
+- Full check: `uv run tox`
+
+## Architecture
+- `src/yoghurt/client.py` -> Yahoo HTTP session, cookies, crumbs, retries, raw response retrieval.
+- `src/yoghurt/session_cache.py` -> persisted Yahoo cookie/crumb cache for one-shot CLI reuse.
+- `src/yoghurt/commands.py` -> command metadata used to build CLI commands, validation, and help.
+- `src/yoghurt/params.py` -> CLI parameter coercion and validation helpers.
+- `src/yoghurt/cli.py` -> argparse command tree and stdout/stderr behavior.
+- `tests/` -> pytest tests mirroring `src/yoghurt/`.
+
+## Rules
+- IMPORTANT: `--help` is the primary product surface; keep it complete, adaptive, and generated from command metadata where practical.
+- Do not add `describe`, `endpoints`, `params`, or other discovery commands; discovery belongs under `yoghurt --help` and `yoghurt <endpoint> --help`.
+- Print Yahoo response bodies to stdout exactly as returned; do not model, reshape, pretty-print, or interpret endpoint JSON.
+- Keep Yahoo endpoint knowledge in metadata and validation only; do not create response classes.
+- Use `uv run python` for Python scripts; never use bare `python` or `python3`.
+- Never log or print Yahoo cookies, crumbs, or full session-cache contents.
+- Keep runtime dependencies narrow; do not add TUI, ORM, web framework, or rich formatting libraries.
+
+## Help text
+When adding or editing a CLI command:
+1. **Summary**: active verb, ≤68 chars (over wraps two-line in top-level help). `Fetch` (data), `List` (catalog), `Run` (saved query), `Query` (DSL), `Show` (symbol-free), `Discover` (curated). Pair sibling commands with the same verb.
+2. **Description**: describe response content, not yoghurt mechanics. Forbidden phrasings: `Calls Yahoo`, `writes to stdout`, `response-model mapping`. The root parser already covers output behavior. Do not paraphrase the summary.
+3. **Notes**: real clarifications only — Yahoo quirks (typos, 500s, paywalled empties), switch-behavior surprises, instrument-type dependencies. Drop live-probe diary entries and redundant restatements.
+4. **Order in `COMMANDS` tuple by importance**: daily-driver → discovery → symbol-bound analysis → market-wide state → schema introspection → `raw`. The DSL parsers (`visualization`, `screener`) slot inside the loop after `screener-predefined` in `cli.py`. Never append to the end.
+5. **Param boilerplate is shared** (`--lang`, `--region`, `--formatted` use exact strings — copy them). Run `pytest -k help` before and after. Pinned-string assertions guard things like `INSIDER_TRANSACTION`, `snake_case`, `Module availability depends on instrument type`. Negative guards (`Calls Yahoo`, `Output:`) forbid implementation leak — do not reintroduce.
+
+## Workflow
+- Make minimal changes and avoid unrelated refactors.
+- When adding a command or parameter, update validation, adaptive help, and tests in the same change.
+- Prefer focused unit tests with mocked HTTP; mark live Yahoo tests as integration.
+- Before considering code changes done, run `uv run tox`. It is the expected bundled verification for formatting, lint, type check, tests, and spelling.
+- For command or parameter changes, also run the app against Yahoo after `tox`:
+  - `uv run yoghurt <command> --help`
+  - `uv run yoghurt <command> <minimal required parameters>`
+  - `uv run yoghurt <command> <parameters with each supported date/time format when dates are involved>`
+  - `uv run yoghurt <command> <parameters with meaningful modules, types, field lists, booleans, or other values that could affect Yahoo's raw output>`
+- When a command has open-ended value lists such as `modules`, `types`, or `fields`, test representative variations and an all-known-values request when practical.
+- When a parameter has a default, test both omission and explicit override if the default affects the request sent to Yahoo.
+- Ask before making architectural changes that affect the CLI grammar or session-cache behavior.
+
+## Yahoo API state probes
+- When checking the current quote-page API surface with browser tooling or live Yahoo calls, use a mixed symbol set so endpoint behavior is not inferred from US mega-cap equities only.
+- Baseline probe symbols:
+  - US stocks, high profile and smaller: `AAPL`, `MSFT`, `OKLO`
+  - ETFs: `SPY`, `QQQ`, `VT`
+  - Futures and commodities: `ES=F`, `CL=F`
+  - Forex: `EURUSD=X`
+  - Indices: `^GSPC`, `^DJI`, `^IXIC`
+  - Crypto: `BTC-USD`
+  - Foreign listings: `RY.TO`, `0700.HK`, `7203.T`, `SHEL.L`
+- Add targeted probes when an endpoint is symbol-sensitive, but keep this baseline for broad API-surface discovery and for checking whether an observed endpoint applies across asset classes.
+
+## Out of scope
+- Mapping Yahoo JSON into Python domain models.
+- Separate documentation/discovery subcommands.
+- Secrets, API keys, or checked-in session-cache files.

yoghurt-0.1.1/LICENSE

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

yoghurt-0.1.1/PKG-INFO

@@ -0,0 +1,460 @@
+Metadata-Version: 2.4
+Name: yoghurt
+Version: 0.1.1
+Summary: LLM-friendly CLI for raw Yahoo Finance endpoint JSON.
+Project-URL: Homepage, https://github.com/joce/yoghurt
+Project-URL: Repository, https://github.com/joce/yoghurt
+Project-URL: Issues, https://github.com/joce/yoghurt/issues
+Author-email: Jocelyn Legault <jocelynlegault@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,finance,llm-tools,quotes,screener,stock-market,yahoo-finance
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Utilities
+Requires-Python: <4.0,>=3.10
+Requires-Dist: httpx<1.0,>=0.28
+Requires-Dist: typing-extensions>=4.13; python_version < '3.12'
+Description-Content-Type: text/markdown
+
+# Yoghurt
+
+[![CI](https://github.com/joce/yoghurt/actions/workflows/ci.yml/badge.svg)](https://github.com/joce/yoghurt/actions/workflows/ci.yml)
+[![Coverage](https://codecov.io/gh/joce/yoghurt/graph/badge.svg)](https://codecov.io/gh/joce/yoghurt)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![GitHub License](https://img.shields.io/github/license/joce/yoghurt)](https://github.com/joce/yoghurt/blob/main/LICENSE)
+
+Yahoo!-Originated Graphs, Histories, Updates, Returns & Tickers.
+
+Yoghurt brings Yahoo Finance's HTTP endpoints to the command line. It is built
+for scripts, agents, and quick terminal work that needs the JSON returned by
+Yahoo's finance endpoints.
+
+The project stays deliberately close to the source. It does not reshape Yahoo
+responses, define finance domain models, or add a discovery API beyond CLI
+help.
+
+## Features
+
+- Raw Yahoo Finance JSON on stdout, with no pretty-printing or interpretation.
+- Endpoint-specific commands for common Yahoo Finance data.
+- A SQL-flavored DSL (`screener`, `visualization`) for ad-hoc filters and
+  cross-entity queries against Yahoo's data-platform endpoints.
+- Generated help that includes examples, parameters, field references, modules,
+  or types when Yoghurt knows them.
+- Reusable Yahoo session cache for faster one-shot CLI calls.
+- A `raw` command for Yahoo query paths that do not have dedicated metadata yet.
+
+## Install From Source
+
+Yoghurt is currently intended to run from a local checkout. It is a Python 3.10+
+project managed with [uv](https://docs.astral.sh/uv/).
+
+```powershell
+uv sync --all-groups
+```
+
+Run the CLI from the repository:
+
+```powershell
+uv run yoghurt --help
+```
+
+Or install it as a package from a local checkout:
+
+```powershell
+uv tool install .
+yoghurt --help
+```
+
+## Quick Start
+
+Fetch quotes for a few symbols:
+
+```powershell
+uv run yoghurt quote AAPL,MSFT,NVDA
+```
+
+Request specific quote fields:
+
+```powershell
+uv run yoghurt quote AAPL,MSFT --fields symbol,longName,companyLogoUrl,regularMarketPrice,overnightMarketPrice
+```
+
+See [QUOTE_FIELDS.md](src/yoghurt/docs/QUOTE_FIELDS.md) for the full quote field reference and
+best-effort meanings.
+
+Fetch selected quote summary modules:
+
+```powershell
+uv run yoghurt quote-summary ^GSPC --modules price,summaryDetail,pageViews,financialsTemplate
+```
+
+See [QUOTE_SUMMARY_MODULES.md](src/yoghurt/docs/QUOTE_SUMMARY_MODULES.md) for the researched
+quote-summary module list and descriptions.
+
+Fetch quote-type metadata using Yahoo's path-symbol endpoint:
+
+```powershell
+uv run yoghurt quote-type ^GSPC
+```
+
+Fetch chart data for a recent window:
+
+```powershell
+uv run yoghurt chart AAPL
+```
+
+Fetch quote-page sparkline data:
+
+```powershell
+uv run yoghurt spark AAPL,MSFT
+```
+
+Quote-page probes have observed `1d` and `24h` spark ranges; pass values such
+as `--range 24h` through when Yahoo supports them.
+
+Fetch recommended symbols for a quote page:
+
+```powershell
+uv run yoghurt recommendations-by-symbol AAPL
+```
+
+Fetch Yahoo calendar events:
+
+```powershell
+uv run yoghurt calendar-events AAPL
+uv run yoghurt calendar-events AAPL --modules ipoEvents
+uv run yoghurt calendar-events AAPL --modules secReports
+uv run yoghurt calendar-events AAPL --modules economicEvents --include-all-economic-events
+```
+
+Confirmed `--modules` values for `calendar-events`:
+
+| Module | Returns |
+| --- | --- |
+| `earnings` | Upcoming and recent earnings dates and EPS estimates (default). |
+| `economicEvents` | Macro economic calendar events (CPI, Fed decisions, employment reports, etc.). |
+| `ipoEvents` | Upcoming and recent IPO events. |
+| `secReports` | Recent SEC filing events (10-K, 10-Q, 8-K, etc.). |
+
+Fetch sector data:
+
+```powershell
+uv run yoghurt sector technology
+uv run yoghurt sector financial-services --with-returns
+```
+
+Confirmed sector slugs: `technology`, `financial-services`, `consumer-cyclical`,
+`communication-services`, `healthcare`, `industrials`, `consumer-defensive`,
+`energy`, `basic-materials`, `real-estate`, `utilities`.
+
+Run a predefined Yahoo screener:
+
+```powershell
+uv run yoghurt screener-predefined MOST_ACTIVES
+uv run yoghurt screener-predefined DAY_GAINERS_CRYPTOCURRENCIES
+uv run yoghurt screener-predefined TOP_OPTIONS_OPEN_INTEREST
+```
+
+Confirmed predefined screener IDs:
+
+**Equities — movers and volume**
+`MOST_ACTIVES`, `MOST_ACTIVE_PENNY_STOCKS`, `UNUSUAL_VOLUME_STOCKS`,
+`DAY_GAINERS`, `DAY_LOSERS`, `MOST_SHORTED_STOCKS`
+
+**Equities — size and price**
+`SMALL_CAP_STOCKS`, `LARGE_CAP_STOCKS`, `MOST_EXPENSIVE_STOCKS`,
+`HIGHEST_BETA_STOCKS`, `PINK_SHEET_STOCKS`, `SMALL_CAP_GAINERS`
+
+**Equities — technical signals**
+`RECENT_52_WEEK_HIGHS`, `RECENT_52_WEEK_LOWS`,
+`BULLISH_STOCKS_RIGHT_NOW`, `BEARISH_STOCKS_RIGHT_NOW`
+
+**Equities — analyst and value**
+`ANALYST_STRONG_BUY_STOCKS`, `MORNINGSTAR_FIVE_STAR_STOCKS`,
+`UNDERVALUED_GROWTH_STOCKS`, `UNDERVALUED_LARGE_CAPS`,
+`UNDERVALUED_WIDE_MOAT_STOCKS`, `GROWTH_TECHNOLOGY_STOCKS`,
+`AGGRESSIVE_SMALL_CAPS`, `HIGHEST_DIVIDEND_STOCKS`
+
+**Equities — institutional**
+`MOST_INSTITUTIONALLY_BOUGHT_LARGE_CAP_STOCKS`,
+`MOST_INSTITUTIONALLY_HELD_LARGE_CAP_STOCKS`,
+`TOP_STOCKS_OWNED_BY_CATHIE_WOOD`
+
+**Funds and ETFs**
+`TOP_MUTUAL_FUNDS`, `SOLID_LARGE_GROWTH_FUNDS`, `SOLID_MIDCAP_GROWTH_FUNDS`,
+`CONSERVATIVE_FOREIGN_FUNDS`, `HIGH_YIELD_BOND`, `LARGE_BLEND_ETFS`,
+`TECHNOLOGY_ETFS`, `PORTFOLIO_ANCHORS`
+
+**Crypto**
+`MOST_ACTIVES_CRYPTOCURRENCIES`, `DAY_GAINERS_CRYPTOCURRENCIES`,
+`DAY_LOSERS_CRYPTOCURRENCIES`
+
+**Private companies**
+`52_WEEK_GAINERS_PRIVATE_COMPANY`, `RECENTLY_FUNDED_PRIVATE_COMPANY`
+
+**Options**
+`DAY_GAINERS_OPTIONS`, `DAY_LOSERS_OPTIONS`,
+`TOP_OPTIONS_OPEN_INTEREST`, `TOP_OPTIONS_IMPLIED_VOLATALITY` *(Yahoo typo)*
+
+Fetch an option chain using Yahoo's default expiration:
+
+```powershell
+uv run yoghurt options AAPL
+```
+
+Fetch current market session status and trading hours:
+
+```powershell
+uv run yoghurt market-time
+```
+
+Fetch analyst intelligence for a symbol (put/call ratio, news summary, price
+targets, and ratings):
+
+```powershell
+uv run yoghurt analyst AAPL
+```
+
+Run a custom screener or cross-entity query with the SQL-flavored DSL:
+
+```powershell
+uv run yoghurt screener --query "
+  SELECT ticker, intradaymarketcap, sector, peratio.lasttwelvemonths
+  FROM EQUITY
+  WHERE region = 'us'
+    AND sector = 'Technology'
+    AND intradaymarketcap >= 10e9
+  ORDER BY intradaymarketcap DESC
+  LIMIT 25"
+
+uv run yoghurt visualization --query "
+  SELECT ticker, transactiondate, shares
+  FROM INSIDER_TRANSACTION
+  WHERE ticker = 'AAPL'
+  ORDER BY transactiondate DESC
+  LIMIT 50"
+```
+
+List the fields, types, and operators available for a given asset class or
+entity (e.g. for use in a `screener` or `visualization` query):
+
+```powershell
+uv run yoghurt screener-instrument-fields equity
+uv run yoghurt screener-instrument-fields insider_transaction
+```
+
+See [QUERY_DSL.md](src/yoghurt/docs/QUERY_DSL.md) for the full DSL reference: grammar,
+operators, entity routing, body shape, premium-locked entities, and more
+examples.
+
+Pass through a Yahoo query path directly:
+
+```powershell
+uv run yoghurt raw /v7/finance/quote --param symbols=AAPL,MSFT --param formatted=true
+```
+
+## Commands
+
+Use root help to see the command list:
+
+```powershell
+uv run yoghurt --help
+```
+
+Current commands, grouped roughly by how often they're reached for:
+
+**Daily-driver fetches**
+
+| Command | Yahoo data |
+| --- | --- |
+| `quote` | Fetch quotes for one or more symbols. |
+| `chart` | Fetch historical OHLC chart data for a symbol. |
+| `options` | Fetch the option chain for a symbol. |
+| `quote-summary` | Fetch quoteSummary modules for a symbol. |
+| `quote-type` | Fetch instrument classification metadata for a symbol. |
+| `spark` | Fetch sparkline price series for one or more symbols. |
+
+**Discovery (find symbols, build custom queries)**
+
+| Command | Yahoo data |
+| --- | --- |
+| `screener-predefined` | Run one or more of Yahoo's predefined screeners. |
+| `visualization` | Query any Yahoo data-platform entity via a SQL-flavored DSL. |
+| `screener` | Query any Yahoo asset class via a SQL-flavored DSL. |
+| `screener-discover` | Discover investment ideas from Yahoo screener modules. |
+
+**Symbol-bound analysis**
+
+| Command | Yahoo data |
+| --- | --- |
+| `timeseries` | Fetch fundamentals timeseries for a symbol. |
+| `calendar-events` | Fetch earnings, IPO, economic, and SEC filing events for a symbol. |
+| `analyst` | Fetch analyst intelligence for a symbol. |
+| `ratings-top` | Fetch top analyst rating buckets for a symbol. |
+| `recommendations-by-symbol` | Fetch related-symbol recommendations for a symbol. |
+| `price-insights` | Fetch AI-generated price insights for one or more symbols. |
+| `insights` | Fetch research reports and insights for one or more symbols. |
+
+**Market-wide state**
+
+| Command | Yahoo data |
+| --- | --- |
+| `trending` | List trending tickers for a region. |
+| `sector` | Fetch sector overview, performance, top holdings, and industries. |
+| `market-summary` | Fetch global market summary: indices, futures, forex, crypto. |
+| `market-info` | Fetch commodity and currency market data. |
+| `market-time` | Show current market hours and session status. |
+
+**Schema introspection**
+
+| Command | Yahoo data |
+| --- | --- |
+| `screener-instrument-fields` | List every field available for a Yahoo data-platform entity. |
+| `timeseries-fields` | List available fundamentals timeseries field names for a type. |
+
+**Escape hatch**
+
+| Command | Yahoo data |
+| --- | --- |
+| `raw` | Send raw parameters to any Yahoo query path. |
+
+Each endpoint has its own adaptive help:
+
+```powershell
+uv run yoghurt quote --help
+uv run yoghurt quote-summary --help
+uv run yoghurt calendar-events --help
+uv run yoghurt timeseries --help
+```
+
+Endpoint help is the primary documentation surface. It shows Yahoo's target
+endpoint, accepted parameters, defaults, examples, and common open-ended values
+where available.
+
+### Chart
+
+The `chart` command calls Yahoo's `/v8/finance/chart/{symbol}` endpoint without
+requesting a crumb:
+
+```powershell
+uv run yoghurt chart AAPL
+```
+
+When period arguments are omitted, Yoghurt uses a recent quote-page-shaped
+window: `period1` defaults to three days before execution time, `period2`
+defaults to execution time, `--interval` defaults to `1m`, and `--events`
+defaults to `div,split,earn`. User-provided events are comma-separated; Yoghurt
+packs them for Yahoo internally. Extended-hours data is opt-in with
+`--include-pre-post`.
+
+### Timeseries
+
+The `timeseries` command can also run with only a ticker:
+
+```powershell
+uv run yoghurt timeseries AAPL
+```
+
+Its default type list matches the Yahoo quote/analysis page request for
+earnings-release, analyst-rating, and economic-event timeseries data. When
+period arguments are omitted, Yoghurt uses a recent quote-page-style window:
+`period1` defaults to three days before execution time and `period2` defaults
+to execution time.
+
+See [TIMESERIES_TYPES.md](src/yoghurt/docs/TIMESERIES_TYPES.md) for the observed `--type`
+reference with descriptions.
+
+## Dates and Booleans
+
+Date and datetime parameters accept:
+
+- Unix timestamps, such as `1510876800`.
+- Date-only values, such as `2017-11-17`.
+- ISO datetime values.
+
+Date-only values are converted at UTC midnight before they are sent to Yahoo.
+For endpoints with `period1` and `period2`, documented defaults let ticker-only
+requests run, `period2` defaults to the current Unix timestamp when omitted, and
+Yoghurt rejects windows where `period2` is not greater than `period1`. Supplying
+`period2` without `period1` is also rejected.
+
+Boolean parameters accept common true and false forms such as `true`, `false`,
+`1`, `0`, `yes`, and `no`.
+
+## Session Cache
+
+Most Yahoo endpoints require a cookie and crumb. Yoghurt establishes that session
+state automatically and caches it for reuse across CLI calls.
+
+Useful global options:
+
+```powershell
+uv run yoghurt --refresh-session quote AAPL
+uv run yoghurt --no-session-cache quote AAPL
+uv run yoghurt --session-cache C:\tmp\yoghurt-session.json quote AAPL
+```
+
+Yoghurt never prints cookies, crumbs, or full session-cache contents.
+
+## Output Contract
+
+Yoghurt writes the Yahoo response body to stdout exactly as returned. This makes
+it easy to pipe into tools that expect JSON:
+
+```powershell
+uv run yoghurt quote AAPL | jq .
+```
+
+Diagnostics and errors are written to stderr.
+
+## Development
+
+Install development dependencies:
+
+```powershell
+uv sync --all-groups
+```
+
+Run the test suite:
+
+```powershell
+uv run pytest
+```
+
+Run checks locally:
+
+```powershell
+uv run black --check .
+uv run ruff format --check --diff .
+uv run ruff check .
+uv run pyright
+uv run pytest -n auto
+```
+
+Run the full project check, including Python checks and spelling:
+
+```powershell
+uv run tox
+```
+
+When adding or changing command metadata, update validation, adaptive help, and
+tests together. Then verify the relevant command against Yahoo with its help,
+minimal required parameters, and representative optional parameters.
+
+## License
+
+Yoghurt is released under the MIT License. See [LICENSE](LICENSE).