astroapi-python/src/astroapi/categories/fixed_stars.py at main · astro-api/astroapi-python · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
"""Fixed stars category client."""

from __future__ import annotations

from astroapi.categories.base import BaseCategoryClient
from astroapi.types.requests import DataRequest
from astroapi.types.responses import FixedStarsResponse, GenericResponse
from astroapi.utils.validators import validate_subject


class FixedStarsClient(BaseCategoryClient):
    """Client for fixed stars endpoints.

    Provides fixed star positions and conjunction calculations.
    """

    API_PREFIX = "/api/v3/fixed-stars"

    def get_positions(self, request: DataRequest) -> FixedStarsResponse:
        """Get fixed star positions.

        Args:
            request: Data request with subject information

        Returns:
            Fixed stars positions response

        Raises:
            AstrologyError: If validation fails or API request fails
        """
        validate_subject(request.subject)

        url = self._build_url("positions")
        data = self._http.post(url, json=request.model_dump(exclude_none=True))
        return FixedStarsResponse(**data)

    def get_conjunctions(self, request: DataRequest) -> GenericResponse:
        """Get fixed star conjunctions with natal planets.

        Args:
            request: Data request with subject information

        Returns:
            Fixed star conjunctions response

        Raises:
            AstrologyError: If validation fails or API request fails
        """
        validate_subject(request.subject)

        url = self._build_url("conjunctions")
        data = self._http.post(url, json=request.model_dump(exclude_none=True))
        return GenericResponse(**data)

    def get_parans(self, request: DataRequest) -> GenericResponse:
        """Get fixed star parans.

        Args:
            request: Data request with subject information

        Returns:
            Fixed star parans response

        Raises:
            AstrologyError: If validation fails or API request fails
        """
        validate_subject(request.subject)

        url = self._build_url("parans")
        data = self._http.post(url, json=request.model_dump(exclude_none=True))
        return GenericResponse(**data)

    def get_report(self, request: DataRequest) -> GenericResponse:
        """Get fixed stars report."""
        validate_subject(request.subject)
        url = self._build_url("report")
        data = self._http.post(url, json=request.model_dump(exclude_none=True))
        return GenericResponse(**data)

    def get_presets(self) -> GenericResponse:
        """Get fixed star presets."""
        url = self._build_url("presets")
        data = self._http.get(url)
        return GenericResponse(**data)