Manufacturing Economic Monitor

A small CLI and Streamlit dashboard for fetching the FRED Industrial Production: Manufacturing (IPMAN) series, validating the response, saving raw and processed JSON files, and showing the latest valid manufacturing index.

Setup

Install dependencies:

uv sync

Set FRED_API_KEY in a local .env file when you need to refresh live data.

.env is ignored by Git. Do not commit API keys or downloaded live data.

Tests

Run the fixture-backed test suite:

uv run pytest

Run tests with coverage:

uv run pytest --cov=manufacturing_monitor

Tests use committed files in tests/fixtures/ and mocks/monkeypatching for external behavior. Routine tests do not contact the live FRED API.

CLI

Run the installed command:

uv run manufacturing-monitor

The compatibility wrapper still works:

uv run main.py

Default output files are:

• raw response: data/raw/ipman_observations_raw.json
• processed observations: data/processed/ipman_observations_processed.json

Run without contacting FRED:

uv run manufacturing-monitor --project-info

Enable console diagnostics:

uv run manufacturing-monitor --verbose

Write detailed diagnostics to a log file:

uv run manufacturing-monitor --log-file logs/manufacturing-monitor.log

Default behavior does not print diagnostic logs. Logging records request events, validation, saved-file locations, and failures, but not API keys or complete request URLs.

Dashboard

Run the Streamlit dashboard:

uv run streamlit run src/manufacturing_monitor/dashboard.py

The dashboard uses the same API, Pydantic validation, and workflow code as the CLI. It accepts a FRED API key through a password-style input and also allows the local environment key from .env.

Validation

Incoming FRED responses are validated with Pydantic before the app uses them. The app rejects:

• non-object top-level responses
• missing or invalid observations
• invalid observation dates
• observation values that are neither numeric strings nor the known FRED . placeholder

Placeholder values are preserved in processed output but skipped when selecting the latest valid manufacturing index.