bump version to 1.0.0

Author: Marc-André Rivet

CHANGELOG.md

@@ -2,7 +2,7 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
-## [Unreleased]
+## [1.0.0] - 2019-06-20
 ### Added
 - `Markdown` components support code highlighting - no need to switch to `SyntaxHighlighter`, which has been removed. Use triple backticks, with the opening backticks followed by the language name or abbreviation. [#562](https://github.com/plotly/dash-core-components/pull/562) Supported languages:
     - Bash

dash_core_components/Checklist.py

@@ -6,16 +6,22 @@
 class Checklist(Component):
     """A Checklist component.
 Checklist is a component that encapsulates several checkboxes.
-The values and labels of the checklist is specified in the `options`
-property and the checked items are specified with the `values` property.
+The values and labels of the checklist are specified in the `options`
+property and the checked items are specified with the `value` property.
 Each checkbox is rendered as an input with a surrounding label.
 
 Keyword arguments:
 - id (string; optional): The ID of this component, used to identify dash components
 in callbacks. The ID needs to be unique across all of the
 components in an app.
-- options (list; optional): An array of options
-- values (list; optional): The currently selected value
+- options (optional): An array of options. options has the following type: list of dict containing keys 'label', 'value', 'disabled'.
+Those keys have the following types:
+  - label (string | number; required): The checkbox's label
+  - value (string | number; required): The value of the checkbox. This value
+corresponds to the items specified in the
+`value` property.
+  - disabled (boolean; optional): If true, this checkbox is disabled and can't be clicked on.s
+- value (list of string | numbers; optional): The currently selected value
 - className (string; optional): The class of the container (div)
 - style (dict; optional): The style of the container (div)
 - inputStyle (dict; optional): The style of the <input> checkbox element
@@ -30,12 +36,12 @@ class Checklist(Component):
   - prop_name (string; optional): Holds which property is loading
   - component_name (string; optional): Holds the name of the component that is loading"""
     @_explicitize_args
-    def __init__(self, id=Component.UNDEFINED, options=Component.UNDEFINED, values=Component.UNDEFINED, className=Component.UNDEFINED, style=Component.UNDEFINED, inputStyle=Component.UNDEFINED, inputClassName=Component.UNDEFINED, labelStyle=Component.UNDEFINED, labelClassName=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
-        self._prop_names = ['id', 'options', 'values', 'className', 'style', 'inputStyle', 'inputClassName', 'labelStyle', 'labelClassName', 'loading_state']
+    def __init__(self, id=Component.UNDEFINED, options=Component.UNDEFINED, value=Component.UNDEFINED, className=Component.UNDEFINED, style=Component.UNDEFINED, inputStyle=Component.UNDEFINED, inputClassName=Component.UNDEFINED, labelStyle=Component.UNDEFINED, labelClassName=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
+        self._prop_names = ['id', 'options', 'value', 'className', 'style', 'inputStyle', 'inputClassName', 'labelStyle', 'labelClassName', 'loading_state']
         self._type = 'Checklist'
         self._namespace = 'dash_core_components'
         self._valid_wildcard_attributes =            []
-        self.available_properties = ['id', 'options', 'values', 'className', 'style', 'inputStyle', 'inputClassName', 'labelStyle', 'labelClassName', 'loading_state']
+        self.available_properties = ['id', 'options', 'value', 'className', 'style', 'inputStyle', 'inputClassName', 'labelStyle', 'labelClassName', 'loading_state']
         self.available_wildcard_properties =            []
 
         _explicit_args = kwargs.pop('_explicit_args')

dash_core_components/Dropdown.py

@@ -18,9 +18,15 @@ class Dropdown(Component):
 - id (string; optional): The ID of this component, used to identify dash components
 in callbacks. The ID needs to be unique across all of the
 components in an app.
-- options (list; optional): An array of options {label: [string|number], value: [string|number]},
-an optional disabled field can be used for each option
-- value (string | list | number | list; optional): The value of the input. If `multi` is false (the default)
+- options (optional): An array of options {label: [string|number], value: [string|number]},
+an optional disabled field can be used for each option. options has the following type: list of dict containing keys 'label', 'value', 'disabled'.
+Those keys have the following types:
+  - label (string | number; required): The dropdown's label
+  - value (string | number; required): The value of the dropdown. This value
+corresponds to the items specified in the
+`value` property.
+  - disabled (boolean; optional): If true, this option is disabled and cannot be selected.s
+- value (string | number | list of string | numbers; optional): The value of the input. If `multi` is false (the default)
 then value is just a string that corresponds to the values
 provided in the `options` property. If `multi` is true, then
 multiple values can be selected at once, and `value` is an
@@ -31,7 +37,7 @@ class Dropdown(Component):
 - clearable (boolean; optional): Whether or not the dropdown is "clearable", that is, whether or
 not a small "x" appears on the right of the dropdown that removes
 the selected value.
-- disabled (boolean; optional): If true, the option is disabled
+- disabled (boolean; optional): If true, this dropdown is disabled and the selection cannot be changed.
 - multi (boolean; optional): If true, the user can select multiple values
 - placeholder (string; optional): The grey, default text shown when no option is selected
 - searchable (boolean; optional): Whether to enable the searching feature or not

dash_core_components/Graph.py

@@ -46,9 +46,9 @@ class Graph(Component):
 
 `config` is set separately by the `config` property. figure has the following type: dict containing keys 'data', 'layout', 'frames'.
 Those keys have the following types:
-  - data (list; optional)
+  - data (list of dicts; optional)
   - layout (dict; optional)
-  - frames (list; optional)
+  - frames (list of dicts; optional)
 - style (dict; optional): Generic style overrides on the plot div
 - className (string; optional): className of the parent div
 - animate (boolean; optional): Beta: If true, animate between updates using

dash_core_components/Loading.py

@@ -8,7 +8,7 @@ class Loading(Component):
 A Loading component that wraps any other component and displays a spinner until the wrapped component has rendered.
 
 Keyword arguments:
-- children (list | a list of or a singular dash component, string or number; optional): Array that holds components to render
+- children (list of a list of or a singular dash component, string or numbers | a list of or a singular dash component, string or number; optional): Array that holds components to render
 - id (string; optional): The ID of this component, used to identify dash components
 in callbacks. The ID needs to be unique across all of the
 components in an app.

dash_core_components/Markdown.py

@@ -0,0 +1,53 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class Markdown(Component):
+    """A Markdown component.
+A component that renders Markdown text as specified by the
+GitHub Markdown spec. These component uses
+[react-markdown](https://rexxars.github.io/react-markdown/) under the hood.
+
+Keyword arguments:
+- children (string | list of strings; optional): A markdown string (or array of strings) that adhreres to the CommonMark spec
+- id (string; optional): The ID of this component, used to identify dash components
+in callbacks. The ID needs to be unique across all of the
+components in an app.
+- className (string; optional): Class name of the container element
+- dangerously_allow_html (boolean; optional): A boolean to control raw HTML escaping.
+Setting HTML from code is risky because it's easy to
+inadvertently expose your users to a cross-site scripting (XSS)
+(https://en.wikipedia.org/wiki/Cross-site_scripting) attack.
+- dedent (boolean; optional): Remove matching leading whitespace from all lines.
+Lines that are empty, or contain *only* whitespace, are ignored.
+Both spaces and tab characters are removed, but only if they match;
+we will not convert tabs to spaces or vice versa.
+- highlight_config (optional): Config options for syntax highlighting.. highlight_config has the following type: dict containing keys 'theme'.
+Those keys have the following types:
+  - theme (a value equal to: 'dark', 'light'; optional): Color scheme; default 'light'
+- loading_state (optional): Object that holds the loading state object coming from dash-renderer. loading_state has the following type: dict containing keys 'is_loading', 'prop_name', 'component_name'.
+Those keys have the following types:
+  - is_loading (boolean; optional): Determines if the component is loading or not
+  - prop_name (string; optional): Holds which property is loading
+  - component_name (string; optional): Holds the name of the component that is loading
+- style (dict; optional): User-defined inline styles for the rendered Markdown"""
+    @_explicitize_args
+    def __init__(self, children=None, id=Component.UNDEFINED, className=Component.UNDEFINED, dangerously_allow_html=Component.UNDEFINED, dedent=Component.UNDEFINED, highlight_config=Component.UNDEFINED, loading_state=Component.UNDEFINED, style=Component.UNDEFINED, **kwargs):
+        self._prop_names = ['children', 'id', 'className', 'dangerously_allow_html', 'dedent', 'highlight_config', 'loading_state', 'style']
+        self._type = 'Markdown'
+        self._namespace = 'dash_core_components'
+        self._valid_wildcard_attributes =            []
+        self.available_properties = ['children', 'id', 'className', 'dangerously_allow_html', 'dedent', 'highlight_config', 'loading_state', 'style']
+        self.available_wildcard_properties =            []
+
+        _explicit_args = kwargs.pop('_explicit_args')
+        _locals = locals()
+        _locals.update(kwargs)  # For wildcard attrs
+        args = {k: _locals[k] for k in _explicit_args if k != 'children'}
+
+        for k in []:
+            if k not in args:
+                raise TypeError(
+                    'Required argument `' + k + '` was not specified.')
+        super(Markdown, self).__init__(children=children, **args)

dash_core_components/RadioItems.py

@@ -14,8 +14,14 @@ class RadioItems(Component):
 - id (string; optional): The ID of this component, used to identify dash components
 in callbacks. The ID needs to be unique across all of the
 components in an app.
-- options (list; optional): An array of options
-- value (string; optional): The currently selected value
+- options (optional): An array of options. options has the following type: list of dict containing keys 'label', 'value', 'disabled'.
+Those keys have the following types:
+  - label (string | number; required): The radio item's label
+  - value (string | number; required): The value of the radio item. This value
+corresponds to the items specified in the
+`value` property.
+  - disabled (boolean; optional): If true, this radio item is disabled and can't be clicked on.s
+- value (string | number; optional): The currently selected value
 - style (dict; optional): The style of the container (div)
 - className (string; optional): The class of the container (div)
 - inputStyle (dict; optional): The style of the <input> radio element

dash_core_components/RangeSlider.py

@@ -21,7 +21,7 @@ class RangeSlider(Component):
 Those keys have the following types:
   - label (string; optional)
   - style (dict; optional)
-- value (list; optional): The value of the input
+- value (list of numbers; optional): The value of the input
 - allowCross (boolean; optional): allowCross could be set as true to allow those handles to cross.
 - className (string; optional): Additional CSS class for the root DOM node
 - count (number; optional): Determine how many ranges to render, and multiple handles
@@ -38,6 +38,14 @@ class RangeSlider(Component):
 surrounding handles when moving an handle.
 When set to a number, the number will be the
 minimum ensured distance between handles.
+- tooltip (optional): . tooltip has the following type: dict containing keys 'always_visible', 'placement'.
+Those keys have the following types:
+  - always_visible (boolean; optional): Determines whether tooltips should always be visible
+(as opposed to the default, visible on hover)
+  - placement (a value equal to: 'left', 'right', 'top', 'bottom', 'topLeft', 'topRight', 'bottomLeft', 'bottomRight'; optional): Determines the placement of tooltips
+See https://github.com/react-component/tooltip#api
+top/bottom{*} sets the _origin_ of the tooltip, so e.g. `topLeft` will
+in reality appear to be on the top right of the handle
 - step (number; optional): Value by which increments or decrements are made
 - vertical (boolean; optional): If true, the slider will be vertical
 - updatemode (a value equal to: 'mouseup', 'drag'; optional): Determines when the component should update
@@ -53,12 +61,12 @@ class RangeSlider(Component):
   - prop_name (string; optional): Holds which property is loading
   - component_name (string; optional): Holds the name of the component that is loading"""
     @_explicitize_args
-    def __init__(self, id=Component.UNDEFINED, marks=Component.UNDEFINED, value=Component.UNDEFINED, allowCross=Component.UNDEFINED, className=Component.UNDEFINED, count=Component.UNDEFINED, disabled=Component.UNDEFINED, dots=Component.UNDEFINED, included=Component.UNDEFINED, min=Component.UNDEFINED, max=Component.UNDEFINED, pushable=Component.UNDEFINED, step=Component.UNDEFINED, vertical=Component.UNDEFINED, updatemode=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
-        self._prop_names = ['id', 'marks', 'value', 'allowCross', 'className', 'count', 'disabled', 'dots', 'included', 'min', 'max', 'pushable', 'step', 'vertical', 'updatemode', 'loading_state']
+    def __init__(self, id=Component.UNDEFINED, marks=Component.UNDEFINED, value=Component.UNDEFINED, allowCross=Component.UNDEFINED, className=Component.UNDEFINED, count=Component.UNDEFINED, disabled=Component.UNDEFINED, dots=Component.UNDEFINED, included=Component.UNDEFINED, min=Component.UNDEFINED, max=Component.UNDEFINED, pushable=Component.UNDEFINED, tooltip=Component.UNDEFINED, step=Component.UNDEFINED, vertical=Component.UNDEFINED, updatemode=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
+        self._prop_names = ['id', 'marks', 'value', 'allowCross', 'className', 'count', 'disabled', 'dots', 'included', 'min', 'max', 'pushable', 'tooltip', 'step', 'vertical', 'updatemode', 'loading_state']
         self._type = 'RangeSlider'
         self._namespace = 'dash_core_components'
         self._valid_wildcard_attributes =            []
-        self.available_properties = ['id', 'marks', 'value', 'allowCross', 'className', 'count', 'disabled', 'dots', 'included', 'min', 'max', 'pushable', 'step', 'vertical', 'updatemode', 'loading_state']
+        self.available_properties = ['id', 'marks', 'value', 'allowCross', 'className', 'count', 'disabled', 'dots', 'included', 'min', 'max', 'pushable', 'tooltip', 'step', 'vertical', 'updatemode', 'loading_state']
         self.available_wildcard_properties =            []
 
         _explicit_args = kwargs.pop('_explicit_args')

dash_core_components/Slider.py

@@ -30,6 +30,14 @@ class Slider(Component):
 value is included. Otherwise, it is an independent value.
 - min (number; optional): Minimum allowed value of the slider
 - max (number; optional): Maximum allowed value of the slider
+- tooltip (optional): . tooltip has the following type: dict containing keys 'always_visible', 'placement'.
+Those keys have the following types:
+  - always_visible (boolean; optional): Determines whether tooltips should always be visible
+(as opposed to the default, visible on hover)
+  - placement (a value equal to: 'left', 'right', 'top', 'bottom', 'topLeft', 'topRight', 'bottomLeft', 'bottomRight'; optional): Determines the placement of tooltips
+See https://github.com/react-component/tooltip#api
+top/bottom{*} sets the _origin_ of the tooltip, so e.g. `topLeft` will
+in reality appear to be on the top right of the handle
 - step (number; optional): Value by which increments or decrements are made
 - vertical (boolean; optional): If true, the slider will be vertical
 - updatemode (a value equal to: 'mouseup', 'drag'; optional): Determines when the component should update
@@ -45,12 +53,12 @@ class Slider(Component):
   - prop_name (string; optional): Holds which property is loading
   - component_name (string; optional): Holds the name of the component that is loading"""
     @_explicitize_args
-    def __init__(self, id=Component.UNDEFINED, marks=Component.UNDEFINED, value=Component.UNDEFINED, className=Component.UNDEFINED, disabled=Component.UNDEFINED, dots=Component.UNDEFINED, included=Component.UNDEFINED, min=Component.UNDEFINED, max=Component.UNDEFINED, step=Component.UNDEFINED, vertical=Component.UNDEFINED, updatemode=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
-        self._prop_names = ['id', 'marks', 'value', 'className', 'disabled', 'dots', 'included', 'min', 'max', 'step', 'vertical', 'updatemode', 'loading_state']
+    def __init__(self, id=Component.UNDEFINED, marks=Component.UNDEFINED, value=Component.UNDEFINED, className=Component.UNDEFINED, disabled=Component.UNDEFINED, dots=Component.UNDEFINED, included=Component.UNDEFINED, min=Component.UNDEFINED, max=Component.UNDEFINED, tooltip=Component.UNDEFINED, step=Component.UNDEFINED, vertical=Component.UNDEFINED, updatemode=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
+        self._prop_names = ['id', 'marks', 'value', 'className', 'disabled', 'dots', 'included', 'min', 'max', 'tooltip', 'step', 'vertical', 'updatemode', 'loading_state']
         self._type = 'Slider'
         self._namespace = 'dash_core_components'
         self._valid_wildcard_attributes =            []
-        self.available_properties = ['id', 'marks', 'value', 'className', 'disabled', 'dots', 'included', 'min', 'max', 'step', 'vertical', 'updatemode', 'loading_state']
+        self.available_properties = ['id', 'marks', 'value', 'className', 'disabled', 'dots', 'included', 'min', 'max', 'tooltip', 'step', 'vertical', 'updatemode', 'loading_state']
         self.available_wildcard_properties =            []
 
         _explicit_args = kwargs.pop('_explicit_args')

dash_core_components/Tabs.py

@@ -10,7 +10,7 @@ class Tabs(Component):
 children components that will be that tab's content.
 
 Keyword arguments:
-- children (list | a list of or a singular dash component, string or number; optional): Array that holds Tab components
+- children (list of a list of or a singular dash component, string or numbers | a list of or a singular dash component, string or number; optional): Array that holds Tab components
 - id (string; optional): The ID of this component, used to identify dash components
 in callbacks. The ID needs to be unique across all of the
 components in an app.