kerykeion 4.25.3__py3-none-any.whl → 4.26.0rc1__py3-none-any.whl

kerykeion/__init__.py

@@ -17,3 +17,4 @@ from .settings import KerykeionSettingsModel, get_settings
 from .enums import Planets, Aspects, Signs
 from .ephemeris_data import EphemerisDataFactory
 from .composite_subject_factory import CompositeSubjectFactory
+from .transits_time_range import TransitsTimeRangeFactory

kerykeion/aspects/natal_aspects.py

@@ -100,8 +100,10 @@ class NatalAspects:
                 if verdict == True:
                     aspect_model = AspectModel(
                         p1_name=active_points_list[first]["name"],
+                        p1_owner=self.user.name,
                         p1_abs_pos=active_points_list[first]["abs_pos"],
                         p2_name=active_points_list[second]["name"],
+                        p2_owner=self.user.name,
                         p2_abs_pos=active_points_list[second]["abs_pos"],
                         aspect=name,
                         orbit=orbit,

kerykeion/aspects/synastry_aspects.py

@@ -93,8 +93,10 @@ class SynastryAspects(NatalAspects):
                 if verdict == True:
                     aspect_model = AspectModel(
                         p1_name=first_active_points_list[first]["name"],
+                        p1_owner=self.first_user.name,
                         p1_abs_pos=first_active_points_list[first]["abs_pos"],
                         p2_name=second_active_points_list[second]["name"],
+                        p2_owner=self.second_user.name,
                         p2_abs_pos=second_active_points_list[second]["abs_pos"],
                         aspect=name,
                         orbit=orbit,

kerykeion/aspects/transits_time_range.py

@@ -0,0 +1,41 @@
+from datetime import datetime, timedelta
+from kerykeion import (
+    TransitsTimeRangeFactory,
+    EphemerisDataFactory,
+    AstrologicalSubject,
+)
+
+# Create a natal chart for the subject
+person = AstrologicalSubject(
+    "Johnny Depp", 1963, 6, 9, 20, 15, "Owensboro", "US"
+)
+
+# Define the time period for transit calculation
+start_date = datetime.now()
+end_date = datetime.now() + timedelta(days=30)
+
+# Create ephemeris data for the specified time period
+ephemeris_factory = EphemerisDataFactory(
+    start_datetime=start_date,
+    end_datetime=end_date,
+    step_type="days",
+    step=1,
+    lat=person.lat,
+    lng=person.lng,
+    tz_str=person.tz_str,
+)
+
+ephemeris_data_points = ephemeris_factory.get_ephemeris_data_as_astrological_subjects()
+
+# Calculate transits for the subject
+transit_factory = TransitsTimeRangeFactory(
+    natal_chart=person,
+    ephemeris_data_points=ephemeris_data_points,
+)
+
+transit_results = transit_factory.get_transit_moments()
+
+# Print example data
+print(transit_results.model_dump()["dates"][2])
+print(transit_results.model_dump()["transits"][2]['date'])
+print(transit_results.model_dump()["transits"][2]['aspects'][0])

kerykeion/ephemeris_data.py

@@ -4,7 +4,7 @@ from kerykeion.astrological_subject import DEFAULT_HOUSES_SYSTEM_IDENTIFIER, DEF
 from kerykeion.kr_types import EphemerisDictModel
 from kerykeion.kr_types import SiderealMode, HousesSystemIdentifier, PerspectiveType, ZodiacType
 from datetime import datetime, timedelta
-from typing import Literal, Union
+from typing import Literal, Union, List
 import logging
 
 
@@ -76,17 +76,19 @@ class EphemerisDataFactory:
 
         self.dates_list = []
         if self.step_type == "days":
-            self.dates_list = [self.start_datetime + timedelta(days=i) for i in range((self.end_datetime - self.start_datetime).days)]
+            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)]
             if max_days and (len(self.dates_list) > max_days):
                 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.")
 
         elif self.step_type == "hours":
-            self.dates_list = [self.start_datetime + timedelta(hours=i) for i in range((self.end_datetime - self.start_datetime).days * 24)]
+            hours_diff = (self.end_datetime - self.start_datetime).total_seconds() / 3600
+            self.dates_list = [self.start_datetime + timedelta(hours=i * self.step) for i in range(int(hours_diff) // self.step + 1)]
             if max_hours and (len(self.dates_list) > max_hours):
                 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.")
 
         elif self.step_type == "minutes":
-            self.dates_list = [self.start_datetime + timedelta(minutes=i) for i in range((self.end_datetime - self.start_datetime).days * 24 * 60)]
+            minutes_diff = (self.end_datetime - self.start_datetime).total_seconds() / 60
+            self.dates_list = [self.start_datetime + timedelta(minutes=i * self.step) for i in range(int(minutes_diff) // self.step + 1)]
             if max_minutes and (len(self.dates_list) > max_minutes):
                 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.")
 
@@ -151,6 +153,55 @@ class EphemerisDataFactory:
 
         return ephemeris_data_list
 
+    def get_ephemeris_data_as_astrological_subjects(self, as_model: bool = False) -> List[AstrologicalSubject]:
+        """
+        Generate ephemeris data for the specified date range as AstrologicalSubject instances.
+
+        This method creates a complete AstrologicalSubject object for each date in the date range,
+        allowing direct access to all properties and methods of the AstrologicalSubject class.
+
+        Args:
+        - as_model (bool): If True, the AstrologicalSubject instances will be returned as model instances. Default is False.
+
+        Returns:
+        - List[AstrologicalSubject]: A list of AstrologicalSubject instances, one for each date in the date range.
+
+        Example usage:
+            subjects = factory.get_ephemeris_data_as_astrological_subjects()
+            # Access methods and properties of the first subject
+            sun_position = subjects[0].get_sun()
+            all_points = subjects[0].get_all_points()
+            chart_drawing = subjects[0].draw_chart()
+        """
+        subjects_list = []
+        for date in self.dates_list:
+            subject = AstrologicalSubject(
+                year=date.year,
+                month=date.month,
+                day=date.day,
+                hour=date.hour,
+                minute=date.minute,
+                lng=self.lng,
+                lat=self.lat,
+                tz_str=self.tz_str,
+                city="Placeholder",
+                nation="Placeholder",
+                online=False,
+                disable_chiron_and_lilith=self.disable_chiron_and_lilith,
+                zodiac_type=self.zodiac_type,
+                sidereal_mode=self.sidereal_mode,
+                houses_system_identifier=self.houses_system_identifier,
+                perspective_type=self.perspective_type,
+                is_dst=self.is_dst,
+            )
+
+            if as_model:
+                subjects_list.append(subject.model())
+            else:
+                subjects_list.append(subject)
+
+        return subjects_list
+
 
 if "__main__" == __name__:
     start_date = datetime.fromisoformat("2020-01-01")
@@ -160,7 +211,7 @@ if "__main__" == __name__:
         start_datetime=start_date,
         end_datetime=end_date,
         step_type="minutes",
-        step=1,
+        step=60,  # One hour intervals to make the example more manageable
         lat=37.9838,
         lng=23.7275,
         tz_str="Europe/Athens",
@@ -170,9 +221,22 @@ if "__main__" == __name__:
         max_days=None,
     )
 
+    # Test original method
     ephemeris_data = factory.get_ephemeris_data(as_model=True)
-    print(ephemeris_data[0])
-    print(len(ephemeris_data))
-
-    for ephe in ephemeris_data:
-        print(ephe.planets[0]["abs_pos"])
+    print(f"Number of ephemeris data points: {len(ephemeris_data)}")
+    print(f"First data point date: {ephemeris_data[0].date}")
+
+    # Test new method
+    subjects = factory.get_ephemeris_data_as_astrological_subjects()
+    print(f"Number of astrological subjects: {len(subjects)}")
+    print(f"First subject sun position: {subjects[0].sun}")
+
+    # Example of accessing more data from the first subject
+    first_subject = subjects[0]
+    print(f"Sun sign: {first_subject.sun['sign']}")
+
+    # Compare sun positions from both methods
+    for i in range(min(3, len(subjects))):
+        print(f"Date: {ephemeris_data[i].date}")
+        print(f"Sun position from dict: {ephemeris_data[i].planets[0]['abs_pos']}")
+        print("---")

kerykeion/kr_types/kr_models.py

@@ -169,8 +169,10 @@ class EphemerisDictModel(SubscriptableBaseModel):
 
 class AspectModel(SubscriptableBaseModel):
     p1_name: str
+    p1_owner: str
     p1_abs_pos: float
     p2_name: str
+    p2_owner: str
     p2_abs_pos: float
     aspect: str
     orbit: float
@@ -278,3 +280,45 @@ class CompositeSubjectModel(SubscriptableBaseModel):
 class ActiveAspect(TypedDict):
     name: AspectName
     orb: int
+
+
+class TransitMomentModel(SubscriptableBaseModel):
+    """
+    Model representing a snapshot of astrological transits at a specific moment in time.
+
+    Captures all active aspects between moving celestial bodies and
+    the fixed positions in a person's natal chart at a specific date and time.
+
+    Attributes:
+        date: ISO 8601 formatted date and time of the transit moment.
+        aspects: List of astrological aspects active at this specific moment.
+    """
+
+    date: str
+    """ISO 8601 formatted date and time of the transit moment."""
+
+    aspects: list[AspectModel]
+    """List of aspects active at this specific moment."""
+
+
+class TransitsTimeRangeModel(SubscriptableBaseModel):
+    """
+    Model representing a collection of transit moments for an astrological subject.
+
+    This model holds a time series of transit snapshots, allowing analysis of
+    planetary movements and their aspects to a natal chart over a period of time.
+
+    Attributes:
+        transits: List of transit moments occurring during the specified time period.
+        subject: The astrological subject model for whom the transits are calculated.
+        dates: List of all dates in ISO 8601 format for which transits were calculated.
+    """
+
+    transits: list[TransitMomentModel]
+    """List of transit moments."""
+
+    subject: Optional[AstrologicalSubjectModel]
+    """Astrological subject data."""
+
+    dates: Optional[list[str]]
+    """ISO 8601 formatted dates of all transit moments."""

kerykeion/transits_time_range.py

@@ -0,0 +1,124 @@
+from typing import Optional, Union, List
+from datetime import datetime, timedelta
+from kerykeion import AstrologicalSubject, SynastryAspects
+from kerykeion.ephemeris_data import EphemerisDataFactory
+from kerykeion.kr_types.kr_literals import AxialCusps, Planet
+from kerykeion.kr_types.kr_models import ActiveAspect, TransitMomentModel, TransitsTimeRangeModel
+from kerykeion.settings.config_constants import DEFAULT_ACTIVE_POINTS, DEFAULT_ACTIVE_ASPECTS
+
+
+class TransitsTimeRangeFactory:
+    """
+    Factory class for generating astrological transit data over a period of time.
+
+    This class compares the positions of celestial bodies at different points in time
+    with the natal chart of an astrological subject to identify significant aspects
+    and produces structured models containing the transit data.
+
+    Attributes:
+        natal_chart: The natal chart of the subject for whom transits are calculated.
+        ephemeris_data_points: List of ephemeris data points representing planetary positions at different times.
+        active_points: List of celestial points to consider when calculating aspects.
+        active_aspects: List of aspect types to consider when analyzing planetary relationships.
+        settings_file: Path to custom settings file for aspect calculations (optional).
+    """
+
+    def __init__(
+        self,
+        natal_chart: AstrologicalSubject,
+        ephemeris_data_points: List[AstrologicalSubject],
+        active_points: List[Union[AxialCusps, Planet]] = DEFAULT_ACTIVE_POINTS,
+        active_aspects: List[ActiveAspect] = DEFAULT_ACTIVE_ASPECTS,
+        settings_file: Optional[str] = None
+    ):
+        """
+        Initialize the TransitMomentsFactory with the necessary data.
+
+        Args:
+            natal_chart: The natal chart of the subject for whom transits are calculated.
+            ephemeris_data_points: List of ephemeris data points representing planetary positions at different times.
+            active_points: List of celestial points to consider when calculating aspects.
+            active_aspects: List of aspect types to consider when analyzing planetary relationships.
+            settings_file: Path to custom settings file for aspect calculations (optional).
+        """
+        self.natal_chart = natal_chart
+        self.ephemeris_data_points = ephemeris_data_points
+        self.active_points = active_points
+        self.active_aspects = active_aspects
+        self.settings_file = settings_file
+
+    def get_transit_moments(self) -> TransitsTimeRangeModel:
+        """
+        Generate a model of transit moments for the given subject across all ephemeris data points.
+
+        This method compares the positions of celestial bodies at different points in time
+        with the natal chart of the subject to identify significant aspects and
+        compiles them into a structured model for analysis.
+
+        Returns:
+            TransitMomentsListModel: A model containing all transit data, including aspects,
+                                    dates, and subject information.
+        """
+        transit_moments = []
+
+        for ephemeris_point in self.ephemeris_data_points:
+            # Calculate aspects between transit positions and natal chart
+            aspects = SynastryAspects(
+                ephemeris_point,
+                self.natal_chart,
+                active_points=self.active_points,
+                active_aspects=self.active_aspects,
+                new_settings_file=self.settings_file,
+            ).relevant_aspects
+
+            # Create a transit moment for this point in time
+            transit_moments.append(
+                TransitMomentModel(
+                    date=ephemeris_point.iso_formatted_utc_datetime,
+                    aspects=aspects,
+                )
+            )
+
+        # Create and return the complete transits model
+        return TransitsTimeRangeModel(
+            dates=[point.iso_formatted_utc_datetime for point in self.ephemeris_data_points],
+            subject=self.natal_chart.model(),
+            transits=transit_moments
+        )
+
+
+if __name__ == "__main__":
+    # Create a natal chart for the subject
+    person = AstrologicalSubject(
+        "Johnny Depp", 1963, 6, 9, 20, 15, "Owensboro", "US"
+    )
+
+    # Define the time period for transit calculation
+    start_date = datetime.now()
+    end_date = datetime.now() + timedelta(days=30)
+
+    # Create ephemeris data for the specified time period
+    ephemeris_factory = EphemerisDataFactory(
+        start_datetime=start_date,
+        end_datetime=end_date,
+        step_type="days",
+        step=1,
+        lat=person.lat,
+        lng=person.lng,
+        tz_str=person.tz_str,
+    )
+
+    ephemeris_data_points = ephemeris_factory.get_ephemeris_data_as_astrological_subjects()
+
+    # Calculate transits for the subject
+    transit_factory = TransitsTimeRangeFactory(
+        natal_chart=person,
+        ephemeris_data_points=ephemeris_data_points,
+    )
+
+    transit_results = transit_factory.get_transit_moments()
+
+    # Print example data
+    print(transit_results.model_dump()["dates"][2])
+    print(transit_results.model_dump()["transits"][2]['date'])
+    print(transit_results.model_dump()["transits"][2]['aspects'][0])

{kerykeion-4.25.3.dist-info → kerykeion-4.26.0rc1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: kerykeion
-Version: 4.25.3
+Version: 4.26.0rc1
 Summary: A python library for astrology.
 Home-page: https://www.kerykeion.net/
 License: AGPL-3.0
@@ -37,53 +37,49 @@ Requires-Dist: typing-extensions (>=4.12.2,<5.0.0)
 Project-URL: Repository, https://github.com/g-battaglia/kerykeion
 Description-Content-Type: text/markdown
 
-<h1 align=center>Kerykeion</h1>
+<h1 align="center">Kerykeion</h1>
+
 <div align="center">
-        <img src="https://img.shields.io/github/stars/g-battaglia/kerykeion.svg?logo=github" alt="stars">
-        <img src="https://img.shields.io/github/forks/g-battaglia/kerykeion.svg?logo=github" alt="forks">
-        
+    <img src="https://img.shields.io/github/stars/g-battaglia/kerykeion.svg?logo=github" alt="stars">
+    <img src="https://img.shields.io/github/forks/g-battaglia/kerykeion.svg?logo=github" alt="forks">
 </div>
 <div align="center">
-        <img src="https://static.pepy.tech/badge/kerykeion/month" alt="PyPI Downloads">
-        <img src="https://static.pepy.tech/badge/kerykeion/week" alt="PyPI Downloads">
-        <img src="https://img.shields.io/github/contributors/g-battaglia/kerykeion?color=blue&logo=github" alt="contributors">
-        <img src="https://img.shields.io/pypi/v/kerykeion?label=pypi%20package" alt="Package version">
-        <img src="https://img.shields.io/pypi/pyversions/kerykeion.svg" alt="Supported Python versions">
+    <img src="https://static.pepy.tech/badge/kerykeion/month" alt="PyPI Downloads">
+    <img src="https://static.pepy.tech/badge/kerykeion/week" alt="PyPI Downloads">
+    <img src="https://img.shields.io/github/contributors/g-battaglia/kerykeion?color=blue&logo=github" alt="contributors">
+    <img src="https://img.shields.io/pypi/v/kerykeion?label=pypi%20package" alt="Package version">
+    <img src="https://img.shields.io/pypi/pyversions/kerykeion.svg" alt="Supported Python versions">
 </div>
 
 &nbsp;
 
-Kerykeion is a python library for Astrology.
-It can calculate all the planet and house position,
-also it can calculate the aspects of a single persone or between two, you can set how many planets you
-need in the settings in the utility module.
-It also can generate an SVG of a birthchart, a synastry chart or a transit chart.
+Kerykeion is a Python library for astrology. It computes planetary and house positions, detects aspects (individual, synastry, composite), and generates SVG charts—including birth, synastry, transit, and composite charts. You can also customize which planets to include in your calculations.
+
+The main goal of this project is to offer a clean, data-driven approach to astrology, making it accessible and programmable.
 
-The core goal of this project is to provide a simple and easy approach to astrology in a data driven way.
+Kerykeion also integrates seamlessly with AI applications. It is designed to work well as a backend for chatbots, recommendation systems, or personal assistants that require astrological insights. You can access structured data in JSON format, making it easy to combine with natural language processing models or knowledge-based systems.
 
-Here's an example of a birthchart:
+Here is an example of a birthchart:
 
 ![John Lenon Chart](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/master/tests/charts/svg/John%20Lennon%20-%20Dark%20Theme%20-%20Natal%20Chart.svg)
 
 ## Web API
 
-If you want to use Kerykeion in a web application, I've created a web API for this purpose, you can find it here:
+If you want to use Kerykeion in a web application, you can try the dedicated web API:
 
 **[AstrologerAPI](https://rapidapi.com/gbattaglia/api/astrologer/pricing)**
 
-It's [open source](https://github.com/g-battaglia/Astrologer-API), it's a way to support me and the project.
+It is [open source](https://github.com/g-battaglia/Astrologer-API) and directly supports this project.
 
 ## Donate
 
-Maintaining this project is a lot of work, the Astrologer API doesn't nearly cover the costs of a software engineer working on this project full time. I do this because I love it, but until I can make this my full time job, I won't be able to spend as much time on it.
-
-If you want to support me, you can do it here:
+Maintaining this project requires substantial time and effort. The Astrologer API alone cannot cover the costs of full-time development. If you find Kerykeion valuable and would like to support further development, please consider donating:
 
 [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/kerykeion)
 
 ## Installation
 
-Kerykeion is a _Python 3.9_ package, make sure you have _Python 3.9_ or above installed on your system.
+Kerykeion requires **Python 3.9** or higher.
 
 ```bash
 pip3 install kerykeion
@@ -91,48 +87,40 @@ pip3 install kerykeion
 
 ## Basic Usage
 
-The basic usage of the library is to create an instance of the AstrologicalSubject class and then access the properties of the instance to get the astrological information about the subject.
-
-Here's an example:
+Below is a simple example illustrating the creation of an astrological subject and retrieving astrological details:
 
 ```python
-
-# Import the main class for creating a kerykeion instance:
 from kerykeion import AstrologicalSubject
 
-# Create a kerykeion instance:
-# Args: Name, year, month, day, hour, minuts, city, nation
+# Create an instance of the AstrologicalSubject class.
+# Arguments: Name, year, month, day, hour, minutes, city, nation
 kanye = AstrologicalSubject("Kanye", 1977, 6, 8, 8, 45, "Atlanta", "US")
 
-# Get the information about the sun in the chart:
-# (The position of the planets always starts at 0)
+# Retrieve information about the Sun:
 kanye.sun
+# > {'name': 'Sun', 'quality': 'Mutable', 'element': 'Air', 'sign': 'Gem', 'sign_num': 2, ...}
 
-#> {'name': 'Sun', 'quality': 'Mutable', 'element': 'Air', 'sign': 'Gem', 'sign_num': 2, 'pos': 17.598992059774275, 'abs_pos': 77.59899205977428, 'emoji': '♊️', 'house': '12th House', 'retrograde': False}
-
-# Get information about the first house:
+# Retrieve information about the first house:
 kanye.first_house
+# > {'name': 'First_House', 'quality': 'Cardinal', 'element': 'Water', 'sign': 'Can', ...}
 
-#> {'name': 'First_House', 'quality': 'Cardinal', 'element': 'Water', 'sign': 'Can', 'sign_num': 3, 'pos': 17.995779673209114, 'abs_pos': 107.99577967320911, 'emoji': '♋️'}
-
-# Get element of the moon sign:
+# Retrieve the element of the Moon sign:
 kanye.moon.element
-
-#> 'Water'
-
+# > 'Water'
 ```
 
-**To avoid connecting to GeoNames (eg. avoiding hourly limit or no internet connection) you should instance kerykeion like this:**
+**To avoid using GeoNames online, specify longitude, latitude, and timezone instead of city and nation:**
 
 ```python
 kanye = AstrologicalSubject(
-    "Kanye", 1977, 6, 8, 8, 45, lng=50, lat=50, tz_str="Europe/Rome", city="Rome"
+    "Kanye", 1977, 6, 8, 8, 45,
+    lng=50,
+    lat=50,
+    tz_str="Europe/Rome",
+    city="Rome"
 )
 ```
 
-The difference is that you have to pass the longitude, latitude and the timezone string, instead of the city and nation.
-If you omit the nation, it will be set to "GB" by default, but the value is not used for calculations. It's better to set it to the correct value though.
-
 ## Generate a SVG Chart
 
 ### Birth Chart
@@ -140,15 +128,13 @@ If you omit the nation, it will be set to "GB" by default, but the value is not
 ```python
 from kerykeion import AstrologicalSubject, KerykeionChartSVG
 
-
 birth_chart = AstrologicalSubject("Kanye", 1977, 6, 8, 8, 45, "Atlanta", "US")
 birth_chart_svg = KerykeionChartSVG(birth_chart)
-
 birth_chart_svg.makeSVG()
 ```
 
 The SVG file will be saved in the home directory.
-![John Lennon Birth Chart](https://www.kerykeion.net/docs/assets/img/examples/birth-chart.svg)
+![John Lennon Birth Chart](https://www.kerykeion.net/img/examples/birth-chart.svg)
 
 ### Synastry Chart
 
@@ -158,13 +144,11 @@ from kerykeion import AstrologicalSubject, KerykeionChartSVG
 first = AstrologicalSubject("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
 second = AstrologicalSubject("Paul McCartney", 1942, 6, 18, 15, 30, "Liverpool", "GB")
 
-# Set the type, it can be Natal, Synastry or Transit
 synastry_chart = KerykeionChartSVG(first, "Synastry", second)
 synastry_chart.makeSVG()
-
 ```
 
-![John Lennon and Paul McCartney Synastry](https://www.kerykeion.net/docs/assets/img/examples/synastry-chart.svg)
+![John Lennon and Paul McCartney Synastry](https://www.kerykeion.net/img/examples/synastry-chart.svg)
 
 
 ### Transit Chart
@@ -187,20 +171,21 @@ transit_chart.makeSVG()
 from kerykeion import CompositeSubjectFactory, AstrologicalSubject, KerykeionChartSVG
 
 angelina = AstrologicalSubject("Angelina Jolie", 1975, 6, 4, 9, 9, "Los Angeles", "US", lng=-118.15, lat=34.03, tz_str="America/Los_Angeles")
+
 brad = AstrologicalSubject("Brad Pitt", 1963, 12, 18, 6, 31, "Shawnee", "US", lng=-96.56, lat=35.20, tz_str="America/Chicago")
 
-composite_subject_factory = CompositeSubjectFactory(angelina, brad)
-composite_subject_model = composite_subject_factory.get_midpoint_composite_subject_model()
+factory = CompositeSubjectFactory(angelina, brad)
+composite_model = factory.get_midpoint_composite_subject_model()
 
-composite_chart = KerykeionChartSVG(composite_subject_model, "Composite")
+composite_chart = KerykeionChartSVG(composite_model, "Composite")
 composite_chart.makeSVG()
 ```
 
 ![Angelina Jolie and Brad Pitt Composite Chart](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/master/tests/charts/svg/Angelina%20Jolie%20and%20Brad%20Pitt%20Composite%20Chart%20-%20Composite%20Chart.svg)
 
-### Change the output directory
+### Change the Output Directory
 
-By default the output directory is the home directory, you can change it by passing the new_output_directory parameter to the KerykeionChartSVG class:
+To save the SVG file in a custom location, specify `new_output_directory`:
 
 ```python
 from kerykeion import AstrologicalSubject, KerykeionChartSVG
@@ -208,23 +193,24 @@ from kerykeion import AstrologicalSubject, KerykeionChartSVG
 first = AstrologicalSubject("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
 second = AstrologicalSubject("Paul McCartney", 1942, 6, 18, 15, 30, "Liverpool", "GB")
 
-# Set the output directory to the current directory
-synastry_chart = KerykeionChartSVG(first, "Synastry", second, new_output_directory=".")
+synastry_chart = KerykeionChartSVG(
+    first, "Synastry", second,
+    new_output_directory="."
+)
 synastry_chart.makeSVG()
 ```
 
 ### Change Language
 
-You can change the language of the SVG by passing the `chart_language` parameter to the KerykeionChartSVG class:
+You can switch chart language by passing `chart_language` to the `AstrologicalSubject` or `KerykeionChartSVG` classes:
 
 ```python
 first = AstrologicalSubject("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB", chart_language="ES")
 ```
-More details [here](https://www.kerykeion.net/docs/examples/chart-language).
 
-## Report
+More details [here](https://www.kerykeion.net/docs//chart-language).
 
-To print a report of all the data:
+## Report
 
 ```python
 from kerykeion import Report, AstrologicalSubject
@@ -232,7 +218,6 @@ from kerykeion import Report, AstrologicalSubject
 kanye = AstrologicalSubject("Kanye", 1977, 6, 8, 8, 45, "Atlanta", "US")
 report = Report(kanye)
 report.print_report()
-
 ```
 
 Returns:
@@ -280,56 +265,57 @@ Returns:
 | Twelfth_House  | Gem  | 15.68    |
 +----------------+------+----------+
 
-```
-
-And if you want to export it to a file:
+To export to a file:
 
 ```bash
 python3 your_script_name.py > file.txt
 ```
 
-## Other examples of possible use cases:
+## Example: Retrieving Aspects
 
 ```python
-# Get all aspects between two persons:
-
 from kerykeion import SynastryAspects, AstrologicalSubject
+
 first = AstrologicalSubject("Jack", 1990, 6, 15, 15, 15, "Roma", "IT")
-second = AstrologicalSubject("Jane", 1991, 10, 25, 21, 00, "Roma", "IT")
+second = AstrologicalSubject("Jane", 1991, 10, 25, 21, 0, "Roma", "IT")
 
 name = SynastryAspects(first, second)
 aspect_list = name.get_relevant_aspects()
 print(aspect_list[0])
-
-#> Generating kerykeion object for Jack...
-#> Generating kerykeion object for Jane...
 #> {'p1_name': 'Sun', 'p1_abs_pos': 84.17867971515636, 'p2_name': 'Sun', 'p2_abs_pos': 211.90472999502984, 'aspect': 'trine', 'orbit': 7.726050279873476, 'aspect_degrees': 120, 'color': '#36d100', 'aid': 6, 'diff': 127.72605027987348, 'p1': 0, 'p2': 0}
 
 ```
 
 ## Ayanamsa (Sidereal Modes)
 
-By default, the zodiac type is set to Tropic (Tropical).
-You can set the zodiac type to Sidereal and the sidereal mode in the AstrologicalSubject class:
+By default, the zodiac type is **Tropical**. To use **Sidereal**, specify the sidereal mode:
 
 ```python
-johnny = AstrologicalSubject("Johnny Depp", 1963, 6, 9, 0, 0, "Owensboro", "US", zodiac_type="Sidereal", sidereal_mode="LAHIRI")
+johnny = AstrologicalSubject(
+    "Johnny Depp", 1963, 6, 9, 0, 0,
+    "Owensboro", "US",
+    zodiac_type="Sidereal",
+    sidereal_mode="LAHIRI"
+)
 ```
 
-More examples [here](https://www.kerykeion.net/docs/examples/sidereal-modes/).
+More examples [here](https://www.kerykeion.net/docs//sidereal-modes/).
 
 Full list of supported sidereal modes [here](https://www.kerykeion.net/pydocs/kerykeion/kr_types/kr_literals.html#SiderealMode).
 
-## Houses Systems
+## House Systems
 
-By default, the houses system is set to Placidus.
-You can set the houses system in the AstrologicalSubject class:
+By default, houses are calculated using **Placidus**. Configure a different house system as follows:
 
 ```python
-johnny = AstrologicalSubject("Johnny Depp", 1963, 6, 9, 0, 0, "Owensboro", "US", houses_system="M")
+johnny = AstrologicalSubject(
+    "Johnny Depp", 1963, 6, 9, 0, 0,
+    "Owensboro", "US",
+    houses_system="M"
+)
 ```
 
-More examples [here](https://www.kerykeion.net/docs/examples/houses-systems/).
+More examples [here](https://www.kerykeion.net/docs//houses-systems/).
 
 Full list of supported house systems [here](https://www.kerykeion.net/pydocs/kerykeion/kr_types/kr_literals.html#HousesSystem).
 
@@ -337,28 +323,30 @@ So far all the available houses system in the Swiss Ephemeris are supported but
 
 ## Perspective Type
 
-By default, the perspective type is set to Apparent Geocentric (the most common standard for astrology).
-The perspective indicates the point of view from which the chart is calculated (Es. Apparent Geocentric, Heliocentric, etc.).
-You can set the perspective type in the AstrologicalSubject class:
+By default, Kerykeion uses the **Apparent Geocentric** perspective (the most standard in astrology). Other perspectives (e.g., **Heliocentric**) can be set this way:
 
 ```python
-johnny = AstrologicalSubject("Johnny Depp", 1963, 6, 9, 0, 0, "Owensboro", "US", perspective_type="Heliocentric")
+johnny = AstrologicalSubject(
+    "Johnny Depp", 1963, 6, 9, 0, 0,
+    "Owensboro", "US",
+    perspective_type="Heliocentric"
+)
 ```
 
-More examples [here](https://www.kerykeion.net/docs/examples/perspective-type/).
+More examples [here](https://www.kerykeion.net/docs//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:
+Kerykeion provides several chart themes:
 
 - **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)
+  
+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/theming)
 
 Here's an example of how to set the theme:
 
@@ -370,28 +358,26 @@ dark_theme_natal_chart = KerykeionChartSVG(dark_high_contrast_theme_subject, the
 dark_theme_natal_chart.makeSVG()
 ```
 
-![John Lennon](https://www.kerykeion.net/assets/img/showcase/John%20Lennon%20-%20Dark%20-%20Natal%20Chart.svg)
+![John Lennon](https://www.kerykeion.net/img/showcase/John%20Lennon%20-%20Dark%20-%20Natal%20Chart.svg)
 
 ## Alternative Initialization
 
-You can initialize the AstrologicalSubject from a **UTC** ISO 8601 string:
+Create an `AstrologicalSubject` from a UTC ISO 8601 string:
 
 ```python
 subject = AstrologicalSubject.get_from_iso_utc_time(
-    "Johnny Depp", "1963-06-09T05:00:00Z", "Owensboro", "US")
+    "Johnny Depp", "1963-06-09T05:00:00Z", "Owensboro", "US"
+)
 ```
 
-Note : The default time zone is UTC, with Greenwich longitude and latitude.
-
-The default online/offline mode is set to offline, if you set it online the default latitude and longitude will be ignored and
-calculated from the city and nation. Remember to pass also the geonames_username parameter if you want to use the online mode, like this:
+If you set `online=True`, provide a `geonames_username` to allow city-based geolocation:
 
 ```python
 from kerykeion.astrological_subject import AstrologicalSubject
 
-# Use the static method get_from_iso_utc_time to create an instance of AstrologicalSubject
 subject = AstrologicalSubject.get_from_iso_utc_time(
-    "Johnny Depp", "1963-06-09T05:00:00Z", "Owensboro", "US", online=True)
+    "Johnny Depp", "1963-06-09T05:00:00Z", "Owensboro", "US", online=True
+)
 ```
 
 ## Lunar Nodes (Rahu & Ketu)
@@ -427,7 +413,7 @@ To display them, you need to edit the configuration file (kr.config.json).
 
 ## JSON Support
 
-The astrological subject, which is the base of data used in the library, can be easily serialized to JSON with the `json` method.
+You can serialize the astrological subject (the base data used throughout the library) to JSON:
 
 ```python
 from kerykeion import AstrologicalSubject
@@ -437,31 +423,25 @@ johnny = AstrologicalSubject("Johnny Depp", 1963, 6, 9, 0, 0, "Owensboro", "US")
 print(johnny.json(dump=False, indent=2))
 ```
 
-## Documentation
-
-Most of the functions and the classes are self documented by the types and have docstrings.
-An auto-generated documentation [is available here](https://www.kerykeion.net/pydocs/kerykeion.html).
+## Auto Generated Documentation
 
-Sooner or later I'll try to write an extensive documentation.
+You can find auto-generated documentation [here](https://www.kerykeion.net/pydocs/kerykeion.html). Most classes and functions include docstrings.
 
 ## Development
 
-You can clone this repository or download a zip file using the right side buttons.
+Clone the repository or download the ZIP via the GitHub interface.
 
-## Integrate Kerykeion Functionalities in Your Project
+## Integrating Kerykeion into Your Project
 
-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.
+If you would like to incorporate Kerykeion’s astrological features into your application, please reach out via [email](mailto:kerykeion.astrology@gmail.com?subject=Integration%20Request). Whether you need custom features, support, or specialized consulting, I am happy to discuss potential collaborations.
 
 ## 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: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.
+This project is covered under the AGPL-3.0 License. For detailed information, please see the [LICENSE](LICENSE) file. If you have questions, feel free to contact me at [kerykeion.astrology@gmail.com](mailto:kerykeion.astrology@gmail.com?subject=Kerykeion).
 
-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.
+As a rule of thumb, if you use this library in a project, you should open-source that project under a compatible license. Alternatively, if you wish to keep your source closed, consider using the [AstrologerAPI](https://rapidapi.com/gbattaglia/api/astrologer/), which is AGPL-3.0 compliant and also helps support the project.
 
 ## Contributing
 
-Feel free to contribute to the code!
+Contributions are welcome! Feel free to submit pull requests or report issues.
 

{kerykeion-4.25.3.dist-info → kerykeion-4.26.0rc1.dist-info}/RECORD

@@ -1,9 +1,10 @@
 LICENSE,sha256=UTLH8EdbAsgQei4PA2PnBCPGLSZkq5J-dhkyJuXgWQU,34273
-kerykeion/__init__.py,sha256=5uWwosgfy16r2g4pl6TJsee8Nz5-UTrpyrH1KTgfvc8,702
+kerykeion/__init__.py,sha256=2tiOzdqAj07A-wdHe30Gq3ElPnyWcLtOBodV_8tB37c,760
 kerykeion/aspects/__init__.py,sha256=9kx_Rx1NJx5SM7nDCSbI79S1neZ3c-q2NvQr-S6A9PY,292
 kerykeion/aspects/aspects_utils.py,sha256=Ej-E7Uvfi8x_ydP9dOhzhCp2uSpvX67T_VXuOjEKdoQ,3071
-kerykeion/aspects/natal_aspects.py,sha256=YAhf8Dqkx9kouealIzPae0VNK77P9-9oQhJw6dYXqo0,6661
-kerykeion/aspects/synastry_aspects.py,sha256=5vU8yJgAGRyVBoKvRpsg-0AcQg-imOzH91tvDM_RUNQ,5044
+kerykeion/aspects/natal_aspects.py,sha256=mwAGDPQE56PMoO8qSkJq7DDPb2aIz_0cVt5nfZHoaq0,6759
+kerykeion/aspects/synastry_aspects.py,sha256=9qw5cV1aiGI9vHFi41-2bBc-BfHU56tFPafZI-RQTiY,5155
+kerykeion/aspects/transits_time_range.py,sha256=_8FHnuWVE5A_9iB_uehMBNp9s8x30n-mMyN-X6-pNw8,1156
 kerykeion/astrological_subject.py,sha256=643axkLtIVPkOOTHhB4InHYn3XVEOBZdXLS9B-N7kSQ,36451
 kerykeion/charts/__init__.py,sha256=i9NMZ7LdkllPlqQSi1or9gTobHbROGDKmJhBDO4R0mA,128
 kerykeion/charts/charts_utils.py,sha256=TGmya60LMswUvQMi6irJWaboK6QRWCZ52wv5FMgaUT8,40424
@@ -18,13 +19,13 @@ kerykeion/charts/themes/dark.css,sha256=ml2lnzQVuS5DhCdoeUrDmMv9kB1nNceRt7hHbOHS
 kerykeion/charts/themes/light.css,sha256=ALf5U8tQsb6ky0N9R7ZLOHDrfKEXNM-sBR3JIRxFrCI,6092
 kerykeion/composite_subject_factory.py,sha256=ha66wQzcyJTb6XvJo3ppcZIZfvg4LQbFMLiIOm8Up0c,8245
 kerykeion/enums.py,sha256=nPXgP_ocsRnRno5H-yunZy3fp-hLZ9aYRaUb-2gBdvw,1199
-kerykeion/ephemeris_data.py,sha256=Cd5TK5nTkFHYU6bkLKjZRfiU4_6AgsWGcwBDrBHKrQk,8096
+kerykeion/ephemeris_data.py,sha256=SAPEuVPv6iB1R95kpVgymOC5P3_fj7E3eqMEhegtJfg,10995
 kerykeion/fetch_geonames.py,sha256=e66Nh6yq9A4VjnuvVSiV1TW1IkJ9m3Q2LKPWrkOGgO0,4764
 kerykeion/kr_types/__init__.py,sha256=jshJOccCQcYZuoOvrILRZH6imy4RBvKpFPujlNLFyGE,295
 kerykeion/kr_types/chart_types.py,sha256=EFXTddX1wwTzbLSDKw_ipg4tbOihTKPEnn2T9ooFSig,2123
 kerykeion/kr_types/kerykeion_exception.py,sha256=kE1y0K0rmuz32b4K_ZppSsZ59I2Get0ZkvOkTE5HejI,314
 kerykeion/kr_types/kr_literals.py,sha256=b1JEgByA8-PWtkM8TdkNb2aePr8dUApI-OH3ciulJF8,4327
-kerykeion/kr_types/kr_models.py,sha256=N7VhwxcMkXMjn5UNArleuxZ684woJzBjvvNC1CF7ttg,6824
+kerykeion/kr_types/kr_models.py,sha256=3ZHc9887zpaftlsetNQ2iEhwzwwF7J7WhjuIUyMAuVU,8347
 kerykeion/kr_types/settings_models.py,sha256=vo_feYdV_DFMw2aDQahe2q8W_OzsmzP0R91wxUxEZzg,11000
 kerykeion/relationship_score/__init__.py,sha256=cLaEBQXQBfyRkv0OaS3ceLROzvWcvKXWiRq0PS6LDjY,114
 kerykeion/relationship_score/relationship_score.py,sha256=lJkSbHw9nOUaPMrPxqcGhnVQIwAgI52K8BQzXXswb6A,6504
@@ -36,9 +37,10 @@ kerykeion/settings/kerykeion_settings.py,sha256=7GCGUzcctEg5uyWlzRk2YIotJSkCZDOV
 kerykeion/settings/kr.config.json,sha256=4ZB7fkM0xiiXDLtxPRVDIVm0lUMYahWQmCVugFe274I,42628
 kerykeion/sweph/README.md,sha256=L7FtNAJTWtrZNGKa8MX87SjduFYPYxwWhaI5fmtzNZo,73
 kerykeion/sweph/seas_18.se1,sha256=X9nCqhZU43wJpq61WAdueVQJt9xL2UjrwPqn1Kdoa1s,223002
+kerykeion/transits_time_range.py,sha256=mOAtJyVrHp1aFUnp9ERJ9z2X6jUcLQN8ECeSupV7F9g,5226
 kerykeion/utilities.py,sha256=sZUFZQJXrMieLPg-0hCTrvfGQaWuPx6cMi-t1kJAxPw,15534
-kerykeion-4.25.3.dist-info/LICENSE,sha256=UTLH8EdbAsgQei4PA2PnBCPGLSZkq5J-dhkyJuXgWQU,34273
-kerykeion-4.25.3.dist-info/METADATA,sha256=z2-LCuJBlGFi26Wtpiz1FJlPX5tBJyQgmnFDeKu0Plk,18976
-kerykeion-4.25.3.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-kerykeion-4.25.3.dist-info/entry_points.txt,sha256=5SmANYscFDDTdeovHvGQ-cnj0hdFvGoxPaWLCpyDFnQ,49
-kerykeion-4.25.3.dist-info/RECORD,,
+kerykeion-4.26.0rc1.dist-info/LICENSE,sha256=UTLH8EdbAsgQei4PA2PnBCPGLSZkq5J-dhkyJuXgWQU,34273
+kerykeion-4.26.0rc1.dist-info/METADATA,sha256=txeOgxvMbGH6eYXJ2IFDCM70Rm2Ex9wLoxR-P10sG5U,17098
+kerykeion-4.26.0rc1.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+kerykeion-4.26.0rc1.dist-info/entry_points.txt,sha256=5SmANYscFDDTdeovHvGQ-cnj0hdFvGoxPaWLCpyDFnQ,49
+kerykeion-4.26.0rc1.dist-info/RECORD,,