kerykeion 4.3.1__tar.gz → 4.4.1__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: kerykeion
-Version: 4.3.1
+Version: 4.4.1
 Summary: A python library for astrology.
 Home-page: https://github.com/g-battaglia/kerykeion
 License: AGPL-3.0
@@ -63,7 +63,10 @@ also it can calculate the aspects of a single persone or between two, you can se
 need in the settings in the utility module.
 It also can generate an SVG of a birthchart, a synastry chart or a transit chart.
 
+The core goal of this project is to provide a simple and easy approach to astrology in a data driven way.
+
 Here's an example of a birthchart:
+
 ![Kanye Birth Chart](http://centuryboy.altervista.org/KanyeNatalChart.svg)
 
 ## Web API
@@ -254,3 +257,12 @@ You can clone this repository or download a zip file using the right side button
 
 Feel free to contribute to the code!
 
+## 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.
+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 kerkeion 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.
+

{kerykeion-4.3.1 → kerykeion-4.4.1}/README.md

@@ -28,7 +28,10 @@ also it can calculate the aspects of a single persone or between two, you can se
 need in the settings in the utility module.
 It also can generate an SVG of a birthchart, a synastry chart or a transit chart.
 
+The core goal of this project is to provide a simple and easy approach to astrology in a data driven way.
+
 Here's an example of a birthchart:
+
 ![Kanye Birth Chart](http://centuryboy.altervista.org/KanyeNatalChart.svg)
 
 ## Web API
@@ -218,3 +221,12 @@ You can clone this repository or download a zip file using the right side button
 ## Contributing
 
 Feel free to contribute to the code!
+
+## 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.
+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 kerkeion 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.

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

@@ -48,10 +48,14 @@ class AstrologicalSubject:
     - geonames_username (str, optional): _ Defaults to 'century.boy'.
     - online (bool, optional): Sets if you want to use the online mode (using
         geonames) or not. Defaults to True.
+    - 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.
     """
 
     # Defined by the user
     name: str
+    utc_datetime: Union[datetime, None]
     year: int
     month: int
     day: int
@@ -111,7 +115,6 @@ class AstrologicalSubject:
 
     now = datetime.now()
 
-
     def __init__(
         self,
         name="Now",
@@ -128,6 +131,7 @@ class AstrologicalSubject:
         geonames_username: Union[str, None] = None,
         zodiac_type: ZodiacType = "Tropic",
         online: bool = True,
+        utc_datetime: Union[datetime, None] = None,
     ) -> None:
         logging.debug("Starting Kerykeion")
 
@@ -153,23 +157,24 @@ class AstrologicalSubject:
         self.online = online
         self.json_dir = Path.home()
         self.geonames_username = geonames_username
+        self.utc_datetime = utc_datetime
 
         # This message is set to encourage the user to set a custom geonames username
         if geonames_username is None and online:
             logging.info(
                 "\n"
-                "********" + \
-                "\n" + \
-                "NO GEONAMES USERNAME SET!" + \
-                "\n" + \
-                "Using the default geonames username is not recommended, please set a custom one!" + \
-                "\n" + \
-                "You can get one for free here:" + \
-                "\n" + \
-                "https://www.geonames.org/login" + \
-                "\n" + \
-                "Keep in mind that the default username is limited to 2000 requests per hour and is shared with everyone else using this library." + \
-                "\n" + \
+                "********" +
+                "\n" +
+                "NO GEONAMES USERNAME SET!" +
+                "\n" +
+                "Using the default geonames username is not recommended, please set a custom one!" +
+                "\n" +
+                "You can get one for free here:" +
+                "\n" +
+                "https://www.geonames.org/login" +
+                "\n" +
+                "Keep in mind that the default username is limited to 2000 requests per hour and is shared with everyone else using this library." +
+                "\n" +
                 "********"
             )
 
@@ -205,10 +210,10 @@ class AstrologicalSubject:
 
     def __repr__(self) -> str:
         return f"Astrological data for: {self.name}, {self.utc} UTC\nBirth location: {self.city}, Lat {self.lat}, Lon {self.lng}"
-    
+
     def __getitem__(self, item):
         return getattr(self, item)
-    
+
     def get(self, item, default=None):
         return getattr(self, item, default)
 
@@ -245,6 +250,11 @@ class AstrologicalSubject:
         if (self.online) and (not self.tz_str or not self.lng or not self.lat):
             self._fetch_tz_from_geonames()
 
+        # If UTC datetime is provided, then use it directly
+        if (self.utc_datetime):
+            self.utc = self.utc_datetime
+            return
+
         local_time = pytz.timezone(self.tz_str)
 
         naive_datetime = datetime(self.year, self.month, self.day, self.hour, self.minute, 0)
@@ -584,7 +594,7 @@ class AstrologicalSubject:
         if self.lat > 66.0:
             self.lat = 66.0
             logging.info("Polar circle override for houses, using 66 degrees")
-            
+
         elif self.lat < -66.0:
             self.lat = -66.0
             logging.info("Polar circle override for houses, using -66 degrees")

{kerykeion-4.3.1 → kerykeion-4.4.1}/kerykeion/charts/kerykeion_chart_svg.py

@@ -1461,8 +1461,7 @@ class KerykeionChartSVG:
         td = self._createTemplateDictionary()
 
         # read template
-        with open(self.xml_svg, "r", encoding="utf-8", errors="ignore") as output_file:
-            f = open(self.xml_svg)
+        with open(self.xml_svg, "r", encoding="utf-8", errors="ignore") as f:
             template = Template(f.read()).substitute(td)
 
         # return filename

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

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