kerykeion 5.0.0a9__py3-none-any.whl → 5.1.8__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of kerykeion might be problematic. Click here for more details.

Files changed (79) hide show
  1. kerykeion/__init__.py +50 -9
  2. kerykeion/aspects/__init__.py +5 -2
  3. kerykeion/aspects/aspects_factory.py +568 -0
  4. kerykeion/aspects/aspects_utils.py +78 -11
  5. kerykeion/astrological_subject_factory.py +1032 -275
  6. kerykeion/backword.py +820 -0
  7. kerykeion/chart_data_factory.py +552 -0
  8. kerykeion/charts/chart_drawer.py +2661 -0
  9. kerykeion/charts/charts_utils.py +652 -399
  10. kerykeion/charts/draw_planets.py +603 -353
  11. kerykeion/charts/templates/aspect_grid_only.xml +326 -198
  12. kerykeion/charts/templates/chart.xml +306 -256
  13. kerykeion/charts/templates/wheel_only.xml +330 -200
  14. kerykeion/charts/themes/black-and-white.css +148 -0
  15. kerykeion/charts/themes/classic.css +11 -0
  16. kerykeion/charts/themes/dark-high-contrast.css +11 -0
  17. kerykeion/charts/themes/dark.css +11 -0
  18. kerykeion/charts/themes/light.css +11 -0
  19. kerykeion/charts/themes/strawberry.css +10 -0
  20. kerykeion/composite_subject_factory.py +232 -13
  21. kerykeion/ephemeris_data_factory.py +443 -0
  22. kerykeion/fetch_geonames.py +78 -21
  23. kerykeion/house_comparison/__init__.py +4 -1
  24. kerykeion/house_comparison/house_comparison_factory.py +52 -19
  25. kerykeion/house_comparison/house_comparison_utils.py +37 -9
  26. kerykeion/kr_types/__init__.py +66 -6
  27. kerykeion/kr_types/chart_template_model.py +20 -0
  28. kerykeion/kr_types/kerykeion_exception.py +15 -9
  29. kerykeion/kr_types/kr_literals.py +14 -160
  30. kerykeion/kr_types/kr_models.py +14 -291
  31. kerykeion/kr_types/settings_models.py +15 -167
  32. kerykeion/planetary_return_factory.py +545 -40
  33. kerykeion/relationship_score_factory.py +137 -63
  34. kerykeion/report.py +749 -64
  35. kerykeion/schemas/__init__.py +106 -0
  36. kerykeion/schemas/chart_template_model.py +367 -0
  37. kerykeion/schemas/kerykeion_exception.py +20 -0
  38. kerykeion/schemas/kr_literals.py +181 -0
  39. kerykeion/schemas/kr_models.py +603 -0
  40. kerykeion/schemas/settings_models.py +188 -0
  41. kerykeion/settings/__init__.py +20 -1
  42. kerykeion/settings/chart_defaults.py +444 -0
  43. kerykeion/settings/config_constants.py +88 -12
  44. kerykeion/settings/kerykeion_settings.py +32 -75
  45. kerykeion/settings/translation_strings.py +1499 -0
  46. kerykeion/settings/translations.py +74 -0
  47. kerykeion/sweph/ast136/s136108s.se1 +0 -0
  48. kerykeion/sweph/ast136/s136199s.se1 +0 -0
  49. kerykeion/sweph/ast136/s136472s.se1 +0 -0
  50. kerykeion/sweph/ast28/se28978s.se1 +0 -0
  51. kerykeion/sweph/ast50/se50000s.se1 +0 -0
  52. kerykeion/sweph/ast90/se90377s.se1 +0 -0
  53. kerykeion/sweph/ast90/se90482s.se1 +0 -0
  54. kerykeion/sweph/sefstars.txt +1602 -0
  55. kerykeion/transits_time_range_factory.py +302 -0
  56. kerykeion/utilities.py +289 -204
  57. kerykeion-5.1.8.dist-info/METADATA +1793 -0
  58. kerykeion-5.1.8.dist-info/RECORD +63 -0
  59. kerykeion/aspects/natal_aspects.py +0 -181
  60. kerykeion/aspects/synastry_aspects.py +0 -141
  61. kerykeion/aspects/transits_time_range.py +0 -41
  62. kerykeion/charts/draw_planets_v2.py +0 -649
  63. kerykeion/charts/draw_planets_v3.py +0 -679
  64. kerykeion/charts/kerykeion_chart_svg.py +0 -2038
  65. kerykeion/enums.py +0 -57
  66. kerykeion/ephemeris_data.py +0 -238
  67. kerykeion/house_comparison/house_comparison_models.py +0 -38
  68. kerykeion/kr_types/chart_types.py +0 -106
  69. kerykeion/settings/kr.config.json +0 -1304
  70. kerykeion/settings/legacy/__init__.py +0 -0
  71. kerykeion/settings/legacy/legacy_celestial_points_settings.py +0 -299
  72. kerykeion/settings/legacy/legacy_chart_aspects_settings.py +0 -71
  73. kerykeion/settings/legacy/legacy_color_settings.py +0 -42
  74. kerykeion/transits_time_range.py +0 -128
  75. kerykeion-5.0.0a9.dist-info/METADATA +0 -636
  76. kerykeion-5.0.0a9.dist-info/RECORD +0 -55
  77. kerykeion-5.0.0a9.dist-info/entry_points.txt +0 -2
  78. {kerykeion-5.0.0a9.dist-info → kerykeion-5.1.8.dist-info}/WHEEL +0 -0
  79. {kerykeion-5.0.0a9.dist-info → kerykeion-5.1.8.dist-info}/licenses/LICENSE +0 -0
kerykeion/enums.py DELETED
@@ -1,57 +0,0 @@
1
- from enum import Enum
2
-
3
-
4
- class Planets(Enum):
5
- SUN = "Sun"
6
- MOON = "Moon"
7
- MERCURY = "Mercury"
8
- VENUS = "Venus"
9
- MARS = "Mars"
10
- JUPITER = "Jupiter"
11
- SATURN = "Saturn"
12
- URANUS = "Uranus"
13
- NEPTUNE = "Neptune"
14
- PLUTO = "Pluto"
15
- CHIRON = "Chiron"
16
- TRUE_NODE = "True_Node"
17
- MEAN_NODE = "Mean_Node"
18
- TRUE_SOUTH_NODE = "True_South_Node"
19
- MEAN_SOUTH_NODE = "Mean_South_Node"
20
- MEAN_LILITH = "Mean_Lilith"
21
- ASCENDANT = "Ascendant"
22
- DESCENDANT = "Descendant"
23
- MEDIUM_COELI = "Medium_Coeli"
24
- IMUM_COELI = "Imum_Coeli"
25
-
26
-
27
- class Aspects(Enum):
28
- CONJUNCTION = "Conjunction"
29
- SEXTILE = "Sextile"
30
- SEMI_SEXTILE = "Semi-Sextile"
31
- SQUARE = "Square"
32
- TRINE = "Trine"
33
- OPPOSITION = "Opposition"
34
- QUINCUNX = "Quincunx"
35
- NONE = None
36
- QUINTILE = "Quintile"
37
- BIQUINTILE = "Biquintile"
38
- OCTILE = "Octile"
39
- TRIOCTILE = "Trioctile"
40
- DECILE = "Decile"
41
- TRIDECILE = "Tridecile"
42
- SESQUIQUADRATE = "Sesquiquadrate"
43
-
44
-
45
- class Signs(Enum):
46
- ARI = "Ari"
47
- TAU = "Tau"
48
- GEM = "Gem"
49
- CAN = "Can"
50
- LEO = "Leo"
51
- VIR = "Vir"
52
- LIB = "Lib"
53
- SCO = "Sco"
54
- SAG = "Sag"
55
- CAP = "Cap"
56
- AQU = "Aqu"
57
- PIS = "Pis"
@@ -1,238 +0,0 @@
1
- from kerykeion import AstrologicalSubjectFactory
2
- from kerykeion.kr_types.kr_models import AstrologicalSubjectModel
3
- from kerykeion.utilities import get_houses_list, get_available_astrological_points_list
4
- from kerykeion.astrological_subject_factory import DEFAULT_HOUSES_SYSTEM_IDENTIFIER, DEFAULT_PERSPECTIVE_TYPE, DEFAULT_ZODIAC_TYPE
5
- from kerykeion.kr_types import EphemerisDictModel
6
- from kerykeion.kr_types import SiderealMode, HousesSystemIdentifier, PerspectiveType, ZodiacType
7
- from datetime import datetime, timedelta
8
- from typing import Literal, Union, List
9
- import logging
10
-
11
-
12
- class EphemerisDataFactory:
13
- """
14
- This class is used to generate ephemeris data for a given date range.
15
-
16
- Parameters:
17
- - start_datetime: datetime object representing the start date and time.
18
- - end_datetime: datetime object representing the end date and time.
19
- - step_type: string representing the step type. It can be "days", "hours", or "minutes". Default is "days".
20
- - step: integer representing the step value. Default is 1.
21
- - lat: float representing the latitude. Default is 51.4769 (Greenwich).
22
- - lng: float representing the longitude. Default is 0.0005 (Greenwich).
23
- - tz_str: string representing the timezone. Default is "Etc/UTC".
24
- - is_dst: boolean representing if daylight saving time is active. Default is False.
25
- - zodiac_type: ZodiacType object representing the zodiac type. Default is DEFAULT_ZODIAC_TYPE.
26
- - sidereal_mode: SiderealMode object representing the sidereal mode. Default is None.
27
- - houses_system_identifier: HousesSystemIdentifier object representing the houses system identifier. Default is DEFAULT_HOUSES_SYSTEM_IDENTIFIER.
28
- - perspective_type: PerspectiveType object representing the perspective type. Default is DEFAULT_PERSPECTIVE_TYPE.
29
- - max_days: integer representing the maximum number of days.
30
- Set it to None to disable the check. Default is 730.
31
- - max_hours: integer representing the maximum number of hours.
32
- Set it to None to disable the check. Default is 8760.
33
- - max_minutes: integer representing the maximum number of minutes.
34
- Set it to None to disable the check. Default is 525600.
35
-
36
- Raises:
37
- - ValueError: if the step type is invalid.
38
- - ValueError: if the number of days, hours, or minutes is greater than the maximum allowed.
39
- """
40
-
41
- def __init__(
42
- self,
43
- start_datetime: datetime,
44
- end_datetime: datetime,
45
- step_type: Literal["days", "hours", "minutes"] = "days",
46
- step: int = 1,
47
- lat: float = 51.4769,
48
- lng: float = 0.0005,
49
- tz_str: str = "Etc/UTC",
50
- is_dst: bool = False,
51
- zodiac_type: ZodiacType = DEFAULT_ZODIAC_TYPE,
52
- sidereal_mode: Union[SiderealMode, None] = None,
53
- houses_system_identifier: HousesSystemIdentifier = DEFAULT_HOUSES_SYSTEM_IDENTIFIER,
54
- perspective_type: PerspectiveType = DEFAULT_PERSPECTIVE_TYPE,
55
- max_days: Union[int, None] = 730,
56
- max_hours: Union[int, None] = 8760,
57
- max_minutes: Union[int, None] = 525600,
58
- ):
59
- self.start_datetime = start_datetime
60
- self.end_datetime = end_datetime
61
- self.step_type = step_type
62
- self.step = step
63
- self.lat = lat
64
- self.lng = lng
65
- self.tz_str = tz_str
66
- self.is_dst = is_dst
67
- self.zodiac_type = zodiac_type
68
- self.sidereal_mode = sidereal_mode
69
- self.houses_system_identifier = houses_system_identifier
70
- self.perspective_type = perspective_type
71
- self.max_days = max_days
72
- self.max_hours = max_hours
73
- self.max_minutes = max_minutes
74
-
75
- self.dates_list = []
76
- if self.step_type == "days":
77
- self.dates_list = [self.start_datetime + timedelta(days=i * self.step) for i in range((self.end_datetime - self.start_datetime).days // self.step + 1)]
78
- if max_days and (len(self.dates_list) > max_days):
79
- raise ValueError(f"Too many days: {len(self.dates_list)} > {self.max_days}. To prevent this error, set max_days to a higher value or reduce the date range.")
80
-
81
- elif self.step_type == "hours":
82
- hours_diff = (self.end_datetime - self.start_datetime).total_seconds() / 3600
83
- self.dates_list = [self.start_datetime + timedelta(hours=i * self.step) for i in range(int(hours_diff) // self.step + 1)]
84
- if max_hours and (len(self.dates_list) > max_hours):
85
- raise ValueError(f"Too many hours: {len(self.dates_list)} > {self.max_hours}. To prevent this error, set max_hours to a higher value or reduce the date range.")
86
-
87
- elif self.step_type == "minutes":
88
- minutes_diff = (self.end_datetime - self.start_datetime).total_seconds() / 60
89
- self.dates_list = [self.start_datetime + timedelta(minutes=i * self.step) for i in range(int(minutes_diff) // self.step + 1)]
90
- if max_minutes and (len(self.dates_list) > max_minutes):
91
- raise ValueError(f"Too many minutes: {len(self.dates_list)} > {self.max_minutes}. To prevent this error, set max_minutes to a higher value or reduce the date range.")
92
-
93
- else:
94
- raise ValueError(f"Invalid step type: {self.step_type}")
95
-
96
- if not self.dates_list:
97
- raise ValueError("No dates found. Check the date range and step values.")
98
-
99
- if len(self.dates_list) > 1000:
100
- logging.warning(f"Large number of dates: {len(self.dates_list)}. The calculation may take a while.")
101
-
102
- def get_ephemeris_data(self, as_model: bool = False) -> list:
103
- """
104
- Generate ephemeris data for the specified date range.
105
- The data is structured as a list of dictionaries, where each dictionary contains the date, planets, and houses data.
106
- Example:
107
- [
108
- {
109
- "date": "2020-01-01T00:00:00",
110
- "planets": [{...}, {...}, ...],
111
- "houses": [{...}, {...}, ...]
112
- },
113
- ...
114
- ]
115
-
116
- Args:
117
- - as_model (bool): If True, the ephemeris data will be returned as model instances. Default is False.
118
-
119
- Returns:
120
- - list: A list of dictionaries representing the ephemeris data. If as_model is True, a list of EphemerisDictModel instances is returned.
121
- """
122
- ephemeris_data_list = []
123
- for date in self.dates_list:
124
- subject = AstrologicalSubjectFactory.from_birth_data(
125
- year=date.year,
126
- month=date.month,
127
- day=date.day,
128
- hour=date.hour,
129
- minute=date.minute,
130
- lng=self.lng,
131
- lat=self.lat,
132
- tz_str=self.tz_str,
133
- city="Placeholder",
134
- nation="Placeholder",
135
- online=False,
136
- zodiac_type=self.zodiac_type,
137
- sidereal_mode=self.sidereal_mode,
138
- houses_system_identifier=self.houses_system_identifier,
139
- perspective_type=self.perspective_type,
140
- is_dst=self.is_dst,
141
- )
142
-
143
- houses_list = get_houses_list(subject)
144
- available_planets = get_available_astrological_points_list(subject)
145
-
146
- ephemeris_data_list.append({"date": date.isoformat(), "planets": available_planets, "houses": houses_list})
147
-
148
- if as_model:
149
- return [EphemerisDictModel(**data) for data in ephemeris_data_list]
150
-
151
- return ephemeris_data_list
152
-
153
- def get_ephemeris_data_as_astrological_subjects(self, as_model: bool = False) -> List[AstrologicalSubjectModel]:
154
- """
155
- Generate ephemeris data for the specified date range as AstrologicalSubject instances.
156
-
157
- This method creates a complete AstrologicalSubject object for each date in the date range,
158
- allowing direct access to all properties and methods of the AstrologicalSubject class.
159
-
160
- Args:
161
- - as_model (bool): If True, the AstrologicalSubject instances will be returned as model instances. Default is False.
162
-
163
- Returns:
164
- - List[AstrologicalSubject]: A list of AstrologicalSubject instances, one for each date in the date range.
165
-
166
- Example usage:
167
- subjects = factory.get_ephemeris_data_as_astrological_subjects()
168
- # Access methods and properties of the first subject
169
- sun_position = subjects[0].get_sun()
170
- all_points = subjects[0].get_all_points()
171
- chart_drawing = subjects[0].draw_chart()
172
- """
173
- subjects_list = []
174
- for date in self.dates_list:
175
- subject = AstrologicalSubjectFactory.from_birth_data(
176
- year=date.year,
177
- month=date.month,
178
- day=date.day,
179
- hour=date.hour,
180
- minute=date.minute,
181
- lng=self.lng,
182
- lat=self.lat,
183
- tz_str=self.tz_str,
184
- city="Placeholder",
185
- nation="Placeholder",
186
- online=False,
187
- zodiac_type=self.zodiac_type,
188
- sidereal_mode=self.sidereal_mode,
189
- houses_system_identifier=self.houses_system_identifier,
190
- perspective_type=self.perspective_type,
191
- is_dst=self.is_dst,
192
- )
193
-
194
- if as_model:
195
- subjects_list.append(subject.model())
196
- else:
197
- subjects_list.append(subject)
198
-
199
- return subjects_list
200
-
201
-
202
- if "__main__" == __name__:
203
- start_date = datetime.fromisoformat("2020-01-01")
204
- end_date = datetime.fromisoformat("2020-01-03")
205
-
206
- factory = EphemerisDataFactory(
207
- start_datetime=start_date,
208
- end_datetime=end_date,
209
- step_type="minutes",
210
- step=60, # One hour intervals to make the example more manageable
211
- lat=37.9838,
212
- lng=23.7275,
213
- tz_str="Europe/Athens",
214
- is_dst=False,
215
- max_hours=None,
216
- max_minutes=None,
217
- max_days=None,
218
- )
219
-
220
- # Test original method
221
- ephemeris_data = factory.get_ephemeris_data(as_model=True)
222
- print(f"Number of ephemeris data points: {len(ephemeris_data)}")
223
- print(f"First data point date: {ephemeris_data[0].date}")
224
-
225
- # Test new method
226
- subjects = factory.get_ephemeris_data_as_astrological_subjects()
227
- print(f"Number of astrological subjects: {len(subjects)}")
228
- print(f"First subject sun position: {subjects[0].sun}")
229
-
230
- # Example of accessing more data from the first subject
231
- first_subject = subjects[0]
232
- print(f"Sun sign: {first_subject.sun['sign']}")
233
-
234
- # Compare sun positions from both methods
235
- for i in range(min(3, len(subjects))):
236
- print(f"Date: {ephemeris_data[i].date}")
237
- print(f"Sun position from dict: {ephemeris_data[i].planets[0]['abs_pos']}")
238
- print("---")
@@ -1,38 +0,0 @@
1
- from kerykeion.kr_types import SubscriptableBaseModel
2
- from typing import Optional
3
-
4
-
5
- class PointInHouseModel(SubscriptableBaseModel):
6
- """Represents a point from one chart positioned in a house from another chart"""
7
-
8
- point_name: str
9
- """Name of the celestial point"""
10
- point_degree: float
11
- """Degree of the celestial point"""
12
- point_sign: str
13
- """Sign of the celestial point"""
14
- point_owner_name: str
15
- """Name of the owner of the celestial point"""
16
- point_owner_house_number: Optional[int]
17
- """House number of the point of the owner of the celestial point"""
18
- point_owner_house_name: Optional[str]
19
- """House name of the point of the owner of the celestial point"""
20
- projected_house_number: int
21
- """Number of the house where the point is projected"""
22
- projected_house_name: str
23
- """Name of the house where the point is projected"""
24
- projected_house_owner_name: str
25
- """Name of the owner of the house where the point is projected"""
26
-
27
-
28
- class HouseComparisonModel(SubscriptableBaseModel):
29
- """Pydantic model for comparing points in houses between two astrological subjects"""
30
-
31
- first_subject_name: str
32
- """Name of the first subject"""
33
- second_subject_name: str
34
- """Name of the second subject"""
35
- first_points_in_second_houses: list[PointInHouseModel]
36
- """List of points from the first subject in the houses of the second subject"""
37
- second_points_in_first_houses: list[PointInHouseModel]
38
- """List of points from the second subject in the houses of the first subject"""
@@ -1,106 +0,0 @@
1
- from typing_extensions import TypedDict
2
-
3
-
4
- class ChartTemplateDictionary(TypedDict):
5
- transitRing: str
6
- degreeRing: str
7
- background_circle: str
8
- first_circle: str
9
- second_circle: str
10
- third_circle: str
11
- makeAspects: str
12
- makeAspectGrid: str
13
- makeDoubleChartAspectList: str
14
- makeHouseComparisonGrid: str
15
- chart_height: float
16
- chart_width: float
17
- viewbox: str
18
- stringTitle: str
19
- top_left_0: str
20
- bottom_left_0: str
21
- bottom_left_1: str
22
- bottom_left_2: str
23
- bottom_left_3: str
24
- bottom_left_4: str
25
- top_left_1: str
26
- top_left_2: str
27
- top_left_3: str
28
- top_left_4: str
29
- top_left_5: str
30
-
31
- # Font color
32
- paper_color_0: str
33
- # Background color of the chart
34
- paper_color_1: str
35
- # Dynamic background color (can be transparent or theme color)
36
- background_color: str
37
-
38
- # Planets colors, from 0 to 16 (0 is the Sun)
39
- planets_color_0: str
40
- planets_color_1: str
41
- planets_color_2: str
42
- planets_color_3: str
43
- planets_color_4: str
44
- planets_color_5: str
45
- planets_color_6: str
46
- planets_color_7: str
47
- planets_color_8: str
48
- planets_color_9: str
49
- planets_color_10: str
50
- planets_color_11: str
51
- planets_color_12: str
52
- planets_color_13: str
53
- planets_color_14: str
54
- planets_color_15: str
55
- planets_color_16: str
56
-
57
- # Zodiac colors, from 0 to 11 (0 is Aries)
58
- zodiac_color_0: str
59
- zodiac_color_1: str
60
- zodiac_color_2: str
61
- zodiac_color_3: str
62
- zodiac_color_4: str
63
- zodiac_color_5: str
64
- zodiac_color_6: str
65
- zodiac_color_7: str
66
- zodiac_color_8: str
67
- zodiac_color_9: str
68
- zodiac_color_10: str
69
- zodiac_color_11: str
70
-
71
- # Aspects colors, from 0 to 9 (0 is conjunction)
72
- orb_color_0: str
73
- orb_color_30: str
74
- orb_color_45: str
75
- orb_color_60: str
76
- orb_color_72: str
77
- orb_color_90: str
78
- orb_color_120: str
79
- orb_color_135: str
80
- orb_color_144: str
81
- orb_color_150: str
82
- orb_color_180: str
83
-
84
- cfgTranslate: str
85
- makeZodiac: str
86
- makeHouses: str
87
- makePlanets: str
88
- makeMainPlanetGrid: str
89
- makeSecondaryPlanetGrid: str
90
- makeMainHousesGrid: str
91
- makeSecondaryHousesGrid: str
92
-
93
- color_style_tag: str
94
-
95
- element_string: str
96
- fire_string: str
97
- earth_string: str
98
- air_string: str
99
- water_string: str
100
-
101
- quality_string: str
102
- cardinal_string: str
103
- fixed_string: str
104
- mutable_string: str
105
-
106
- makeLunarPhase: str