kerykeion 4.18.3__py3-none-any.whl → 5.1.9__py3-none-any.whl

kerykeion/schemas/__init__.py

@@ -0,0 +1,106 @@
+# -*- coding: utf-8 -*-
+"""
+    This is part of Kerykeion (C) 2025 Giacomo Battaglia
+"""
+
+from .kerykeion_exception import KerykeionException
+from .kr_literals import (
+    ZodiacType,
+    Sign,
+    SignNumbers,
+    AspectMovementType,
+    Houses,
+    HouseNumbers,
+    AstrologicalPoint,
+    Element,
+    Quality,
+    ChartType,
+    PointType,
+    LunarPhaseEmoji,
+    LunarPhaseName,
+    SiderealMode,
+    HousesSystemIdentifier,
+    PerspectiveType,
+    SignsEmoji,
+    KerykeionChartTheme,
+    KerykeionChartLanguage,
+    RelationshipScoreDescription,
+    CompositeChartType,
+    AspectName,
+    # Deprecated aliases
+    Planet,
+    AxialCusps,
+)
+from .kr_models import (
+    SubscriptableBaseModel,
+    LunarPhaseModel,
+    KerykeionPointModel,
+    AstrologicalBaseModel,
+    AstrologicalSubjectModel,
+    CompositeSubjectModel,
+    PlanetReturnModel,
+    EphemerisDictModel,
+    AspectModel,
+    ZodiacSignModel,
+    RelationshipScoreAspectModel,
+    RelationshipScoreModel,
+    ActiveAspect,
+    TransitMomentModel,
+    TransitsTimeRangeModel,
+)
+from .chart_template_model import ChartTemplateModel
+from .settings_models import KerykeionSettingsModel
+
+__all__ = [
+    # Exceptions
+    "KerykeionException",
+
+    # Settings and Chart Types
+    "ChartTemplateModel",
+    "KerykeionSettingsModel",
+
+    # Main Literal Types (from kr_literals)
+    "ZodiacType",
+    "Sign",
+    "SignNumbers",
+    "AspectMovementType",
+    "Houses",
+    "HouseNumbers",
+    "AstrologicalPoint",
+    "Element",
+    "Quality",
+    "ChartType",
+    "PointType",
+    "LunarPhaseEmoji",
+    "LunarPhaseName",
+    "SiderealMode",
+    "HousesSystemIdentifier",
+    "PerspectiveType",
+    "SignsEmoji",
+    "KerykeionChartTheme",
+    "KerykeionChartLanguage",
+    "RelationshipScoreDescription",
+    "CompositeChartType",
+    "AspectName",
+
+    # Deprecated aliases (for v4.x compatibility, will be removed in v6.0)
+    "Planet",
+    "AxialCusps",
+
+    # Main Model Classes (from kr_models)
+    "SubscriptableBaseModel",
+    "LunarPhaseModel",
+    "KerykeionPointModel",
+    "AstrologicalBaseModel",
+    "AstrologicalSubjectModel",
+    "CompositeSubjectModel",
+    "PlanetReturnModel",
+    "EphemerisDictModel",
+    "AspectModel",
+    "ZodiacSignModel",
+    "RelationshipScoreAspectModel",
+    "RelationshipScoreModel",
+    "ActiveAspect",
+    "TransitMomentModel",
+    "TransitsTimeRangeModel",
+]

kerykeion/schemas/chart_template_model.py

@@ -0,0 +1,367 @@
+from .kr_models import SubscriptableBaseModel
+
+
+class ChartTemplateModel(SubscriptableBaseModel):
+    """
+    Pydantic model for chart template variables used in SVG generation.
+
+    This model contains all the template variables required to render
+    astrological charts, including colors, dimensions, and SVG components.
+    """
+
+    transitRing: str
+    """SVG markup for the transit ring"""
+
+    degreeRing: str
+    """SVG markup for the degree ring"""
+
+    background_circle: str
+    """SVG markup for the background circle"""
+
+    first_circle: str
+    """SVG markup for the first circle"""
+
+    second_circle: str
+    """SVG markup for the second circle"""
+
+    third_circle: str
+    """SVG markup for the third circle"""
+
+    makeAspects: str
+    """SVG markup for aspects"""
+
+    makeAspectGrid: str
+    """SVG markup for aspect grid"""
+
+    makeDoubleChartAspectList: str
+    """SVG markup for double chart aspect list"""
+
+    makeHouseComparisonGrid: str
+    """SVG markup for house comparison grid"""
+
+    full_wheel_translate_y: int
+    """Vertical translation for the full wheel group"""
+
+    houses_and_planets_translate_y: int
+    """Vertical translation for the houses and planets grid group"""
+
+    aspect_grid_translate_y: int
+    """Vertical translation for the aspect grid group"""
+
+    aspect_list_translate_y: int
+    """Vertical translation for the aspect list group"""
+
+    title_translate_y: int
+    """Vertical translation for the title and top-left text block"""
+
+    elements_translate_y: int
+    """Vertical translation for the elements summary block"""
+
+    qualities_translate_y: int
+    """Vertical translation for the qualities summary block"""
+
+    lunar_phase_translate_y: int
+    """Vertical translation for the lunar phase block"""
+
+    bottom_left_translate_y: int
+    """Vertical translation for the bottom-left info block"""
+
+    chart_height: float
+    """Chart height in pixels"""
+
+    chart_width: float
+    """Chart width in pixels"""
+
+    viewbox: str
+    """SVG viewBox attribute value"""
+
+    stringTitle: str
+    """Chart title string"""
+
+    top_left_0: str
+    """Top left panel content - line 0"""
+
+    bottom_left_0: str
+    """Bottom left panel content - line 0"""
+
+    bottom_left_1: str
+    """Bottom left panel content - line 1"""
+
+    bottom_left_2: str
+    """Bottom left panel content - line 2"""
+
+    bottom_left_3: str
+    """Bottom left panel content - line 3"""
+
+    bottom_left_4: str
+    """Bottom left panel content - line 4"""
+
+    top_left_1: str
+    """Top left panel content - line 1"""
+
+    top_left_2: str
+    """Top left panel content - line 2"""
+
+    top_left_3: str
+    """Top left panel content - line 3"""
+
+    top_left_4: str
+    """Top left panel content - line 4"""
+
+    top_left_5: str
+    """Top left panel content - line 5"""
+
+    paper_color_0: str
+    """Font color"""
+
+    background_color: str
+    """Dynamic background color (can be transparent or theme color)"""
+
+    planets_color_0: str
+    """Planet color for Sun (index 0)"""
+
+    planets_color_1: str
+    """Planet color for Moon (index 1)"""
+
+    planets_color_2: str
+    """Planet color for Mercury (index 2)"""
+
+    planets_color_3: str
+    """Planet color for Venus (index 3)"""
+
+    planets_color_4: str
+    """Planet color for Mars (index 4)"""
+
+    planets_color_5: str
+    """Planet color for Jupiter (index 5)"""
+
+    planets_color_6: str
+    """Planet color for Saturn (index 6)"""
+
+    planets_color_7: str
+    """Planet color for Uranus (index 7)"""
+
+    planets_color_8: str
+    """Planet color for Neptune (index 8)"""
+
+    planets_color_9: str
+    """Planet color for Pluto (index 9)"""
+
+    planets_color_10: str
+    """Planet color for North Node (index 10)"""
+
+    planets_color_11: str
+    """Planet color for South Node (index 11)"""
+
+    planets_color_12: str
+    """Planet color for Chiron (index 12)"""
+
+    planets_color_13: str
+    """Planet color for Ceres (index 13)"""
+
+    planets_color_14: str
+    """Planet color for Pallas (index 14)"""
+
+    planets_color_15: str
+    """Planet color for Juno (index 15)"""
+
+    planets_color_16: str
+    """Planet color for Vesta (index 16)"""
+
+    planets_color_17: str
+    """Planet color for Pars Fortunae (index 17)"""
+
+    planets_color_18: str
+    """Planet color for Draconic Moon (index 18)"""
+
+    planets_color_19: str
+    """Planet color for additional celestial point (index 19)"""
+
+    planets_color_20: str
+    """Planet color for celestial point (index 20)"""
+
+    planets_color_21: str
+    """Planet color for celestial point (index 21)"""
+
+    planets_color_22: str
+    """Planet color for celestial point (index 22)"""
+
+    planets_color_23: str
+    """Planet color for celestial point (index 23)"""
+
+    planets_color_24: str
+    """Planet color for celestial point (index 24)"""
+
+    planets_color_25: str
+    """Planet color for celestial point (index 25)"""
+
+    planets_color_26: str
+    """Planet color for celestial point (index 26)"""
+
+    planets_color_27: str
+    """Planet color for celestial point (index 27)"""
+
+    planets_color_28: str
+    """Planet color for celestial point (index 28)"""
+
+    planets_color_29: str
+    """Planet color for celestial point (index 29)"""
+
+    planets_color_30: str
+    """Planet color for celestial point (index 30)"""
+
+    planets_color_31: str
+    """Planet color for celestial point (index 31)"""
+
+    planets_color_32: str
+    """Planet color for celestial point (index 32)"""
+
+    planets_color_33: str
+    """Planet color for celestial point (index 33)"""
+
+    planets_color_34: str
+    """Planet color for celestial point (index 34)"""
+
+    planets_color_35: str
+    """Planet color for celestial point (index 35)"""
+
+    planets_color_36: str
+    """Planet color for celestial point (index 36)"""
+
+    planets_color_37: str
+    """Planet color for celestial point (index 37)"""
+
+    planets_color_38: str
+    """Planet color for celestial point (index 38)"""
+
+    planets_color_39: str
+    """Planet color for celestial point (index 39)"""
+
+    planets_color_40: str
+    """Planet color for celestial point (index 40)"""
+
+    planets_color_41: str
+    """Planet color for celestial point (index 41)"""
+
+    zodiac_color_0: str
+    """Zodiac color for Aries (index 0)"""
+
+    zodiac_color_1: str
+    """Zodiac color for Taurus (index 1)"""
+
+    zodiac_color_2: str
+    """Zodiac color for Gemini (index 2)"""
+
+    zodiac_color_3: str
+    """Zodiac color for Cancer (index 3)"""
+
+    zodiac_color_4: str
+    """Zodiac color for Leo (index 4)"""
+
+    zodiac_color_5: str
+    """Zodiac color for Virgo (index 5)"""
+
+    zodiac_color_6: str
+    """Zodiac color for Libra (index 6)"""
+
+    zodiac_color_7: str
+    """Zodiac color for Scorpio (index 7)"""
+
+    zodiac_color_8: str
+    """Zodiac color for Sagittarius (index 8)"""
+
+    zodiac_color_9: str
+    """Zodiac color for Capricorn (index 9)"""
+
+    zodiac_color_10: str
+    """Zodiac color for Aquarius (index 10)"""
+
+    zodiac_color_11: str
+    """Zodiac color for Pisces (index 11)"""
+
+    orb_color_0: str
+    """Aspect color for conjunction (0°)"""
+
+    orb_color_30: str
+    """Aspect color for semi-sextile (30°)"""
+
+    orb_color_45: str
+    """Aspect color for semi-square (45°)"""
+
+    orb_color_60: str
+    """Aspect color for sextile (60°)"""
+
+    orb_color_72: str
+    """Aspect color for quintile (72°)"""
+
+    orb_color_90: str
+    """Aspect color for square (90°)"""
+
+    orb_color_120: str
+    """Aspect color for trine (120°)"""
+
+    orb_color_135: str
+    """Aspect color for sesqui-quadrate (135°)"""
+
+    orb_color_144: str
+    """Aspect color for bi-quintile (144°)"""
+
+    orb_color_150: str
+    """Aspect color for quincunx (150°)"""
+
+    orb_color_180: str
+    """Aspect color for opposition (180°)"""
+
+    makeZodiac: str
+    """SVG markup for zodiac signs"""
+
+    makeHouses: str
+    """SVG markup for houses"""
+
+    makePlanets: str
+    """SVG markup for planets"""
+
+    makeMainPlanetGrid: str
+    """SVG markup for main planet grid"""
+
+    makeSecondaryPlanetGrid: str
+    """SVG markup for secondary planet grid"""
+
+    makeMainHousesGrid: str
+    """SVG markup for main houses grid"""
+
+    makeSecondaryHousesGrid: str
+    """SVG markup for secondary houses grid"""
+
+    color_style_tag: str
+    """CSS color style tag"""
+
+    elements_string: str
+    """Elements header string"""
+
+    fire_string: str
+    """Fire element string with percentage"""
+
+    earth_string: str
+    """Earth element string with percentage"""
+
+    air_string: str
+    """Air element string with percentage"""
+
+    water_string: str
+    """Water element string with percentage"""
+
+    qualities_string: str
+    """Qualities header string"""
+
+    cardinal_string: str
+    """Cardinal quality string with percentage"""
+
+    fixed_string: str
+    """Fixed quality string with percentage"""
+
+    mutable_string: str
+    """Mutable quality string with percentage"""
+
+    makeLunarPhase: str
+    """SVG markup for lunar phase"""

kerykeion/schemas/kerykeion_exception.py

@@ -0,0 +1,20 @@
+# -*- coding: utf-8 -*-
+"""
+    This is part of Kerykeion (C) 2025 Giacomo Battaglia
+"""
+
+
+class KerykeionException(Exception):
+    """
+    Custom Kerykeion Exception
+    """
+
+    def __init__(self, message):
+        """
+        Initialize a new KerykeionException.
+
+        Args:
+            message: The error message to be displayed.
+        """
+        # Call the base class constructor with the parameters it needs
+        super().__init__(message)

kerykeion/schemas/kr_literals.py

@@ -0,0 +1,181 @@
+# -*- coding: utf-8 -*-
+"""
+This is part of Kerykeion (C) 2025 Giacomo Battaglia
+"""
+from typing import Literal
+
+
+ZodiacType = Literal["Tropical", "Sidereal"]
+"""Literal type for Zodiac Types"""
+
+
+Sign = Literal["Ari", "Tau", "Gem", "Can", "Leo", "Vir", "Lib", "Sco", "Sag", "Cap", "Aqu", "Pis"]
+"""Literal type for Zodiac Signs"""
+
+
+SignNumbers = Literal[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]
+"""Literal type for Zodiac Sign Numbers, the signs are numbered in order starting from Aries (0) to Pis (11)"""
+
+
+AspectMovementType = Literal["Applying", "Separating", "Exact"]
+"""Literal type for Aspect Movement: Applying (planets moving toward exact aspect), Separating (planets moving away), or Exact (within tight orb)"""
+
+
+Houses = Literal["First_House", "Second_House", "Third_House", "Fourth_House", "Fifth_House", "Sixth_House", "Seventh_House", "Eighth_House", "Ninth_House", "Tenth_House", "Eleventh_House", "Twelfth_House"]
+"""Literal type for Houses"""
+
+
+HouseNumbers = Literal[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]
+"""Literal type for House Numbers, starting from the First House (1) to the Twelfth House (12)"""
+
+
+AstrologicalPoint = Literal[
+    # Main Planets
+    "Sun", "Moon", "Mercury", "Venus", "Mars", "Jupiter", "Saturn", "Uranus", "Neptune", "Pluto",
+
+    # Lunar Nodes
+    "Mean_North_Lunar_Node", "True_North_Lunar_Node", "Mean_South_Lunar_Node", "True_South_Lunar_Node",
+
+    # Special Points
+    "Chiron", "Mean_Lilith", "True_Lilith", "Earth", "Pholus",
+
+    # Asteroids
+    "Ceres", "Pallas", "Juno", "Vesta",
+
+    # Trans-Neptunian Objects
+    "Eris", "Sedna", "Haumea", "Makemake", "Ixion", "Orcus", "Quaoar",
+
+    # Fixed Stars
+    "Regulus", "Spica",
+
+    # Arabic Parts
+    "Pars_Fortunae", "Pars_Spiritus", "Pars_Amoris", "Pars_Fidei",
+
+    # Special Points
+    "Vertex", "Anti_Vertex",
+
+    # Axial Cusps
+    "Ascendant", "Medium_Coeli", "Descendant", "Imum_Coeli",
+]
+
+"""Literal type for Axial Cusps"""
+
+
+Element = Literal["Air", "Fire", "Earth", "Water"]
+"""Literal type for Elements"""
+
+
+Quality = Literal["Cardinal", "Fixed", "Mutable"]
+"""Literal type for Qualities"""
+
+
+ChartType = Literal["Natal", "Synastry", "Transit", "Composite", "DualReturnChart", "SingleReturnChart"]
+"""Literal type for Chart Types"""
+
+
+PointType = Literal["AstrologicalPoint", "House"]
+"""Literal type for Point Types"""
+
+
+LunarPhaseEmoji = Literal["🌑", "🌒", "🌓", "🌔", "🌕", "🌖", "🌗", "🌘"]
+"""Literal type for Lunar Phases Emoji"""
+
+
+LunarPhaseName = Literal["New Moon", "Waxing Crescent", "First Quarter", "Waxing Gibbous", "Full Moon", "Waning Gibbous", "Last Quarter", "Waning Crescent"]
+"""Literal type for Lunar Phases Name"""
+
+
+SiderealMode = Literal["FAGAN_BRADLEY", "LAHIRI", "DELUCE", "RAMAN", "USHASHASHI", "KRISHNAMURTI", "DJWHAL_KHUL", "YUKTESHWAR", "JN_BHASIN", "BABYL_KUGLER1", "BABYL_KUGLER2", "BABYL_KUGLER3", "BABYL_HUBER", "BABYL_ETPSC", "ALDEBARAN_15TAU", "HIPPARCHOS", "SASSANIAN", "J2000", "J1900", "B1950"]
+"""Literal type for Sidereal Modes, as known as Ayanamsa"""
+
+
+HousesSystemIdentifier = Literal["A", "B", "C", "D", "F", "H", "I", "i", "K", "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U", "V", "W", "X", "Y"]
+"""
+Literal type for Houses Systems:
+
+A = equal
+B = Alcabitius
+C = Campanus
+D = equal (MC)
+F = Carter poli-equ.
+H = horizon/azimut
+I = Sunshine
+i = Sunshine/alt.
+K = Koch
+L = Pullen SD
+M = Morinus
+N = equal/1=Aries
+O = Porphyry
+P = Placidus
+Q = Pullen SR
+R = Regiomontanus
+S = Sripati
+T = Polich/Page
+U = Krusinski-Pisa-Goelzer
+V = equal/Vehlow
+W = equal/whole sign
+X = axial rotation system/Meridian houses
+Y = APC houses
+
+Usually the standard is Placidus (P)
+"""
+
+
+PerspectiveType = Literal["Apparent Geocentric", "Heliocentric", "Topocentric", "True Geocentric"]
+"""
+Literal type for perspective types.
+- "Apparent Geocentric": Earth-centered, apparent positions.
+- "Heliocentric": Sun-centered.
+- "Topocentric": Observer's location on Earth's surface.
+- "True Geocentric": Earth-centered, true positions.
+
+Usually the standard is "Apparent Geocentric"
+"""
+
+
+SignsEmoji = Literal["♈️", "♉️", "♊️", "♋️", "♌️", "♍️", "♎️", "♏️", "♐️", "♑️", "♒️", "♓️"]
+"""Literal type for Zodiac Signs Emoji"""
+
+KerykeionChartTheme = Literal["light", "dark", "dark-high-contrast", "classic", "strawberry", "black-and-white"]
+"""Literal type for Kerykeion Chart Themes"""
+
+
+KerykeionChartLanguage = Literal["EN", "FR", "PT", "IT", "CN", "ES", "RU", "TR", "DE", "HI"]
+"""Literal type for Kerykeion Chart Languages"""
+
+
+RelationshipScoreDescription = Literal["Minimal", "Medium", "Important", "Very Important", "Exceptional", "Rare Exceptional"]
+"""Literal type for Relationship Score Description"""
+
+
+CompositeChartType = Literal["Midpoint"]
+"""Literal type for Composite Chart Types"""
+
+AspectName = Literal[
+    "conjunction",
+    "semi-sextile",
+    "semi-square",
+    "sextile",
+    "quintile",
+    "square",
+    "trine",
+    "sesquiquadrate",
+    "biquintile",
+    "quincunx",
+    "opposition"
+]
+"""Literal type for all the available aspects names"""
+
+ReturnType = Literal["Lunar", "Solar"]
+"""Literal type for Return Types"""
+
+
+# ---------------------------------------------------------------------------
+# Deprecated aliases for backward compatibility with Kerykeion v4.x
+# ---------------------------------------------------------------------------
+# These will be removed in v6.0 - migrate to AstrologicalPoint
+Planet = AstrologicalPoint
+"""DEPRECATED: Use AstrologicalPoint instead. This alias will be removed in v6.0."""
+
+AxialCusps = AstrologicalPoint
+"""DEPRECATED: Use AstrologicalPoint instead. This alias will be removed in v6.0."""