bmv-cli 0.1.0__tar.gz

bmv_cli-0.1.0/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: bmv-cli
+Version: 0.1.0
+Summary: CLI tool for Mexican stock market (BMV/BIVA) data via DataBursatil API
+Author: Axel Berrelleza
+License-Expression: MIT
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Classifier: Topic :: Terminals
+Requires-Dist: python-dotenv>=1.2.1
+Requires-Dist: requests>=2.32.5
+Requires-Dist: rich>=14.2.0
+Requires-Dist: typer>=0.20.0
+Requires-Dist: pytest>=8.3.5 ; extra == 'dev'
+Requires-Dist: requests-mock>=1.12.1 ; extra == 'dev'
+Requires-Dist: ruff>=0.9.0 ; extra == 'dev'
+Requires-Dist: mypy>=1.15.0 ; extra == 'dev'
+Requires-Dist: types-requests>=2.32.0.20241016 ; extra == 'dev'
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/AxelBerrelleza/bmv-cli
+Project-URL: Issues, https://github.com/AxelBerrelleza/bmv-cli/issues
+Provides-Extra: dev
+Description-Content-Type: text/markdown
+
+# bmv-cli
+
+A command-line interface for Mexican stock market (BMV/BIVA) data via the [DataBursatil](https://www.databursatil.com) API v2.
+
+Get real-time quotes, currency rates, API credits, search for symbols, and dividend information — all from your terminal.
+
+## Installation
+
+### uv tool (recommended)
+```bash
+uv tool install bmv-cli
+```
+
+### pipx
+```bash
+pipx install bmv-cli
+```
+
+### pip
+```bash
+pip install bmv-cli
+```
+
+## Setup
+
+You need a DataBursatil API token. Get one at <https://www.databursatil.com>.
+
+Set the token as an environment variable:
+
+```bash
+export BMV_API_TOKEN="your-token-here"
+```
+
+For local development, you can also create a `.env` file in the project root:
+
+```bash
+cp .env.sample .env
+# Edit .env and add your BMV_API_TOKEN
+```
+
+## Usage
+
+All commands require the `BMV_API_TOKEN` environment variable.
+
+### Get real-time prices
+```bash
+bmv price GFNORTEO WALMEX*
+```
+
+### Get currency exchange rates
+```bash
+bmv currencies
+```
+
+### Check remaining API credits
+```bash
+bmv credits
+```
+
+### Search for stock symbols
+```bash
+bmv search WALMEX
+bmv search GFNORTE --market global
+```
+
+### Get dividend information
+```bash
+bmv dividend FMTY14
+bmv dividend WALMEX*
+```
+
+## Development
+
+```bash
+# Clone and setup
+git clone https://github.com/AxelBerrelleza/bmv-cli.git
+cd bmv-cli
+uv sync --extra dev
+
+# Run quality gates
+uv run ruff format --check .
+uv run ruff check .
+uv run mypy src/bmv_cli/api src/bmv_cli/commands
+uv run pytest
+
+# Run the CLI during development
+uv run bmv --help
+```
+
+See [AGENTS.md](AGENTS.md) for detailed development instructions.

bmv_cli-0.1.0/README.md

@@ -0,0 +1,90 @@
+# bmv-cli
+
+A command-line interface for Mexican stock market (BMV/BIVA) data via the [DataBursatil](https://www.databursatil.com) API v2.
+
+Get real-time quotes, currency rates, API credits, search for symbols, and dividend information — all from your terminal.
+
+## Installation
+
+### uv tool (recommended)
+```bash
+uv tool install bmv-cli
+```
+
+### pipx
+```bash
+pipx install bmv-cli
+```
+
+### pip
+```bash
+pip install bmv-cli
+```
+
+## Setup
+
+You need a DataBursatil API token. Get one at <https://www.databursatil.com>.
+
+Set the token as an environment variable:
+
+```bash
+export BMV_API_TOKEN="your-token-here"
+```
+
+For local development, you can also create a `.env` file in the project root:
+
+```bash
+cp .env.sample .env
+# Edit .env and add your BMV_API_TOKEN
+```
+
+## Usage
+
+All commands require the `BMV_API_TOKEN` environment variable.
+
+### Get real-time prices
+```bash
+bmv price GFNORTEO WALMEX*
+```
+
+### Get currency exchange rates
+```bash
+bmv currencies
+```
+
+### Check remaining API credits
+```bash
+bmv credits
+```
+
+### Search for stock symbols
+```bash
+bmv search WALMEX
+bmv search GFNORTE --market global
+```
+
+### Get dividend information
+```bash
+bmv dividend FMTY14
+bmv dividend WALMEX*
+```
+
+## Development
+
+```bash
+# Clone and setup
+git clone https://github.com/AxelBerrelleza/bmv-cli.git
+cd bmv-cli
+uv sync --extra dev
+
+# Run quality gates
+uv run ruff format --check .
+uv run ruff check .
+uv run mypy src/bmv_cli/api src/bmv_cli/commands
+uv run pytest
+
+# Run the CLI during development
+uv run bmv --help
+```
+
+See [AGENTS.md](AGENTS.md) for detailed development instructions.

bmv_cli-0.1.0/pyproject.toml

@@ -0,0 +1,109 @@
+[project]
+name = "bmv-cli"
+version = "0.1.0"
+description = "CLI tool for Mexican stock market (BMV/BIVA) data via DataBursatil API"
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+classifiers = [
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Financial and Insurance Industry",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Office/Business :: Financial :: Investment",
+    "Topic :: Terminals",
+]
+dependencies = [
+    "python-dotenv>=1.2.1",
+    "requests>=2.32.5",
+    "rich>=14.2.0",
+    "typer>=0.20.0",
+]
+
+[[project.authors]]
+name = "Axel Berrelleza"
+
+[project.scripts]
+bmv = "bmv_cli.main:app"
+
+[project.urls]
+Homepage = "https://github.com/AxelBerrelleza/bmv-cli"
+Issues = "https://github.com/AxelBerrelleza/bmv-cli/issues"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.3.5",
+    "requests-mock>=1.12.1",
+    "ruff>=0.9.0",
+    "mypy>=1.15.0",
+    "types-requests>=2.32.0.20241016",
+]
+
+[build-system]
+requires = ["uv_build>=0.13.6,<0.14"]
+build-backend = "uv_build"
+
+[tool.ruff]
+target-version = "py312"
+line-length = 100
+exclude = [
+    ".venv",
+    ".git",
+    "__pycache__",
+    "build",
+    "dist",
+]
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "W",
+    "F",
+    "I",
+    "UP",
+    "B",
+    "SIM",
+    "RUF",
+    "TCH",
+]
+ignore = [
+    "E501",
+    "B008",
+    "B904",
+    "B905",
+    "RUF012",
+    "SIM113",
+    "SIM117",
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["bmv_cli"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
+
+[tool.mypy]
+python_version = "3.12"
+warn_return_any = false
+warn_unused_configs = true
+warn_unused_ignores = true
+check_untyped_defs = true
+disallow_untyped_decorators = false
+no_implicit_optional = true
+show_error_codes = true
+
+[[tool.mypy.overrides]]
+module = "bmv_cli.commands.tests.*"
+ignore_errors = true
+
+[tool.pytest.ini_options]
+minversion = "8.0"
+testpaths = ["src/bmv_cli/commands/tests"]
+log_cli = true
+log_cli_level = "INFO"
+addopts = "-v --tb=short"

bmv_cli-0.1.0/pyproject.toml.orig

@@ -0,0 +1,118 @@
+[project]
+name = "bmv-cli"
+version = "0.1.0"
+description = "CLI tool for Mexican stock market (BMV/BIVA) data via DataBursatil API"
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+authors = [
+    { name = "Axel Berrelleza" }
+]
+classifiers = [
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Financial and Insurance Industry",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Office/Business :: Financial :: Investment",
+    "Topic :: Terminals",
+]
+dependencies = [
+    "python-dotenv>=1.2.1",
+    "requests>=2.32.5",
+    "rich>=14.2.0",
+    "typer>=0.20.0",
+]
+
+[project.scripts]
+bmv = "bmv_cli.main:app"
+
+[project.urls]
+Homepage = "https://github.com/AxelBerrelleza/bmv-cli"
+Issues = "https://github.com/AxelBerrelleza/bmv-cli/issues"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.3.5",
+    "requests-mock>=1.12.1",
+    "ruff>=0.9.0",
+    "mypy>=1.15.0",
+    "types-requests>=2.32.0.20241016",
+]
+
+[build-system]
+requires = ["uv_build>=0.13.6,<0.14"]
+build-backend = "uv_build"
+
+# ==============================================================================
+# Ruff Configuration (Formatting & Linting)
+# ==============================================================================
+[tool.ruff]
+target-version = "py312"
+line-length = 100
+exclude = [
+    ".venv",
+    ".git",
+    "__pycache__",
+    "build",
+    "dist",
+]
+
+[tool.ruff.lint]
+select = [
+    "E",     # pycodestyle errors
+    "W",     # pycodestyle warnings
+    "F",     # Pyflakes
+    "I",     # isort (import sorting)
+    "UP",    # pyupgrade (modern Python 3.12+ syntax)
+    "B",     # flake8-bugbear
+    "SIM",   # flake8-simplify
+    "RUF",   # Ruff-specific rules
+    "TCH",   # flake8-type-checking
+]
+ignore = [
+    "E501",  # Line too long (handled by ruff format)
+    "B008",  # Do not perform function calls in argument defaults (needed for Typer)
+    "B904",  # Within an except clause, raise exceptions with from err
+    "B905",  # zip() without an explicit strict= parameter
+    "RUF012", # Mutable default value for class attribute
+    "SIM113", # Use enumerate() for index variable in for loop
+    "SIM117", # Combine nested with statements
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["bmv_cli"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
+
+# ==============================================================================
+# Mypy Configuration (Static Analysis & Type Checking)
+# ==============================================================================
+[tool.mypy]
+python_version = "3.12"
+warn_return_any = false
+warn_unused_configs = true
+warn_unused_ignores = true
+check_untyped_defs = true
+disallow_untyped_decorators = false
+no_implicit_optional = true
+show_error_codes = true
+
+[[tool.mypy.overrides]]
+module = "bmv_cli.commands.tests.*"
+ignore_errors = true
+
+# ==============================================================================
+# Pytest Configuration
+# ==============================================================================
+[tool.pytest.ini_options]
+minversion = "8.0"
+testpaths = ["src/bmv_cli/commands/tests"]
+log_cli = true
+log_cli_level = "INFO"
+addopts = "-v --tb=short"

bmv_cli-0.1.0/src/bmv_cli/__init__.py

@@ -0,0 +1 @@
+"""BMV CLI - Mexican stock market data via DataBursatil API."""

bmv_cli-0.1.0/src/bmv_cli/api/client.py

@@ -0,0 +1,39 @@
+from os import getenv
+
+import requests
+from dotenv import load_dotenv
+
+load_dotenv()
+
+
+def get_base_url(endpoint: str, withExchange: bool) -> str:
+    return f"https://api.databursatil.com/v2/{endpoint}?token={getenv('BMV_API_TOKEN')}" + (
+        "&bolsa=bmv,biva" if withExchange else ""
+    )
+
+
+def request_prices(symbols: list[str]):
+    response = requests.get(
+        get_base_url("cotizaciones", withExchange=True)
+        + "&concepto=u,p,a,x,n,c,m,v,o,i"
+        + "&emisora_serie="
+        + ",".join(symbols)
+    )
+    return response.json()
+
+
+def request_currencies():
+    response = requests.get(get_base_url("divisas", withExchange=False))
+    return response.json()
+
+
+def request_credits():
+    response = requests.get(get_base_url("creditos", withExchange=False))
+    return response.json()
+
+
+def request_emisoras(letra: str, mercado: str = "local"):
+    response = requests.get(
+        get_base_url("emisoras", withExchange=False) + f"&letra={letra}&mercado={mercado}"
+    )
+    return response.json()

bmv_cli-0.1.0/src/bmv_cli/commands/credits.py

@@ -0,0 +1,14 @@
+import typer
+from rich.console import Console
+
+from bmv_cli.api.client import request_credits
+
+app = typer.Typer()
+
+
+@app.command()
+def credits():
+    """Check remaining API credits"""
+    response = request_credits()
+    console = Console()
+    console.print(f"[bold green]Remaining credits:[/] {response['disponibles']}")

bmv_cli-0.1.0/src/bmv_cli/commands/currencies.py

@@ -0,0 +1,27 @@
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from bmv_cli.api.client import request_currencies
+
+app = typer.Typer()
+
+
+@app.command()
+def currencies():
+    response = request_currencies()
+    table = Table(
+        "Currency",
+        "Last Value",
+        "Change %",
+        "Change",
+    )
+    date = response.get("t")
+    response.pop("t")
+    for currency, data in response.items():
+        # pp(data)
+        table.add_row(currency, *[str(value) for value in data.values()])
+
+    console = Console()
+    console.print(table)
+    console.print(f"Datetime: {date}")

bmv_cli-0.1.0/src/bmv_cli/commands/dividend.py

@@ -0,0 +1,102 @@
+import re
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from bmv_cli.api.client import request_emisoras
+
+app = typer.Typer()
+
+
+def extract_emitter_name(symbol: str) -> str:
+    """Extract emitter name from symbol+series (e.g., FMTY14 -> FMTY, GFNORTEO -> GFNORTE, WALMEX* -> WALMEX)"""
+    symbol = symbol.upper()
+
+    # If ends with *, strip it
+    if symbol.endswith("*"):
+        return symbol[:-1]
+
+    # If ends with digits, strip them
+    match = re.match(r"^([A-Z]+)\d+$", symbol)
+    if match:
+        return match.group(1)
+
+    # If ends with a single letter, try stripping it (risky but common pattern)
+    # Only do this if the remaining part is at least 3 characters
+    if len(symbol) > 3 and symbol[-1].isalpha():
+        return symbol[:-1]
+
+    return symbol
+
+
+@app.command()
+def dividend(
+    symbol: str = typer.Argument(..., help="Stock symbol (e.g., FMTY, FMTY14, WALMEX*)"),
+):
+    """Get dividend information for a symbol"""
+    console = Console()
+
+    # Try the symbol as-is first
+    response = request_emisoras(symbol)
+
+    # If API returns an error, try extracting just the emitter name
+    if "Error" in response:
+        emitter_name = extract_emitter_name(symbol)
+        if emitter_name != symbol:
+            console.print(f"[yellow]Trying with emitter name: {emitter_name}[/yellow]")
+            response = request_emisoras(emitter_name)
+
+    # Still an error?
+    if "Error" in response:
+        console.print(f"[red]Error: {response['Error']}[/red]")
+        raise typer.Exit(code=1)
+
+    # Response structure: {SYMBOL: {SERIE: {data...}}}
+    found = False
+    for emitter_key, series_data in response.items():
+        if not isinstance(series_data, dict):
+            continue
+
+        for serie, data in series_data.items():
+            if not isinstance(data, dict):
+                continue
+
+            dividendos = data.get("dividendos", {})
+            found = True
+
+            if not dividendos:
+                console.print(
+                    f"[yellow]No dividend information available for {emitter_key}{serie}[/yellow]"
+                )
+                continue
+
+            console.print(f"\n[bold]Dividend Info for {emitter_key}{serie}:[/]")
+
+            # Recent dividend
+            if "reciente" in dividendos:
+                console.print("\n[bold green]Most Recent Dividend(s):[/]")
+                for date, info in dividendos["reciente"].items():
+                    console.print(f"  Date: {date}")
+                    console.print(f"  Ex-coupon Date: {info.get('fechaexcupon', 'N/A')}")
+                    console.print(f"  Amount: {info.get('pago', 'N/A')} {info.get('divisa', '')}")
+                    console.print(f"  Type: {info.get('tipo', 'N/A')}")
+                    console.print()
+
+            # Historical dividends
+            if "historico" in dividendos:
+                console.print("\n[bold blue]Dividend History:[/]")
+                table = Table("Date", "Amount", "Type")
+
+                for date, info in dividendos["historico"].items():
+                    table.add_row(
+                        date,
+                        str(info.get("pago", "N/A")),
+                        info.get("tipo", "N/A"),
+                    )
+
+                console.print(table)
+
+    if not found:
+        console.print(f"[red]No data found for symbol: {symbol}[/red]")
+        raise typer.Exit(code=1)

bmv_cli-0.1.0/src/bmv_cli/commands/hello.py

@@ -0,0 +1,8 @@
+import typer
+
+app = typer.Typer()
+
+
+@app.command()
+def hello():
+    print("Hello world")

bmv_cli-0.1.0/src/bmv_cli/commands/price.py

@@ -0,0 +1,32 @@
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from bmv_cli.api.client import request_prices
+
+app = typer.Typer()
+
+
+@app.command()
+def price(symbols: list[str]):
+    response = request_prices(symbols)
+    table = Table(
+        "simbolo",
+        "ultimo",
+        "ppp",
+        "anterior",
+        "maximo",
+        "minimo",
+        "cambioporciento",
+        "cambiopesos",
+        "volumenoperado",
+        "operaciones",
+        "importeacumulado",
+        "fecha",
+    )
+    for symbol, data in response.items():
+        row = data["bmv"] if data["bmv"]["f"] > data["biva"]["f"] else data["biva"]
+        table.add_row(symbol, *[str(value) for value in row.values()])
+
+    console = Console()
+    console.print(table)

bmv_cli-0.1.0/src/bmv_cli/commands/search.py

@@ -0,0 +1,49 @@
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from bmv_cli.api.client import request_emisoras
+
+app = typer.Typer()
+
+
+@app.command()
+def search(
+    text: str = typer.Argument(..., help="Search text (letter or company name)"),
+    market: str = typer.Option(
+        "local",
+        "--market",
+        "-m",
+        help="Market type: local or global",
+        case_sensitive=False,
+    ),
+):
+    """Search for stock symbols"""
+    response = request_emisoras(text, market)
+    table = Table(
+        "Symbol",
+        "Status",
+        "Company Name",
+        "Exchange",
+        "Type",
+        "Shares Outstanding",
+        "ISIN",
+    )
+
+    console = Console()
+
+    # Response structure: {SYMBOL: {SERIE: {data...}}}
+    for symbol, series_data in response.items():
+        for serie, data in series_data.items():
+            if isinstance(data, dict):
+                table.add_row(
+                    f"{symbol}{serie}",
+                    data.get("estatus", "N/A"),
+                    data.get("razon_social", "N/A"),
+                    data.get("bolsa", "N/A"),
+                    data.get("tipo_valor_descripcion", "N/A"),
+                    str(data.get("acciones_en_circulacion", "N/A")),
+                    data.get("isin", "N/A"),
+                )
+
+    console.print(table)

bmv_cli-0.1.0/src/bmv_cli/commands/tests/conftest.py

@@ -0,0 +1,9 @@
+import pytest
+
+
+@pytest.fixture
+def cli_runner():
+    """Provide a Typer CliRunner for testing CLI commands."""
+    from typer.testing import CliRunner
+
+    return CliRunner()

bmv_cli-0.1.0/src/bmv_cli/commands/tests/fixtures/APIResponses.py

@@ -0,0 +1,134 @@
+"""Test fixtures for API responses - DataBursatil v2 API."""
+
+
+def prices_response():
+    """Mock response from /v2/cotizaciones endpoint."""
+    return {
+        "GFNORTEO": {
+            "bmv": {
+                "u": 213.5,
+                "p": 213.46,
+                "a": 207.91,
+                "x": 214.69,
+                "n": 206.89,
+                "c": 2.67,
+                "m": 5.55,
+                "v": 8081217.0,
+                "o": 25245.0,
+                "i": 1710147325.48,
+                "f": "2026-10-23 14:00:00",
+            },
+            "biva": {
+                "u": 213.5,
+                "p": 213.46,
+                "a": 207.91,
+                "x": 214.43,
+                "n": 207.49,
+                "c": 2.68,
+                "m": 5.59,
+                "v": 1190223.0,
+                "o": 6307.0,
+                "i": 252457560.01,
+                "f": "2026-10-23 14:05:00",
+            },
+        },
+        "WALMEX*": {
+            "bmv": {
+                "u": 50.73,
+                "p": 50.77,
+                "a": 50.34,
+                "x": 50.94,
+                "n": 50.01,
+                "c": 0.85,
+                "m": 0.43,
+                "v": 8904568.0,
+                "o": 18587.0,
+                "i": 451685201.71,
+                "f": "2026-10-23 14:00:00",
+            },
+            "biva": {
+                "u": 50.88,
+                "p": 50.77,
+                "a": 50.34,
+                "x": 50.94,
+                "n": 50.12,
+                "c": 1.07,
+                "m": 0.53,
+                "v": 1714520.0,
+                "o": 6643.0,
+                "i": 86940490.91,
+                "f": "2026-10-23 14:05:00",
+            },
+        },
+    }
+
+
+def currencies_response():
+    """Mock response from /v2/divisas endpoint."""
+    return {
+        "AUDUSD": {"u": 0.6903, "c": -0.1, "m": -0.0007},
+        "CADMXN": {"u": 12.3493, "c": 0.16, "m": 0.0196},
+        "CHFMXN": {"u": 21.6778, "c": 0.3, "m": 0.0659},
+        "EURMXN": {"u": 19.9913, "c": 0.42, "m": 0.0833},
+        "EURUSD": {"u": 1.1408, "c": 0.34, "m": 0.0039},
+        "GBPMXN": {"u": 23.1671, "c": 0.29, "m": 0.0671},
+        "GBPUSD": {"u": 1.3224, "c": 0.24, "m": 0.0031},
+        "USDCAD": {"u": 1.4181, "c": -0.14, "m": -0.002},
+        "USDJPY": {"u": 161.55, "c": -0.15, "m": -0.24},
+        "USDMXN": {"u": 17.5147, "c": 0.03, "m": 0.0047},
+        "t": "2026-06-26 04:01:00",
+    }
+
+
+def credits_response():
+    """Mock response from /v2/creditos endpoint."""
+    return {"disponibles": 249421}
+
+
+def emisoras_response():
+    """Mock response from /v2/emisoras endpoint."""
+    return {
+        "WALMEX": {
+            "*": {
+                "razon_social": "WAL - MART DE MEXICO, S.A.B. DE C.V.",
+                "isin": "MX01WA000038",
+                "bolsa": "BMV",
+                "tipo_valor_descripcion": "ACCIONES DE EMPRESAS COMERCIALES, INDUSTRIALES Y DE SERVICIOS",
+                "tipo_valor_id": "1",
+                "estatus": "ACTIVA",
+                "acciones_en_circulacion": 17461402631,
+                "rango_historicos": "2010-01-05 a 2026-10-23",
+                "rango_financieros": "1T_2017, 1T_2018, 1T_2019, 1T_2020, 1T_2021, 1T_2022, 1T_2023, 1T_2024, 1T_2025, 1T_2026",
+                "dividendos": {
+                    "reciente": {
+                        "2025-12-17": {
+                            "pago": 0.85,
+                            "tipo": "DIVIDENDO EN EFECTIVO",
+                            "divisa": "MXN",
+                            "fechaexcupon": "2025-12-16",
+                        }
+                    },
+                    "historico": {
+                        "2021-11-24": {"pago": 0.81, "tipo": "DIVIDENDO EN EFECTIVO"},
+                        "2021-12-28": {"pago": 0.82, "tipo": "DIVIDENDO EN EFECTIVO"},
+                        "2022-11-22": {"pago": 0.85, "tipo": "DIVIDENDO EN EFECTIVO"},
+                        "2022-12-27": {"pago": 0.86, "tipo": "DIVIDENDO EN EFECTIVO"},
+                        "2023-04-11": {"pago": 0.75, "tipo": "DIVIDENDO EN EFECTIVO"},
+                        "2023-11-29": {"pago": 0.97, "tipo": "DIVIDENDO EN EFECTIVO"},
+                        "2023-12-06": {"pago": 0.97, "tipo": "DIVIDENDO EN EFECTIVO"},
+                        "2024-11-12": {"pago": 0.59, "tipo": "DIVIDENDO EN EFECTIVO"},
+                        "2024-12-10": {"pago": 1.09, "tipo": "DIVIDENDO EN EFECTIVO"},
+                        "2025-11-19": {"pago": 0.84, "tipo": "DIVIDENDO EN EFECTIVO"},
+                        "2025-12-17": {"pago": 0.85, "tipo": "DIVIDENDO EN EFECTIVO"},
+                    },
+                },
+            }
+        }
+    }
+
+
+def emisoras_error_response():
+    """Mock error response from /v2/emisoras endpoint."""
+    return {
+        "Error": "La busqueda no arrojo ningun resultado. ¿Dudas? Revisa la documentacion: https://databursatil.com/docs.html"
+    }

bmv_cli-0.1.0/src/bmv_cli/commands/tests/fixtures/__init__.py

@@ -0,0 +1,17 @@
+"""Test fixtures package."""
+
+from .APIResponses import (
+    credits_response,
+    currencies_response,
+    emisoras_error_response,
+    emisoras_response,
+    prices_response,
+)
+
+__all__ = [
+    "credits_response",
+    "currencies_response",
+    "emisoras_error_response",
+    "emisoras_response",
+    "prices_response",
+]

bmv_cli-0.1.0/src/bmv_cli/commands/tests/test_currencies.py

@@ -0,0 +1,51 @@
+import pytest
+from typer.testing import CliRunner
+
+from bmv_cli.commands.currencies import app
+from bmv_cli.commands.tests.fixtures import currencies_response
+
+runner = CliRunner()
+
+
+@pytest.fixture
+def mock_currencies_api(requests_mock):
+    """Mock the divisas API endpoint."""
+    response = currencies_response()
+    requests_mock.get(
+        "https://api.databursatil.com/v2/divisas",
+        json=response,
+    )
+    return response
+
+
+def test_currencies_command(requests_mock, mock_currencies_api):
+    """Test currencies command with mocked API."""
+    result = runner.invoke(app, [], env={"COLUMNS": "200"})
+
+    assert result.exit_code == 0
+    # Check that some currencies appear in output
+    assert "USDMXN" in result.stdout
+    assert "EURUSD" in result.stdout
+
+
+def test_currencies_table_data(requests_mock, mock_currencies_api):
+    """Verify table output contains expected currency data."""
+    result = runner.invoke(app, [], env={"COLUMNS": "200"})
+
+    assert result.exit_code == 0
+    # Check for table headers
+    assert "Currency" in result.stdout
+    assert "Last Value" in result.stdout
+    # Check for specific currency values from the fixture
+    assert "17.5147" in result.stdout  # USDMXN rate
+    assert "1.1408" in result.stdout  # EURUSD rate
+
+
+def test_currencies_date_display(requests_mock, mock_currencies_api):
+    """Verify date display."""
+    result = runner.invoke(app, [], env={"COLUMNS": "200"})
+
+    assert result.exit_code == 0
+    # Check that the datetime is displayed
+    assert "Datetime:" in result.stdout
+    assert "2026-06-26 04:01:00" in result.stdout

bmv_cli-0.1.0/src/bmv_cli/commands/tests/test_hello.py

@@ -0,0 +1,12 @@
+from typer.testing import CliRunner
+
+from bmv_cli.commands.hello import app
+
+
+def test_hello_command():
+    """Test hello command output and exit code."""
+    runner = CliRunner()
+    result = runner.invoke(app, [])
+
+    assert result.exit_code == 0
+    assert "Hello world" in result.stdout

bmv_cli-0.1.0/src/bmv_cli/commands/tests/test_price.py

@@ -0,0 +1,100 @@
+import pytest
+from typer.testing import CliRunner
+
+from bmv_cli.commands.price import app
+from bmv_cli.commands.tests.fixtures import prices_response
+
+runner = CliRunner()
+
+
+@pytest.fixture
+def mock_prices_api(requests_mock):
+    """Mock the cotizaciones API endpoint."""
+    response = prices_response()
+    requests_mock.get(
+        "https://api.databursatil.com/v2/cotizaciones",
+        json=response,
+    )
+    return response
+
+
+def test_single_symbol_price(requests_mock, mock_prices_api):
+    """Test single symbol price lookup with mocked API."""
+    result = runner.invoke(app, ["GFNORTEO"], env={"COLUMNS": "200"})
+
+    assert result.exit_code == 0
+    assert "GFNORTEO" in result.stdout
+    # Should show BIVA data (more recent timestamp) - ultimo price 213.5
+    assert "213.5" in result.stdout
+
+
+def test_multiple_symbols_price(requests_mock, mock_prices_api):
+    """Test multiple symbols price lookup."""
+    result = runner.invoke(app, ["GFNORTEO", "WALMEX*"], env={"COLUMNS": "200"})
+
+    assert result.exit_code == 0
+    assert "GFNORTEO" in result.stdout
+    assert "WALMEX*" in result.stdout
+
+
+def test_price_table_columns(requests_mock, mock_prices_api):
+    """Verify table output contains expected columns and data."""
+    result = runner.invoke(app, ["GFNORTEO"], env={"COLUMNS": "200"})
+
+    assert result.exit_code == 0
+    # Check for table headers (full names with wide terminal)
+    assert "simbolo" in result.stdout
+    assert "ultimo" in result.stdout
+    assert "fecha" in result.stdout
+    # Check for data values from the BIVA response (more recent)
+    assert "213.5" in result.stdout
+    assert "2.68" in result.stdout
+
+
+def test_bmv_vs_biva_selection(requests_mock):
+    """Test BMV vs BIVA selection logic (higher 'f' value wins)."""
+    # Create a response where BIVA has a more recent timestamp
+    response = {
+        "TESTSYMBOL": {
+            "bmv": {
+                "u": 100.0,
+                "p": 99.5,
+                "a": 98.0,
+                "x": 101.0,
+                "n": 97.0,
+                "c": 2.0,
+                "m": 2.0,
+                "v": 1000.0,
+                "o": 10.0,
+                "i": 100000.0,
+                "f": "2026-10-23 14:00:00",
+            },
+            "biva": {
+                "u": 105.0,
+                "p": 104.5,
+                "a": 103.0,
+                "x": 106.0,
+                "n": 102.0,
+                "c": 3.0,
+                "m": 3.0,
+                "v": 2000.0,
+                "o": 20.0,
+                "i": 200000.0,
+                "f": "2026-10-23 14:05:00",  # More recent
+            },
+        }
+    }
+
+    requests_mock.get(
+        "https://api.databursatil.com/v2/cotizaciones",
+        json=response,
+    )
+
+    result = runner.invoke(app, ["TESTSYMBOL"], env={"COLUMNS": "200"})
+
+    assert result.exit_code == 0
+    # Should show BIVA data (105.0 ultimo) not BMV (100.0)
+    assert "105.0" in result.stdout
+    # BMV's ultimo (100.0) should NOT appear since we use BIVA
+    # But 100.0 could appear as part of other values, so check for the row pattern
+    assert "TESTSYMBOL" in result.stdout

bmv_cli-0.1.0/src/bmv_cli/main.py

@@ -0,0 +1,20 @@
+import typer
+
+from bmv_cli.commands.credits import app as credits
+from bmv_cli.commands.currencies import app as currencies
+from bmv_cli.commands.dividend import app as dividend
+from bmv_cli.commands.hello import app as hello
+from bmv_cli.commands.price import app as price
+from bmv_cli.commands.search import app as search
+
+app = typer.Typer()
+app.add_typer(hello)
+app.add_typer(price)
+app.add_typer(currencies)
+app.add_typer(credits)
+app.add_typer(search)
+app.add_typer(dividend)
+
+
+if __name__ == "__main__":
+    app()