astroapi-python/src/astroapi/categories/svg.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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
"""SVG chart generation category client."""

from __future__ import annotations

from astroapi.categories.base import BaseCategoryClient
from astroapi.types.requests import (
    CompositeChartRequest,
    NatalChartRequest,
    SynastryChartRequest,
    TransitChartRequest,
)
from astroapi.utils.validators import validate_datetime_location, validate_subject


class SvgClient(BaseCategoryClient):
    """Client for SVG chart generation endpoints.

    .. deprecated::
        The SVG client is deprecated. Use :class:`~astroapi.categories.render.RenderClient`
        (``client.render``) instead, which supports multiple output formats and themes.

    Provides SVG rendering of charts for natal, synastry, composite, and transit charts.
    All methods return SVG strings rather than JSON.
    """

    API_PREFIX = "/api/v3/svg"

    def get_natal_chart_svg(self, request: NatalChartRequest) -> str:
        """Generate SVG for natal chart.

        Args:
            request: Natal chart request parameters

        Returns:
            SVG string

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

        url = self._build_url("natal")
        result: str = self._http.post(
            url, json=request.model_dump(exclude_none=True), response_type="text"
        )
        return result

    def get_synastry_chart_svg(self, request: SynastryChartRequest) -> str:
        """Generate SVG for synastry chart.

        Args:
            request: Synastry chart request parameters

        Returns:
            SVG string

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

        url = self._build_url("synastry")
        result: str = self._http.post(
            url, json=request.model_dump(exclude_none=True), response_type="text"
        )
        return result

    def get_composite_chart_svg(self, request: CompositeChartRequest) -> str:
        """Generate SVG for composite chart.

        Args:
            request: Composite chart request parameters

        Returns:
            SVG string

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

        url = self._build_url("composite")
        result: str = self._http.post(
            url, json=request.model_dump(exclude_none=True), response_type="text"
        )
        return result

    def get_transit_chart_svg(self, request: TransitChartRequest) -> str:
        """Generate SVG for transit chart.

        Args:
            request: Transit chart request parameters

        Returns:
            SVG string

        Raises:
            AstrologyError: If validation fails or API request fails
        """
        validate_subject(request.natal_subject)
        validate_datetime_location(request.transit_datetime)

        url = self._build_url("transit")
        result: str = self._http.post(
            url, json=request.model_dump(exclude_none=True), response_type="text"
        )
        return result