kerykeion 4.26.0rc1__tar.gz → 4.26.1__tar.gz

{kerykeion-4.26.0rc1 → kerykeion-4.26.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: kerykeion
-Version: 4.26.0rc1
+Version: 4.26.1
 Summary: A python library for astrology.
 Home-page: https://www.kerykeion.net/
 License: AGPL-3.0
@@ -53,17 +53,18 @@ Description-Content-Type: text/markdown
 
  
 
-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.
+Kerykeion is a Python library for astrology. It computes planetary and house positions, detects aspects, 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.
 
-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.
+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)
 
-## Web API
+**Web API**
+---
 
 If you want to use Kerykeion in a web application, you can try the dedicated web API:
 
@@ -71,12 +72,40 @@ If you want to use Kerykeion in a web application, you can try the dedicated web
 
 It is [open source](https://github.com/g-battaglia/Astrologer-API) and directly supports this project.
 
-## Donate
+**Donate**
+--
 
 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)
 
+
+## Table of Contents
+- [Installation](#installation)
+- [Basic Usage](#basic-usage)
+- [Generate a SVG Chart](#generate-a-svg-chart)
+  - [Birth Chart](#birth-chart)
+  - [Synastry Chart](#synastry-chart)
+  - [Transit Chart](#transit-chart)
+  - [Composite Chart](#composite-chart)
+  - [Change the Output Directory](#change-the-output-directory)
+  - [Change Language](#change-language)
+- [Report](#report)
+- [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)
+- [Integrating Kerykeion into Your Project](#integrating-kerykeion-into-your-project)
+- [License](#license)
+- [Contributing](#contributing)
+- [Citations](#citations)
+
 ## Installation
 
 Kerykeion requires **Python 3.9** or higher.
@@ -382,34 +411,49 @@ subject = AstrologicalSubject.get_from_iso_utc_time(
 
 ## Lunar Nodes (Rahu & Ketu)
 
-The following are present:
+Kerykeion supports both **True** and **Mean** Lunar Nodes:
 
-- True North Lunar Node: Simply referred to as "true_node" (without the term "north") for backward compatibility.
-- True South Lunar Node: Referred to as "true_south_node."
-- Mean North Lunar Node: Referred to as "mean_node" (without the term "north") for backward compatibility.
-- Mean South Lunar Node: Referred to as "mean_south_node."
+- **True North Lunar Node**: `"true_node"` (name kept without "north" for backward compatibility).
+- **True South Lunar Node**: `"true_south_node"`.
+- **Mean North Lunar Node**: `"mean_node"` (name kept without "north" for backward compatibility).
+- **Mean South Lunar Node**: `"mean_south_node"`.
 
 In instances of the AstrologicalSubject class, all of them are active by default.
 
-In instances of the classes used to generate aspects and SVG charts, only the mean nodes are active. To activate the true nodes, you need to edit the configuration file (kr.config.json).
+In instances of the classes used to generate aspects and SVG charts, only the mean nodes are active. To activate the true nodes, you need to pass the `active_points` parameter to the `KerykeionChartSVG` class.
+
 Example:
 
-```json
-...
-    {
-      "id": 19,
-      "name": "True_South_Node",
-      "color": "var(--kerykeion-chart-color-true-node)",
-      "is_active": true, // Set to true to activate the true node
-      "element_points": 0,
-      "related_zodiac_signs": [],
-      "label": "True_South_Node"
-    }
-...
-```
+```python
+from kerykeion import AstrologicalSubject, KerykeionChartSVG
+
+subject = AstrologicalSubject("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
 
-In the charts, by default, the mean nodes (M) are displayed, while the true nodes are not displayed. 
-To display them, you need to edit the configuration file (kr.config.json).
+chart = KerykeionChartSVG(
+    subject,
+    active_points=[
+        "Sun", 
+        "Moon", 
+        "Mercury", 
+        "Venus", 
+        "Mars", 
+        "Jupiter", 
+        "Saturn",
+        "Uranus", 
+        "Neptune", 
+        "Pluto", 
+        "Mean_Node", 
+        "Mean_South_Node", 
+        "True_Node",       # Activates True North Node 
+        "True_South_Node", # Activates True South Node
+        "Ascendant",
+        "Medium_Coeli", 
+        "Descendant", 
+        "Imum_Coeli"
+    ]
+)
+chart.makeSVG()
+```
 
 ## JSON Support
 
@@ -441,7 +485,18 @@ This project is covered under the AGPL-3.0 License. For detailed information, pl
 
 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.
 
+Since the AstrologerAPI is an external third-party service, using it does *not* require your code to be open-source.
+
 ## Contributing
 
 Contributions are welcome! Feel free to submit pull requests or report issues.
 
+## Citations
+
+If using Kerykeion in published or academic work, please cite as follows:
+
+```
+Battaglia, G. (2025). Kerykeion: A Python Library for Astrological Calculations and Chart Generation.
+https://github.com/g-battaglia/kerykeion
+```
+

{kerykeion-4.26.0rc1 → kerykeion-4.26.1}/README.md

@@ -14,17 +14,18 @@
 
  
 
-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.
+Kerykeion is a Python library for astrology. It computes planetary and house positions, detects aspects, 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.
 
-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.
+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)
 
-## Web API
+**Web API**
+---
 
 If you want to use Kerykeion in a web application, you can try the dedicated web API:
 
@@ -32,12 +33,40 @@ If you want to use Kerykeion in a web application, you can try the dedicated web
 
 It is [open source](https://github.com/g-battaglia/Astrologer-API) and directly supports this project.
 
-## Donate
+**Donate**
+--
 
 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)
 
+
+## Table of Contents
+- [Installation](#installation)
+- [Basic Usage](#basic-usage)
+- [Generate a SVG Chart](#generate-a-svg-chart)
+  - [Birth Chart](#birth-chart)
+  - [Synastry Chart](#synastry-chart)
+  - [Transit Chart](#transit-chart)
+  - [Composite Chart](#composite-chart)
+  - [Change the Output Directory](#change-the-output-directory)
+  - [Change Language](#change-language)
+- [Report](#report)
+- [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)
+- [Integrating Kerykeion into Your Project](#integrating-kerykeion-into-your-project)
+- [License](#license)
+- [Contributing](#contributing)
+- [Citations](#citations)
+
 ## Installation
 
 Kerykeion requires **Python 3.9** or higher.
@@ -343,34 +372,49 @@ subject = AstrologicalSubject.get_from_iso_utc_time(
 
 ## Lunar Nodes (Rahu & Ketu)
 
-The following are present:
+Kerykeion supports both **True** and **Mean** Lunar Nodes:
 
-- True North Lunar Node: Simply referred to as "true_node" (without the term "north") for backward compatibility.
-- True South Lunar Node: Referred to as "true_south_node."
-- Mean North Lunar Node: Referred to as "mean_node" (without the term "north") for backward compatibility.
-- Mean South Lunar Node: Referred to as "mean_south_node."
+- **True North Lunar Node**: `"true_node"` (name kept without "north" for backward compatibility).
+- **True South Lunar Node**: `"true_south_node"`.
+- **Mean North Lunar Node**: `"mean_node"` (name kept without "north" for backward compatibility).
+- **Mean South Lunar Node**: `"mean_south_node"`.
 
 In instances of the AstrologicalSubject class, all of them are active by default.
 
-In instances of the classes used to generate aspects and SVG charts, only the mean nodes are active. To activate the true nodes, you need to edit the configuration file (kr.config.json).
+In instances of the classes used to generate aspects and SVG charts, only the mean nodes are active. To activate the true nodes, you need to pass the `active_points` parameter to the `KerykeionChartSVG` class.
+
 Example:
 
-```json
-...
-    {
-      "id": 19,
-      "name": "True_South_Node",
-      "color": "var(--kerykeion-chart-color-true-node)",
-      "is_active": true, // Set to true to activate the true node
-      "element_points": 0,
-      "related_zodiac_signs": [],
-      "label": "True_South_Node"
-    }
-...
-```
+```python
+from kerykeion import AstrologicalSubject, KerykeionChartSVG
+
+subject = AstrologicalSubject("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
 
-In the charts, by default, the mean nodes (M) are displayed, while the true nodes are not displayed. 
-To display them, you need to edit the configuration file (kr.config.json).
+chart = KerykeionChartSVG(
+    subject,
+    active_points=[
+        "Sun", 
+        "Moon", 
+        "Mercury", 
+        "Venus", 
+        "Mars", 
+        "Jupiter", 
+        "Saturn",
+        "Uranus", 
+        "Neptune", 
+        "Pluto", 
+        "Mean_Node", 
+        "Mean_South_Node", 
+        "True_Node",       # Activates True North Node 
+        "True_South_Node", # Activates True South Node
+        "Ascendant",
+        "Medium_Coeli", 
+        "Descendant", 
+        "Imum_Coeli"
+    ]
+)
+chart.makeSVG()
+```
 
 ## JSON Support
 
@@ -402,6 +446,17 @@ This project is covered under the AGPL-3.0 License. For detailed information, pl
 
 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.
 
+Since the AstrologerAPI is an external third-party service, using it does *not* require your code to be open-source.
+
 ## Contributing
 
 Contributions are welcome! Feel free to submit pull requests or report issues.
+
+## Citations
+
+If using Kerykeion in published or academic work, please cite as follows:
+
+```
+Battaglia, G. (2025). Kerykeion: A Python Library for Astrological Calculations and Chart Generation.
+https://github.com/g-battaglia/kerykeion
+```

{kerykeion-4.26.0rc1 → kerykeion-4.26.1}/kerykeion/charts/kerykeion_chart_svg.py

@@ -37,7 +37,7 @@ from kerykeion.charts.charts_utils import (
     draw_planet_grid,
 )
 from kerykeion.charts.draw_planets import draw_planets # type: ignore
-from kerykeion.utilities import get_houses_list
+from kerykeion.utilities import get_houses_list, inline_css_variables_in_svg
 from kerykeion.settings.config_constants import DEFAULT_ACTIVE_POINTS, DEFAULT_ACTIVE_ASPECTS
 from pathlib import Path
 from scour.scour import scourString
@@ -47,23 +47,44 @@ from datetime import datetime
 
 class KerykeionChartSVG:
     """
-    Creates the instance that can generate the chart with the
-    function makeSVG().
-
-    Parameters:
-        - first_obj: First kerykeion object
-        - chart_type: Natal, ExternalNatal, Transit, Synastry (Default: Type="Natal").
-        - second_obj: Second kerykeion object (Not required if type is Natal)
-        - new_output_directory: Set the output directory (default: home directory).
-        - new_settings_file: Set the settings file (default: kr.config.json).
-            In the settings file you can set the language, colors, planets, aspects, etc.
-        - theme: Set the theme for the chart (default: classic). If None the <style> tag will be empty.
-            That's useful if you want to use your own CSS file customizing the value of the default theme variables.
-        - double_chart_aspect_grid_type: Set the type of the aspect grid for the double chart (transit or synastry). (Default: list.)
-        - chart_language: Set the language for the chart (default: EN).
-        - active_points: Set the active points for the chart (default: DEFAULT_ACTIVE_POINTS). Example:
-            ["Sun", "Moon", "Mercury", "Venus", "Mars", "Jupiter", "Saturn", "Uranus", "Neptune", "Pluto", "True_Node", "True_South_Node", "Ascendant", "Medium_Coeli", "Descendant", "Imum_Coeli"]
-        - active_aspects: Set the active aspects for the chart (default: DEFAULT_ACTIVE_ASPECTS). Example:
+    KerykeionChartSVG generates astrological chart visualizations as SVG files.
+
+    This class supports creating full chart SVGs, wheel-only SVGs, and aspect-grid-only SVGs
+    for various chart types including Natal, ExternalNatal, Transit, Synastry, and Composite.
+    Charts are rendered using XML templates and drawing utilities, with customizable themes,
+    language, active points, and aspects.
+    The rendered SVGs can be saved to a specified output directory or, by default, to the user's home directory.
+
+    NOTE:
+        The generated SVG files are optimized for web use, opening in browsers. If you want to
+        use them in other applications, you might need to adjust the SVG settings or styles.
+
+    Args:
+        first_obj (AstrologicalSubject | AstrologicalSubjectModel | CompositeSubjectModel):
+            The primary astrological subject for the chart.
+        chart_type (ChartType, optional):
+            The type of chart to generate ('Natal', 'ExternalNatal', 'Transit', 'Synastry', 'Composite').
+            Defaults to 'Natal'.
+        second_obj (AstrologicalSubject | AstrologicalSubjectModel, optional):
+            The secondary subject for Transit or Synastry charts. Not required for Natal or Composite.
+        new_output_directory (str | Path, optional):
+            Directory to write generated SVG files. Defaults to the user's home directory.
+        new_settings_file (Path | dict | KerykeionSettingsModel, optional):
+            Path or settings object to override default chart configuration (colors, fonts, aspects).
+        theme (KerykeionChartTheme, optional):
+            CSS theme for the chart. If None, no default styles are applied. Defaults to 'classic'.
+        double_chart_aspect_grid_type (Literal['list', 'table'], optional):
+            Specifies rendering style for double-chart aspect grids. Defaults to 'list'.
+        chart_language (KerykeionChartLanguage, optional):
+            Language code for chart labels. Defaults to 'EN'.
+        active_points (list[Planet | AxialCusps], optional):
+            List of celestial points and angles to include. Defaults to DEFAULT_ACTIVE_POINTS.
+            Example:
+            ["Sun", "Moon", "Mercury", "Venus"]
+
+        active_aspects (list[ActiveAspect], optional):
+            List of aspects (name and orb) to calculate. Defaults to DEFAULT_ACTIVE_ASPECTS.
+            Example:
             [
                 {"name": "conjunction", "orb": 10},
                 {"name": "opposition", "orb": 10},
@@ -72,6 +93,30 @@ class KerykeionChartSVG:
                 {"name": "square", "orb": 5},
                 {"name": "quintile", "orb": 1},
             ]
+
+    Public Methods:
+        makeTemplate(minify=False, remove_css_variables=False) -> str:
+            Render the full chart SVG as a string without writing to disk. Use `minify=True`
+            to remove whitespace and quotes, and `remove_css_variables=True` to embed CSS vars.
+
+        makeSVG(minify=False, remove_css_variables=False) -> None:
+            Generate and write the full chart SVG file to the output directory.
+            Filenames follow the pattern:
+            '{subject.name} - {chart_type} Chart.svg'.
+
+        makeWheelOnlyTemplate(minify=False, remove_css_variables=False) -> str:
+            Render only the chart wheel (no aspect grid) as an SVG string.
+
+        makeWheelOnlySVG(minify=False, remove_css_variables=False) -> None:
+            Generate and write the wheel-only SVG file:
+            '{subject.name} - {chart_type} Chart - Wheel Only.svg'.
+
+        makeAspectGridOnlyTemplate(minify=False, remove_css_variables=False) -> str:
+            Render only the aspect grid as an SVG string.
+
+        makeAspectGridOnlySVG(minify=False, remove_css_variables=False) -> None:
+            Generate and write the aspect-grid-only SVG file:
+            '{subject.name} - {chart_type} Chart - Aspect Grid Only.svg'.
     """
 
     # Constants
@@ -131,8 +176,33 @@ class KerykeionChartSVG:
         double_chart_aspect_grid_type: Literal["list", "table"] = "list",
         chart_language: KerykeionChartLanguage = "EN",
         active_points: List[Union[Planet, AxialCusps]] = DEFAULT_ACTIVE_POINTS,
-        active_aspects: List[ActiveAspect] = DEFAULT_ACTIVE_ASPECTS,
+    active_aspects: List[ActiveAspect] = DEFAULT_ACTIVE_ASPECTS,
     ):
+        """
+        Initialize the chart generator with subject data and configuration options.
+
+        Args:
+            first_obj (AstrologicalSubject, AstrologicalSubjectModel, or CompositeSubjectModel):
+                Primary astrological subject instance.
+            chart_type (ChartType, optional):
+                Type of chart to generate (e.g., 'Natal', 'Transit').
+            second_obj (AstrologicalSubject or AstrologicalSubjectModel, optional):
+                Secondary subject for Transit or Synastry charts.
+            new_output_directory (str or Path, optional):
+                Base directory to save generated SVG files.
+            new_settings_file (Path, dict, or KerykeionSettingsModel, optional):
+                Custom settings source for chart colors, fonts, and aspects.
+            theme (KerykeionChartTheme or None, optional):
+                CSS theme to apply; None for default styling.
+            double_chart_aspect_grid_type (Literal['list','table'], optional):
+                Layout style for double-chart aspect grids ('list' or 'table').
+            chart_language (KerykeionChartLanguage, optional):
+                Language code for chart labels (e.g., 'EN', 'IT').
+            active_points (List[Planet or AxialCusps], optional):
+                Celestial points to include in the chart visualization.
+            active_aspects (List[ActiveAspect], optional):
+                Aspects to calculate, each defined by name and orb.
+        """
         home_directory = Path.home()
         self.new_settings_file = new_settings_file
         self.chart_language = chart_language
@@ -269,7 +339,10 @@ class KerykeionChartSVG:
 
     def set_up_theme(self, theme: Union[KerykeionChartTheme, None] = None) -> None:
         """
-        Set the theme for the chart.
+        Load and apply a CSS theme for the chart visualization.
+
+        Args:
+            theme (KerykeionChartTheme or None): Name of the theme to apply. If None, no CSS is applied.
         """
         if theme is None:
             self.color_style_tag = ""
@@ -282,14 +355,21 @@ class KerykeionChartSVG:
 
     def set_output_directory(self, dir_path: Path) -> None:
         """
-        Sets the output direcotry and returns it's path.
+        Set the directory where generated SVG files will be saved.
+
+        Args:
+            dir_path (Path): Target directory for SVG output.
         """
         self.output_directory = dir_path
         logging.info(f"Output direcotry set to: {self.output_directory}")
 
     def parse_json_settings(self, settings_file_or_dict: Union[Path, dict, KerykeionSettingsModel, None]) -> None:
         """
-        Parse the settings file.
+        Load and parse chart configuration settings.
+
+        Args:
+            settings_file_or_dict (Path, dict, or KerykeionSettingsModel):
+                Source for custom chart settings.
         """
         settings = get_settings(settings_file_or_dict)
 
@@ -300,14 +380,13 @@ class KerykeionChartSVG:
 
     def _draw_zodiac_circle_slices(self, r):
         """
-        Generate the SVG string representing the zodiac circle
-        with the 12 slices for each zodiac sign.
+        Draw zodiac circle slices for each sign.
 
         Args:
-            r (float): The radius of the zodiac slices.
+            r (float): Outer radius of the zodiac ring.
 
         Returns:
-            str: The SVG string representing the zodiac circle.
+            str: Concatenated SVG elements for zodiac slices.
         """
         sings = get_args(Sign)
         output = ""
@@ -326,10 +405,13 @@ class KerykeionChartSVG:
 
     def _calculate_elements_points_from_planets(self):
         """
-        Calculate chart element points from a planet.
-        TODO: Refactor this method.
-        Should be completely rewritten. Maybe even part of the AstrologicalSubject class.
-        The points should include just the standard way of calculating the elements points.
+        Compute elemental point totals based on active planetary positions.
+
+        Iterates over each active planet to determine its zodiac element and adds extra points
+        if the planet is in a related sign. Updates self.fire, self.earth, self.air, and self.water.
+
+        Returns:
+            None
         """
 
         ZODIAC = (
@@ -381,6 +463,16 @@ class KerykeionChartSVG:
                 self.water = self.water + self.available_planets_setting[i]["element_points"] + extra_points
 
     def _draw_all_aspects_lines(self, r, ar):
+        """
+        Render SVG lines for all aspects in the chart.
+
+        Args:
+            r (float): Radius at which aspect lines originate.
+            ar (float): Radius at which aspect lines terminate.
+
+        Returns:
+            str: SVG markup for all aspect lines.
+        """
         out = ""
         for aspect in self.aspects_list:
             aspect_name = aspect["aspect"]
@@ -396,6 +488,16 @@ class KerykeionChartSVG:
         return out
 
     def _draw_all_transit_aspects_lines(self, r, ar):
+        """
+        Render SVG lines for all transit aspects in the chart.
+
+        Args:
+            r (float): Radius at which transit aspect lines originate.
+            ar (float): Radius at which transit aspect lines terminate.
+
+        Returns:
+            str: SVG markup for all transit aspect lines.
+        """
         out = ""
         for aspect in self.aspects_list:
             aspect_name = aspect["aspect"]
@@ -412,10 +514,13 @@ class KerykeionChartSVG:
 
     def _create_template_dictionary(self) -> ChartTemplateDictionary:
         """
-        Create a dictionary containing the template data for generating an astrological chart.
+        Assemble chart data and rendering instructions into a template dictionary.
+
+        Gathers styling, dimensions, and SVG fragments for chart components based on
+        chart type and subjects.
 
         Returns:
-            ChartTemplateDictionary: A dictionary with template data for the chart.
+            ChartTemplateDictionary: Populated structure of template variables.
         """
         # Initialize template dictionary
         template_dict: dict = {}
@@ -702,8 +807,20 @@ class KerykeionChartSVG:
 
         return ChartTemplateDictionary(**template_dict)
 
-    def makeTemplate(self, minify: bool = False) -> str:
-        """Creates the template for the SVG file"""
+    def makeTemplate(self, minify: bool = False, remove_css_variables = False) -> str:
+        """
+        Render the full chart SVG as a string.
+
+        Reads the XML template, substitutes variables, and optionally inlines CSS
+        variables and minifies the output.
+
+        Args:
+            minify (bool): Remove whitespace and quotes for compactness.
+            remove_css_variables (bool): Embed CSS variable definitions.
+
+        Returns:
+            str: SVG markup as a string.
+        """
         td = self._create_template_dictionary()
 
         DATA_DIR = Path(__file__).parent
@@ -719,6 +836,9 @@ class KerykeionChartSVG:
 
         self._create_template_dictionary()
 
+        if remove_css_variables:
+            template = inline_css_variables_in_svg(template)
+
         if minify:
             template = scourString(template).replace('"', "'").replace("\n", "").replace("\t","").replace("    ", "").replace("  ", "")
 
@@ -727,11 +847,22 @@ class KerykeionChartSVG:
 
         return template
 
-    def makeSVG(self, minify: bool = False):
-        """Prints out the SVG file in the specified folder"""
+    def makeSVG(self, minify: bool = False, remove_css_variables = False):
+        """
+        Generate and save the full chart SVG to disk.
+
+        Calls makeTemplate to render the SVG, then writes a file named
+        "{subject.name} - {chart_type} Chart.svg" in the output directory.
+
+        Args:
+            minify (bool): Pass-through to makeTemplate for compact output.
+            remove_css_variables (bool): Pass-through to makeTemplate to embed CSS variables.
+
+        Returns:
+            None
+        """
 
-        if not hasattr(self, "template"):
-            self.template = self.makeTemplate(minify)
+        self.template = self.makeTemplate(minify, remove_css_variables)
 
         chartname = self.output_directory / f"{self.user.name} - {self.chart_type} Chart.svg"
 
@@ -739,8 +870,21 @@ class KerykeionChartSVG:
             output_file.write(self.template)
 
         print(f"SVG Generated Correctly in: {chartname}")
-    def makeWheelOnlyTemplate(self, minify: bool = False):
-        """Creates the template for the SVG file with only the wheel"""
+
+    def makeWheelOnlyTemplate(self, minify: bool = False, remove_css_variables = False):
+        """
+        Render the wheel-only chart SVG as a string.
+
+        Reads the wheel-only XML template, substitutes chart data, and applies optional
+        CSS inlining and minification.
+
+        Args:
+            minify (bool): Remove whitespace and quotes for compactness.
+            remove_css_variables (bool): Embed CSS variable definitions.
+
+        Returns:
+            str: SVG markup for the chart wheel only.
+        """
 
         with open(Path(__file__).parent / "templates" / "wheel_only.xml", "r", encoding="utf-8", errors="ignore") as f:
             template = f.read()
@@ -748,6 +892,9 @@ class KerykeionChartSVG:
         template_dict = self._create_template_dictionary()
         template = Template(template).substitute(template_dict)
 
+        if remove_css_variables:
+            template = inline_css_variables_in_svg(template)
+
         if minify:
             template = scourString(template).replace('"', "'").replace("\n", "").replace("\t","").replace("    ", "").replace("  ", "")
 
@@ -756,18 +903,43 @@ class KerykeionChartSVG:
 
         return template
 
-    def makeWheelOnlySVG(self, minify: bool = False):
-        """Prints out the SVG file in the specified folder with only the wheel"""
+    def makeWheelOnlySVG(self, minify: bool = False, remove_css_variables = False):
+        """
+        Generate and save wheel-only chart SVG to disk.
+
+        Calls makeWheelOnlyTemplate and writes a file named
+        "{subject.name} - {chart_type} Chart - Wheel Only.svg" in the output directory.
+
+        Args:
+            minify (bool): Pass-through to makeWheelOnlyTemplate for compact output.
+            remove_css_variables (bool): Pass-through to makeWheelOnlyTemplate to embed CSS variables.
 
-        template = self.makeWheelOnlyTemplate(minify)
+        Returns:
+            None
+        """
+
+        template = self.makeWheelOnlyTemplate(minify, remove_css_variables)
         chartname = self.output_directory / f"{self.user.name} - {self.chart_type} Chart - Wheel Only.svg"
 
         with open(chartname, "w", encoding="utf-8", errors="ignore") as output_file:
             output_file.write(template)
 
         print(f"SVG Generated Correctly in: {chartname}")
-    def makeAspectGridOnlyTemplate(self, minify: bool = False):
-        """Creates the template for the SVG file with only the aspect grid"""
+
+    def makeAspectGridOnlyTemplate(self, minify: bool = False, remove_css_variables = False):
+        """
+        Render the aspect-grid-only chart SVG as a string.
+
+        Reads the aspect-grid XML template, generates the aspect grid based on chart type,
+        and applies optional CSS inlining and minification.
+
+        Args:
+            minify (bool): Remove whitespace and quotes for compactness.
+            remove_css_variables (bool): Embed CSS variable definitions.
+
+        Returns:
+            str: SVG markup for the aspect grid only.
+        """
 
         with open(Path(__file__).parent / "templates" / "aspect_grid_only.xml", "r", encoding="utf-8", errors="ignore") as f:
             template = f.read()
@@ -781,6 +953,9 @@ class KerykeionChartSVG:
 
         template = Template(template).substitute({**template_dict, "makeAspectGrid": aspects_grid})
 
+        if remove_css_variables:
+            template = inline_css_variables_in_svg(template)
+
         if minify:
             template = scourString(template).replace('"', "'").replace("\n", "").replace("\t","").replace("    ", "").replace("  ", "")
 
@@ -789,10 +964,22 @@ class KerykeionChartSVG:
 
         return template
 
-    def makeAspectGridOnlySVG(self, minify: bool = False):
-        """Prints out the SVG file in the specified folder with only the aspect grid"""
+    def makeAspectGridOnlySVG(self, minify: bool = False, remove_css_variables = False):
+        """
+        Generate and save aspect-grid-only chart SVG to disk.
+
+        Calls makeAspectGridOnlyTemplate and writes a file named
+        "{subject.name} - {chart_type} Chart - Aspect Grid Only.svg" in the output directory.
+
+        Args:
+            minify (bool): Pass-through to makeAspectGridOnlyTemplate for compact output.
+            remove_css_variables (bool): Pass-through to makeAspectGridOnlyTemplate to embed CSS variables.
+
+        Returns:
+            None
+        """
 
-        template = self.makeAspectGridOnlyTemplate(minify)
+        template = self.makeAspectGridOnlyTemplate(minify, remove_css_variables)
         chartname = self.output_directory / f"{self.user.name} - {self.chart_type} Chart - Aspect Grid Only.svg"
 
         with open(chartname, "w", encoding="utf-8", errors="ignore") as output_file:

{kerykeion-4.26.0rc1 → kerykeion-4.26.1}/kerykeion/utilities.py

@@ -3,6 +3,7 @@ from kerykeion.kr_types.kr_literals import LunarPhaseEmoji, LunarPhaseName, Poin
 from typing import Union, get_args, TYPE_CHECKING
 import logging
 import math
+import re
 
 if TYPE_CHECKING:
     from kerykeion import AstrologicalSubject
@@ -440,3 +441,57 @@ def circular_sort(degrees: list[Union[int, float]]) -> list[Union[int, float]]:
 
     # Return the reference followed by the sorted remaining elements
     return [reference] + sorted_remaining
+
+
+def inline_css_variables_in_svg(svg_content: str) -> str:
+    """
+    Process an SVG string to inline all CSS custom properties.
+
+    Args:
+        svg_content (str): The original SVG string with CSS variables
+
+    Returns:
+        str: The modified SVG with all CSS variables replaced by their values
+             and all style blocks removed
+    """
+    # Find and extract CSS custom properties from style tags
+    css_variable_map = {}
+    style_tag_pattern = re.compile(r"<style.*?>(.*?)</style>", re.DOTALL)
+    style_blocks = style_tag_pattern.findall(svg_content)
+
+    # Parse all CSS custom properties from style blocks
+    for style_block in style_blocks:
+        # Match patterns like --color-primary: #ff0000;
+        css_variable_pattern = re.compile(r"--([a-zA-Z0-9_-]+)\s*:\s*([^;]+);")
+        for match in css_variable_pattern.finditer(style_block):
+            variable_name = match.group(1)
+            variable_value = match.group(2).strip()
+            css_variable_map[f"--{variable_name}"] = variable_value
+
+    # Remove all style blocks from the SVG
+    svg_without_style_blocks = style_tag_pattern.sub("", svg_content)
+
+    # Function to replace var() references with their actual values
+    def replace_css_variable_reference(match):
+        variable_name = match.group(1).strip()
+        fallback_value = match.group(2) if match.group(2) else None
+
+        if variable_name in css_variable_map:
+            return css_variable_map[variable_name]
+        elif fallback_value:
+            return fallback_value.strip(", ")
+        else:
+            return ""  # If variable not found and no fallback provided
+
+    # Pattern to match var(--name) or var(--name, fallback)
+    variable_usage_pattern = re.compile(r"var\(\s*(--([\w-]+))\s*(,\s*([^)]+))?\s*\)")
+
+    # Repeatedly replace all var() references until none remain
+    # This handles nested variables or variables that reference other variables
+    processed_svg = svg_without_style_blocks
+    while variable_usage_pattern.search(processed_svg):
+        processed_svg = variable_usage_pattern.sub(
+            lambda m: replace_css_variable_reference(m), processed_svg
+        )
+
+    return processed_svg

{kerykeion-4.26.0rc1 → kerykeion-4.26.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "kerykeion"
-version = "4.26.0rc1"
+version = "4.26.1"
 authors = ["Giacomo Battaglia <kerykeion.astrology@gmail.com>"]
 description = "A python library for astrology."
 license = "AGPL-3.0"