Enhance testing framework and expand API client capabilities

- Updated `pyproject.toml` to include markers for integration tests and modified test options for better coverage reporting.
- Expanded the README.md to clarify the distinction between unit and integration tests, providing detailed usage instructions for both.
- Added multiple new request and response types across various categories in the API client, including insights, astrology, and horoscopes.
- Introduced new methods in the `AnalysisClient`, `AstrocartographyClient`, and `ChineseClient` for additional analysis and reporting features.
- Improved the `AstrologyClient` to include new category clients for enhanced functionality.

Author: Sergii Solonyna

README.md

@@ -305,17 +305,38 @@ pre-commit install
 
 ### Testing
 
+The project has two test suites: **unit tests** (fast, mocked HTTP) and **integration tests** (real API calls or auto-mocked).
+
+#### Unit Tests
+
 ```bash
-# Run tests with coverage
-pytest --cov=src/astroapi --cov-report=html
+# Run all unit tests with coverage (100% branch coverage enforced)
+pytest
 
-# Run specific test file
+# Run a specific test file
 pytest tests/unit/test_client.py
 
-# Run with verbose output
-pytest -v
+# Run a single test
+pytest tests/unit/test_client.py::TestAstrologyClient::test_client_creation_with_config
+```
+
+#### Integration Tests
+
+Integration tests verify every SDK endpoint against the real API. If the `ASTROLOGY_API_KEY` environment variable is set, tests call the live API. If not, the HTTP layer is automatically mocked so tests always pass regardless of API access.
+
+```bash
+# Mock mode (no API key required, runs in ~0.1s)
+pytest tests/integration/ -m integration --no-cov
+
+# Live mode (calls real API, runs in ~6 min)
+ASTROLOGY_API_KEY=your_key pytest tests/integration/ -m integration --no-cov
+
+# Run a single integration test file
+pytest tests/integration/test_horoscope.py -m integration --no-cov
 ```
 
+> Tests marked with `@pytest.mark.xfail` are endpoints known to be unavailable or returning unexpected formats in the current API version. In mock mode these show as `xpassed`; in live mode they show as `xfailed`.
+
 ### Linting and Formatting
 
 ```bash

pyproject.toml

@@ -62,7 +62,11 @@ addopts = [
     "--cov-report=term-missing",
     "--cov-report=html",
     "--cov-branch",
-    "-v"
+    "-v",
+    "-m", "not integration",
+]
+markers = [
+    "integration: Integration tests calling real API (run with: pytest -m integration)",
 ]
 filterwarnings = [
     "error",

src/astroapi/__init__.py

@@ -14,89 +14,289 @@
 from astroapi.errors import AstrologyError
 from astroapi.types import (
     AnalysisRequest,
+    AnnualProfectionRequest,
+    AstrocartographyMapRequest,
     AstrocartographyRequest,
+    AstrodynesRequest,
     AstrologyClientConfig,
     BaZiRequest,
+    BirthAngelsRequest,
     BirthData,
+    BradleyRequest,
     BusinessInsightRequest,
+    BusinessMultipleRequest,
+    BusinessSingleRequest,
     ChartOptions,
+    ChineseBaziHoroscopeRequest,
+    ChineseCompatibilityRequest,
+    ChineseSubject,
+    CompareAstrodynesRequest,
+    CompareLocationsRequest,
     CompositeAnalysisRequest,
     CompositeChartRequest,
+    CryptoTimingRequest,
     DataOptions,
     DataRequest,
     DateRange,
     DateTimeLocation,
     DignityRequest,
+    DirectionReportRequest,
     DirectionRequest,
     DrawCardsRequest,
+    EclipseInterpretationRequest,
+    EclipseNatalCheckRequest,
     EclipsesRequest,
     FinancialInsightRequest,
     FixedStarsConfig,
+    FlyingStarsChartRequest,
+    ForexTimingRequest,
+    GannAnalysisRequest,
+    GematriaRequest,
+    HoraryAnalyzeRequest,
+    HoraryAspectsRequest,
+    HoraryChartRequest,
+    HoraryFertilityRequest,
+    HumanDesignCompatibilityRequest,
+    HumanDesignOptions,
+    HumanDesignRequest,
+    HumanDesignTransitRequest,
+    LocationAnalysisRequest,
+    LuckPillarsRequest,
+    LunarAnalysisRequest,
+    LunarEventsRequest,
+    LunarMansionsRequest,
+    LunarPhasesRequest,
+    LunarReturnReportRequest,
     LunarReturnRequest,
+    LunarVoidOfCourseRequest,
+    MarketTimingRequest,
+    MingGuaRequest,
     MoonPhaseRequest,
+    MultiPetRequest,
+    MultipleSubjectsRequest,
     NatalChartRequest,
+    NatalTransitReportRequest,
+    NatalTransitsRequest,
+    NumerologyCompatibilityRequest,
     NumerologyRequest,
+    PalmAnalysisRequest,
+    PalmAstroRequest,
+    PalmCompatibilityRequest,
+    PalmReadingRequest,
+    ParanMapRequest,
+    PdfDailyHoroscopeRequest,
+    PdfNatalReportRequest,
+    PdfOptions,
+    PdfWeeklyHoroscopeRequest,
     PersonalizedHoroscopeRequest,
+    PersonalTextHoroscopeRequest,
     PetInsightRequest,
+    PetPersonalityRequest,
     PlanetaryPositionsRequest,
+    PowerZonesRequest,
+    ProfectionTimelineRequest,
+    ProgressionReportRequest,
     ProgressionRequest,
     RelationshipInsightRequest,
+    RelocationAnalysisRequest,
+    RenderCompositeRequest,
+    RenderNatalRequest,
+    RenderOptions,
+    RenderSynastryRequest,
+    RenderTransitRequest,
     ReportOptions,
     RetryConfig,
+    ReturnTransitReportRequest,
+    SearchLocationsRequest,
+    SignTextHoroscopeRequest,
     SimpleDate,
+    SingleSubjectRequest,
+    SolarReturnReportRequest,
     SolarReturnRequest,
     Subject,
     SunSignHoroscopeRequest,
     SynastryAnalysisRequest,
     SynastryChartRequest,
+    TarotBirthCardsRequest,
+    TarotDignitiesRequest,
+    TarotNatalReportRequest,
+    TarotOptimalTimesRequest,
+    TarotQuintessenceRequest,
     TarotReadingRequest,
+    TarotReportRequest,
+    TarotTimingRequest,
+    TikkunRequest,
+    TraditionalAnalysisRequest,
     TransitAnalysisRequest,
     TransitChartRequest,
+    TreeOfLifeChartRequest,
+    VedicCharaDashaRequest,
+    VedicChartOptions,
+    VedicChartRequest,
+    VedicDashaRequest,
+    VedicDivisionalChartRequest,
+    VedicFestivalRequest,
+    VedicKPRequest,
+    VedicKundliRequest,
+    VedicOptions,
+    VedicPanchangRequest,
+    VedicRegionalPanchangRequest,
+    VedicRemediesRequest,
+    VedicRequest,
+    VedicSadeSatiRequest,
+    VedicSVGOptions,
+    VedicTransitRequest,
+    VedicVarshaphalRequest,
+    VedicYogaRequest,
+    VenusReturnReportRequest,
+    VenusReturnRequest,
     WellnessInsightRequest,
+    YearlyForecastRequest,
+    ZiweiChartRequest,
 )
 
 __all__ = [
     "AnalysisRequest",
+    "AnnualProfectionRequest",
+    "AstrocartographyMapRequest",
     "AstrocartographyRequest",
+    "AstrodynesRequest",
     "AstrologyClient",
     "AstrologyClientConfig",
     "AstrologyError",
     "BaZiRequest",
+    "BirthAngelsRequest",
     "BirthData",
+    "BradleyRequest",
     "BusinessInsightRequest",
+    "BusinessMultipleRequest",
+    "BusinessSingleRequest",
     "ChartOptions",
+    "ChineseBaziHoroscopeRequest",
+    "ChineseCompatibilityRequest",
+    "ChineseSubject",
+    "CompareAstrodynesRequest",
+    "CompareLocationsRequest",
     "CompositeAnalysisRequest",
     "CompositeChartRequest",
+    "CryptoTimingRequest",
     "DataOptions",
     "DataRequest",
     "DateRange",
     "DateTimeLocation",
     "DignityRequest",
+    "DirectionReportRequest",
     "DirectionRequest",
     "DrawCardsRequest",
+    "EclipseInterpretationRequest",
+    "EclipseNatalCheckRequest",
     "EclipsesRequest",
     "FinancialInsightRequest",
     "FixedStarsConfig",
+    "FlyingStarsChartRequest",
+    "ForexTimingRequest",
+    "GannAnalysisRequest",
+    "GematriaRequest",
+    "HoraryAnalyzeRequest",
+    "HoraryAspectsRequest",
+    "HoraryChartRequest",
+    "HoraryFertilityRequest",
+    "HumanDesignCompatibilityRequest",
+    "HumanDesignOptions",
+    "HumanDesignRequest",
+    "HumanDesignTransitRequest",
+    "LocationAnalysisRequest",
+    "LuckPillarsRequest",
+    "LunarAnalysisRequest",
+    "LunarEventsRequest",
+    "LunarMansionsRequest",
+    "LunarPhasesRequest",
+    "LunarReturnReportRequest",
     "LunarReturnRequest",
+    "LunarVoidOfCourseRequest",
+    "MarketTimingRequest",
+    "MingGuaRequest",
     "MoonPhaseRequest",
+    "MultiPetRequest",
+    "MultipleSubjectsRequest",
     "NatalChartRequest",
+    "NatalTransitReportRequest",
+    "NatalTransitsRequest",
+    "NumerologyCompatibilityRequest",
     "NumerologyRequest",
+    "PalmAnalysisRequest",
+    "PalmAstroRequest",
+    "PalmCompatibilityRequest",
+    "PalmReadingRequest",
+    "ParanMapRequest",
+    "PdfDailyHoroscopeRequest",
+    "PdfNatalReportRequest",
+    "PdfOptions",
+    "PdfWeeklyHoroscopeRequest",
+    "PersonalTextHoroscopeRequest",
     "PersonalizedHoroscopeRequest",
     "PetInsightRequest",
+    "PetPersonalityRequest",
     "PlanetaryPositionsRequest",
+    "PowerZonesRequest",
+    "ProfectionTimelineRequest",
+    "ProgressionReportRequest",
     "ProgressionRequest",
     "RelationshipInsightRequest",
+    "RelocationAnalysisRequest",
+    "RenderCompositeRequest",
+    "RenderNatalRequest",
+    "RenderOptions",
+    "RenderSynastryRequest",
+    "RenderTransitRequest",
     "ReportOptions",
     "RetryConfig",
+    "ReturnTransitReportRequest",
+    "SearchLocationsRequest",
+    "SignTextHoroscopeRequest",
     "SimpleDate",
+    "SingleSubjectRequest",
+    "SolarReturnReportRequest",
     "SolarReturnRequest",
     "Subject",
     "SunSignHoroscopeRequest",
     "SynastryAnalysisRequest",
     "SynastryChartRequest",
+    "TarotBirthCardsRequest",
+    "TarotDignitiesRequest",
+    "TarotNatalReportRequest",
+    "TarotOptimalTimesRequest",
+    "TarotQuintessenceRequest",
     "TarotReadingRequest",
+    "TarotReportRequest",
+    "TarotTimingRequest",
+    "TikkunRequest",
+    "TraditionalAnalysisRequest",
     "TransitAnalysisRequest",
     "TransitChartRequest",
+    "TreeOfLifeChartRequest",
+    "VedicCharaDashaRequest",
+    "VedicChartOptions",
+    "VedicChartRequest",
+    "VedicDashaRequest",
+    "VedicDivisionalChartRequest",
+    "VedicFestivalRequest",
+    "VedicKPRequest",
+    "VedicKundliRequest",
+    "VedicOptions",
+    "VedicPanchangRequest",
+    "VedicRegionalPanchangRequest",
+    "VedicRemediesRequest",
+    "VedicRequest",
+    "VedicSVGOptions",
+    "VedicSadeSatiRequest",
+    "VedicTransitRequest",
+    "VedicVarshaphalRequest",
+    "VedicYogaRequest",
+    "VenusReturnReportRequest",
+    "VenusReturnRequest",
     "WellnessInsightRequest",
+    "YearlyForecastRequest",
+    "ZiweiChartRequest",
     "__version__",
 ]

src/astroapi/categories/__init__.py

@@ -10,15 +10,24 @@
 from astroapi.categories.data import DataClient
 from astroapi.categories.eclipses import EclipsesClient
 from astroapi.categories.enhanced import EnhancedClient
+from astroapi.categories.fengshui import FengshuiClient
 from astroapi.categories.fixed_stars import FixedStarsClient
 from astroapi.categories.glossary import GlossaryClient
+from astroapi.categories.horary import HoraryClient
 from astroapi.categories.horoscope import HoroscopeClient
+from astroapi.categories.human_design import HumanDesignClient
 from astroapi.categories.insights import InsightsClient
+from astroapi.categories.kabbalah import KabbalahClient
 from astroapi.categories.lunar import LunarClient
 from astroapi.categories.numerology import NumerologyClient
+from astroapi.categories.palmistry import PalmistryClient
+from astroapi.categories.pdf import PdfClient
+from astroapi.categories.render import RenderClient
 from astroapi.categories.svg import SvgClient
 from astroapi.categories.tarot import TarotClient
 from astroapi.categories.traditional import TraditionalClient
+from astroapi.categories.vedic import VedicClient
+from astroapi.categories.ziwei import ZiweiClient
 
 __all__ = [
     "AnalysisClient",
@@ -29,13 +38,22 @@
     "DataClient",
     "EclipsesClient",
     "EnhancedClient",
+    "FengshuiClient",
     "FixedStarsClient",
     "GlossaryClient",
+    "HoraryClient",
     "HoroscopeClient",
+    "HumanDesignClient",
     "InsightsClient",
+    "KabbalahClient",
     "LunarClient",
     "NumerologyClient",
+    "PalmistryClient",
+    "PdfClient",
+    "RenderClient",
     "SvgClient",
     "TarotClient",
     "TraditionalClient",
+    "VedicClient",
+    "ZiweiClient",
 ]