Implemented ChartOptions.axis_layout_runs.

Author: hcpchris

highcharts_core/options/chart/__init__.py

@@ -108,6 +108,7 @@ def __init__(self, **kwargs):
         self._align_ticks = None
         self._allow_mutating_data = None
         self._animation = None
+        self._axis_layout_runs = None
         self._background_color = None
         self._border_color = None
         self._border_radius = None
@@ -155,6 +156,7 @@ def __init__(self, **kwargs):
         self.align_ticks = kwargs.get('align_ticks', None)
         self.allow_mutating_data = kwargs.get('allow_mutating_data', None)
         self.animation = kwargs.get('animation', None)
+        self.axis_layout_runs = kwargs.get('axis_layout_runs', None)
         self.background_color = kwargs.get('background_color', None)
         self.border_color = kwargs.get('border_color', None)
         self.border_radius = kwargs.get('border_radius', None)
@@ -337,6 +339,38 @@ def animation(self, value):
             self._animation = validate_types(value,
                                              types = AnimationOptions)
 
+    @property
+    def axis_layout_runs(self) -> Optional[int]:
+        """The number of axis layout runs to execute when rendering the chart. Defaults to ``2``.
+
+        .. note::
+
+          When a chart with an x and a y-axis is rendered, we first pre-render the labels of both
+          in order to measure them. Then, if either of the axis labels take up so much space that
+          it significantly affects the length of the other axis, we repeat the process.
+
+          By default we stop at two axis layout runs, but it may be that the second run also alters
+          the space required by either axis, for example if it causes the labels to rotate. In this
+          situation, a subsequent redraw of the chart may cause the tick and label placement to
+          change for apparently no reason.
+
+          Use the ``.axis_layout_runs`` property to set the maximum allowed number of repetitions.
+
+        .. warning::
+
+          Keep in mind that the default value of ``2`` is set because every run costs performance time.
+          Changing this value option to higher than the default might decrease performance significantly,
+          especially with bigger sets of data.
+
+        :returns: The maximum allowed number of axis layout runs.
+        :rtype: :class:`int <python:int>`
+        """
+        return self._axis_layout_runs
+    
+    @axis_layout_runs.setter
+    def axis_layout_runs(self, value):
+        self._axis_layout_runs = validators.integer(value, allow_empty = True)
+
     @property
     def background_color(self) -> Optional[str | Gradient | Pattern]:
         """The background color or gradient for the outer chart area. Defaults to
@@ -1349,6 +1383,7 @@ def _get_kwargs_from_dict(cls, as_dict):
             'align_ticks': as_dict.get('alignTicks', None),
             'allow_mutating_data': as_dict.get('allowMutatingData', None),
             'animation': as_dict.get('animation', None),
+            'axis_layout_runs': as_dict.get('axisLayoutRuns', None),
             'background_color': as_dict.get('backgroundColor', None),
             'border_color': as_dict.get('borderColor', None),
             'border_radius': as_dict.get('borderRadius', None),
@@ -1403,6 +1438,7 @@ def _to_untrimmed_dict(self, in_cls = None) -> dict:
             'alignTicks': self.align_ticks,
             'allowMutatingData': self.allow_mutating_data,
             'animation': self.animation,
+            'axisLayoutRuns': self.axis_layout_runs,
             'backgroundColor': self.background_color,
             'borderColor': self.border_color,
             'borderRadius': self.border_radius,