Skip to content

New Release: Kerykeion 4.13.0

Compare
Choose a tag to compare
@g-battaglia g-battaglia released this 19 Jul 18:56
· 181 commits to master since this release

🚀 New Release: Kerykeion 4.13.0 🚀

I'm excited to announce the release of Kerykeion 4.13.0!

🌟 New Feature: Ephemeris Data Factory 🌟

I have introduced a powerful new feature that allows you to generate ephemeris data for a specified date range with ease. The EphemerisDataFactory class provides extensive customization options to suit your astrological needs.

Key Features:

  • Date Range Customization: Specify start_datetime and end_datetime for generating data.
  • Step Type Flexibility: Choose from days, hours, or minutes for step intervals.
  • Location Parameters: Define latitude and longitude for precise calculations.
  • Timezone Support: Set the timezone string and daylight saving time status.
  • Zodiac and Houses System Options: Customize zodiac type, sidereal mode, houses system identifier, and perspective type.
  • Data Limits: Configure maximum allowable days, hours, or minutes to prevent overload.

Usage Example

from datetime import datetime
from kerykeion.ephemeris_data_factory import EphemerisDataFactory

start_date = datetime.fromisoformat("2020-01-01")
end_date = datetime.fromisoformat("2050-01-03")

factory = EphemerisDataFactory(
    start_datetime=start_date,
    end_datetime=end_date,
    step_type="hours",
    step=1,
    lat=37.9838,
    lng=23.7275,
    tz_str="Europe/Athens",
    is_dst=False,
)

ephemeris_data = factory.get_ephemeris_data(as_model=True)
print(ephemeris_data[0])
print(len(ephemeris_data))

🌟 New Parameter: is_dst in AstrologicalSubject 🌟

A new parameter, is_dst, has been added to the AstrologicalSubject class to enhance the handling of daylight saving time (DST).

Parameter Details:

  • is_dst (Union[None, bool], optional): Specify if the time is in DST. Defaults to None.
    • By default (None), the library will try to guess if the time is in DST or not and raise an AmbiguousTimeError if it can't guess.
    • If you know the time is in DST, set this to True; if you know it's not, set it to False.

🛠️ Bug Fixes

I have addressed several bugs in this release to improve the stability of the library.

🆙 Upgrade

Upgrade to Kerykeion 4.13.0 now to take advantage of these new features and improvements!

Happy coding and clear skies! 🌠