All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
1.0.0 - 2026-02-16
- Initial release of astroapi-python
- Full Astrology API v3 client implementation
- 16 category clients with 150+ endpoint methods
- Complete type safety with Pydantic models
- Automatic retry logic with exponential backoff
- Comprehensive validation for all request parameters
- Context manager support for resource cleanup
- 100% test coverage
- GitHub Actions CI/CD pipeline
- Comprehensive documentation and examples
- DataClient: Planetary positions, houses, aspects, midpoints, Arabic parts
- ChartsClient: Natal, synastry, composite, transit, return, progression, direction charts
- HoroscopeClient: Personalized and sun sign horoscopes (daily, weekly, monthly, yearly)
- AnalysisClient: Natal, synastry, composite, transit reports and compatibility analysis
- GlossaryClient: Reference data for cities, planets, signs, aspects, keywords
- ChineseClient: BaZi (Four Pillars), Chinese zodiac, elements
- NumerologyClient: Life path, expression, soul urge, personality numbers
- TarotClient: Card draws and readings
- EclipsesClient: Solar and lunar eclipse calculations
- LunarClient: Moon phases, void of course, lunar mansions
- AstrocartographyClient: Planetary lines and relocated charts
- TraditionalClient: Dignities, receptions, almutens
- FixedStarsClient: Fixed star positions and conjunctions
- InsightsClient: Relationship, pet, wellness, financial, business insights
- SvgClient: SVG chart rendering
- EnhancedClient: Advanced calculations, patterns, dominants
- Type-safe request and response models
- Flexible configuration with environment variable support
- Custom retry policies
- Debug logging
- HTTP client abstraction for testability
- Comprehensive error handling with AstrologyError
- Input validation before API calls
- Response envelope unwrapping