kerykeion 4.4.1__tar.gz → 4.5.0__tar.gz

{kerykeion-4.4.1 → kerykeion-4.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: kerykeion
-Version: 4.4.1
+Version: 4.5.0
 Summary: A python library for astrology.
 Home-page: https://github.com/g-battaglia/kerykeion
 License: AGPL-3.0
@@ -18,6 +18,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Topic :: Scientific/Engineering :: Astronomy
 Classifier: Topic :: Software Development

{kerykeion-4.4.1 → kerykeion-4.5.0}/kerykeion/__init__.py

@@ -106,3 +106,4 @@ from .relationship_score import RelationshipScore
 from .aspects import SynastryAspects, NatalAspects
 from .report import Report
 from .settings import KerykeionSettingsModel, get_settings
+from .enums import Planets, Aspects, Signs

{kerykeion-4.4.1 → kerykeion-4.5.0}/kerykeion/astrological_subject.py

@@ -51,6 +51,8 @@ class AstrologicalSubject:
     - utc_datetime (datetime, optional): An alternative way of constructing the object, 
         if you know the UTC datetime but do not have easy access to e.g. timezone identifier
         _ Defaults to None.
+    - disable_chiron (bool, optional): Disables the calculation of Chiron. Defaults to False.
+        Chiron calculation can create some issues with the Swiss Ephemeris when the date is too far in the past.
     """
 
     # Defined by the user
@@ -91,7 +93,7 @@ class AstrologicalSubject:
     pluto: KerykeionPointModel
     true_node: KerykeionPointModel
     mean_node: KerykeionPointModel
-    chiron: KerykeionPointModel
+    chiron: KerykeionPointModel | None
 
     # Houses
     first_house: KerykeionPointModel
@@ -123,15 +125,16 @@ class AstrologicalSubject:
         day: int = now.day,
         hour: int = now.hour,
         minute: int = now.minute,
-        city: str = "",
-        nation: str = "",
-        lng: Union[int, float] = 0,
-        lat: Union[int, float] = 0,
-        tz_str: str = "",
+        city: Union[str, None] = None,
+        nation: Union[str, None] = None,
+        lng: Union[int, float, None] = None,
+        lat: Union[int, float, None] = None,
+        tz_str: Union[str, None] = None,
         geonames_username: Union[str, None] = None,
         zodiac_type: ZodiacType = "Tropic",
         online: bool = True,
         utc_datetime: Union[datetime, None] = None,
+        disable_chiron: bool = False
     ) -> None:
         logging.debug("Starting Kerykeion")
 
@@ -158,6 +161,7 @@ class AstrologicalSubject:
         self.json_dir = Path.home()
         self.geonames_username = geonames_username
         self.utc_datetime = utc_datetime
+        self.disable_chiron = disable_chiron
 
         # This message is set to encourage the user to set a custom geonames username
         if geonames_username is None and online:
@@ -188,7 +192,15 @@ class AstrologicalSubject:
             self.nation = "GB"
             logging.warning("No nation specified, using GB as default")
 
-        if (not self.online) and (not lng or not lat or not tz_str):
+        if not self.lat:
+            self.lat = 51.5074
+            logging.warning("No latitude specified, using London as default")
+
+        if not self.lng:
+            self.lng = 0
+            logging.warning("No longitude specified, using London as default")
+
+        if (not self.online) and (not tz_str):
             raise KerykeionException(
                 "You need to set the coordinates and timezone if you want to use the offline mode!"
             )
@@ -219,7 +231,7 @@ class AstrologicalSubject:
 
     def _fetch_tz_from_geonames(self) -> None:
         """Gets the nearest time zone for the calculation"""
-        logging.debug("Conneting to Geonames...")
+        logging.info("Fetching timezone/coordinates from geonames")
 
         geonames = FetchGeonames(
             self.city,
@@ -247,7 +259,7 @@ class AstrologicalSubject:
         """Converts local time to utc time."""
 
         # If the coordinates are not set, get them from geonames.
-        if (self.online) and (not self.tz_str or not self.lng or not self.lat):
+        if (self.online) and (not self.tz_str):
             self._fetch_tz_from_geonames()
 
         # If UTC datetime is provided, then use it directly
@@ -367,7 +379,11 @@ class AstrologicalSubject:
         pluto_deg = swe.calc(self.julian_day, 9, self._iflag)[0][0]
         mean_node_deg = swe.calc(self.julian_day, 10, self._iflag)[0][0]
         true_node_deg = swe.calc(self.julian_day, 11, self._iflag)[0][0]
-        chiron_deg = swe.calc(self.julian_day, 15, self._iflag)[0][0]
+        
+        if not self.disable_chiron:
+            chiron_deg = swe.calc(self.julian_day, 15, self._iflag)[0][0]
+        else:
+            chiron_deg = 0
 
         self.planets_degrees_ut = [
             sun_deg,
@@ -382,8 +398,10 @@ class AstrologicalSubject:
             pluto_deg,
             mean_node_deg,
             true_node_deg,
-            chiron_deg,
         ]
+        
+        if not self.disable_chiron:
+            self.planets_degrees_ut.append(chiron_deg)
 
     def _planets(self) -> None:
         """Defines body positon in signs and information and
@@ -403,7 +421,11 @@ class AstrologicalSubject:
         self.pluto = calculate_position(self.planets_degrees_ut[9], "Pluto", point_type=point_type)
         self.mean_node = calculate_position(self.planets_degrees_ut[10], "Mean_Node", point_type=point_type)
         self.true_node = calculate_position(self.planets_degrees_ut[11], "True_Node", point_type=point_type)
-        self.chiron = calculate_position(self.planets_degrees_ut[12], "Chiron", point_type=point_type)
+        
+        if not self.disable_chiron:
+            self.chiron = calculate_position(self.planets_degrees_ut[12], "Chiron", point_type=point_type)
+        else:
+            self.chiron = None
 
     def _planets_in_houses(self) -> None:
         """Calculates the house of the planet and updates
@@ -464,7 +486,11 @@ class AstrologicalSubject:
         self.pluto = for_every_planet(self.pluto, self.planets_degrees_ut[9])
         self.mean_node = for_every_planet(self.mean_node, self.planets_degrees_ut[10])
         self.true_node = for_every_planet(self.true_node, self.planets_degrees_ut[11])
-        self.chiron = for_every_planet(self.chiron, self.planets_degrees_ut[12])
+
+        if not self.disable_chiron:
+            self.chiron = for_every_planet(self.chiron, self.planets_degrees_ut[12])
+        else:
+            self.chiron = None
 
         self.planets_list = [
             self.sun,
@@ -479,8 +505,10 @@ class AstrologicalSubject:
             self.pluto,
             self.mean_node,
             self.true_node,
-            self.chiron
         ]
+        
+        if not self.disable_chiron:
+            self.planets_list.append(self.chiron)
 
         # Check in retrograde or not:
         planets_ret = []
@@ -635,10 +663,19 @@ class AstrologicalSubject:
 if __name__ == "__main__":
     import json
     from kerykeion.utilities import setup_logging
-    setup_logging(level="debug")
 
+    setup_logging(level="debug")
+    
+    # With Chiron enabled
     johnny = AstrologicalSubject("Johnny Depp", 1963, 6, 9, 0, 0, "Owensboro", "US")
     print(json.loads(johnny.json(dump=True)))
 
     print('\n')
     print(johnny.chiron)
+
+    # With Chiron disabled
+    johnny = AstrologicalSubject("Johnny Depp", 1963, 6, 9, 0, 0, "Owensboro", "US", disable_chiron=True)
+    print(json.loads(johnny.json(dump=True)))
+
+    print('\n')
+    print(johnny.chiron)

kerykeion-4.5.0/kerykeion/enums.py

@@ -0,0 +1,50 @@
+from enum import Enum
+
+
+class Planets(Enum):
+    SUN = "Sun"
+    MOON = "Moon"
+    MERCURY = "Mercury"
+    VENUS = "Venus"
+    MARS = "Mars"
+    JUPITER = "Jupiter"
+    SATURN = "Saturn"
+    URANUS = "Uranus"
+    NEPTUNE = "Neptune"
+    PLUTO = "Pluto"
+    CHIRON = "Chiron"
+    TRUE_NODE = "True_Node"
+    MEAN_NODE = "Mean_Node"
+
+
+class Aspects(Enum):
+    CONJUNCTION = "Conjunction"
+    SEXTILE = "Sextile"
+    SEMI_SEXTILE = "Semi-Sextile"
+    SQUARE = "Square"
+    TRINE = "Trine"
+    OPPOSITION = "Opposition"
+    QUINCUNX = "Quincunx"
+    NONE = None
+    QUINTILE = "Quintile"
+    BIQUINTILE = "Biquintile"
+    OCTILE = "Octile"
+    TRIOCTILE = "Trioctile"
+    DECILE = "Decile"
+    TRIDECILE = "Tridecile"
+    SESQUIQUADRATE = "Sesquiquadrate"
+
+
+class Signs(Enum):
+    ARI = "Ari"
+    TAU = "Tau"
+    GEM = "Gem"
+    CAN = "Can"
+    LEO = "Leo"
+    VIR = "Vir"
+    LIB = "Lib"
+    SCO = "Sco"
+    SAG = "Sag"
+    CAP = "Cap"
+    AQU = "Aqu"
+    PIS = "Pis"

{kerykeion-4.4.1 → kerykeion-4.5.0}/kerykeion/kr_types/kr_models.py

@@ -136,7 +136,7 @@ class AstrologicalSubjectModel(BaseModel):
     uranus: KerykeionPointModel
     neptune: KerykeionPointModel
     pluto: KerykeionPointModel
-    chiron: KerykeionPointModel
+    chiron: KerykeionPointModel | None
 
     # Houses
     first_house: KerykeionPointModel

{kerykeion-4.4.1 → kerykeion-4.5.0}/kerykeion/utilities.py

@@ -203,15 +203,20 @@ def calculate_position(
 
     return KerykeionPointModel(**dictionary)
 
+
 def setup_logging(level: str) -> None:
-    """Setup logging for testing.
-    
+    """
+    Setup logging for testing.
+
     Args:
-        level: Log level as a string, options: debug, info, warning, error"""
-    logopt: dict[str, int]  = {"debug": logging.DEBUG, 
-                               "info": logging.INFO, 
-                               "warning": logging.WARNING , 
-                               "error": logging.ERROR}
-    format: str             = "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
-    loglevel: int           = logopt.get(level, logging.INFO)
-    logging.basicConfig(format=format, level=loglevel)
+        level: Log level as a string, options: debug, info, warning, error
+    """
+    logopt: dict[str, int] = {
+        "debug": logging.DEBUG,
+        "info": logging.INFO,
+        "warning": logging.WARNING,
+        "error": logging.ERROR,
+    }
+    format: str = "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
+    loglevel: int = logopt.get(level, logging.INFO)
+    logging.basicConfig(format=format, level=loglevel)

{kerykeion-4.4.1 → kerykeion-4.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "kerykeion"
-version = "4.4.1"
+version = "4.5.0"
 authors = ["Giacomo Battaglia <battaglia.giacomo@yahoo.it>"]
 description = "A python library for astrology."
 license = "AGPL-3.0"