kerykeion 5.0.0a1__tar.gz → 5.0.0a3__tar.gz

{kerykeion-5.0.0a1 → kerykeion-5.0.0a3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: kerykeion
-Version: 5.0.0a1
+Version: 5.0.0a3
 Summary: A python library for astrology.
 License: AGPL-3.0
 Keywords: astrology,ephemeris,astrology library,birtchart,svg,zodiac,zodiac-sing,astronomical-algorithms,synastry,astrology-calculator
@@ -79,8 +79,17 @@ 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)
@@ -127,34 +136,34 @@ pip3 install kerykeion
 Below is a simple example illustrating the creation of an astrological subject and retrieving astrological details:
 
 ```python
-from kerykeion import AstrologicalSubject
+from kerykeion import AstrologicalSubjectFactory
 
-# Create an instance of the AstrologicalSubject class.
+# Create an instance of the AstrologicalSubjectFactory class.
 # Arguments: Name, year, month, day, hour, minutes, city, nation
-kanye = AstrologicalSubject("Kanye", 1977, 6, 8, 8, 45, "Atlanta", "US")
+john = AstrologicalSubjectFactory.from_birth_data("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
 
 # Retrieve information about the Sun:
-kanye.sun
-# > {'name': 'Sun', 'quality': 'Mutable', 'element': 'Air', 'sign': 'Gem', 'sign_num': 2, ...}
+print(john.sun.model_dump_json())
+# > {"name":"Sun","quality":"Cardinal","element":"Air","sign":"Lib","sign_num":6,"position":16.26789199474399,"abs_pos":196.267891994744,"emoji":"♎️","point_type":"AstrologicalPoint","house":"Sixth_House","retrograde":false}
 
 # Retrieve information about the first house:
-kanye.first_house
-# > {'name': 'First_House', 'quality': 'Cardinal', 'element': 'Water', 'sign': 'Can', ...}
+print(john.first_house.model_dump_json())
+# > {"name":"First_House","quality":"Cardinal","element":"Fire","sign":"Ari","sign_num":0,"position":19.74676624176799,"abs_pos":19.74676624176799,"emoji":"♈️","point_type":"House","house":null,"retrograde":null}
 
 # Retrieve the element of the Moon sign:
-kanye.moon.element
-# > 'Water'
+print(john.moon.element)
+# > 'Air'
 ```
 
 **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"
+john = AstrologicalSubjectFactory.from_birth_data(
+    "John Lennon", 1940, 10, 9, 18, 30,
+    lng=-2.9833,  # Longitude for Liverpool
+    lat=53.4000,  # Latitude for Liverpool
+    tz_str="Europe/London",  # Timezone for Liverpool
+    city="Liverpool", 
 )
 ```
 
@@ -169,9 +178,9 @@ To improve compatibility across different applications, you can use the `remove_
 ### Birth Chart
 
 ```python
-from kerykeion import AstrologicalSubject, KerykeionChartSVG
+from kerykeion import AstrologicalSubjectFactory, KerykeionChartSVG
 
-john = AstrologicalSubject("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
+john = AstrologicalSubjectFactory.from_birth_data("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
 birth_chart_svg = KerykeionChartSVG(john)
 birth_chart_svg.makeSVG()
 ```
@@ -186,8 +195,8 @@ The SVG file will be saved in the home directory.
 ### External Birth Chart
 
 ```python
-from kerykeion import AstrologicalSubject, KerykeionChartSVG
-birth_chart = AstrologicalSubject("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
+from kerykeion import AstrologicalSubjectFactory, KerykeionChartSVG
+birth_chart = AstrologicalSubjectFactory.from_birth_data("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
 birth_chart_svg = KerykeionChartSVG(birth_chart, chart_type="ExternalNatal")
 birth_chart_svg.makeSVG()
 ```
@@ -196,10 +205,10 @@ birth_chart_svg.makeSVG()
 ### Synastry Chart
 
 ```python
-from kerykeion import AstrologicalSubject, KerykeionChartSVG
+from kerykeion import AstrologicalSubjectFactory, KerykeionChartSVG
 
-first = AstrologicalSubject("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
-second = AstrologicalSubject("Paul McCartney", 1942, 6, 18, 15, 30, "Liverpool", "GB")
+first = AstrologicalSubjectFactory.from_birth_data("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
+second = AstrologicalSubjectFactory.from_birth_data("Paul McCartney", 1942, 6, 18, 15, 30, "Liverpool", "GB")
 
 synastry_chart = KerykeionChartSVG(first, "Synastry", second)
 synastry_chart.makeSVG()
@@ -211,10 +220,10 @@ synastry_chart.makeSVG()
 ### Transit Chart
 
 ```python
-from kerykeion import AstrologicalSubject
+from kerykeion import AstrologicalSubjectFactory
 
-transit = AstrologicalSubject("Transit", 2025, 6, 8, 8, 45, "Atlanta", "US")
-subject = AstrologicalSubject("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
+transit = AstrologicalSubjectFactory.from_birth_data("Transit", 2025, 6, 8, 8, 45, "Atlanta", "US")
+subject = AstrologicalSubjectFactory.from_birth_data("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
 
 transit_chart = KerykeionChartSVG(subject, "Transit", transit)
 transit_chart.makeSVG()
@@ -225,11 +234,11 @@ transit_chart.makeSVG()
 ### Composite Chart
 
 ```python
-from kerykeion import CompositeSubjectFactory, AstrologicalSubject, KerykeionChartSVG
+from kerykeion import CompositeSubjectFactory, AstrologicalSubjectFactory, KerykeionChartSVG
 
-angelina = AstrologicalSubject("Angelina Jolie", 1975, 6, 4, 9, 9, "Los Angeles", "US", lng=-118.15, lat=34.03, tz_str="America/Los_Angeles")
+angelina = AstrologicalSubjectFactory.from_birth_data("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")
+brad = AstrologicalSubjectFactory.from_birth_data("Brad Pitt", 1963, 12, 18, 6, 31, "Shawnee", "US", lng=-96.56, lat=35.20, tz_str="America/Chicago")
 
 factory = CompositeSubjectFactory(angelina, brad)
 composite_model = factory.get_midpoint_composite_subject_model()
@@ -246,9 +255,9 @@ For *all* the charts, you can generate a wheel-only chart by using the method `m
 
 ### Birth Chart
 ```python
-from kerykeion import AstrologicalSubject, KerykeionChartSVG
+from kerykeion import AstrologicalSubjectFactory, KerykeionChartSVG
 
-birth_chart = AstrologicalSubject("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
+birth_chart = AstrologicalSubjectFactory.from_birth_data("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
 birth_chart_svg = KerykeionChartSVG(birth_chart)
 birth_chart_svg.makeWheelOnlySVG()
 ```
@@ -257,8 +266,8 @@ birth_chart_svg.makeWheelOnlySVG()
 ### Wheel Only Birth Chart (External)
 
 ```python
-from kerykeion import AstrologicalSubject, KerykeionChartSVG
-birth_chart = AstrologicalSubject("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
+from kerykeion import AstrologicalSubjectFactory, KerykeionChartSVG
+birth_chart = AstrologicalSubjectFactory.from_birth_data("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
 birth_chart_svg = KerykeionChartSVG(birth_chart, chart_type="ExternalNatal")
 birth_chart_svg.makeWheelOnlySVG(
     wheel_only=True,
@@ -270,9 +279,9 @@ birth_chart_svg.makeWheelOnlySVG(
 
 ### Synastry Chart
 ```python
-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")
+from kerykeion import AstrologicalSubjectFactory, KerykeionChartSVG
+first = AstrologicalSubjectFactory.from_birth_data("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
+second = AstrologicalSubjectFactory.from_birth_data("Paul McCartney", 1942, 6, 18, 15, 30, "Liverpool", "GB")
 synastry_chart = KerykeionChartSVG(
     first, "Synastry", second
 )
@@ -286,10 +295,10 @@ synastry_chart.makeWheelOnlySVG()
 To save the SVG file in a custom location, specify `new_output_directory`:
 
 ```python
-from kerykeion import AstrologicalSubject, KerykeionChartSVG
+from kerykeion import AstrologicalSubjectFactory, KerykeionChartSVG
 
-first = AstrologicalSubject("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
-second = AstrologicalSubject("Paul McCartney", 1942, 6, 18, 15, 30, "Liverpool", "GB")
+first = AstrologicalSubjectFactory.from_birth_data("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
+second = AstrologicalSubjectFactory.from_birth_data("Paul McCartney", 1942, 6, 18, 15, 30, "Liverpool", "GB")
 
 synastry_chart = KerykeionChartSVG(
     first, "Synastry", second,
@@ -303,9 +312,9 @@ synastry_chart.makeSVG()
 You can switch chart language by passing `chart_language` to the  `KerykeionChartSVG` class:
 
 ```python
-from kerykeion import AstrologicalSubject, KerykeionChartSVG
+from kerykeion import AstrologicalSubjectFactory, KerykeionChartSVG
 
-first = AstrologicalSubject("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
+first = AstrologicalSubjectFactory.from_birth_data("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
 birth_chart_svg = KerykeionChartSVG(
     birth_chart,
     chart_language="IT"  # Change to Italian
@@ -331,8 +340,8 @@ The available languages are:
 To generate a minified SVG, set `minify_svg=True` in the `makeSVG()` method:
 
 ```python
-from kerykeion import AstrologicalSubject, KerykeionChartSVG
-first = AstrologicalSubject("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
+from kerykeion import AstrologicalSubjectFactory, KerykeionChartSVG
+first = AstrologicalSubjectFactory.from_birth_data("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
 birth_chart_svg = KerykeionChartSVG(birth_chart)
 birth_chart_svg.makeSVG(
     minify=True
@@ -343,9 +352,9 @@ birth_chart_svg.makeSVG(
 To generate an SVG without CSS variables, set `remove_css_variables=True` in the `makeSVG()` method:
 
 ```python
-from kerykeion import AstrologicalSubject, KerykeionChartSVG
+from kerykeion import AstrologicalSubjectFactory, KerykeionChartSVG
 
-first = AstrologicalSubject("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
+first = AstrologicalSubjectFactory.from_birth_data("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
 birth_chart_svg = KerykeionChartSVG(birth_chart)
 birth_chart_svg.makeSVG(
     remove_css_variables=True
@@ -359,8 +368,8 @@ This will inline all styles and eliminate CSS variables, resulting in an SVG tha
 It's possible to generate a grid-only SVG, useful for creating a custom layout. To do this, use the `makeGridOnlySVG()` method:
 
 ```python
-from kerykeion import AstrologicalSubject, KerykeionChartSVG
-birth_chart = AstrologicalSubject("John Lennon - Aspect Grid Dark Synastry", 1977, 6, 8, 8, 45, "Atlanta", "US")
+from kerykeion import AstrologicalSubjectFactory, KerykeionChartSVG
+birth_chart = AstrologicalSubjectFactory.from_birth_data("John Lennon - Aspect Grid Dark Synastry", 1977, 6, 8, 8, 45, "Atlanta", "US")
 aspect_grid_dark_synastry_chart = KerykeionChartSVG(aspect_grid_dark_synastry_subject, "Synastry", second, theme="dark")
 aspect_grid_dark_synastry_chart.makeAspectGridOnlySVG()
 ```
@@ -369,57 +378,62 @@ aspect_grid_dark_synastry_chart.makeAspectGridOnlySVG()
 ## Report
 
 ```python
-from kerykeion import Report, AstrologicalSubject
-
-kanye = AstrologicalSubject("Kanye", 1977, 6, 8, 8, 45, "Atlanta", "US")
-report = Report(kanye)
+from kerykeion import Report, AstrologicalSubjectFactory
+
+john = AstrologicalSubjectFactory.from_birth_data(
+    "John Lennon", 1940, 10, 9, 18, 30,
+    lng=-2.9833,  # Longitude for Liverpool
+    lat=53.4000,  # Latitude for Liverpool
+    tz_str="Europe/London",  # Timezone for Liverpool
+    city="Liverpool",
+)
+report = Report(john)
 report.print_report()
 ```
 
-Returns:
-
-```txt
-+- Kerykeion report for Kanye -+
-+----------+------+-------------+-----------+----------+
-| Date     | Time | Location    | Longitude | Latitude |
-+----------+------+-------------+-----------+----------+
-| 8/6/1977 | 8:45 | Atlanta, US | -84.38798 | 33.749   |
-+----------+------+-------------+-----------+----------+
-+-----------------+------+-------+------+----------------+
-| Planet          | Sign | Pos.  | Ret. | House          |
-+-----------------+------+-------+------+----------------+
-| Sun             | Gem  | 17.6  | -    | Twelfth_House  |
-| Moon            | Pis  | 16.43 | -    | Ninth_House    |
-| Mercury         | Tau  | 26.29 | -    | Eleventh_House |
-| Venus           | Tau  | 2.03  | -    | Tenth_House    |
-| Mars            | Tau  | 1.79  | -    | Tenth_House    |
-| Jupiter         | Gem  | 14.61 | -    | Eleventh_House |
-| Saturn          | Leo  | 12.8  | -    | Second_House   |
-| Uranus          | Sco  | 8.27  | R    | Fourth_House   |
-| Neptune         | Sag  | 14.69 | R    | Fifth_House    |
-| Pluto           | Lib  | 11.45 | R    | Fourth_House   |
-| Mean_Node       | Lib  | 21.49 | R    | Fourth_House   |
-| True_Node       | Lib  | 22.82 | R    | Fourth_House   |
-| Mean_South_Node | Ari  | 21.49 | R    | Tenth_House    |
-| True_South_Node | Ari  | 22.82 | R    | Tenth_House    |
-| Chiron          | Tau  | 4.17  | -    | Tenth_House    |
-+-----------------+------+-------+------+----------------+
+Report output:
+```plaintext
++- Kerykeion report for John Lennon -+
++-----------+-------+---------------+-----------+----------+
+| Date      | Time  | Location      | Longitude | Latitude |
++-----------+-------+---------------+-----------+----------+
+| 9/10/1940 | 18:30 | Liverpool, GB | -2.9833   | 53.4     |
++-----------+-------+---------------+-----------+----------+
++-------------------+------+-------+------+----------------+
+| AstrologicalPoint | Sign | Pos.  | Ret. | House          |
++-------------------+------+-------+------+----------------+
+| Sun               | Lib  | 16.27 | -    | Sixth_House    |
+| Moon              | Aqu  | 3.55  | -    | Eleventh_House |
+| Mercury           | Sco  | 8.56  | -    | Seventh_House  |
+| Venus             | Vir  | 3.22  | -    | Sixth_House    |
+| Mars              | Lib  | 2.66  | -    | Sixth_House    |
+| Jupiter           | Tau  | 13.69 | R    | First_House    |
+| Saturn            | Tau  | 13.22 | R    | First_House    |
+| Uranus            | Tau  | 25.55 | R    | First_House    |
+| Neptune           | Vir  | 26.03 | -    | Sixth_House    |
+| Pluto             | Leo  | 4.19  | -    | Fifth_House    |
+| Mean_Node         | Lib  | 10.58 | R    | Sixth_House    |
+| Mean_South_Node   | Ari  | 10.58 | R    | Twelfth_House  |
+| Mean_Lilith       | Ari  | 13.37 | -    | Twelfth_House  |
+| Chiron            | Leo  | 0.57  | -    | Fifth_House    |
++-------------------+------+-------+------+----------------+
 +----------------+------+----------+
 | House          | Sign | Position |
 +----------------+------+----------+
-| First_House    | Can  | 18.0     |
-| Second_House   | Leo  | 9.51     |
-| Third_House    | Vir  | 4.02     |
-| Fourth_House   | Lib  | 3.98     |
-| Fifth_House    | Sco  | 9.39     |
-| Sixth_House    | Sag  | 15.68    |
-| Seventh_House  | Cap  | 18.0     |
-| Eighth_House   | Aqu  | 9.51     |
-| Ninth_House    | Pis  | 4.02     |
-| Tenth_House    | Ari  | 3.98     |
-| Eleventh_House | Tau  | 9.39     |
-| Twelfth_House  | Gem  | 15.68    |
+| First_House    | Ari  | 19.72    |
+| Second_House   | Tau  | 29.52    |
+| Third_House    | Gem  | 20.23    |
+| Fourth_House   | Can  | 7.07     |
+| Fifth_House    | Can  | 25.31    |
+| Sixth_House    | Leo  | 22.11    |
+| Seventh_House  | Lib  | 19.72    |
+| Eighth_House   | Sco  | 29.52    |
+| Ninth_House    | Sag  | 20.23    |
+| Tenth_House    | Cap  | 7.07     |
+| Eleventh_House | Cap  | 25.31    |
+| Twelfth_House  | Aqu  | 22.11    |
 +----------------+------+----------+
+```
 
 To export to a file:
 
@@ -432,8 +446,8 @@ python3 your_script_name.py > file.txt
 ```python
 from kerykeion import SynastryAspects, AstrologicalSubject
 
-first = AstrologicalSubject("Jack", 1990, 6, 15, 15, 15, "Roma", "IT")
-second = AstrologicalSubject("Jane", 1991, 10, 25, 21, 0, "Roma", "IT")
+first = AstrologicalSubjectFactory.from_birth_data("Jack", 1990, 6, 15, 15, 15, "Roma", "IT")
+second = AstrologicalSubjectFactory.from_birth_data("Jane", 1991, 10, 25, 21, 0, "Roma", "IT")
 
 name = SynastryAspects(first, second)
 aspect_list = name.get_relevant_aspects()
@@ -447,7 +461,7 @@ print(aspect_list[0])
 By default, the zodiac type is **Tropical**. To use **Sidereal**, specify the sidereal mode:
 
 ```python
-johnny = AstrologicalSubject(
+johnny = AstrologicalSubjectFactory.from_birth_data(
     "Johnny Depp", 1963, 6, 9, 0, 0,
     "Owensboro", "US",
     zodiac_type="Sidereal",
@@ -464,7 +478,7 @@ Full list of supported sidereal modes [here](https://www.kerykeion.net/pydocs/ke
 By default, houses are calculated using **Placidus**. Configure a different house system as follows:
 
 ```python
-johnny = AstrologicalSubject(
+johnny = AstrologicalSubjectFactory.from_birth_data(
     "Johnny Depp", 1963, 6, 9, 0, 0,
     "Owensboro", "US",
     houses_system="M"
@@ -482,7 +496,7 @@ So far all the available houses system in the Swiss Ephemeris are supported but
 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 = AstrologicalSubjectFactory.from_birth_data(
     "Johnny Depp", 1963, 6, 9, 0, 0,
     "Owensboro", "US",
     perspective_type="Heliocentric"
@@ -507,9 +521,9 @@ Each theme offers a distinct visual style, allowing you to choose the one that b
 Here's an example of how to set the theme:
 
 ```python
-from kerykeion import AstrologicalSubject, KerykeionChartSVG
+from kerykeion import AstrologicalSubjectFactory, KerykeionChartSVG
 
-dark_theme_subject = AstrologicalSubject("John Lennon - Dark Theme", 1940, 10, 9, 18, 30, "Liverpool", "GB")
+dark_theme_subject = AstrologicalSubjectFactory.from_birth_data("John Lennon - Dark Theme", 1940, 10, 9, 18, 30, "Liverpool", "GB")
 dark_theme_natal_chart = KerykeionChartSVG(dark_high_contrast_theme_subject, theme="dark_high_contrast")
 dark_theme_natal_chart.makeSVG()
 ```
@@ -529,7 +543,7 @@ subject = AstrologicalSubject.get_from_iso_utc_time(
 If you set `online=True`, provide a `geonames_username` to allow city-based geolocation:
 
 ```python
-from kerykeion.astrological_subject import AstrologicalSubject
+from kerykeion.astrological_subject import AstrologicalSubjectFactory
 
 subject = AstrologicalSubject.get_from_iso_utc_time(
     "Johnny Depp", "1963-06-09T05:00:00Z", "Owensboro", "US", online=True
@@ -545,16 +559,14 @@ Kerykeion supports both **True** and **Mean** Lunar Nodes:
 - **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 pass the `active_points` parameter to the `KerykeionChartSVG` class.
 
 Example:
 
 ```python
-from kerykeion import AstrologicalSubject, KerykeionChartSVG
+from kerykeion import AstrologicalSubjectFactory, KerykeionChartSVG
 
-subject = AstrologicalSubject("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
+subject = AstrologicalSubjectFactory.from_birth_data("John Lennon", 1940, 10, 9, 18, 30, "Liverpool", "GB")
 
 chart = KerykeionChartSVG(
     subject,
@@ -587,9 +599,9 @@ chart.makeSVG()
 You can serialize the astrological subject (the base data used throughout the library) to JSON:
 
 ```python
-from kerykeion import AstrologicalSubject
+from kerykeion import AstrologicalSubjectFactory
 
-johnny = AstrologicalSubject("Johnny Depp", 1963, 6, 9, 0, 0, "Owensboro", "US")
+johnny = AstrologicalSubjectFactory.from_birth_data("Johnny Depp", 1963, 6, 9, 0, 0, "Owensboro", "US")
 
 print(johnny.json(dump=False, indent=2))
 ```