emq-cli 0.2.1

EMQ CLI with vendored EmQuantAPI integration.

emq-cli

emq is a domain-oriented command line tool for EmQuantAPI with vendored runtime libraries.

Requirements

• Python 3.11+
• uv

Quick Start

uv sync --dev
uv run emq --help

Login once (credentials from flags or env):

export EMQ_USER='your_user'
export EMQ_PASS='your_pass'
uv run emq auth login

Sample market query:

uv run emq market series 000001.SZ CLOSE --start 2025-01-01 --end 2025-12-31 --output table

Quick portfolio order:

uv run emq portfolio qorder --code MYPORT --stock 300059.SZ --volume 1000 --price 10.5 --date 2025-01-15

Command Domains

• auth: login, logout, status
• market: snapshot, series
• portfolio: create, list, order, qorder
• quota: usage
• raw: css, csd, pquery, porder

Output

Every command uses a unified envelope and supports:

• --output json (default)
• --output table (ASCII)
• --output csv

--output can be placed either before the domain command (global) or at the end of leaf commands (override).
If both are provided, the leaf command --output takes precedence.

Credential Persistence

• auth login saves credentials to ~/.emq/state.json (plain text, initial version).
• Business commands auto-login from saved state or environment variables.
• auth logout clears local state and calls SDK logout.

Development

uv run ruff check .
uv run mypy src
uv run pytest

Notes

• The vendored SDK lives in src/emq/vendor/emquantapi/python3.
• Root EMQuantAPI_Python should not be kept after migration.