stock-manager-cli 0.3.0

A world-class Python CLI template powered by Typer and rich.

World-Class Python CLI Template

This repository is a state-of-the-art starting point for building Python Command Line Interfaces (CLIs). It's optimized for both human developers and the Antigravity AI pair-programming agent.

Core Technologies

• Framework: Typer with Rich
• Packaging: Standard pyproject.toml (PEP 621) using hatchling
• Linting & Formatting: Ruff
• Type Checking: Mypy
• Testing: Pytest
• Git Hooks: pre-commit

Antigravity (AI) Integration

This repository is configured out-of-the-box with .gemini/rules.md. These rules instruct Antigravity automatically on architectural patterns (like enforcing standard Typer usage over other frameworks and maintaining ruff standards). See .gemini/mcp_instructions.md for tips on how to push the AI even further using MCP tools like sequential-thinking.

How to Work on this project

1. Install tools and dependencies: We highly recommend using uv or creating a virtual environment first.

# Using standard pip in a venv
pip install -e ".[dev]"

2. Setup Git hooks:

make setup

3. Useful Commands:

• make format: Auto-fix linting issues and auto-format code using Ruff.
• make lint: Run strict Ruff and Mypy checks.
• make test: Run pytest suite.
• make check: Run format, lint, and tests all at once.

Database Configuration

Before running commands that require a database connection (like the dashboard), you need to set up your environment variables.

In PowerShell, you can set them for your current session like this:

$env:DB_NAME="fractanomicsdb"
$env:DB_USER="postgres"
$env:DB_PASS="postgres"
$env:DB_HOST="localhost"
$env:DB_PORT="5433"

Try the CLI locally

Once installed, you can invoke the CLI from anywhere in your terminal!

tradingtools-stock --help
tradingtools-stock example hello World