Merge pull request #47 from highcharts-for-python/develop

hcpchris · web-flow · commit c5fa3b352c9c · 2024-04-06T20:43:51.000-04:00
Release Candidate v.1.6. Closes #45 .
diff --git a/CHANGES.rst b/CHANGES.rst
@@ -1,4 +1,21 @@
 
+Release 1.6.0
+=========================================
+
+* **ENHANCEMENT:** Align the API to **Highcharts (JS) v.11.3** (#45). In particular, this includes:
+
+  * Updated requirements to depend on Highcharts Core for Python v.1.6.
+  * Added ``ChartOptions.axis_layout_runs`` property.
+  * Added ``ColorAxis.height`` property.
+  * Added ``ColorAxis.width`` property.
+  * Added ``Data.column_types`` property.
+  * Added ``Exporting.fetch_options`` property.
+  * Implemented support for verbose axis date-time unit labelling configuration (see: ``DateTimeLabelFormats``).
+
+* **DOCUMENTATION:** Fixed typos in **Getting Started** tutorial.
+
+------------------
+
 Release 1.5.1
 =========================================
 
diff --git a/LICENSE b/LICENSE
@@ -18,6 +18,8 @@ Without prejudice to the limited right to download and test the Wrapper for eval
 
 A Wrapper License (as defined below) or renewal thereof can only be purchased by a Licensee either already holding a License to the Software, or at the same time as purchasing such a License, as an add-on product to such License, and only by a Licensee holding an active and valid enrolment in the Highcharts Advantage plan. The purchase of, and right to use the Licensed Software shall remain governed by the terms and conditions of the License issued by Highsoft to Licensee, whether this is Highsoft Standard License Agreement, Highsoft Terms and Conditions for Subscription to Annual License to Highsoft Software, or another licensing agreement as agreed between Highsoft and Licensee, as applicable (such terms and conditions between Highsoft and Licensee hereinafter collectively referred to as the “Main Agreement”). 
 
+A Wrapper License (as defined below) can additionally be obtained by holding an active and valid Educational or Personal License to the Software. The right to use the Licensed Software shall remain governed by the terms and conditions of the Authorized User issued by Highsoft to Authorized User, as defined in the Educational and Personal License 1.0, (such terms and conditions between Highsoft and Authorized User hereinafter collectively referred to as the "Main Agreement").
+
 These Wrapper T&Cs constitute an addendum to the Main Agreement and an integral part thereof and apply to the use of the Wrapper only. 
 
 In the case of any discrepancy between the Main Agreement and these Wrapper T&Cs related to the licensing of the Wrapper, these Wrapper T&Cs shall prevail. 
@@ -86,13 +88,16 @@ Licensee shall not modify, delete or obscure any notices of proprietary rights o
 6. Wrapper Support
 ***********************************************
 
-A Wrapper License entitles Licensee to the support services and access to new Releases of the Wrapper as set out herein. While support for the Wrapper is contingent upon Licensee’s valid enrollment in the Highcharts Advantage plan and the annual number of hours of support available for support of the Licensed Software for each successive twelve month term during the period that Licensee is enrolled in Highcharts Advantage (each, a “Support Year”) are inclusive of the number of hours of support offered during such Support Year for the Wrapper, support of the Wrapper is not covered under Licensee’s enrollment in Highcharts Advantage, but is offered by Highsoft for a separate fee and provided separately, directly and independently by HCP.
+A Wrapper License entitles Licensee to the support services and access to new Releases of the Wrapper as set out herein. While support for the Wrapper is contingent upon Licensee’s valid enrollment in the Highcharts Advantage plan and the annual number of hours of support available for support of the Licensed Software for each successive twelve month term during the period that Licensee is enrolled in Highcharts Advantage (each, a “Support Year”) are inclusive of the number of hours of support offered during such Support Year for the Wrapper, support of the Wrapper is not covered under Licensee’s enrollment in Highcharts Advantage, but is offered by Highsoft for a separate fee and provided separately, directly and independently by HCP. In the event that the Licensee is not enrolled in the Highcharts Advantage Plan, for example if the Main Agreement grants the Licensee a Personal or Educational License, then the Licensee shall not be entitled to the support services outlined herein.
 
 All support inquiries related to the Wrapper shall be sent to support@highchartspython.com or filed at https://www.highchartspython.com.
 
-Under a valid and effective Wrapper License, Licensee shall be entitled to receive from HCP: 
+Under a valid and effective Wrapper License, Licensee shall be entitled to receive from HCP:
 
   i. All new releases or updates of the Wrapper released during the applicable Advantage Period; 
+
+Under a valid and effective Wrapper License, contingent upon the Licensee’s valid enrollment in the Highcharts Advantage Plan and payment of applicable fees, Licensee shall be entitled to receive from HCP: 
+
   ii. Up to ten (10) hours of the personalized technical support for the Wrapper and/or the Licensed Software 
       (combined) per Developer per Support Year based on the number of Developers stated in the License Statement for 
       the License. Licensee may freely distribute its included total of ten (10) hours of personalized technical 
diff --git a/README.rst b/README.rst
@@ -16,10 +16,10 @@ JavaScript data visualization library.
   * The **Highcharts Export Server** - enabling the programmatic creation of static
     (downloadable) data visualizations
 
-The library supports Highcharts (JS) v.10.2 and higher, including Highcharts (JS) v.11.2.0.
+The library supports Highcharts (JS) v.10.2 and higher, including Highcharts (JS) v.11.3.0.
 
 **Highcharts Maps for Python** is fully integrated with the broader Python ecosystem,
-offerin gnative integrations with:
+offering native integrations with:
 
   * **Jupyter Labs/Notebook**. You can now produce high-end and interactive plots and
     renders using the full suite of Highcharts visualization capabilities.
@@ -85,7 +85,7 @@ Before you install, please be aware of the following "hard" dependencies:
   * Python 3.10 or higher
   * Highcharts Maps (JS) v.10.2 or higher (not technically a Python dependency, but 
     it won't work with earlier versions of Highcharts)
-  * `Highcharts Core for Python <https://core-docs.highchartspython.com/en/latest/>`__ v.1.3 or higher
+  * `Highcharts Core for Python <https://core-docs.highchartspython.com/en/latest/>`__ v.1.6 or higher
   * `esprima-python <https://github.com/Kronuz/esprima-python>`__ v.4.0 or higher
   * `requests <https://requests.readthedocs.io/en/latest/>`__ v.2.31 or higher
   * `validator-collection <https://validator-collection.readthedocs.io/en/latest/>`__
@@ -324,7 +324,7 @@ Hello World, and Basic Usage
     # EXAMPLE 1.
     # Using dicts
     my_chart.title = {
-        'align': 'center'
+        'align': 'center',
         'floating': True,
         'text': 'The Title for My Chart',
         'use_html': False,
diff --git a/docs/_dependencies.rst b/docs/_dependencies.rst
@@ -32,7 +32,7 @@
         Not technically a Python dependency, but obviously **Highcharts Maps for Python**
         will not work properly if your rendering layer does not leverage Highcharts Maps.
 
-    * `highcharts-core <https://core-docs.highchartspython.com>`_ v.1.3.0 or higher
+    * `highcharts-core <https://core-docs.highchartspython.com>`_ v.1.6.0 or higher
     * `esprima-python <https://github.com/Kronuz/esprima-python>`_ v.4.0 or higher
     * `requests <https://requests.readthedocs.io/en/latest/>`_ v.2.31 or higher
     * `validator-collection <https://validator-collection.readthedocs.io/en/latest/>`_
diff --git a/docs/index.rst b/docs/index.rst
@@ -37,7 +37,7 @@ Highcharts Maps for Python
 
 .. sidebar:: Version Compatibility
 
-  **Latest Highcharts (JS) version supported:** v.11.2.0
+  **Latest Highcharts (JS) version supported:** v.11.3.0
 
   **Highcharts Maps for Python** is designed to be compatible with:
 
@@ -319,7 +319,7 @@ Hello World, and Basic Usage
     # EXAMPLE 1.
     # Using dicts
     my_chart.title = {
-        'align': 'center'
+        'align': 'center',
         'floating': True,
         'text': 'The Title for My Chart',
         'use_html': False,
diff --git a/docs/license.rst b/docs/license.rst
@@ -4,12 +4,13 @@ Terms and Conditions for the Highcharts for Python Toolkit License
 
 .. warning::
 
-  The **Highcharts for Python Toolkit** as a whole, and the **Highcharts Core for Python** library specifically, 
+  The **Highcharts for Python Toolkit** as a whole, and the **Highcharts Maps for Python** library specifically, 
   are made available subject to a *paid* commercial license. This means that while the code is open-source, in order
   to use it you **must** purchase a license from `Highsoft A/S <https://www.highcharts.com>`__, the 
   creators of the Highcharts JavaScript library.
 
   **TO PURCHASE A LICENSE:** `https://shop.highcharts.com/ <https://shop.highcharts.com/>`__
+  **TO APPLY FOR A PERSONAL / EDUCATIONAL LICENSE:** `https://shop.highcharts.com/contact/educational <https://shop.highcharts.com/contact/educational>`__
 
 ***********************************************
 1. Acceptance of the Terms and Conditions
@@ -27,6 +28,8 @@ Without prejudice to the limited right to download and test the Wrapper for eval
 
 A Wrapper License (as defined below) or renewal thereof can only be purchased by a Licensee either already holding a License to the Software, or at the same time as purchasing such a License, as an add-on product to such License, and only by a Licensee holding an active and valid enrolment in the Highcharts Advantage plan. The purchase of, and right to use the Licensed Software shall remain governed by the terms and conditions of the License issued by Highsoft to Licensee, whether this is Highsoft Standard License Agreement, Highsoft Terms and Conditions for Subscription to Annual License to Highsoft Software, or another licensing agreement as agreed between Highsoft and Licensee, as applicable (such terms and conditions between Highsoft and Licensee hereinafter collectively referred to as the “Main Agreement”). 
 
+A Wrapper License (as defined below) can additionally be obtained by holding an active and valid Educational or Personal License to the Software. The right to use the Licensed Software shall remain governed by the terms and conditions of the Authorized User issued by Highsoft to Authorized User, as defined in the Educational and Personal License 1.0, (such terms and conditions between Highsoft and Authorized User hereinafter collectively referred to as the "Main Agreement").
+
 These Wrapper T&Cs constitute an addendum to the Main Agreement and an integral part thereof and apply to the use of the Wrapper only. 
 
 In the case of any discrepancy between the Main Agreement and these Wrapper T&Cs related to the licensing of the Wrapper, these Wrapper T&Cs shall prevail. 
@@ -95,13 +98,16 @@ Licensee shall not modify, delete or obscure any notices of proprietary rights o
 6. Wrapper Support
 ***********************************************
 
-A Wrapper License entitles Licensee to the support services and access to new Releases of the Wrapper as set out herein. While support for the Wrapper is contingent upon Licensee’s valid enrollment in the Highcharts Advantage plan and the annual number of hours of support available for support of the Licensed Software for each successive twelve month term during the period that Licensee is enrolled in Highcharts Advantage (each, a “Support Year”) are inclusive of the number of hours of support offered during such Support Year for the Wrapper, support of the Wrapper is not covered under Licensee’s enrollment in Highcharts Advantage, but is offered by Highsoft for a separate fee and provided separately, directly and independently by HCP.
+A Wrapper License entitles Licensee to the support services and access to new Releases of the Wrapper as set out herein. While support for the Wrapper is contingent upon Licensee's valid enrollment in the Highcharts Advantage plan and the annual number of hours of support available for support of the Licensed Software for each successive twelve month term during the period that Licensee is enrolled in Highcharts Advantage (each, a “Support Year”) are inclusive of the number of hours of support offered during such Support Year for the Wrapper, support of the Wrapper is not covered under Licensee’s enrollment in Highcharts Advantage, but is offered by Highsoft for a separate fee and provided separately, directly and independently by HCP. In the event that the Licensee is not enrolled in the Highcharts Advantage Plan, for example if the Main Agreement grants the Licensee a Personal or Educational License, then the Licensee shall not be entitled to the support services outlined herein.
 
 All support inquiries related to the Wrapper shall be sent to support@highchartspython.com or filed at https://www.highchartspython.com.
 
-Under a valid and effective Wrapper License, Licensee shall be entitled to receive from HCP: 
+Under a valid and effective Wrapper License, Licensee shall be entitled to receive from HCP:
 
   i. All new releases or updates of the Wrapper released during the applicable Advantage Period; 
+
+Under a valid and effective Wrapper License, contingent upon the Licensee’s valid enrollment in the Highcharts Advantage Plan and payment of applicable fees, Licensee shall be entitled to receive from HCP: 
+
   ii. Up to ten (10) hours of the personalized technical support for the Wrapper and/or the Licensed Software 
       (combined) per Developer per Support Year based on the number of Developers stated in the License Statement for 
       the License. Licensee may freely distribute its included total of ten (10) hours of personalized technical 
diff --git a/docs/tutorials/_assembling_a_chart.rst b/docs/tutorials/_assembling_a_chart.rst
@@ -18,7 +18,7 @@ from a :class:`pandas.DataFrame <pandas:pandas.DataFrame>`,
 
     # From a Numpy ndarray
 
-    my_chart = Chart.from_array(data = as_ndarray, series_type = 'line')
+    my_chart = Chart.from_array(as_ndarray, series_type = 'line')
 
     # From a Python dict
 
diff --git a/docs/tutorials/getting_started.rst b/docs/tutorials/getting_started.rst
@@ -92,7 +92,7 @@ or Python :class:`dict <python:dict>`:
     df = pandas.DataFrame(my_iterable, columns=['x', 'y'])
 
     # As a Numpy ndarray
-    as_ndarray = numpy.as_ndarray(my_iterable)
+    as_ndarray = numpy.asarray(my_iterable)
 
     # As a Python dict
     as_dict = {'x': x[0], 'y': x[1] for x in my_iterable}
diff --git a/highcharts_maps/__version__.py b/highcharts_maps/__version__.py
@@ -1 +1 @@
-__version__ = '1.5.1'
+__version__ = '1.6.0'
diff --git a/pyproject.toml b/pyproject.toml
@@ -58,7 +58,7 @@ classifiers = [
 
 requires-python = ">= 3.10"
 dependencies = [
-    "highcharts-core>=1.5.0",
+    "highcharts-core>=1.6.0",
     "esprima>=4.0.1",
     "validator-collection>=1.5.0",
     "requests>=2.31.0",
diff --git a/requirements.dev.txt b/requirements.dev.txt
@@ -17,4 +17,4 @@ sphinx-tabs>=3.4.1
 requests==2.31.0
 tox==4.0.0
 validator-collection==1.5.0
-highcharts-core>=1.5.0
+highcharts-core>=1.6.0
diff --git a/requirements.travis.txt b/requirements.travis.txt
@@ -17,4 +17,4 @@ sphinx-tabs>=3.4.1
 requests==2.31.0
 tox==4.0.0
 validator-collection==1.5.0
-highcharts-core>=1.5.0
+highcharts-core>=1.6.0
diff --git a/requirements.txt b/requirements.txt
@@ -3,4 +3,4 @@ geojson==3.0.1
 requests==2.31.0
 topojson==1.5
 validator-collection==1.5.0
-highcharts-core>=1.5.0
+highcharts-core>=1.6.0

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-__version__ = '1.5.1'`
	`1`	`+__version__ = '1.6.0'`