Changelog

All notable changes to numistalib will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

Added

Changed

Fixed

Removed

[0.1.2] - 2025-12-29

Added

Changed

Fixed

Removed

[0.1.1] - 2025-12-28

Added

  • Initial release

  • Complete Numista API v3 coverage

  • HTTP caching with hishel (7-day TTL)

  • Rate limiting (45 requests/minute)

  • Retry logic with exponential backoff

  • Rich CLI with tables and panels

  • Full Pydantic model validation

  • Sync and async support

  • Comprehensive documentation

  • ReadTheDocs configuration

Features

Client

  • NumistaApiClient with sync/async support

  • RFC 9111-compliant HTTP caching

  • Persistent SQLite cache storage

  • Rate limiting with pyrate-limiter

  • Exponential backoff with jitter

  • Cache indicators (💾/🌐)

Services

  • Types: Search and retrieve coin/banknote/exonumia types

  • Catalogues: List reference catalogues

  • Issuers: List countries and entities

  • Issues: Get issue information

  • Mints: List and retrieve mint details

  • Collections: Manage user collections (OAuth)

  • Image Search: Search by coin images

  • Literature: Get publication information

  • Prices: Get price estimates

  • Users: Get user profiles

CLI

  • Rich v14 theming

  • Consistent panel/table display

  • Cache indicators

  • Short/long option flags

  • Command aliases (cat, isr, isu)

  • Error handling with rich console

Models

  • Full Pydantic validation

  • Type safety with strict hints

  • Rich rendering methods

  • Serialization support

Documentation

  • Installation guide

  • Quickstart tutorial

  • Complete CLI reference

  • Python API guide

  • Configuration reference

  • Advanced usage patterns

  • Architecture documentation

  • Contributing guide

  • API reference (Sphinx)

[0.1.0] - 2025-12-27

Initial development version.