PyPI - kerykeion - Versions diffs - 5.0.0b5__tar.gz → 5.0.2__tar.gz - Mend - Supply Chain Defender

kerykeion 5.0.0b5tar.gz → 5.0.2tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of kerykeion might be problematic. Click here for more details.

Files changed (249) hide show

{kerykeion-5.0.0b5 → kerykeion-5.0.2}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kerykeion
-Version: 5.0.0b5
+Version: 5.0.2
 Summary: A Python library for astrological calculations, including natal charts, houses, planetary aspects, and SVG chart generation.
 Project-URL: Homepage, https://www.kerykeion.net/
 Project-URL: Repository, https://github.com/g-battaglia/kerykeion
@@ -64,7 +64,7 @@ Kerykeion also integrates seamlessly with LLM and AI applications.
 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)
+![John Lenon Chart](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/main/tests/charts/svg/John%20Lennon%20-%20Dark%20Theme%20-%20Natal%20Chart.svg)
 ## **Web API**
@@ -80,70 +80,69 @@ Maintaining this project requires substantial time and effort. The Astrologer AP
 [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/kerykeion)
-## ⚠️ Development Branch Notice
-This branch (`next`) is **not the stable version** of Kerykeion. It is the **development branch for the upcoming V5 release**.
-If you're looking for the latest stable version, please check out the [`master`](https://github.com/g-battaglia/kerykeion/tree/master) branch instead.
 ## Table of Contents
--   [**Web API**](#web-api)
--   [**Donate**](#donate)
--   [⚠️ Development Branch Notice](#️-development-branch-notice)
--   [Table of Contents](#table-of-contents)
--   [Installation](#installation)
--   [Basic Usage](#basic-usage)
--   [Generate a SVG Chart](#generate-a-svg-chart)
-    -   [Birth Chart](#birth-chart)
-    -   [External Birth Chart](#external-birth-chart)
-    -   [Synastry Chart](#synastry-chart)
-    -   [Transit Chart](#transit-chart)
-    -   [Composite Chart](#composite-chart)
--   [Wheel Only Charts](#wheel-only-charts)
-    -   [Birth Chart](#birth-chart-1)
-    -   [Wheel Only Birth Chart (External)](#wheel-only-birth-chart-external)
-    -   [Synastry Chart](#synastry-chart-1)
-    -   [Change the Output Directory](#change-the-output-directory)
-    -   [Change Language](#change-language)
-    -   [Minified SVG](#minified-svg)
-    -   [SVG without CSS Variables](#svg-without-css-variables)
-    -   [Grid Only SVG](#grid-only-svg)
--   [Report Generator](#report-generator)
-    -   [Quick Examples](#quick-examples)
-    -   [Section Access](#section-access)
--   [Example: Retrieving Aspects](#example-retrieving-aspects)
--   [Ayanamsa (Sidereal Modes)](#ayanamsa-sidereal-modes)
--   [House Systems](#house-systems)
--   [Perspective Type](#perspective-type)
--   [Themes](#themes)
--   [Alternative Initialization](#alternative-initialization)
--   [Lunar Nodes (Rahu \& Ketu)](#lunar-nodes-rahu--ketu)
--   [JSON Support](#json-support)
--   [Auto Generated Documentation](#auto-generated-documentation)
--   [Development](#development)
--   [Kerykeion v5.0 – What's New](#kerykeion-v50--whats-new)
-    -   [🎯 Key Highlights](#-key-highlights)
-        -   [Factory-Centered Architecture](#factory-centered-architecture)
-        -   [Pydantic 2 Models \& Type Safety](#pydantic-2-models--type-safety)
-        -   [Enhanced Features](#enhanced-features)
-    -   [🚨 Breaking Changes](#-breaking-changes)
-        -   [1. Removed Legacy Classes](#1-removed-legacy-classes)
-        -   [2. Import Changes](#2-import-changes)
-        -   [3. Lunar Nodes Naming](#3-lunar-nodes-naming)
-        -   [4. Chart Generation Changes](#4-chart-generation-changes)
-        -   [5. Aspects API Changes](#5-aspects-api-changes)
-    -   [🔄 Migration Guide](#-migration-guide)
-        -   [Using the Backward Compatibility Layer](#using-the-backward-compatibility-layer)
-        -   [Step-by-Step Migration](#step-by-step-migration)
-        -   [Automated Migration Script](#automated-migration-script)
-    -   [📦 Other Notable Changes](#-other-notable-changes)
-    -   [🎨 New Themes](#-new-themes)
-    -   [📚 Resources](#-resources)
--   [Integrating Kerykeion into Your Project](#integrating-kerykeion-into-your-project)
--   [License](#license)
--   [Contributing](#contributing)
--   [Citations](#citations)
+- [**Web API**](#web-api)
+- [**Donate**](#donate)
+- [Table of Contents](#table-of-contents)
+- [Installation](#installation)
+- [Basic Usage](#basic-usage)
+- [Generate a SVG Chart](#generate-a-svg-chart)
+  - [Birth Chart](#birth-chart)
+  - [External Birth Chart](#external-birth-chart)
+  - [Synastry Chart](#synastry-chart)
+  - [Transit Chart](#transit-chart)
+  - [Solar Return Chart (Dual Wheel)](#solar-return-chart-dual-wheel)
+  - [Solar Return Chart (Single Wheel)](#solar-return-chart-single-wheel)
+  - [Lunar Return Chart](#lunar-return-chart)
+  - [Composite Chart](#composite-chart)
+- [Wheel Only Charts](#wheel-only-charts)
+  - [Birth Chart](#birth-chart-1)
+  - [Wheel Only Birth Chart (External)](#wheel-only-birth-chart-external)
+  - [Synastry Chart](#synastry-chart-1)
+  - [Change the Output Directory](#change-the-output-directory)
+  - [Change Language](#change-language)
+  - [Minified SVG](#minified-svg)
+  - [SVG without CSS Variables](#svg-without-css-variables)
+  - [Grid Only SVG](#grid-only-svg)
+- [Report Generator](#report-generator)
+  - [Quick Examples](#quick-examples)
+  - [Section Access](#section-access)
+- [Example: Retrieving Aspects](#example-retrieving-aspects)
+- [Element \& Quality Distribution Strategies](#element--quality-distribution-strategies)
+- [Ayanamsa (Sidereal Modes)](#ayanamsa-sidereal-modes)
+- [House Systems](#house-systems)
+- [Perspective Type](#perspective-type)
+- [Themes](#themes)
+- [Alternative Initialization](#alternative-initialization)
+- [Lunar Nodes (Rahu \& Ketu)](#lunar-nodes-rahu--ketu)
+- [JSON Support](#json-support)
+- [Auto Generated Documentation](#auto-generated-documentation)
+- [Development](#development)
+- [Kerykeion v5.0 – What's New](#kerykeion-v50--whats-new)
+  - [🎯 Key Highlights](#-key-highlights)
+    - [Factory-Centered Architecture](#factory-centered-architecture)
+    - [Pydantic 2 Models \& Type Safety](#pydantic-2-models--type-safety)
+    - [Enhanced Features](#enhanced-features)
+  - [🚨 Breaking Changes](#-breaking-changes)
+    - [1. Removed Legacy Classes](#1-removed-legacy-classes)
+    - [2. Import Changes](#2-import-changes)
+    - [3. Type Aliases Unified](#3-type-aliases-unified)
+    - [4. Lunar Nodes Naming](#4-lunar-nodes-naming)
+    - [5. Axis Orb Filtering](#5-axis-orb-filtering)
+    - [6. Chart Generation Changes](#6-chart-generation-changes)
+    - [7. Aspects API Changes](#7-aspects-api-changes)
+  - [🔄 Migration Guide](#-migration-guide)
+    - [Using the Backward Compatibility Layer](#using-the-backward-compatibility-layer)
+    - [Step-by-Step Migration](#step-by-step-migration)
+    - [Automated Migration Script](#automated-migration-script)
+  - [📦 Other Notable Changes](#-other-notable-changes)
+  - [🎨 New Themes](#-new-themes)
+  - [📚 Resources](#-resources)
+- [Integrating Kerykeion into Your Project](#integrating-kerykeion-into-your-project)
+- [License](#license)
+- [Contributing](#contributing)
+- [Citations](#citations)
 ## Installation
@@ -216,7 +215,7 @@ birth_chart_svg.save_svg()
 ```
 The SVG file will be saved in the home directory.
-![John Lennon Birth Chart](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/master/tests/charts/svg/John%20Lennon%20-%20Natal%20Chart.svg)
+![John Lennon Birth Chart](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/main/tests/charts/svg/John%20Lennon%20-%20Natal%20Chart.svg)
 ### External Birth Chart
@@ -229,14 +228,14 @@ from kerykeion.charts.chart_drawer import ChartDrawer
 birth_chart = AstrologicalSubjectFactory.from_birth_data("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
 # Step 2: Pre-compute chart data for external natal chart
-chart_data = ChartDataFactory.create_external_natal_chart_data(birth_chart)
+chart_data = ChartDataFactory.create_natal_chart_data(birth_chart)
 # Step 3: Create visualization
 birth_chart_svg = ChartDrawer(chart_data=chart_data)
 birth_chart_svg.save_svg()
 ```
-![John Lennon External Birth Chart](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/master/tests/charts/svg/John%20Lennon%20-%20ExternalNatal%20Chart.svg)
+![John Lennon External Birth Chart](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/main/tests/charts/svg/John%20Lennon%20-%20ExternalNatal%20-%20Natal%20Chart.svg)
 ### Synastry Chart
@@ -278,7 +277,105 @@ transit_chart = ChartDrawer(chart_data=chart_data)
 transit_chart.save_svg()
 ```
-![John Lennon Transit Chart](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/master/tests/charts/svg/John%20Lennon%20-%20Transit%20Chart.svg)
+![John Lennon Transit Chart](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/main/tests/charts/svg/John%20Lennon%20-%20Transit%20Chart.svg)
+### Solar Return Chart (Dual Wheel)
+```python
+from kerykeion import AstrologicalSubjectFactory
+from kerykeion.planetary_return_factory import PlanetaryReturnFactory
+from kerykeion.chart_data_factory import ChartDataFactory
+from kerykeion.charts.chart_drawer import ChartDrawer
+# Step 1: Create natal subject
+john = AstrologicalSubjectFactory.from_birth_data("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
+# Step 2: Calculate Solar Return subject (offline example with manual coordinates)
+return_factory = PlanetaryReturnFactory(
+    john,
+    lng=-2.9833,
+    lat=53.4000,
+    tz_str="Europe/London",
+    online=False
+)
+solar_return_subject = return_factory.next_return_from_year(1964, "Solar")
+# Step 3: Pre-compute return chart data (dual wheel: natal + solar return)
+chart_data = ChartDataFactory.create_return_chart_data(john, solar_return_subject)
+# Step 4: Create visualization
+solar_return_chart = ChartDrawer(chart_data=chart_data)
+solar_return_chart.save_svg()
+```
+![John Lennon Solar Return Chart (Dual Wheel)](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/main/tests/charts/svg/John%20Lennon%20-%20DualReturnChart%20Chart%20-%20Solar%20Return.svg)
+### Solar Return Chart (Single Wheel)
+```python
+from kerykeion import AstrologicalSubjectFactory
+from kerykeion.planetary_return_factory import PlanetaryReturnFactory
+from kerykeion.chart_data_factory import ChartDataFactory
+from kerykeion.charts.chart_drawer import ChartDrawer
+# Step 1: Create natal subject
+john = AstrologicalSubjectFactory.from_birth_data("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
+# Step 2: Calculate Solar Return subject (offline example with manual coordinates)
+return_factory = PlanetaryReturnFactory(
+    john,
+    lng=-2.9833,
+    lat=53.4000,
+    tz_str="Europe/London",
+    online=False
+)
+solar_return_subject = return_factory.next_return_from_year(1964, "Solar")
+# Step 3: Build a single-wheel return chart
+chart_data = ChartDataFactory.create_single_wheel_return_chart_data(solar_return_subject)
+# Step 4: Create visualization
+single_wheel_chart = ChartDrawer(chart_data=chart_data)
+single_wheel_chart.save_svg()
+```
+![John Lennon Solar Return Chart (Single Wheel)](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/main/tests/charts/svg/John%20Lennon%20Solar%20Return%20-%20SingleReturnChart%20Chart.svg)
+### Lunar Return Chart
+```python
+from kerykeion import AstrologicalSubjectFactory
+from kerykeion.planetary_return_factory import PlanetaryReturnFactory
+from kerykeion.chart_data_factory import ChartDataFactory
+from kerykeion.charts.chart_drawer import ChartDrawer
+# Step 1: Create natal subject
+john = AstrologicalSubjectFactory.from_birth_data("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
+# Step 2: Calculate Lunar Return subject
+return_factory = PlanetaryReturnFactory(
+    john,
+    lng=-2.9833,
+    lat=53.4000,
+    tz_str="Europe/London",
+    online=False
+)
+lunar_return_subject = return_factory.next_return_from_year(1964, "Lunar")
+# Step 3: Build a dual wheel (natal + lunar return)
+lunar_return_chart_data = ChartDataFactory.create_return_chart_data(john, lunar_return_subject)
+dual_wheel_chart = ChartDrawer(chart_data=lunar_return_chart_data)
+dual_wheel_chart.save_svg()
+# Optional: create a single-wheel lunar return
+single_wheel_data = ChartDataFactory.create_single_wheel_return_chart_data(lunar_return_subject)
+single_wheel_chart = ChartDrawer(chart_data=single_wheel_data)
+single_wheel_chart.save_svg()
+```
+![John Lennon Lunar Return Chart (Dual Wheel)](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/main/tests/charts/svg/John%20Lennon%20-%20DualReturnChart%20Chart%20-%20Lunar%20Return.svg)
+![John Lennon Lunar Return Chart (Single Wheel)](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/main/tests/charts/svg/John%20Lennon%20Lunar%20Return%20-%20SingleReturnChart%20Chart.svg)
 ### Composite Chart
@@ -304,7 +401,7 @@ composite_chart = ChartDrawer(chart_data=chart_data)
 composite_chart.save_svg()
 ```
-![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)
+![Angelina Jolie and Brad Pitt Composite Chart](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/main/tests/charts/svg/Angelina%20Jolie%20and%20Brad%20Pitt%20Composite%20Chart%20-%20Composite%20Chart.svg)
 ## Wheel Only Charts
@@ -328,7 +425,7 @@ birth_chart_svg = ChartDrawer(chart_data=chart_data)
 birth_chart_svg.save_wheel_only_svg_file()
 ```
-![John Lennon Birth Chart](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/master/tests/charts/svg/John%20Lennon%20-%20Wheel%20Only%20-%20Natal%20Chart%20-%20Wheel%20Only.svg)
+![John Lennon Birth Chart](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/main/tests/charts/svg/John%20Lennon%20-%20Wheel%20Only%20-%20Natal%20Chart%20-%20Wheel%20Only.svg)
 ### Wheel Only Birth Chart (External)
@@ -341,7 +438,7 @@ from kerykeion.charts.chart_drawer import ChartDrawer
 birth_chart = AstrologicalSubjectFactory.from_birth_data("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
 # Step 2: Pre-compute external natal chart data
-chart_data = ChartDataFactory.create_external_natal_chart_data(birth_chart)
+chart_data = ChartDataFactory.create_natal_chart_data(birth_chart)
 # Step 3: Create visualization
 birth_chart_svg = ChartDrawer(chart_data=chart_data)
@@ -351,7 +448,7 @@ birth_chart_svg.save_wheel_only_svg_file(
 )
 ```
-![John Lennon Birth Chart](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/master/tests/charts/svg/John%20Lennon%20-%20Wheel%20External%20Only%20-%20ExternalNatal%20Chart%20-%20Wheel%20Only.svg)
+![John Lennon Birth Chart](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/main/tests/charts/svg/John%20Lennon%20-%20Wheel%20External%20Only%20-%20ExternalNatal%20Chart%20-%20Wheel%20Only.svg)
 ### Synastry Chart
@@ -372,7 +469,7 @@ synastry_chart = ChartDrawer(chart_data=chart_data)
 synastry_chart.save_wheel_only_svg_file()
 ```
-![John Lennon and Paul McCartney Synastry](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/master/tests/charts/svg/John%20Lennon%20-%20Wheel%20Synastry%20Only%20-%20Synastry%20Chart%20-%20Wheel%20Only.svg)
+![John Lennon and Paul McCartney Synastry](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/main/tests/charts/svg/John%20Lennon%20-%20Wheel%20Synastry%20Only%20-%20Synastry%20Chart%20-%20Wheel%20Only.svg)
 ### Change the Output Directory
@@ -416,6 +513,7 @@ birth_chart_svg = ChartDrawer(
     chart_language="IT"  # Change to Italian
 )
 birth_chart_svg.save_svg()
+```
 You can also provide custom labels (or introduce a brand-new language) by passing
 a dictionary to `language_pack`. Only the keys you supply are merged on top of the
@@ -435,7 +533,6 @@ birth_chart_svg = ChartDrawer(
     language_pack=custom_labels["PT"],
 )
 ```
-```
 More details [here](https://www.kerykeion.net/docs/chart-language).
@@ -518,7 +615,7 @@ aspect_grid_chart = ChartDrawer(chart_data=chart_data, theme="dark")
 aspect_grid_chart.save_aspect_grid_only_svg_file()
 ```
-![John Lennon Birth Chart](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/master/tests/charts/svg/John%20Lennon%20-%20Aspect%20Grid%20Only%20-%20Natal%20Chart%20-%20Aspect%20Grid%20Only.svg)
+![John Lennon Birth Chart](https://raw.githubusercontent.com/g-battaglia/kerykeion/refs/heads/main/tests/charts/svg/John%20Lennon%20-%20Aspect%20Grid%20Only%20-%20Natal%20Chart%20-%20Aspect%20Grid%20Only.svg)
 ## Report Generator