Asterism Utils

An interface for interacting with data from Asterism Books (asterismbooks.com).

Configuration

You can optionally store your credentials in a asterism_utils.toml file in the current directory or your home directory:

email = "your-email@example.com"
password = "your-secret-password"

Usage

All commands can be accessed via the asterism CLI:

# With uv (recommended)
uv run asterism [COMMAND] [ARGS]

# Or if installed directly
asterism [COMMAND] [ARGS]

Commands

1. Wholesale Customers

Generate a CSV of current wholesale customers.

asterism customers [--email EMAIL]

Outputs: asterism_customers_YYYY-MM-DD.csv

2. Payment History

Download monthly payment history (transfers and item details).

asterism payments 2026-01

Argument: MONTH (YYYY-MM) Outputs: asterism_payments_2026-01.csv

3. Payment History Range

Download payment history for a range of months.

asterism payments-range 2025-01 2025-03 my_reports/

Arguments:

• START_MONTH: YYYY-MM
• END_MONTH: YYYY-MM
• OUTPUT_BASE: Directory (if ends in /) or filename prefix.
  • If my_reports/: saves my_reports/asterism_payments_2025-01.csv, etc.
  • If stats_: saves stats_2025-01.csv, etc.

4. Sales Orders

Download sales orders for a specific month.

asterism orders 2026-01 [--publisher "Publisher Name"]

Argument: MONTH (YYYY-MM) Option: --publisher (Required if your account manages multiple publishers; otherwise autodetected). Outputs: asterism_orders_2026-01.csv