Source code for highcharts_gantt.options

"""Implements the :class:`HighchartsOptions` class."""
from typing import Optional, List

from validator_collection import validators

from highcharts_gantt import utility_functions
from highcharts_gantt.decorators import class_sensitive
from highcharts_gantt.utility_classes.gradients import Gradient
from highcharts_gantt.utility_classes.patterns import Pattern
from highcharts_gantt.options.series.series_generator import create_series_obj

from highcharts_gantt.options.accessibility import Accessibility
from highcharts_gantt.options.annotations import Annotation
from highcharts_gantt.options.caption import Caption
from highcharts_gantt.options.chart import ChartOptions
from highcharts_gantt.options.credits import Credits
from highcharts_gantt.options.data import Data
from highcharts_gantt.options.defs import MarkerDefinition
from highcharts_gantt.options.exporting import Exporting
from highcharts_gantt.global_options.language import Language
from highcharts_gantt.options.legend import Legend
from highcharts_gantt.options.loading import Loading
from highcharts_gantt.options.navigation import Navigation
from highcharts_gantt.options.no_data import NoData
from highcharts_gantt.options.plot_options import PlotOptions
from highcharts_gantt.options.plot_options.generic import GenericTypeOptions
from highcharts_gantt.options.responsive import Responsive
from highcharts_gantt.options.subtitle import Subtitle
from highcharts_gantt.options.time import Time
from highcharts_gantt.options.title import Title
from highcharts_gantt.options.tooltips import Tooltip
from highcharts_gantt.options.axes.x_axis import XAxis
from highcharts_gantt.options.axes.y_axis import YAxis

# Highcharts Gantt Classes
from highcharts_gantt.options.connectors import ConnectorOptions
from highcharts_gantt.options.navigator import Navigator
from highcharts_gantt.options.range_selector import RangeSelector
from highcharts_gantt.options.scrollbar import Scrollbar

from highcharts_stock.options import Options, HighchartsOptions, HighchartsStockOptions

[docs]class HighchartsGanttOptions(HighchartsStockOptions): """The Python representation of the `Highcharts Gantt <https://api.highcharts.com/gantt/>`_ configuration object.""" def __init__(self, **kwargs): self._connectors = None self._navigator = None self._no_data = None self._range_selector = None self._scrollbar = None self.connectors = kwargs.get('connectors', None) self.navigator = kwargs.get('navigator', None) self.no_data = kwargs.get('no_data', None) self.range_selector = kwargs.get('range_selector', None) self.scrollbar = kwargs.get('scrollbar', None) super().__init__(**kwargs) @property def accessibility(self) -> Optional[Accessibility]: """Options for configuring accessibility for the chart. .. note:: Requires the accessibility module to be loaded in the browser. For a description of the module and information on its features, see `Highcharts Accessibility <https://www.highcharts.com/docs/accessibility/accessibility-module>`_. :returns: The accessibility configuration for the chart or :obj:`None <python:None>` :rtype: :class:`Accessibility <highcharts.accessibility.Accessibility>` / :obj:`None <python:None>` :raise HighchartsError: if setting the value to an incompatible type """ return self._accessibility @accessibility.setter @class_sensitive(Accessibility) def accessibility(self, value: Optional[Accessibility | dict | str]): self._accessibility = value @property def annotations(self) -> Optional[List[Annotation]]: """A basic type of an annotation. It allows adding custom labels or shapes. The items can be tied to points, axis coordinates or chart pixel coordinates. :returns: A collection of the annotations applied to the chart. :rtype: :class:`list <python:list>` of :class:`Annotation` objects or :obj:`None <python:None>` if no annotations are applied """ return self._annotations @annotations.setter @class_sensitive(Annotation, force_iterable = True) def annotations(self, value): self._annotations = value @property def caption(self) -> Optional[Caption]: """The chart's caption, which will render below the chart and will be part of exported charts. .. note:: The caption can be updated after chart initialization through the ``Chart.update`` or ``Chart.caption.update`` JavaScript methods. :returns: The chart's caption or :obj:`None <python:None>` :rtype: :class:`Caption` / :obj:`None <python:None>` """ return self._caption @caption.setter @class_sensitive(Caption) def caption(self, value): self._caption = value @property def chart(self) -> Optional[ChartOptions]: """General options for the chart. .. note:: This property is perhaps one of the most important properties you will use when configuring your Highcharts data visualization. :returns: A :class:`ChartOptions` configuration object or :obj:`None <python:None>` :rtype: :class:`ChartOptions` or :obj:`None <python:None>` """ return self._chart @chart.setter @class_sensitive(ChartOptions) def chart(self, value): self._chart = value @property def colors(self) -> Optional[List[str | Gradient | Pattern]]: """An array containing the default colors for the chart's series. When all colors are used, new colors are pulled from the start again. Default colors can also be set on a series or ``series.type`` basis, see :ref:`Column.colors` and :ref:`Pie.colors`. .. warning:: In styled mode, the colors option does not exist. Instead, colors are defined in CSS and applied either through series or point class names, or through the :ref:`Chart.color_count` option. Defaults to: .. code-block:: python [ "#7cb5ec", "#434348", "#90ed7d", "#f7a35c", "#8085e9", "#f15c80", "#e4d354", "#2b908f", "#f45b5b", "#91e8e1" ] :returns: A collection of hex color strings. :rtype: :class:`list <python:list>` of :class:`str <python:str>` """ return self._colors @colors.setter def colors(self, value): if not value: self._colors = None else: value = validators.iterable(value) self._colors = [utility_functions.validate_color(x) for x in value] @property def connectors(self) -> Optional[ConnectorOptions]: """**Highcharts Gantt for Python** allows you to define a connection between two points, with the connection represented as a line with optional markers for the start and end of that line. Multiple algorithms are available for calculating how connecting lines should be drawn. .. note:: These configuration options are used to control how :term:`dependencies` between tasks are rendered in :term:`Gantt charts <Gantt chart>`. :rtype: :class:`ConnectorOptions <highcharts_gantt.options.connectors.ConnectorOptions>` or :obj:`None <python:None>` """ return self._connectors @connectors.setter @class_sensitive(ConnectorOptions) def connectors(self, value): self._connectors = value @property def credits(self) -> Optional[Credits]: """Highchart by default puts a credits label in the lower right corner of the chart. This can be changed using these options. :returns: :class:`Credits` configuration or :obj:`None <python:None>` :rtype: :class:`Credits` or :obj:`None <python:None>` """ return self._credits @credits.setter @class_sensitive(Credits) def credits(self, value): self._credits = value @property def data(self) -> Optional[Data]: """The ``data`` property provides a simplified interface for adding data to a chart from sources like CVS, HTML tables, or grid views. See also `the tutorial article on the Data module <https://www.highcharts.com/docs/working-with-data/data-module>`_. .. warning:: It requires the ``modules/data.js`` file to be loaded in the browser / client. .. warning:: Please note that the default way of adding data in Highcharts, without the need of a module, is through the ``series.type.data`` property. :returns: The :class:`Data` object or :obj:`None <python:None>` :rtype: :class:`Data` object or :obj:`None <python:None>` """ return self._data @data.setter @class_sensitive(Data) def data(self, value): self._data = value @property def defs(self) -> Optional[MarkerDefinition]: """Options for configuring markers for annotations. :returns: A :class:`MarkerDefinition` object or :obj:`None <python:None>` :rtype: :class:`MarkerDefinition` or :obj:`None <python:None>` """ return self._defs @defs.setter @class_sensitive(MarkerDefinition) def defs(self, value): self._defs = value @property def exporting(self) -> Optional[Exporting]: """Options to configure the export functionality enabled for the chart. :returns: The configuration of the chart's exporting functionality. :rtype: :class:`Exporting` or :obj:`None <python:None>` """ return self._exporting @exporting.setter @class_sensitive(Exporting) def exporting(self, value): self._exporting = value @property def language(self) -> Optional[Language]: """Language object which can be used to configure the specific text to use in the chart. .. note:: When working in JavaScript, the ``lang`` configuration is global and it can't be set on each chart initialization. Instead, use ``Highcharts.setOptions()`` to set it before any chart is initialized. :returns: A :class:`Language` object or :obj:`None <python:None>` :rtype: :class:`Language` or :obj:`None <python:None>` """ return self._language @language.setter @class_sensitive(Language) def language(self, value): self._language = value @property def legend(self) -> Optional[Legend]: """The legend is a box containing a symbol and name for each series item or point item in the chart. Each series (or points in case of pie charts) is represented by a symbol and its name in the legend. .. seealso:: It is possible to override the symbol creator function and create `custom legend symbols <https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/studies/legend-custom-symbol/>`_. :returns: The :class:`Legend` configuration or :obj:`None <python:None>` :rtype: :class:`Legend` or :obj:`None <python:None>` """ return self._legend @legend.setter @class_sensitive(Legend) def legend(self, value): self._legend = value @property def loading(self) -> Optional[Loading]: """The loading options control the appearance of the loading screen that covers the plot area on chart operations. This screen only appears after an explicit call to ``chart.showLoading()`` in the browser. It is a utility for developers to communicate to the end user that something is going on, for example while retrieving new data via an XHR connection. .. hint:: The "Loading..." text itself is **not** part of this configuration object, but is instead part of the :meth:`.language <Options.language>` configuration. :returns: The configuration of the loading screen or :obj:`None <python:None>` :rtype: :class:`Loading` or :obj:`None <python:None>` """ return self._loading @loading.setter @class_sensitive(Loading) def loading(self, value): self._loading = value @property def navigation(self) -> Optional[Navigation]: """A collection of options for buttons and menus appearing in the exporting module or in Stock Tools. :returns: The configuration of the navigation buttons. :rtype: ;class:`Navigation` or :obj:`None <python:None>` """ return self._navigation @navigation.setter @class_sensitive(Navigation) def navigation(self, value): self._navigation = value @property def navigator(self) -> Optional[Navigator]: """The navigator is a small series below the main series, displaying a view of the entire data set. It provides tools to zoom in and out on parts of the data as well as panning across the dataset. :returns: Configuration instructions for the :class:`Navigator` functionality. :rtype: :class:`Navigator` or :obj:`None <python:None>` """ return self._navigator @navigator.setter @class_sensitive(Navigator) def navigator(self, value): self._navigator = value @property def no_data(self) -> Optional[NoData]: """Options for displaying a message like "No data to display". .. warning:: This feature requires the file ``no-data-to-display.js`` to be loaded in the page. .. tip:: The actual text to display is set in the :meth:`language <Options.language>` options. :returns: Configuration of how to display a no data message. :rtype: :class:`NoData` or :obj:`None <python:None>` """ return self._no_data @no_data.setter @class_sensitive(NoData) def no_data(self, value): self._no_data = value @property def plot_options(self) -> Optional[PlotOptions]: """A wrapper object for configurations applied to each series type. The config objects for each series can also be overridden for each series item as given in the series array. Configuration options for the series are given in three levels: * Options for all series in a chart are given in the :meth:`series <PlotOptions.series>` property. * Options for all series of a specific type are given in the corresponding property for that type, for example :meth:`plot_options.line <PlotOptions.line>`. * Finally, options for one single series are given in the :meth:`series <Options.series>` array. :returns: Configurations for how series should be plotted / displayed. :rtype: :class:`PlotOptions` or :obj:`None <python:None>` """ return self._plot_options @plot_options.setter @class_sensitive(PlotOptions) def plot_options(self, value): self._plot_options = value @property def range_selector(self) -> Optional[RangeSelector]: """The range selector is a tool for selecting ranges to display within the chart. It provides buttons to select preconfigured ranges in the chart, like 1 day, 1 week, 1 month etc. It also provides input boxes where min and max dates can be manually input. :returns: Configuration instructions for the Range Selector functionality. :rtype: :class:`RangeSelector` or :obj:`None <python:None>` """ return self._range_selector @range_selector.setter @class_sensitive(RangeSelector) def range_selector(self, value): self._range_selector = value @property def responsive(self) -> Optional[Responsive]: """Rules to apply for different screen or chart sizes. .. note:: Each rule specifies additional chart options. :returns: Rules to apply for different screen or chart sizes. :rtype: :class:`Responsive` or :obj:`None <python:None>` """ return self._responsive @responsive.setter @class_sensitive(Responsive) def responsive(self, value): self._responsive = value @property def scrollbar(self) -> Optional[Scrollbar]: """The scrollbar is a means of panning over the X axis of a stock chart. .. note:: Scrollbars can also be applied to other types of axes. .. note:: Another approach to scrollable charts is the :meth:`Chart.scrollable_plot_area` option that is especially suitable for simpler cartesian charts on mobile. In styled mode, all the presentational options for the scrollbar are replaced by the classes ``.highcharts-scrollbar-thumb``, ``.highcharts-scrollbar-arrow``, ``.highcharts-scrollbar-button``, ``.highcharts-scrollbar-rifles`` and ``.highcharts-scrollbar-track``. :returns: The configuration options for the Scrollbar functionality. :rtype: :class:`Scrollbar` or :obj:`None <python:None>` """ return self._scrollbar @scrollbar.setter @class_sensitive(Scrollbar) def scrollbar(self, value): self._scrollbar = value @property def series(self) -> Optional[List[GenericTypeOptions]]: """Series options for specific data and the data itself. :returns: The series to display along with configuration and data. :rtype: :class:`Series` or :obj:`None <python:None>` """ return self._series @series.setter def series(self, value): value = validators.iterable(value, allow_empty = True) default_series_type = None if self.chart: default_series_type = self.chart.type if not value: self._series = None else: self._series = [create_series_obj(x, default_type = default_series_type) for x in value] @property def subtitle(self) -> Optional[Subtitle]: """The chart's subtitle. .. note:: This can be used both to display a subtitle below the main title, and to display random text anywhere in the chart. .. warning:: The subtitle can be updated after chart initialization through the ``Chart.setTitle`` JavaScript method. :returns: Configuration of the chart's subtitle. :rtype: :class:`Subtitle` or :obj:`None <python:None>` """ return self._subtitle @subtitle.setter @class_sensitive(Subtitle) def subtitle(self, value): self._subtitle = value @property def time(self) -> Optional[Time]: """Time options that can apply globally or to individual charts. These settings affect how datetime axes are laid out, how tooltips are formatted, how series :meth:`point_interval_unit <Series.point_interval_unit` works and how the Highcharts Stock range selector handles time. :returns: Configuration of applicable Time options. :rtype: :class:`Time` or :obj:`None <python:None>` """ return self._time @time.setter @class_sensitive(Time) def time(self, value): self._time = value @property def title(self) -> Optional[Title]: """Options for configuring the chart's main title. :returns: Configuration of the chart's main title. :rtype: :class:`Title` or :obj:`None <python:None>` """ return self._title @title.setter @class_sensitive(Title) def title(self, value): self._title = value @property def tooltip(self) -> Optional[Tooltip]: """Options for the tooltip that appears when the user hovers over a series or point. :returns: Configuration settings for tooltips to display above the chart. :rtype: :class:`Tooltip` or :obj:`None <python:None>` """ return self._tooltip @tooltip.setter @class_sensitive(Tooltip) def tooltip(self, value): self._tooltip = value @property def x_axis(self) -> Optional[List[XAxis]]: """The X axis or category axis. Normally this is the horizontal axis, though if the chart is inverted this is the vertical axis. :returns: A collection of :class:`XAxis` objects :rtype: :class:`list <python:list>` of :class:`XAxis` or :obj:`None <python:None>` """ return self._x_axis @x_axis.setter @class_sensitive(XAxis, force_iterable = True) def x_axis(self, value): self._x_axis = value @property def y_axis(self) -> Optional[List[YAxis]]: """The Y axis or value axis. Normally this is the vertical axis, though if the chart is inverted this is the horizontal axis. :returns: A collection of :class:`YAxis` objects :rtype: :class:`list <python:list>` of :class:`YAxis` or :obj:`None <python:None>` """ return self._y_axis @y_axis.setter @class_sensitive(YAxis, force_iterable = True) def y_axis(self, value): self._y_axis = value @classmethod def _get_kwargs_from_dict(cls, as_dict): as_dict = validators.dict(as_dict, allow_empty = True) or {} kwargs_dict = { 'accessibility': as_dict.get('accessibility', None), 'annotations': as_dict.get('annotations', None), 'boost': as_dict.get('boost', None), 'caption': as_dict.get('caption', None), 'chart': as_dict.get('chart', None), 'color_axis': as_dict.get('colorAxis', None), 'colors': as_dict.get('colors', None), 'connectors': as_dict.get('connectors', None), 'credits': as_dict.get('credits', None), 'data': as_dict.get('data', None), 'defs': as_dict.get('defs', None), 'drilldown': as_dict.get('drilldown', None), 'exporting': as_dict.get('exporting', None), 'language': as_dict.get('lang', None), 'legend': as_dict.get('legend', None), 'loading': as_dict.get('loading', None), 'navigation': as_dict.get('navigation', None), 'navigator': as_dict.get('navigator', None), 'no_data': as_dict.get('noData', None), 'pane': as_dict.get('pane', None), 'plot_options': as_dict.get('plotOptions', None), 'range_selector': as_dict.get('rangeSelector', None), 'responsive': as_dict.get('responsive', None), 'scrollbar': as_dict.get('scrollbar', None), 'series': as_dict.get('series', None), 'stock_tools': as_dict.get('stockTools', None), 'subtitle': as_dict.get('subtitle', None), 'time': as_dict.get('time', None), 'title': as_dict.get('title', None), 'tooltip': as_dict.get('tooltip', None), 'x_axis': as_dict.get('xAxis', None), 'y_axis': as_dict.get('yAxis', None), 'z_axis': as_dict.get('zAxis', None), } return kwargs_dict def _to_untrimmed_dict(self, in_cls = None) -> dict: untrimmed = { 'accessibility': self.accessibility, 'annotations': self.annotations, 'boost': self.boost, 'caption': self.caption, 'chart': self.chart, 'colorAxis': self.color_axis, 'colors': self.colors, 'connectors': self.connectors, 'credits': self.credits, 'data': self.data, 'drilldown': self.drilldown, 'defs': self.defs, 'exporting': self.exporting, 'lang': self.language, 'legend': self.legend, 'loading': self.loading, 'navigation': self.navigation, 'navigator': self.navigator, 'noData': self.no_data, 'pane': self.pane, 'plotOptions': self.plot_options, 'rangeSelector': self.range_selector, 'responsive': self.responsive, 'scrollbar': self.scrollbar, 'series': self.series, 'stockTools': self.stock_tools, 'subtitle': self.subtitle, 'time': self.time, 'title': self.title, 'tooltip': self.tooltip, 'xAxis': self.x_axis, 'yAxis': self.y_axis, 'zAxis': self.z_axis } return untrimmed