kerykeion 4.16.4__py3-none-any.whl → 4.17.0__py3-none-any.whl

kerykeion/aspects/natal_aspects.py

@@ -12,6 +12,7 @@ from dataclasses import dataclass
 from functools import cached_property
 from kerykeion.aspects.aspects_utils import planet_id_decoder, get_aspect_from_two_points, get_active_points_list
 from kerykeion.kr_types.kr_models import AstrologicalSubjectModel
+from kerykeion.kr_types.settings_models import KerykeionSettingsModel
 
 
 AXES_LIST = [
@@ -29,7 +30,7 @@ class NatalAspects:
     """
 
     user: Union[AstrologicalSubject, AstrologicalSubjectModel]
-    new_settings_file: Union[Path, None] = None
+    new_settings_file: Union[Path, KerykeionSettingsModel, dict, None] = None
 
     def __post_init__(self):
         self.settings = get_settings(self.new_settings_file)

kerykeion/aspects/synastry_aspects.py

@@ -12,6 +12,7 @@ from kerykeion.aspects.natal_aspects import NatalAspects
 from kerykeion.settings.kerykeion_settings import get_settings
 from kerykeion.aspects.aspects_utils import planet_id_decoder, get_aspect_from_two_points, get_active_points_list
 from kerykeion.kr_types.kr_models import AstrologicalSubjectModel
+from kerykeion.kr_types.settings_models import KerykeionSettingsModel
 from typing import Union
 
 
@@ -24,7 +25,7 @@ class SynastryAspects(NatalAspects):
         self,
         kr_object_one: Union[AstrologicalSubject, AstrologicalSubjectModel],
         kr_object_two: Union[AstrologicalSubject, AstrologicalSubjectModel],
-        new_settings_file: Union[Path, None] = None,
+        new_settings_file: Union[Path, KerykeionSettingsModel, dict, None] = None
     ):
         # Subjects
         self.first_user = kr_object_one

kerykeion/charts/kerykeion_chart_svg.py

@@ -14,7 +14,7 @@ from kerykeion.astrological_subject import AstrologicalSubject
 from kerykeion.kr_types import KerykeionException, ChartType, KerykeionPointModel, Sign
 from kerykeion.kr_types import ChartTemplateDictionary
 from kerykeion.kr_types.kr_models import AstrologicalSubjectModel
-from kerykeion.kr_types.settings_models import KerykeionSettingsCelestialPointModel
+from kerykeion.kr_types.settings_models import KerykeionSettingsCelestialPointModel, KerykeionSettingsModel
 from kerykeion.kr_types.kr_literals import KerykeionChartTheme
 from kerykeion.charts.charts_utils import (
     draw_zodiac_slice, 
@@ -59,6 +59,8 @@ class KerykeionChartSVG:
             In the settings file you can set the language, colors, planets, aspects, etc.
         - theme: Set the theme for the chart (default: classic). If None the <style> tag will be empty.
             That's useful if you want to use your own CSS file customizing the value of the default theme variables.
+        - double_chart_aspect_grid_type: Set the type of the aspect grid for the double chart (transit or synastry). (Default: list.)
+        - chart_language: Set the language for the chart (default: EN).
     """
     
     # Constants
@@ -71,7 +73,7 @@ class KerykeionChartSVG:
     second_obj: Union[AstrologicalSubject, AstrologicalSubjectModel, None]
     chart_type: ChartType
     new_output_directory: Union[Path, None]
-    new_settings_file: Union[Path, None]
+    new_settings_file: Union[Path, None, KerykeionSettingsModel, dict]
     output_directory: Path
 
     # Internal properties
@@ -105,13 +107,15 @@ class KerykeionChartSVG:
         chart_type: ChartType = "Natal",
         second_obj: Union[AstrologicalSubject, AstrologicalSubjectModel, None] = None,
         new_output_directory: Union[str, None] = None,
-        new_settings_file: Union[Path, None] = None,
+        new_settings_file: Union[Path, None, KerykeionSettingsModel, dict] = None,
         theme: Union[KerykeionChartTheme, None] = "classic",
-        double_chart_aspect_grid_type: Literal["list", "table"] = "list"
+        double_chart_aspect_grid_type: Literal["list", "table"] = "list",
+        chart_language: str = "EN",
     ):
         # Directories:
         self.homedir = Path.home()
         self.new_settings_file = new_settings_file
+        self.chart_language = chart_language
 
         if new_output_directory:
             self.output_directory = Path(new_output_directory)
@@ -221,14 +225,13 @@ class KerykeionChartSVG:
         self.output_directory = dir_path
         logging.info(f"Output direcotry set to: {self.output_directory}")
 
-    def parse_json_settings(self, settings_file):
+    def parse_json_settings(self, settings_file_or_dict: Union[Path, dict, KerykeionSettingsModel, None]) -> None:
         """
         Parse the settings file.
         """
-        settings = get_settings(settings_file)
+        settings = get_settings(settings_file_or_dict)
 
-        language = settings["general_settings"]["language"]
-        self.language_settings = settings["language_settings"].get(language, "EN")
+        self.language_settings = settings["language_settings"][self.chart_language]
         self.chart_colors_settings = settings["chart_colors"]
         self.planets_settings = settings["celestial_points"]
         self.aspects_settings = settings["aspects"]
@@ -572,7 +575,7 @@ class KerykeionChartSVG:
 
         # Set date time string
         dt = datetime.fromisoformat(self.user.iso_formatted_local_datetime)
-        custom_format = dt.strftime('%Y-%-m-%-d %H:%M [%z]')  # Note the use of '-' to remove leading zeros
+        custom_format = dt.strftime('%Y-%m-%d %H:%M [%z]')
         custom_format = custom_format[:-3] + ':' + custom_format[-3:]
         template_dict["stringDateTime"] = f"{custom_format}"
 
@@ -845,4 +848,44 @@ if __name__ == "__main__":
     # Transit Chart With draw_transit_aspect_grid table
     transit_chart_with_table_grid_subject = AstrologicalSubject("John Lennon - TCWTG", 1940, 10, 9, 18, 30, "Liverpool", "GB")
     transit_chart_with_table_grid = KerykeionChartSVG(transit_chart_with_table_grid_subject, "Transit", second, double_chart_aspect_grid_type="table", theme="dark")
-    transit_chart_with_table_grid.makeSVG()
+    transit_chart_with_table_grid.makeSVG()
+
+    # Chines Language Chart
+    chinese_subject = AstrologicalSubject("Hua Chenyu", 1990, 2, 7, 12, 0, "Hunan", "CN")
+    chinese_chart = KerykeionChartSVG(chinese_subject, chart_language="CN")
+    chinese_chart.makeSVG()
+
+    # French Language Chart
+    french_subject = AstrologicalSubject("Jeanne Moreau", 1928, 1, 23, 10, 0, "Paris", "FR")
+    french_chart = KerykeionChartSVG(french_subject, chart_language="FR")
+    french_chart.makeSVG()
+
+    # Spanish Language Chart
+    spanish_subject = AstrologicalSubject("Antonio Banderas", 1960, 8, 10, 12, 0, "Malaga", "ES")
+    spanish_chart = KerykeionChartSVG(spanish_subject, chart_language="ES")
+    spanish_chart.makeSVG()
+
+    # Portuguese Language Chart
+    portuguese_subject = AstrologicalSubject("Cristiano Ronaldo", 1985, 2, 5, 5, 25, "Funchal", "PT")
+    portuguese_chart = KerykeionChartSVG(portuguese_subject, chart_language="PT")
+    portuguese_chart.makeSVG()
+
+    # Italian Language Chart
+    italian_subject = AstrologicalSubject("Sophia Loren", 1934, 9, 20, 2, 0, "Rome", "IT")
+    italian_chart = KerykeionChartSVG(italian_subject, chart_language="IT")
+    italian_chart.makeSVG()
+
+    # Russian Language Chart
+    russian_subject = AstrologicalSubject("Mikhail Bulgakov", 1891, 5, 15, 12, 0, "Kiev", "UA")
+    russian_chart = KerykeionChartSVG(russian_subject, chart_language="RU")
+    russian_chart.makeSVG()
+
+    # Turkish Language Chart
+    turkish_subject = AstrologicalSubject("Mehmet Oz", 1960, 6, 11, 12, 0, "Istanbul", "TR")
+    turkish_chart = KerykeionChartSVG(turkish_subject, chart_language="TR")
+    turkish_chart.makeSVG()
+
+    # German Language Chart
+    german_subject = AstrologicalSubject("Albert Einstein", 1879, 3, 14, 11, 30, "Ulm", "DE")
+    german_chart = KerykeionChartSVG(german_subject, chart_language="DE")
+    german_chart.makeSVG()

kerykeion/settings/kerykeion_settings.py

@@ -11,7 +11,7 @@ from typing import Dict, Union
 from kerykeion.kr_types import KerykeionSettingsModel
 
 
-def get_settings(new_settings_file: Union[Path, None] = None) -> KerykeionSettingsModel:
+def get_settings(new_settings_file: Union[Path, None, KerykeionSettingsModel, dict] = None) -> KerykeionSettingsModel:
     """
     This function is used to get the settings dict from the settings file.
     If no settings file is passed as argument, or the file is not found, it will fallback to:
@@ -25,6 +25,11 @@ def get_settings(new_settings_file: Union[Path, None] = None) -> KerykeionSettin
         Dict: The settings dict
     """
 
+    if isinstance(new_settings_file, dict):
+        return KerykeionSettingsModel(**new_settings_file)
+    elif isinstance(new_settings_file, KerykeionSettingsModel):
+        return new_settings_file
+
     # Config path we passed as argument
     if new_settings_file is not None:
         settings_file = new_settings_file

kerykeion/settings/kr.config.json

@@ -209,6 +209,174 @@
         "Chiron": "凱龍星",
         "Mean_Lilith": "黑月亮"
       }
+    },
+    "ES": {
+      "info": "Información",
+      "cusp": "Casa",
+      "longitude": "Longitud",
+      "latitude": "Latitud",
+      "north": "Norte",
+      "east": "Este",
+      "south": "Sur",
+      "west": "Oeste",
+      "fire": "Fuego",
+      "earth": "Tierra",
+      "air": "Aire",
+      "water": "Agua",
+      "and_word": "y",
+      "transits": "Tránsitos para",
+      "type": "Tipo",
+      "aspects": "Aspectos de la pareja",
+      "planets_and_house": "Puntos para",
+      "transit_name": "En el momento del tránsito",
+      "lunar_phase": "Fase lunar",
+      "day": "Día",
+      "celestial_points": {
+        "Sun": "Sol",
+        "Moon": "Luna",
+        "Mercury": "Mercurio",
+        "Venus": "Venus",
+        "Mars": "Marte",
+        "Jupiter": "Júpiter",
+        "Saturn": "Saturno",
+        "Uranus": "Urano",
+        "Neptune": "Neptuno",
+        "Pluto": "Plutón",
+        "Asc": "Asc",
+        "Mc": "Mc",
+        "Dsc": "Dsc",
+        "Ic": "Ic",
+        "True_Node": "Nodo Norte",
+        "Mean_Node": "Nodo Medio",
+        "Chiron": "Quirón",
+        "Mean_Lilith": "Lilith"
+      }
+    },
+    "RU": {
+      "info": "Информация",
+      "cusp": "Дом",
+      "longitude": "Долгота",
+      "latitude": "Широта",
+      "north": "Север",
+      "east": "Восток",
+      "south": "Юг",
+      "west": "Запад",
+      "fire": "Огонь",
+      "earth": "Земля",
+      "air": "Воздух",
+      "water": "Вода",
+      "and_word": "и",
+      "transits": "Транзиты для",
+      "type": "Тип",
+      "aspects": "Аспекты пары",
+      "planets_and_house": "Пункты для",
+      "transit_name": "В момент транзита",
+      "lunar_phase": "Лунная фаза",
+      "day": "День",
+      "celestial_points": {
+        "Sun": "Солнце",
+        "Moon": "Луна",
+        "Mercury": "Меркурий",
+        "Venus": "Венера",
+        "Mars": "Марс",
+        "Jupiter": "Юпитер",
+        "Saturn": "Сатурн",
+        "Uranus": "Уран",
+        "Neptune": "Нептун",
+        "Pluto": "Плутон",
+        "Asc": "Асц",
+        "Mc": "MC",
+        "Dsc": "ДСЦ",
+        "Ic": "IC",
+        "True_Node": "Северный узел",
+        "Mean_Node": "Средний узел",
+        "Chiron": "Хирон",
+        "Mean_Lilith": "Лилит"
+      }
+    },
+    "TR": {
+      "info": "Bilgi",
+      "cusp": "Ev",
+      "longitude": "Boylam",
+      "latitude": "Enlem",
+      "north": "Kuzey",
+      "east": "Doğu",
+      "south": "Güney",
+      "west": "Batı",
+      "fire": "Ateş",
+      "earth": "Toprak",
+      "air": "Hava",
+      "water": "Su",
+      "and_word": "ve",
+      "transits": "Geçişler için",
+      "type": "Tür",
+      "aspects": "Çiftin Açılar",
+      "planets_and_house": "Puanlar için",
+      "transit_name": "Geçiş anında",
+      "lunar_phase": "Ay Aşaması",
+      "day": "Gün",
+      "celestial_points": {
+        "Sun": "Güneş",
+        "Moon": "Ay",
+        "Mercury": "Merkür",
+        "Venus": "Venüs",
+        "Mars": "Mars",
+        "Jupiter": "Jüpiter",
+        "Saturn": "Satürn",
+        "Uranus": "Uranüs",
+        "Neptune": "Neptün",
+        "Pluto": "Plüton",
+        "Asc": "Yükselen",
+        "Mc": "MC",
+        "Dsc": "İK",
+        "Ic": "IC",
+        "True_Node": "Kuzey Düğümü",
+        "Mean_Node": "Ortalama Düğüm",
+        "Chiron": "Kiron",
+        "Mean_Lilith": "Lilith"
+      }
+    },
+    "DE": {
+      "info": "Informationen",
+      "cusp": "Haus",
+      "longitude": "Längengrad",
+      "latitude": "Breitengrad",
+      "north": "Norden",
+      "east": "Osten",
+      "south": "Süden",
+      "west": "Westen",
+      "fire": "Feuer",
+      "earth": "Erde",
+      "air": "Luft",
+      "water": "Wasser",
+      "and_word": "und",
+      "transits": "Transite für",
+      "type": "Typ",
+      "aspects": "Aspekte des Paares",
+      "planets_and_house": "Punkte für",
+      "transit_name": "Zum Zeitpunkt des Transits",
+      "lunar_phase": "Mondphase",
+      "day": "Tag",
+      "celestial_points": {
+        "Sun": "Sonne",
+        "Moon": "Mond",
+        "Mercury": "Merkur",
+        "Venus": "Venus",
+        "Mars": "Mars",
+        "Jupiter": "Jupiter",
+        "Saturn": "Saturn",
+        "Uranus": "Uranus",
+        "Neptune": "Neptun",
+        "Pluto": "Pluto",
+        "Asc": "Asz",
+        "Mc": "MC",
+        "Dsc": "DSC",
+        "Ic": "IC",
+        "True_Node": "Wahrer Mondknoten",
+        "Mean_Node": "Mittlerer Mondknoten",
+        "Chiron": "Chiron",
+        "Mean_Lilith": "Lilith"
+      }
     }
   },
   "aspects": [

{kerykeion-4.16.4.dist-info → kerykeion-4.17.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: kerykeion
-Version: 4.16.4
+Version: 4.17.0
 Summary: A python library for astrology.
 Home-page: https://www.kerykeion.net/
 License: AGPL-3.0
@@ -318,6 +318,29 @@ More examples [here](https://www.kerykeion.net/docs/examples/perspective-type/).
 
 Full list of supported perspective types [here](https://www.kerykeion.net/pydocs/kerykeion/kr_types/kr_literals.html#PerspectiveType).
 
+## Themes
+
+You can now personalize your astrological charts with different themes! Four themes are available:
+
+- **Classic** (default)
+- **Dark**
+- **Dark High Contrast**
+- **Light**
+
+Each theme offers a distinct visual style, allowing you to choose the one that best suits your preferences or presentation needs. If you prefer more control over the appearance, you can opt not to set any theme, making it easier to customize the chart by overriding the default CSS variables. For more detailed instructions on how to apply themes, check the [documentation](https://www.kerykeion.net/docs/examples/theming)
+
+Here's an example of how to set the theme:
+
+```python
+from kerykeion import AstrologicalSubject, KerykeionChartSVG
+
+dark_theme_subject = AstrologicalSubject("John Lennon - Dark Theme", 1940, 10, 9, 18, 30, "Liverpool", "GB")
+dark_theme_natal_chart = KerykeionChartSVG(dark_high_contrast_theme_subject, theme="dark_high_contrast")
+dark_theme_natal_chart.makeSVG()
+```
+
+![John Lennon](https://www.kerykeion.net/assets/img/showcase/John%20Lennon%20-%20Dark%20-%20Natal%20Chart.svg)
+
 ## Alternative Initialization
 
 You can initialize the AstrologicalSubject from a **UTC** ISO 8601 string:
@@ -351,16 +374,20 @@ Sooner or later I'll try to write an extensive documentation.
 
 You can clone this repository or download a zip file using the right side buttons.
 
-## Contributing
+## Integrate Kerykeion Functionalities in Your Project
 
-Feel free to contribute to the code!
+If you are interested in integrating Kerykeion's astrological functionalities into your project, I would be happy to collaborate with you. Whether you need custom features, support, or consultation, feel free to reach out to me at my [email](mailto:kerykeion.astrology@gmail.com?subject=Integration%20Request) address.
 
 ## License
 
 This project is licensed under the AGPL-3.0 License.
 To understand how this impacts your use of the software, please see the [LICENSE](LICENSE) file for details.
-If you have questions, you can reach out to me at my [email](mailto:battaglia.giacomo@yahoo.it?subject=Kerykeion) address.
+If you have questions, you can reach out to me at my [email](mailto:kerykeion.astrology@gmail.com?subject=Kerykeion) address.
 As a rule of thumb, if you are using this library in a project, you should open source the code of the project with a compatible license.
 
 You can implement the logic of kerykeion in your project and also keep it closed source by using a third party API, like the [AstrologerAPI](https://rapidapi.com/gbattaglia/api/astrologer/). The AstrologerAPI is AGPL-3.0 compliant. Subscribing to the API is also, currently, the best way to support the project.
 
+## Contributing
+
+Feel free to contribute to the code!
+

{kerykeion-4.16.4.dist-info → kerykeion-4.17.0.dist-info}/RECORD

@@ -2,13 +2,13 @@ LICENSE,sha256=UTLH8EdbAsgQei4PA2PnBCPGLSZkq5J-dhkyJuXgWQU,34273
 kerykeion/__init__.py,sha256=f4_J_hAh_OSLAUrabqVhrc1rH59I6X1LS9vuAEzE9PY,536
 kerykeion/aspects/__init__.py,sha256=9FlDVI1ndCJga0-chNIhcLitjU_x3kbtAFfFqVp2ejc,293
 kerykeion/aspects/aspects_utils.py,sha256=vV21Xr5b3TF-HQ28h56VZeoCHcObHNxErW18S-kUxms,5508
-kerykeion/aspects/natal_aspects.py,sha256=KnrHt8AvEE66RWLXXAMv-srm8x077AHLtoNabjeC9KI,4790
-kerykeion/aspects/synastry_aspects.py,sha256=_qrsdzxtZ8nl_f4k3q2iRFL10GNp7zM5sJEEz2XBWhg,4324
+kerykeion/aspects/natal_aspects.py,sha256=rnzdwTNGaRETs8qDMYE81mAIuKTOmmoN7ak1mtgOGF0,4890
+kerykeion/aspects/synastry_aspects.py,sha256=cy7Zz5EcR5LKMgCyZxRRnJxGlFNVrUMxCFFq2kykgwY,4423
 kerykeion/astrological_subject.py,sha256=YkEHyge_S6FTsAsLNuSMBR-4XdNMFhRo6lHqYdp-u6Y,35045
 kerykeion/charts/__init__.py,sha256=Juxkduy2TaagWblh_7CE8Acrg3dHL27-WEddJhau_eQ,127
 kerykeion/charts/charts_utils.py,sha256=IMvYy6jt6HmZZqpE1FIMhpL3eIqdxq2_aaF1RrpgzpE,42148
 kerykeion/charts/draw_planets.py,sha256=Uty3zpWYMQZvvK7ZHhlmynCHeL8DIN3qL2ifnBXVciM,17393
-kerykeion/charts/kerykeion_chart_svg.py,sha256=Es4G3jGEbU-RmDPAjQC_QOL6LUObiU2Gl8iwpF5Jc0g,40499
+kerykeion/charts/kerykeion_chart_svg.py,sha256=RuU14RNWM6b-fmPPUviHps_EI1GQRtMWDVVWNoQyFVg,42668
 kerykeion/charts/templates/aspect_grid_only.xml,sha256=5CUctWk2wgXV-ev2JHJ5yLlow7gzzFZz1eO744PLu2A,65150
 kerykeion/charts/templates/chart.xml,sha256=ryQao1xDqlSjNUY0HzZiJjdRK__mQoMFA3WV-W6t5Jo,68383
 kerykeion/charts/templates/wheel_only.xml,sha256=xyFlULo1rKZDk8kT9pRWgaEoYyNcmwK40PARKqr30FY,66372
@@ -28,13 +28,13 @@ kerykeion/kr_types/settings_models.py,sha256=hDDoJBz1arIsBySKUeqpmW9mw4aOaoUQo6i
 kerykeion/relationship_score.py,sha256=LzEA2JXb_GeUinjfEtce_eQ97jxXFGfK3B97fODHIOE,6992
 kerykeion/report.py,sha256=QEZfadIxmqIugoLHMW0KBhOqCwTywGSDDfpX4NJD6qg,2785
 kerykeion/settings/__init__.py,sha256=QQNFCl7sgN27MKaVscqtpPk10HGz4wZS3I_7KEGMaVA,69
-kerykeion/settings/kerykeion_settings.py,sha256=uRAbhJ0ZXAbGBPGJjhh5u8YX2phcXobEwJA646wMHcM,2347
-kerykeion/settings/kr.config.json,sha256=OT_aqKDiWIGGufGyl4qRLWgz6_br0-VYuVAf_Jpf8vY,14817
+kerykeion/settings/kerykeion_settings.py,sha256=zGLq9vNUQRXs8KY47EyKZ9bHrDl2gNYrvVhwsbh4yas,2578
+kerykeion/settings/kr.config.json,sha256=G7P9k6zwN7XqYyqAYZ4ATIkDJAh5E9nSQDoYDzfTRU0,19481
 kerykeion/sweph/README.md,sha256=L7FtNAJTWtrZNGKa8MX87SjduFYPYxwWhaI5fmtzNZo,73
 kerykeion/sweph/seas_18.se1,sha256=X9nCqhZU43wJpq61WAdueVQJt9xL2UjrwPqn1Kdoa1s,223002
 kerykeion/utilities.py,sha256=wJdjksXZlMWyvFnEe_1HQuCxYAtAWg-p8lqe2aO2zpE,9046
-kerykeion-4.16.4.dist-info/LICENSE,sha256=UTLH8EdbAsgQei4PA2PnBCPGLSZkq5J-dhkyJuXgWQU,34273
-kerykeion-4.16.4.dist-info/METADATA,sha256=hvJmPMkG1quGdw23pvMiS-AhLdexHZaYMk01tNxaIUQ,14428
-kerykeion-4.16.4.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-kerykeion-4.16.4.dist-info/entry_points.txt,sha256=5SmANYscFDDTdeovHvGQ-cnj0hdFvGoxPaWLCpyDFnQ,49
-kerykeion-4.16.4.dist-info/RECORD,,
+kerykeion-4.17.0.dist-info/LICENSE,sha256=UTLH8EdbAsgQei4PA2PnBCPGLSZkq5J-dhkyJuXgWQU,34273
+kerykeion-4.17.0.dist-info/METADATA,sha256=od1EdESgWryLgY1m00zckK-PqvlBQg-7Q1W29z2sWms,15895
+kerykeion-4.17.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+kerykeion-4.17.0.dist-info/entry_points.txt,sha256=5SmANYscFDDTdeovHvGQ-cnj0hdFvGoxPaWLCpyDFnQ,49
+kerykeion-4.17.0.dist-info/RECORD,,