emq-cli 0.2.1__tar.gz

emq_cli-0.2.1/.gitignore

@@ -0,0 +1,28 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual environments
+.venv/
+venv/
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+
+# Tool caches
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.coverage
+coverage.xml
+
+# OS / editor
+.DS_Store
+.idea/
+.vscode/
+
+# EmQuant API local login artifact
+src/emq/vendor/emquantapi/python3/libs/mac/logininfo.log

emq_cli-0.2.1/ARCHITECHTURE.md

@@ -0,0 +1,47 @@
+# EMQ CLI Architecture Map
+
+## Overview
+
+The CLI is structured by business domains and a shared core layer:
+
+- `src/emq/cli.py`: root command and global options.
+- `src/emq/commands/*`: domain command handlers (`auth`, `market`, `portfolio`, `quota`, `raw`).
+- `src/emq/core/*`: common runtime services.
+- `src/emq/vendor/emquantapi/python3`: vendored EmQuant SDK and native libraries.
+
+## Core Modules
+
+- `config.py`: constants, env names, vendor paths.
+- `emquant_loader.py`: dynamic import + native library path patching.
+- `session.py`: login lifecycle and auto-login.
+- `state.py`: local credential state persistence.
+- `normalize.py`: convert `EmQuantData` into row-based data.
+- `output.py`: envelope creation + `json/table/csv` rendering.
+- `errors.py`: domain exceptions and exit codes.
+- `logging.py`: CLI logging initialization.
+
+## Command Flow
+
+1. Root callback parses global options (`--output`, logging, auto-login).
+2. Domain command validates inputs and invokes core session.
+3. Loader returns EmQuant client from vendored SDK.
+4. SDK result is normalized into row records.
+5. Output layer renders the unified envelope in selected format.
+
+## Session Model
+
+1. `auth login` logs in and stores credentials in `~/.emq/state.json`.
+2. Business commands call `ensure_login()` to auto-login if needed.
+3. `auth logout` calls `stop()` and clears local state.
+4. `auth status` supports local-only and remote probe modes.
+
+## Data and Error Model
+
+All commands emit:
+
+- `success`: boolean
+- `error`: `{code,message,source}` or `null`
+- `meta`: command metadata + row count
+- `data`: row records
+
+Errors from SDK (`ErrorCode != 0`) are mapped to `source=emquant`.

emq_cli-0.2.1/LICENSE

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

emq_cli-0.2.1/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: emq-cli
+Version: 0.2.1
+Summary: EMQ CLI with vendored EmQuantAPI integration.
+Author: emq-cli contributors
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: typer<1.0.0,>=0.16.0
+Description-Content-Type: text/markdown
+
+# emq-cli
+
+`emq` is a domain-oriented command line tool for EmQuantAPI with vendored runtime libraries.
+
+## Requirements
+
+- Python 3.11+
+- [uv](https://docs.astral.sh/uv/)
+
+## Quick Start
+
+```bash
+uv sync --dev
+uv run emq --help
+```
+
+Login once (credentials from flags or env):
+
+```bash
+export EMQ_USER='your_user'
+export EMQ_PASS='your_pass'
+uv run emq auth login
+```
+
+Sample market query:
+
+```bash
+uv run emq market series 000001.SZ CLOSE --start 2025-01-01 --end 2025-12-31 --output table
+```
+
+Quick portfolio order:
+
+```bash
+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
+
+```bash
+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.

emq_cli-0.2.1/README.md

@@ -0,0 +1,73 @@
+# emq-cli
+
+`emq` is a domain-oriented command line tool for EmQuantAPI with vendored runtime libraries.
+
+## Requirements
+
+- Python 3.11+
+- [uv](https://docs.astral.sh/uv/)
+
+## Quick Start
+
+```bash
+uv sync --dev
+uv run emq --help
+```
+
+Login once (credentials from flags or env):
+
+```bash
+export EMQ_USER='your_user'
+export EMQ_PASS='your_pass'
+uv run emq auth login
+```
+
+Sample market query:
+
+```bash
+uv run emq market series 000001.SZ CLOSE --start 2025-01-01 --end 2025-12-31 --output table
+```
+
+Quick portfolio order:
+
+```bash
+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
+
+```bash
+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.

emq_cli-0.2.1/docs/design.md

@@ -0,0 +1,89 @@
+# EMQ CLI Detailed Design
+
+## 1. Goals
+
+- Provide domain-driven EMQ CLI commands.
+- Vendor EmQuant Python runtime in package without external install step.
+- Persist login until explicit logout.
+- Standardize output across commands.
+
+## 2. Command Contracts
+
+### auth
+
+- `auth login [--user] [--password] [--force-login/--no-force-login]`
+- `auth logout`
+- `auth status [--check]`
+
+### market
+
+- `market snapshot <codes> <indicators> [--options]`
+- `market series <codes> <indicators> --start <date> --end <date> [--options]`
+
+### portfolio
+
+- `portfolio create --code --name --initial-fund [--remark] [--options]`
+- `portfolio list [--options]`
+- `portfolio order --code <combinCode> --orders-file <json> [--remark] [--options]`
+- `portfolio qorder --code <combinCode> --stock <code> --volume <n> --price <p> --date <date> [--time <time>] [--type <type>] [--remark] [--options]`
+
+### quota
+
+- `quota usage [--start] [--end] [--func] [--indicators] [--options]`
+
+### raw
+
+- `raw css <codes> <indicators> [--options]`
+- `raw csd <codes> <indicators> --start --end [--options]`
+- `raw pquery [--options]`
+- `raw porder --code <combinCode> --orders-file <json> [--remark] [--options]`
+
+## 3. SDK Loading
+
+- Use `importlib` to load `EmQuantAPI.py` from vendored path.
+- Patch `UtilAccess.GetLibraryPath()` to return platform-specific native library path.
+- Native library location is selected by OS and architecture.
+
+## 4. Authentication State
+
+- State file: `~/.emq/state.json`.
+- File permission target: `0600`.
+- Credential resolution priority:
+  1. CLI options
+  2. env `EMQ_USER` / `EMQ_PASS`
+  3. saved local state
+
+## 5. Unified Output
+
+Envelope schema:
+
+```json
+{
+  "success": true,
+  "error": null,
+  "meta": {},
+  "data": []
+}
+```
+
+`table` and `csv` are rendered from normalized row records.
+
+## 6. Error Strategy
+
+- User/config validation errors: `source=cli`, exit code `2`.
+- SDK errors: `source=emquant`, exit code `3`.
+- Unexpected command failures are wrapped into envelope errors.
+
+## 7. Logging
+
+- Configured in root callback.
+- Supports `--log-level` and optional `--log-file`.
+
+## 8. Testing Scope
+
+- Command tree availability.
+- Output format behavior.
+- Login precedence and auto-login semantics.
+- Raw option passthrough and order file validation.
+- SDK error mapping.
+- SDK mocking via `FakeClient`/`FakeEmqData` with call recording for verification.