IDE with defaults

.gitignore

@@ -7,6 +7,7 @@ node_modules/
 .npm
 vv/
 venv/
+.tox
 *.pyc
 *.egg-info
 *.log

CHANGELOG.md

@@ -2,6 +2,11 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## [0.24.0] - UNRELEASED
+### Changed
+- `dash_core_components/__init__.py` now imports from python class files rather than generating classes at runtime,
+adding support for IDE autocomplete ect.
+
 ## [0.23.0] - UNRELEASED
 ### Added
 - Upgraded Plotly.js, the underlying library behind the

dash_core_components/Checklist.py

@@ -0,0 +1,70 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+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.
+Each checkbox is rendered as an input with a surrounding label.
+
+Keyword arguments:
+- id (string; optional)
+- options (list; optional): An array of options
+- values (list; 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
+- inputClassName (string; optional): The class of the <input> checkbox element
+- labelStyle (dict; optional): The style of the <label> that wraps the checkbox input
+ and the option's label
+- labelClassName (string; optional): The class of the <label> that wraps the checkbox input
+ and the option's label
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, options=[], values=Component._NO_DEFAULT_ARG, className=Component._NO_DEFAULT_ARG, style=Component._NO_DEFAULT_ARG, inputStyle={}, inputClassName='', labelStyle={}, labelClassName='', **kwargs):
+ self._prop_names = ['id', 'options', 'values', 'className', 'style', 'inputStyle', 'inputClassName', 'labelStyle', 'labelClassName']
+ self._type = 'Checklist'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'options', 'values', 'className', 'style', 'inputStyle', 'inputClassName', 'labelStyle', 'labelClassName']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(Checklist, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('Checklist(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'Checklist(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

dash_core_components/DatePickerRange.py

@@ -0,0 +1,120 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class DatePickerRange(Component):
+ """A DatePickerRange component.
+DatePickerRange is a tailor made component designed for selecting
+timespan across multiple days off of a calendar.
+
+The DatePicker integrates well with the Python datetime module with the
+startDate and endDate being returned in a string format suitable for
+creating datetime objects.
+
+This component is based off of Airbnb's react-dates react component
+which can be found here: https://github.com/airbnb/react-dates
+
+Keyword arguments:
+- id (string; optional)
+- start_date (string; optional): Specifies the starting date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- end_date (string; optional): Specifies the ending date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- min_date_allowed (string; optional): Specifies the lowest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- max_date_allowed (string; optional): Specifies the highest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- initial_visible_month (string; optional): Specifies the month that is initially presented when the user
+opens the calendar. Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- start_date_placeholder_text (string; optional): Text that will be displayed in the first input
+box of the date picker when no date is selected. Default value is 'Start Date'
+- end_date_placeholder_text (string; optional): Text that will be displayed in the second input
+box of the date picker when no date is selected. Default value is 'End Date'
+- day_size (number; optional): Size of rendered calendar days, higher number
+means bigger day size and larger calendar overall
+- calendar_orientation (a value equal to: 'vertical', 'horizontal'; optional): Orientation of calendar, either vertical or horizontal.
+Valid options are 'vertical' or 'horizontal'.
+- is_RTL (boolean; optional): Determines whether the calendar and days operate
+from left to right or from right to left
+- reopen_calendar_on_clear (boolean; optional): If True, the calendar will automatically open when cleared
+- number_of_months_shown (number; optional): Number of calendar months that are shown when calendar is opened
+- with_portal (boolean; optional): If True, calendar will open in a screen overlay portal,
+not supported on vertical calendar
+- with_full_screen_portal (boolean; optional): If True, calendar will open in a full screen overlay portal, will
+take precedent over 'withPortal' if both are set to true,
+not supported on vertical calendar
+- first_day_of_week (a value equal to: 0, 1, 2, 3, 4, 5, 6; optional): Specifies what day is the first day of the week, values must be
+from [0, ..., 6] with 0 denoting Sunday and 6 denoting Saturday
+- minimum_nights (number; optional): Specifies a minimum number of nights that must be selected between
+the startDate and the endDate
+- stay_open_on_select (boolean; optional): If True the calendar will not close when the user has selected a value
+and will wait until the user clicks off the calendar
+- show_outside_days (boolean; optional): If True the calendar will display days that rollover into
+the next month
+- month_format (string; optional): Specifies the format that the month will be displayed in the calendar,
+valid formats are variations of "MM YY". For example:
+"MM YY" renders as '05 97' for May 1997
+"MMMM, YYYY" renders as 'May, 1997' for May 1997
+"MMM, YY" renders as 'Sep, 97' for September 1997
+- display_format (string; optional): Specifies the format that the selected dates will be displayed
+valid formats are variations of "MM YY DD". For example:
+"MM YY DD" renders as '05 10 97' for May 10th 1997
+"MMMM, YY" renders as 'May, 1997' for May 10th 1997
+"M, D, YYYY" renders as '07, 10, 1997' for September 10th 1997
+"MMMM" renders as 'May' for May 10 1997
+- disabled (boolean; optional): If True, no dates can be selected.
+- 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.
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, start_date=Component._NO_DEFAULT_ARG, end_date=Component._NO_DEFAULT_ARG, min_date_allowed=Component._NO_DEFAULT_ARG, max_date_allowed=Component._NO_DEFAULT_ARG, initial_visible_month=Component._NO_DEFAULT_ARG, start_date_placeholder_text=Component._NO_DEFAULT_ARG, end_date_placeholder_text=Component._NO_DEFAULT_ARG, day_size=39, calendar_orientation=Component._NO_DEFAULT_ARG, is_RTL=False, reopen_calendar_on_clear=False, number_of_months_shown=1, with_portal=False, with_full_screen_portal=False, first_day_of_week=Component._NO_DEFAULT_ARG, minimum_nights=Component._NO_DEFAULT_ARG, stay_open_on_select=False, show_outside_days=Component._NO_DEFAULT_ARG, month_format=Component._NO_DEFAULT_ARG, display_format=Component._NO_DEFAULT_ARG, disabled=False, clearable=False, **kwargs):
+ self._prop_names = ['id', 'start_date', 'end_date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'start_date_placeholder_text', 'end_date_placeholder_text', 'day_size', 'calendar_orientation', 'is_RTL', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'minimum_nights', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self._type = 'DatePickerRange'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'start_date', 'end_date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'start_date_placeholder_text', 'end_date_placeholder_text', 'day_size', 'calendar_orientation', 'is_RTL', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'minimum_nights', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(DatePickerRange, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('DatePickerRange(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'DatePickerRange(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

dash_core_components/DatePickerSingle.py

@@ -0,0 +1,113 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class DatePickerSingle(Component):
+ """A DatePickerSingle component.
+DatePickerSingle is a tailor made component designed for selecting
+a single day off of a calendar.
+
+The DatePicker integrates well with the Python datetime module with the
+startDate and endDate being returned in a string format suitable for
+creating datetime objects.
+
+This component is based off of Airbnb's react-dates react component
+which can be found here: https://github.com/airbnb/react-dates
+
+Keyword arguments:
+- id (string; optional)
+- date (string; optional): Specifies the starting date for the component, best practice is to pass
+value via datetime object
+- min_date_allowed (string; optional): Specifies the lowest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- max_date_allowed (string; optional): Specifies the highest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- initial_visible_month (string; optional): Specifies the month that is initially presented when the user
+opens the calendar. Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- day_size (number; optional): Size of rendered calendar days, higher number
+means bigger day size and larger calendar overall
+- calendar_orientation (a value equal to: 'vertical', 'horizontal'; optional): Orientation of calendar, either vertical or horizontal.
+Valid options are 'vertical' or 'horizontal'.
+- is_RTL (boolean; optional): Determines whether the calendar and days operate
+from left to right or from right to left
+- placeholder (string; optional): Text that will be displayed in the input
+box of the date picker when no date is selected.
+Default value is 'Start Date'
+- reopen_calendar_on_clear (boolean; optional): If True, the calendar will automatically open when cleared
+- number_of_months_shown (number; optional): Number of calendar months that are shown when calendar is opened
+- with_portal (boolean; optional): If True, calendar will open in a screen overlay portal,
+not supported on vertical calendar
+- with_full_screen_portal (boolean; optional): If True, calendar will open in a full screen overlay portal, will
+take precedent over 'withPortal' if both are set to True,
+not supported on vertical calendar
+- first_day_of_week (a value equal to: 0, 1, 2, 3, 4, 5, 6; optional): Specifies what day is the first day of the week, values must be
+from [0, ..., 6] with 0 denoting Sunday and 6 denoting Saturday
+- stay_open_on_select (boolean; optional): If True the calendar will not close when the user has selected a value
+and will wait until the user clicks off the calendar
+- show_outside_days (boolean; optional): If True the calendar will display days that rollover into
+the next month
+- month_format (string; optional): Specifies the format that the month will be displayed in the calendar,
+valid formats are variations of "MM YY". For example:
+"MM YY" renders as '05 97' for May 1997
+"MMMM, YYYY" renders as 'May, 1997' for May 1997
+"MMM, YY" renders as 'Sep, 97' for September 1997
+- display_format (string; optional): Specifies the format that the selected dates will be displayed
+valid formats are variations of "MM YY DD". For example:
+"MM YY DD" renders as '05 10 97' for May 10th 1997
+"MMMM, YY" renders as 'May, 1997' for May 10th 1997
+"M, D, YYYY" renders as '07, 10, 1997' for September 10th 1997
+"MMMM" renders as 'May' for May 10 1997
+- disabled (boolean; optional): If True, no dates can be selected.
+- 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.
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, date=Component._NO_DEFAULT_ARG, min_date_allowed=Component._NO_DEFAULT_ARG, max_date_allowed=Component._NO_DEFAULT_ARG, initial_visible_month=Component._NO_DEFAULT_ARG, day_size=39, calendar_orientation=Component._NO_DEFAULT_ARG, is_RTL=False, placeholder=Component._NO_DEFAULT_ARG, reopen_calendar_on_clear=False, number_of_months_shown=1, with_portal=False, with_full_screen_portal=False, first_day_of_week=Component._NO_DEFAULT_ARG, stay_open_on_select=False, show_outside_days=True, month_format=Component._NO_DEFAULT_ARG, display_format=Component._NO_DEFAULT_ARG, disabled=False, clearable=False, **kwargs):
+ self._prop_names = ['id', 'date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'day_size', 'calendar_orientation', 'is_RTL', 'placeholder', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self._type = 'DatePickerSingle'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'day_size', 'calendar_orientation', 'is_RTL', 'placeholder', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(DatePickerSingle, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('DatePickerSingle(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'DatePickerSingle(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

.gitignore

@@ -7,6 +7,7 @@ node_modules/
 .npm
 vv/
 venv/
+.tox
 *.pyc
 *.egg-info
 *.log

CHANGELOG.md

@@ -2,6 +2,11 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## [0.24.0] - UNRELEASED
+### Changed
+- `dash_core_components/__init__.py` now imports from python class files rather than generating classes at runtime,
+adding support for IDE autocomplete ect.
+
 ## [0.23.0] - UNRELEASED
 ### Added
 - Upgraded Plotly.js, the underlying library behind the

dash_core_components/Checklist.py

@@ -0,0 +1,70 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+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.
+Each checkbox is rendered as an input with a surrounding label.
+
+Keyword arguments:
+- id (string; optional)
+- options (list; optional): An array of options
+- values (list; 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
+- inputClassName (string; optional): The class of the <input> checkbox element
+- labelStyle (dict; optional): The style of the <label> that wraps the checkbox input
+ and the option's label
+- labelClassName (string; optional): The class of the <label> that wraps the checkbox input
+ and the option's label
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, options=[], values=Component._NO_DEFAULT_ARG, className=Component._NO_DEFAULT_ARG, style=Component._NO_DEFAULT_ARG, inputStyle={}, inputClassName='', labelStyle={}, labelClassName='', **kwargs):
+ self._prop_names = ['id', 'options', 'values', 'className', 'style', 'inputStyle', 'inputClassName', 'labelStyle', 'labelClassName']
+ self._type = 'Checklist'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'options', 'values', 'className', 'style', 'inputStyle', 'inputClassName', 'labelStyle', 'labelClassName']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(Checklist, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('Checklist(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'Checklist(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

dash_core_components/DatePickerRange.py

@@ -0,0 +1,120 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class DatePickerRange(Component):
+ """A DatePickerRange component.
+DatePickerRange is a tailor made component designed for selecting
+timespan across multiple days off of a calendar.
+
+The DatePicker integrates well with the Python datetime module with the
+startDate and endDate being returned in a string format suitable for
+creating datetime objects.
+
+This component is based off of Airbnb's react-dates react component
+which can be found here: https://github.com/airbnb/react-dates
+
+Keyword arguments:
+- id (string; optional)
+- start_date (string; optional): Specifies the starting date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- end_date (string; optional): Specifies the ending date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- min_date_allowed (string; optional): Specifies the lowest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- max_date_allowed (string; optional): Specifies the highest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- initial_visible_month (string; optional): Specifies the month that is initially presented when the user
+opens the calendar. Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- start_date_placeholder_text (string; optional): Text that will be displayed in the first input
+box of the date picker when no date is selected. Default value is 'Start Date'
+- end_date_placeholder_text (string; optional): Text that will be displayed in the second input
+box of the date picker when no date is selected. Default value is 'End Date'
+- day_size (number; optional): Size of rendered calendar days, higher number
+means bigger day size and larger calendar overall
+- calendar_orientation (a value equal to: 'vertical', 'horizontal'; optional): Orientation of calendar, either vertical or horizontal.
+Valid options are 'vertical' or 'horizontal'.
+- is_RTL (boolean; optional): Determines whether the calendar and days operate
+from left to right or from right to left
+- reopen_calendar_on_clear (boolean; optional): If True, the calendar will automatically open when cleared
+- number_of_months_shown (number; optional): Number of calendar months that are shown when calendar is opened
+- with_portal (boolean; optional): If True, calendar will open in a screen overlay portal,
+not supported on vertical calendar
+- with_full_screen_portal (boolean; optional): If True, calendar will open in a full screen overlay portal, will
+take precedent over 'withPortal' if both are set to true,
+not supported on vertical calendar
+- first_day_of_week (a value equal to: 0, 1, 2, 3, 4, 5, 6; optional): Specifies what day is the first day of the week, values must be
+from [0, ..., 6] with 0 denoting Sunday and 6 denoting Saturday
+- minimum_nights (number; optional): Specifies a minimum number of nights that must be selected between
+the startDate and the endDate
+- stay_open_on_select (boolean; optional): If True the calendar will not close when the user has selected a value
+and will wait until the user clicks off the calendar
+- show_outside_days (boolean; optional): If True the calendar will display days that rollover into
+the next month
+- month_format (string; optional): Specifies the format that the month will be displayed in the calendar,
+valid formats are variations of "MM YY". For example:
+"MM YY" renders as '05 97' for May 1997
+"MMMM, YYYY" renders as 'May, 1997' for May 1997
+"MMM, YY" renders as 'Sep, 97' for September 1997
+- display_format (string; optional): Specifies the format that the selected dates will be displayed
+valid formats are variations of "MM YY DD". For example:
+"MM YY DD" renders as '05 10 97' for May 10th 1997
+"MMMM, YY" renders as 'May, 1997' for May 10th 1997
+"M, D, YYYY" renders as '07, 10, 1997' for September 10th 1997
+"MMMM" renders as 'May' for May 10 1997
+- disabled (boolean; optional): If True, no dates can be selected.
+- 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.
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, start_date=Component._NO_DEFAULT_ARG, end_date=Component._NO_DEFAULT_ARG, min_date_allowed=Component._NO_DEFAULT_ARG, max_date_allowed=Component._NO_DEFAULT_ARG, initial_visible_month=Component._NO_DEFAULT_ARG, start_date_placeholder_text=Component._NO_DEFAULT_ARG, end_date_placeholder_text=Component._NO_DEFAULT_ARG, day_size=39, calendar_orientation=Component._NO_DEFAULT_ARG, is_RTL=False, reopen_calendar_on_clear=False, number_of_months_shown=1, with_portal=False, with_full_screen_portal=False, first_day_of_week=Component._NO_DEFAULT_ARG, minimum_nights=Component._NO_DEFAULT_ARG, stay_open_on_select=False, show_outside_days=Component._NO_DEFAULT_ARG, month_format=Component._NO_DEFAULT_ARG, display_format=Component._NO_DEFAULT_ARG, disabled=False, clearable=False, **kwargs):
+ self._prop_names = ['id', 'start_date', 'end_date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'start_date_placeholder_text', 'end_date_placeholder_text', 'day_size', 'calendar_orientation', 'is_RTL', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'minimum_nights', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self._type = 'DatePickerRange'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'start_date', 'end_date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'start_date_placeholder_text', 'end_date_placeholder_text', 'day_size', 'calendar_orientation', 'is_RTL', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'minimum_nights', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(DatePickerRange, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('DatePickerRange(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'DatePickerRange(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

dash_core_components/DatePickerSingle.py

@@ -0,0 +1,113 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class DatePickerSingle(Component):
+ """A DatePickerSingle component.
+DatePickerSingle is a tailor made component designed for selecting
+a single day off of a calendar.
+
+The DatePicker integrates well with the Python datetime module with the
+startDate and endDate being returned in a string format suitable for
+creating datetime objects.
+
+This component is based off of Airbnb's react-dates react component
+which can be found here: https://github.com/airbnb/react-dates
+
+Keyword arguments:
+- id (string; optional)
+- date (string; optional): Specifies the starting date for the component, best practice is to pass
+value via datetime object
+- min_date_allowed (string; optional): Specifies the lowest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- max_date_allowed (string; optional): Specifies the highest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- initial_visible_month (string; optional): Specifies the month that is initially presented when the user
+opens the calendar. Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- day_size (number; optional): Size of rendered calendar days, higher number
+means bigger day size and larger calendar overall
+- calendar_orientation (a value equal to: 'vertical', 'horizontal'; optional): Orientation of calendar, either vertical or horizontal.
+Valid options are 'vertical' or 'horizontal'.
+- is_RTL (boolean; optional): Determines whether the calendar and days operate
+from left to right or from right to left
+- placeholder (string; optional): Text that will be displayed in the input
+box of the date picker when no date is selected.
+Default value is 'Start Date'
+- reopen_calendar_on_clear (boolean; optional): If True, the calendar will automatically open when cleared
+- number_of_months_shown (number; optional): Number of calendar months that are shown when calendar is opened
+- with_portal (boolean; optional): If True, calendar will open in a screen overlay portal,
+not supported on vertical calendar
+- with_full_screen_portal (boolean; optional): If True, calendar will open in a full screen overlay portal, will
+take precedent over 'withPortal' if both are set to True,
+not supported on vertical calendar
+- first_day_of_week (a value equal to: 0, 1, 2, 3, 4, 5, 6; optional): Specifies what day is the first day of the week, values must be
+from [0, ..., 6] with 0 denoting Sunday and 6 denoting Saturday
+- stay_open_on_select (boolean; optional): If True the calendar will not close when the user has selected a value
+and will wait until the user clicks off the calendar
+- show_outside_days (boolean; optional): If True the calendar will display days that rollover into
+the next month
+- month_format (string; optional): Specifies the format that the month will be displayed in the calendar,
+valid formats are variations of "MM YY". For example:
+"MM YY" renders as '05 97' for May 1997
+"MMMM, YYYY" renders as 'May, 1997' for May 1997
+"MMM, YY" renders as 'Sep, 97' for September 1997
+- display_format (string; optional): Specifies the format that the selected dates will be displayed
+valid formats are variations of "MM YY DD". For example:
+"MM YY DD" renders as '05 10 97' for May 10th 1997
+"MMMM, YY" renders as 'May, 1997' for May 10th 1997
+"M, D, YYYY" renders as '07, 10, 1997' for September 10th 1997
+"MMMM" renders as 'May' for May 10 1997
+- disabled (boolean; optional): If True, no dates can be selected.
+- 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.
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, date=Component._NO_DEFAULT_ARG, min_date_allowed=Component._NO_DEFAULT_ARG, max_date_allowed=Component._NO_DEFAULT_ARG, initial_visible_month=Component._NO_DEFAULT_ARG, day_size=39, calendar_orientation=Component._NO_DEFAULT_ARG, is_RTL=False, placeholder=Component._NO_DEFAULT_ARG, reopen_calendar_on_clear=False, number_of_months_shown=1, with_portal=False, with_full_screen_portal=False, first_day_of_week=Component._NO_DEFAULT_ARG, stay_open_on_select=False, show_outside_days=True, month_format=Component._NO_DEFAULT_ARG, display_format=Component._NO_DEFAULT_ARG, disabled=False, clearable=False, **kwargs):
+ self._prop_names = ['id', 'date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'day_size', 'calendar_orientation', 'is_RTL', 'placeholder', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self._type = 'DatePickerSingle'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'day_size', 'calendar_orientation', 'is_RTL', 'placeholder', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(DatePickerSingle, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('DatePickerSingle(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'DatePickerSingle(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

.gitignore

@@ -7,6 +7,7 @@ node_modules/
 .npm
 vv/
 venv/
+.tox
 *.pyc
 *.egg-info
 *.log

CHANGELOG.md

@@ -2,6 +2,11 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## [0.24.0] - UNRELEASED
+### Changed
+- `dash_core_components/__init__.py` now imports from python class files rather than generating classes at runtime,
+adding support for IDE autocomplete ect.
+
 ## [0.23.0] - UNRELEASED
 ### Added
 - Upgraded Plotly.js, the underlying library behind the

dash_core_components/Checklist.py

@@ -0,0 +1,70 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+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.
+Each checkbox is rendered as an input with a surrounding label.
+
+Keyword arguments:
+- id (string; optional)
+- options (list; optional): An array of options
+- values (list; 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
+- inputClassName (string; optional): The class of the <input> checkbox element
+- labelStyle (dict; optional): The style of the <label> that wraps the checkbox input
+ and the option's label
+- labelClassName (string; optional): The class of the <label> that wraps the checkbox input
+ and the option's label
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, options=[], values=Component._NO_DEFAULT_ARG, className=Component._NO_DEFAULT_ARG, style=Component._NO_DEFAULT_ARG, inputStyle={}, inputClassName='', labelStyle={}, labelClassName='', **kwargs):
+ self._prop_names = ['id', 'options', 'values', 'className', 'style', 'inputStyle', 'inputClassName', 'labelStyle', 'labelClassName']
+ self._type = 'Checklist'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'options', 'values', 'className', 'style', 'inputStyle', 'inputClassName', 'labelStyle', 'labelClassName']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(Checklist, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('Checklist(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'Checklist(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

dash_core_components/DatePickerRange.py

@@ -0,0 +1,120 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class DatePickerRange(Component):
+ """A DatePickerRange component.
+DatePickerRange is a tailor made component designed for selecting
+timespan across multiple days off of a calendar.
+
+The DatePicker integrates well with the Python datetime module with the
+startDate and endDate being returned in a string format suitable for
+creating datetime objects.
+
+This component is based off of Airbnb's react-dates react component
+which can be found here: https://github.com/airbnb/react-dates
+
+Keyword arguments:
+- id (string; optional)
+- start_date (string; optional): Specifies the starting date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- end_date (string; optional): Specifies the ending date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- min_date_allowed (string; optional): Specifies the lowest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- max_date_allowed (string; optional): Specifies the highest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- initial_visible_month (string; optional): Specifies the month that is initially presented when the user
+opens the calendar. Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- start_date_placeholder_text (string; optional): Text that will be displayed in the first input
+box of the date picker when no date is selected. Default value is 'Start Date'
+- end_date_placeholder_text (string; optional): Text that will be displayed in the second input
+box of the date picker when no date is selected. Default value is 'End Date'
+- day_size (number; optional): Size of rendered calendar days, higher number
+means bigger day size and larger calendar overall
+- calendar_orientation (a value equal to: 'vertical', 'horizontal'; optional): Orientation of calendar, either vertical or horizontal.
+Valid options are 'vertical' or 'horizontal'.
+- is_RTL (boolean; optional): Determines whether the calendar and days operate
+from left to right or from right to left
+- reopen_calendar_on_clear (boolean; optional): If True, the calendar will automatically open when cleared
+- number_of_months_shown (number; optional): Number of calendar months that are shown when calendar is opened
+- with_portal (boolean; optional): If True, calendar will open in a screen overlay portal,
+not supported on vertical calendar
+- with_full_screen_portal (boolean; optional): If True, calendar will open in a full screen overlay portal, will
+take precedent over 'withPortal' if both are set to true,
+not supported on vertical calendar
+- first_day_of_week (a value equal to: 0, 1, 2, 3, 4, 5, 6; optional): Specifies what day is the first day of the week, values must be
+from [0, ..., 6] with 0 denoting Sunday and 6 denoting Saturday
+- minimum_nights (number; optional): Specifies a minimum number of nights that must be selected between
+the startDate and the endDate
+- stay_open_on_select (boolean; optional): If True the calendar will not close when the user has selected a value
+and will wait until the user clicks off the calendar
+- show_outside_days (boolean; optional): If True the calendar will display days that rollover into
+the next month
+- month_format (string; optional): Specifies the format that the month will be displayed in the calendar,
+valid formats are variations of "MM YY". For example:
+"MM YY" renders as '05 97' for May 1997
+"MMMM, YYYY" renders as 'May, 1997' for May 1997
+"MMM, YY" renders as 'Sep, 97' for September 1997
+- display_format (string; optional): Specifies the format that the selected dates will be displayed
+valid formats are variations of "MM YY DD". For example:
+"MM YY DD" renders as '05 10 97' for May 10th 1997
+"MMMM, YY" renders as 'May, 1997' for May 10th 1997
+"M, D, YYYY" renders as '07, 10, 1997' for September 10th 1997
+"MMMM" renders as 'May' for May 10 1997
+- disabled (boolean; optional): If True, no dates can be selected.
+- 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.
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, start_date=Component._NO_DEFAULT_ARG, end_date=Component._NO_DEFAULT_ARG, min_date_allowed=Component._NO_DEFAULT_ARG, max_date_allowed=Component._NO_DEFAULT_ARG, initial_visible_month=Component._NO_DEFAULT_ARG, start_date_placeholder_text=Component._NO_DEFAULT_ARG, end_date_placeholder_text=Component._NO_DEFAULT_ARG, day_size=39, calendar_orientation=Component._NO_DEFAULT_ARG, is_RTL=False, reopen_calendar_on_clear=False, number_of_months_shown=1, with_portal=False, with_full_screen_portal=False, first_day_of_week=Component._NO_DEFAULT_ARG, minimum_nights=Component._NO_DEFAULT_ARG, stay_open_on_select=False, show_outside_days=Component._NO_DEFAULT_ARG, month_format=Component._NO_DEFAULT_ARG, display_format=Component._NO_DEFAULT_ARG, disabled=False, clearable=False, **kwargs):
+ self._prop_names = ['id', 'start_date', 'end_date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'start_date_placeholder_text', 'end_date_placeholder_text', 'day_size', 'calendar_orientation', 'is_RTL', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'minimum_nights', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self._type = 'DatePickerRange'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'start_date', 'end_date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'start_date_placeholder_text', 'end_date_placeholder_text', 'day_size', 'calendar_orientation', 'is_RTL', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'minimum_nights', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(DatePickerRange, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('DatePickerRange(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'DatePickerRange(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

dash_core_components/DatePickerSingle.py

@@ -0,0 +1,113 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class DatePickerSingle(Component):
+ """A DatePickerSingle component.
+DatePickerSingle is a tailor made component designed for selecting
+a single day off of a calendar.
+
+The DatePicker integrates well with the Python datetime module with the
+startDate and endDate being returned in a string format suitable for
+creating datetime objects.
+
+This component is based off of Airbnb's react-dates react component
+which can be found here: https://github.com/airbnb/react-dates
+
+Keyword arguments:
+- id (string; optional)
+- date (string; optional): Specifies the starting date for the component, best practice is to pass
+value via datetime object
+- min_date_allowed (string; optional): Specifies the lowest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- max_date_allowed (string; optional): Specifies the highest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- initial_visible_month (string; optional): Specifies the month that is initially presented when the user
+opens the calendar. Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- day_size (number; optional): Size of rendered calendar days, higher number
+means bigger day size and larger calendar overall
+- calendar_orientation (a value equal to: 'vertical', 'horizontal'; optional): Orientation of calendar, either vertical or horizontal.
+Valid options are 'vertical' or 'horizontal'.
+- is_RTL (boolean; optional): Determines whether the calendar and days operate
+from left to right or from right to left
+- placeholder (string; optional): Text that will be displayed in the input
+box of the date picker when no date is selected.
+Default value is 'Start Date'
+- reopen_calendar_on_clear (boolean; optional): If True, the calendar will automatically open when cleared
+- number_of_months_shown (number; optional): Number of calendar months that are shown when calendar is opened
+- with_portal (boolean; optional): If True, calendar will open in a screen overlay portal,
+not supported on vertical calendar
+- with_full_screen_portal (boolean; optional): If True, calendar will open in a full screen overlay portal, will
+take precedent over 'withPortal' if both are set to True,
+not supported on vertical calendar
+- first_day_of_week (a value equal to: 0, 1, 2, 3, 4, 5, 6; optional): Specifies what day is the first day of the week, values must be
+from [0, ..., 6] with 0 denoting Sunday and 6 denoting Saturday
+- stay_open_on_select (boolean; optional): If True the calendar will not close when the user has selected a value
+and will wait until the user clicks off the calendar
+- show_outside_days (boolean; optional): If True the calendar will display days that rollover into
+the next month
+- month_format (string; optional): Specifies the format that the month will be displayed in the calendar,
+valid formats are variations of "MM YY". For example:
+"MM YY" renders as '05 97' for May 1997
+"MMMM, YYYY" renders as 'May, 1997' for May 1997
+"MMM, YY" renders as 'Sep, 97' for September 1997
+- display_format (string; optional): Specifies the format that the selected dates will be displayed
+valid formats are variations of "MM YY DD". For example:
+"MM YY DD" renders as '05 10 97' for May 10th 1997
+"MMMM, YY" renders as 'May, 1997' for May 10th 1997
+"M, D, YYYY" renders as '07, 10, 1997' for September 10th 1997
+"MMMM" renders as 'May' for May 10 1997
+- disabled (boolean; optional): If True, no dates can be selected.
+- 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.
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, date=Component._NO_DEFAULT_ARG, min_date_allowed=Component._NO_DEFAULT_ARG, max_date_allowed=Component._NO_DEFAULT_ARG, initial_visible_month=Component._NO_DEFAULT_ARG, day_size=39, calendar_orientation=Component._NO_DEFAULT_ARG, is_RTL=False, placeholder=Component._NO_DEFAULT_ARG, reopen_calendar_on_clear=False, number_of_months_shown=1, with_portal=False, with_full_screen_portal=False, first_day_of_week=Component._NO_DEFAULT_ARG, stay_open_on_select=False, show_outside_days=True, month_format=Component._NO_DEFAULT_ARG, display_format=Component._NO_DEFAULT_ARG, disabled=False, clearable=False, **kwargs):
+ self._prop_names = ['id', 'date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'day_size', 'calendar_orientation', 'is_RTL', 'placeholder', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self._type = 'DatePickerSingle'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'day_size', 'calendar_orientation', 'is_RTL', 'placeholder', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(DatePickerSingle, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('DatePickerSingle(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'DatePickerSingle(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

.gitignore

@@ -7,6 +7,7 @@ node_modules/
 .npm
 vv/
 venv/
+.tox
 *.pyc
 *.egg-info
 *.log

CHANGELOG.md

@@ -2,6 +2,11 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## [0.24.0] - UNRELEASED
+### Changed
+- `dash_core_components/__init__.py` now imports from python class files rather than generating classes at runtime,
+adding support for IDE autocomplete ect.
+
 ## [0.23.0] - UNRELEASED
 ### Added
 - Upgraded Plotly.js, the underlying library behind the

dash_core_components/Checklist.py

@@ -0,0 +1,70 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+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.
+Each checkbox is rendered as an input with a surrounding label.
+
+Keyword arguments:
+- id (string; optional)
+- options (list; optional): An array of options
+- values (list; 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
+- inputClassName (string; optional): The class of the <input> checkbox element
+- labelStyle (dict; optional): The style of the <label> that wraps the checkbox input
+ and the option's label
+- labelClassName (string; optional): The class of the <label> that wraps the checkbox input
+ and the option's label
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, options=[], values=Component._NO_DEFAULT_ARG, className=Component._NO_DEFAULT_ARG, style=Component._NO_DEFAULT_ARG, inputStyle={}, inputClassName='', labelStyle={}, labelClassName='', **kwargs):
+ self._prop_names = ['id', 'options', 'values', 'className', 'style', 'inputStyle', 'inputClassName', 'labelStyle', 'labelClassName']
+ self._type = 'Checklist'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'options', 'values', 'className', 'style', 'inputStyle', 'inputClassName', 'labelStyle', 'labelClassName']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(Checklist, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('Checklist(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'Checklist(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

dash_core_components/DatePickerRange.py

@@ -0,0 +1,120 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class DatePickerRange(Component):
+ """A DatePickerRange component.
+DatePickerRange is a tailor made component designed for selecting
+timespan across multiple days off of a calendar.
+
+The DatePicker integrates well with the Python datetime module with the
+startDate and endDate being returned in a string format suitable for
+creating datetime objects.
+
+This component is based off of Airbnb's react-dates react component
+which can be found here: https://github.com/airbnb/react-dates
+
+Keyword arguments:
+- id (string; optional)
+- start_date (string; optional): Specifies the starting date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- end_date (string; optional): Specifies the ending date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- min_date_allowed (string; optional): Specifies the lowest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- max_date_allowed (string; optional): Specifies the highest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- initial_visible_month (string; optional): Specifies the month that is initially presented when the user
+opens the calendar. Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- start_date_placeholder_text (string; optional): Text that will be displayed in the first input
+box of the date picker when no date is selected. Default value is 'Start Date'
+- end_date_placeholder_text (string; optional): Text that will be displayed in the second input
+box of the date picker when no date is selected. Default value is 'End Date'
+- day_size (number; optional): Size of rendered calendar days, higher number
+means bigger day size and larger calendar overall
+- calendar_orientation (a value equal to: 'vertical', 'horizontal'; optional): Orientation of calendar, either vertical or horizontal.
+Valid options are 'vertical' or 'horizontal'.
+- is_RTL (boolean; optional): Determines whether the calendar and days operate
+from left to right or from right to left
+- reopen_calendar_on_clear (boolean; optional): If True, the calendar will automatically open when cleared
+- number_of_months_shown (number; optional): Number of calendar months that are shown when calendar is opened
+- with_portal (boolean; optional): If True, calendar will open in a screen overlay portal,
+not supported on vertical calendar
+- with_full_screen_portal (boolean; optional): If True, calendar will open in a full screen overlay portal, will
+take precedent over 'withPortal' if both are set to true,
+not supported on vertical calendar
+- first_day_of_week (a value equal to: 0, 1, 2, 3, 4, 5, 6; optional): Specifies what day is the first day of the week, values must be
+from [0, ..., 6] with 0 denoting Sunday and 6 denoting Saturday
+- minimum_nights (number; optional): Specifies a minimum number of nights that must be selected between
+the startDate and the endDate
+- stay_open_on_select (boolean; optional): If True the calendar will not close when the user has selected a value
+and will wait until the user clicks off the calendar
+- show_outside_days (boolean; optional): If True the calendar will display days that rollover into
+the next month
+- month_format (string; optional): Specifies the format that the month will be displayed in the calendar,
+valid formats are variations of "MM YY". For example:
+"MM YY" renders as '05 97' for May 1997
+"MMMM, YYYY" renders as 'May, 1997' for May 1997
+"MMM, YY" renders as 'Sep, 97' for September 1997
+- display_format (string; optional): Specifies the format that the selected dates will be displayed
+valid formats are variations of "MM YY DD". For example:
+"MM YY DD" renders as '05 10 97' for May 10th 1997
+"MMMM, YY" renders as 'May, 1997' for May 10th 1997
+"M, D, YYYY" renders as '07, 10, 1997' for September 10th 1997
+"MMMM" renders as 'May' for May 10 1997
+- disabled (boolean; optional): If True, no dates can be selected.
+- 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.
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, start_date=Component._NO_DEFAULT_ARG, end_date=Component._NO_DEFAULT_ARG, min_date_allowed=Component._NO_DEFAULT_ARG, max_date_allowed=Component._NO_DEFAULT_ARG, initial_visible_month=Component._NO_DEFAULT_ARG, start_date_placeholder_text=Component._NO_DEFAULT_ARG, end_date_placeholder_text=Component._NO_DEFAULT_ARG, day_size=39, calendar_orientation=Component._NO_DEFAULT_ARG, is_RTL=False, reopen_calendar_on_clear=False, number_of_months_shown=1, with_portal=False, with_full_screen_portal=False, first_day_of_week=Component._NO_DEFAULT_ARG, minimum_nights=Component._NO_DEFAULT_ARG, stay_open_on_select=False, show_outside_days=Component._NO_DEFAULT_ARG, month_format=Component._NO_DEFAULT_ARG, display_format=Component._NO_DEFAULT_ARG, disabled=False, clearable=False, **kwargs):
+ self._prop_names = ['id', 'start_date', 'end_date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'start_date_placeholder_text', 'end_date_placeholder_text', 'day_size', 'calendar_orientation', 'is_RTL', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'minimum_nights', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self._type = 'DatePickerRange'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'start_date', 'end_date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'start_date_placeholder_text', 'end_date_placeholder_text', 'day_size', 'calendar_orientation', 'is_RTL', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'minimum_nights', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(DatePickerRange, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('DatePickerRange(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'DatePickerRange(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

dash_core_components/DatePickerSingle.py

@@ -0,0 +1,113 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class DatePickerSingle(Component):
+ """A DatePickerSingle component.
+DatePickerSingle is a tailor made component designed for selecting
+a single day off of a calendar.
+
+The DatePicker integrates well with the Python datetime module with the
+startDate and endDate being returned in a string format suitable for
+creating datetime objects.
+
+This component is based off of Airbnb's react-dates react component
+which can be found here: https://github.com/airbnb/react-dates
+
+Keyword arguments:
+- id (string; optional)
+- date (string; optional): Specifies the starting date for the component, best practice is to pass
+value via datetime object
+- min_date_allowed (string; optional): Specifies the lowest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- max_date_allowed (string; optional): Specifies the highest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- initial_visible_month (string; optional): Specifies the month that is initially presented when the user
+opens the calendar. Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- day_size (number; optional): Size of rendered calendar days, higher number
+means bigger day size and larger calendar overall
+- calendar_orientation (a value equal to: 'vertical', 'horizontal'; optional): Orientation of calendar, either vertical or horizontal.
+Valid options are 'vertical' or 'horizontal'.
+- is_RTL (boolean; optional): Determines whether the calendar and days operate
+from left to right or from right to left
+- placeholder (string; optional): Text that will be displayed in the input
+box of the date picker when no date is selected.
+Default value is 'Start Date'
+- reopen_calendar_on_clear (boolean; optional): If True, the calendar will automatically open when cleared
+- number_of_months_shown (number; optional): Number of calendar months that are shown when calendar is opened
+- with_portal (boolean; optional): If True, calendar will open in a screen overlay portal,
+not supported on vertical calendar
+- with_full_screen_portal (boolean; optional): If True, calendar will open in a full screen overlay portal, will
+take precedent over 'withPortal' if both are set to True,
+not supported on vertical calendar
+- first_day_of_week (a value equal to: 0, 1, 2, 3, 4, 5, 6; optional): Specifies what day is the first day of the week, values must be
+from [0, ..., 6] with 0 denoting Sunday and 6 denoting Saturday
+- stay_open_on_select (boolean; optional): If True the calendar will not close when the user has selected a value
+and will wait until the user clicks off the calendar
+- show_outside_days (boolean; optional): If True the calendar will display days that rollover into
+the next month
+- month_format (string; optional): Specifies the format that the month will be displayed in the calendar,
+valid formats are variations of "MM YY". For example:
+"MM YY" renders as '05 97' for May 1997
+"MMMM, YYYY" renders as 'May, 1997' for May 1997
+"MMM, YY" renders as 'Sep, 97' for September 1997
+- display_format (string; optional): Specifies the format that the selected dates will be displayed
+valid formats are variations of "MM YY DD". For example:
+"MM YY DD" renders as '05 10 97' for May 10th 1997
+"MMMM, YY" renders as 'May, 1997' for May 10th 1997
+"M, D, YYYY" renders as '07, 10, 1997' for September 10th 1997
+"MMMM" renders as 'May' for May 10 1997
+- disabled (boolean; optional): If True, no dates can be selected.
+- 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.
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, date=Component._NO_DEFAULT_ARG, min_date_allowed=Component._NO_DEFAULT_ARG, max_date_allowed=Component._NO_DEFAULT_ARG, initial_visible_month=Component._NO_DEFAULT_ARG, day_size=39, calendar_orientation=Component._NO_DEFAULT_ARG, is_RTL=False, placeholder=Component._NO_DEFAULT_ARG, reopen_calendar_on_clear=False, number_of_months_shown=1, with_portal=False, with_full_screen_portal=False, first_day_of_week=Component._NO_DEFAULT_ARG, stay_open_on_select=False, show_outside_days=True, month_format=Component._NO_DEFAULT_ARG, display_format=Component._NO_DEFAULT_ARG, disabled=False, clearable=False, **kwargs):
+ self._prop_names = ['id', 'date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'day_size', 'calendar_orientation', 'is_RTL', 'placeholder', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self._type = 'DatePickerSingle'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'day_size', 'calendar_orientation', 'is_RTL', 'placeholder', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(DatePickerSingle, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('DatePickerSingle(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'DatePickerSingle(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

.gitignore

@@ -7,6 +7,7 @@ node_modules/
 .npm
 vv/
 venv/
+.tox
 *.pyc
 *.egg-info
 *.log

CHANGELOG.md

@@ -2,6 +2,11 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## [0.24.0] - UNRELEASED
+### Changed
+- `dash_core_components/__init__.py` now imports from python class files rather than generating classes at runtime,
+adding support for IDE autocomplete ect.
+
 ## [0.23.0] - UNRELEASED
 ### Added
 - Upgraded Plotly.js, the underlying library behind the

dash_core_components/Checklist.py

@@ -0,0 +1,70 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+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.
+Each checkbox is rendered as an input with a surrounding label.
+
+Keyword arguments:
+- id (string; optional)
+- options (list; optional): An array of options
+- values (list; 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
+- inputClassName (string; optional): The class of the <input> checkbox element
+- labelStyle (dict; optional): The style of the <label> that wraps the checkbox input
+ and the option's label
+- labelClassName (string; optional): The class of the <label> that wraps the checkbox input
+ and the option's label
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, options=[], values=Component._NO_DEFAULT_ARG, className=Component._NO_DEFAULT_ARG, style=Component._NO_DEFAULT_ARG, inputStyle={}, inputClassName='', labelStyle={}, labelClassName='', **kwargs):
+ self._prop_names = ['id', 'options', 'values', 'className', 'style', 'inputStyle', 'inputClassName', 'labelStyle', 'labelClassName']
+ self._type = 'Checklist'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'options', 'values', 'className', 'style', 'inputStyle', 'inputClassName', 'labelStyle', 'labelClassName']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(Checklist, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('Checklist(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'Checklist(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

dash_core_components/DatePickerRange.py

@@ -0,0 +1,120 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class DatePickerRange(Component):
+ """A DatePickerRange component.
+DatePickerRange is a tailor made component designed for selecting
+timespan across multiple days off of a calendar.
+
+The DatePicker integrates well with the Python datetime module with the
+startDate and endDate being returned in a string format suitable for
+creating datetime objects.
+
+This component is based off of Airbnb's react-dates react component
+which can be found here: https://github.com/airbnb/react-dates
+
+Keyword arguments:
+- id (string; optional)
+- start_date (string; optional): Specifies the starting date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- end_date (string; optional): Specifies the ending date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- min_date_allowed (string; optional): Specifies the lowest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- max_date_allowed (string; optional): Specifies the highest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- initial_visible_month (string; optional): Specifies the month that is initially presented when the user
+opens the calendar. Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- start_date_placeholder_text (string; optional): Text that will be displayed in the first input
+box of the date picker when no date is selected. Default value is 'Start Date'
+- end_date_placeholder_text (string; optional): Text that will be displayed in the second input
+box of the date picker when no date is selected. Default value is 'End Date'
+- day_size (number; optional): Size of rendered calendar days, higher number
+means bigger day size and larger calendar overall
+- calendar_orientation (a value equal to: 'vertical', 'horizontal'; optional): Orientation of calendar, either vertical or horizontal.
+Valid options are 'vertical' or 'horizontal'.
+- is_RTL (boolean; optional): Determines whether the calendar and days operate
+from left to right or from right to left
+- reopen_calendar_on_clear (boolean; optional): If True, the calendar will automatically open when cleared
+- number_of_months_shown (number; optional): Number of calendar months that are shown when calendar is opened
+- with_portal (boolean; optional): If True, calendar will open in a screen overlay portal,
+not supported on vertical calendar
+- with_full_screen_portal (boolean; optional): If True, calendar will open in a full screen overlay portal, will
+take precedent over 'withPortal' if both are set to true,
+not supported on vertical calendar
+- first_day_of_week (a value equal to: 0, 1, 2, 3, 4, 5, 6; optional): Specifies what day is the first day of the week, values must be
+from [0, ..., 6] with 0 denoting Sunday and 6 denoting Saturday
+- minimum_nights (number; optional): Specifies a minimum number of nights that must be selected between
+the startDate and the endDate
+- stay_open_on_select (boolean; optional): If True the calendar will not close when the user has selected a value
+and will wait until the user clicks off the calendar
+- show_outside_days (boolean; optional): If True the calendar will display days that rollover into
+the next month
+- month_format (string; optional): Specifies the format that the month will be displayed in the calendar,
+valid formats are variations of "MM YY". For example:
+"MM YY" renders as '05 97' for May 1997
+"MMMM, YYYY" renders as 'May, 1997' for May 1997
+"MMM, YY" renders as 'Sep, 97' for September 1997
+- display_format (string; optional): Specifies the format that the selected dates will be displayed
+valid formats are variations of "MM YY DD". For example:
+"MM YY DD" renders as '05 10 97' for May 10th 1997
+"MMMM, YY" renders as 'May, 1997' for May 10th 1997
+"M, D, YYYY" renders as '07, 10, 1997' for September 10th 1997
+"MMMM" renders as 'May' for May 10 1997
+- disabled (boolean; optional): If True, no dates can be selected.
+- 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.
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, start_date=Component._NO_DEFAULT_ARG, end_date=Component._NO_DEFAULT_ARG, min_date_allowed=Component._NO_DEFAULT_ARG, max_date_allowed=Component._NO_DEFAULT_ARG, initial_visible_month=Component._NO_DEFAULT_ARG, start_date_placeholder_text=Component._NO_DEFAULT_ARG, end_date_placeholder_text=Component._NO_DEFAULT_ARG, day_size=39, calendar_orientation=Component._NO_DEFAULT_ARG, is_RTL=False, reopen_calendar_on_clear=False, number_of_months_shown=1, with_portal=False, with_full_screen_portal=False, first_day_of_week=Component._NO_DEFAULT_ARG, minimum_nights=Component._NO_DEFAULT_ARG, stay_open_on_select=False, show_outside_days=Component._NO_DEFAULT_ARG, month_format=Component._NO_DEFAULT_ARG, display_format=Component._NO_DEFAULT_ARG, disabled=False, clearable=False, **kwargs):
+ self._prop_names = ['id', 'start_date', 'end_date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'start_date_placeholder_text', 'end_date_placeholder_text', 'day_size', 'calendar_orientation', 'is_RTL', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'minimum_nights', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self._type = 'DatePickerRange'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'start_date', 'end_date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'start_date_placeholder_text', 'end_date_placeholder_text', 'day_size', 'calendar_orientation', 'is_RTL', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'minimum_nights', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(DatePickerRange, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('DatePickerRange(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'DatePickerRange(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

dash_core_components/DatePickerSingle.py

@@ -0,0 +1,113 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class DatePickerSingle(Component):
+ """A DatePickerSingle component.
+DatePickerSingle is a tailor made component designed for selecting
+a single day off of a calendar.
+
+The DatePicker integrates well with the Python datetime module with the
+startDate and endDate being returned in a string format suitable for
+creating datetime objects.
+
+This component is based off of Airbnb's react-dates react component
+which can be found here: https://github.com/airbnb/react-dates
+
+Keyword arguments:
+- id (string; optional)
+- date (string; optional): Specifies the starting date for the component, best practice is to pass
+value via datetime object
+- min_date_allowed (string; optional): Specifies the lowest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- max_date_allowed (string; optional): Specifies the highest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- initial_visible_month (string; optional): Specifies the month that is initially presented when the user
+opens the calendar. Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- day_size (number; optional): Size of rendered calendar days, higher number
+means bigger day size and larger calendar overall
+- calendar_orientation (a value equal to: 'vertical', 'horizontal'; optional): Orientation of calendar, either vertical or horizontal.
+Valid options are 'vertical' or 'horizontal'.
+- is_RTL (boolean; optional): Determines whether the calendar and days operate
+from left to right or from right to left
+- placeholder (string; optional): Text that will be displayed in the input
+box of the date picker when no date is selected.
+Default value is 'Start Date'
+- reopen_calendar_on_clear (boolean; optional): If True, the calendar will automatically open when cleared
+- number_of_months_shown (number; optional): Number of calendar months that are shown when calendar is opened
+- with_portal (boolean; optional): If True, calendar will open in a screen overlay portal,
+not supported on vertical calendar
+- with_full_screen_portal (boolean; optional): If True, calendar will open in a full screen overlay portal, will
+take precedent over 'withPortal' if both are set to True,
+not supported on vertical calendar
+- first_day_of_week (a value equal to: 0, 1, 2, 3, 4, 5, 6; optional): Specifies what day is the first day of the week, values must be
+from [0, ..., 6] with 0 denoting Sunday and 6 denoting Saturday
+- stay_open_on_select (boolean; optional): If True the calendar will not close when the user has selected a value
+and will wait until the user clicks off the calendar
+- show_outside_days (boolean; optional): If True the calendar will display days that rollover into
+the next month
+- month_format (string; optional): Specifies the format that the month will be displayed in the calendar,
+valid formats are variations of "MM YY". For example:
+"MM YY" renders as '05 97' for May 1997
+"MMMM, YYYY" renders as 'May, 1997' for May 1997
+"MMM, YY" renders as 'Sep, 97' for September 1997
+- display_format (string; optional): Specifies the format that the selected dates will be displayed
+valid formats are variations of "MM YY DD". For example:
+"MM YY DD" renders as '05 10 97' for May 10th 1997
+"MMMM, YY" renders as 'May, 1997' for May 10th 1997
+"M, D, YYYY" renders as '07, 10, 1997' for September 10th 1997
+"MMMM" renders as 'May' for May 10 1997
+- disabled (boolean; optional): If True, no dates can be selected.
+- 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.
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, date=Component._NO_DEFAULT_ARG, min_date_allowed=Component._NO_DEFAULT_ARG, max_date_allowed=Component._NO_DEFAULT_ARG, initial_visible_month=Component._NO_DEFAULT_ARG, day_size=39, calendar_orientation=Component._NO_DEFAULT_ARG, is_RTL=False, placeholder=Component._NO_DEFAULT_ARG, reopen_calendar_on_clear=False, number_of_months_shown=1, with_portal=False, with_full_screen_portal=False, first_day_of_week=Component._NO_DEFAULT_ARG, stay_open_on_select=False, show_outside_days=True, month_format=Component._NO_DEFAULT_ARG, display_format=Component._NO_DEFAULT_ARG, disabled=False, clearable=False, **kwargs):
+ self._prop_names = ['id', 'date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'day_size', 'calendar_orientation', 'is_RTL', 'placeholder', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self._type = 'DatePickerSingle'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'day_size', 'calendar_orientation', 'is_RTL', 'placeholder', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(DatePickerSingle, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('DatePickerSingle(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'DatePickerSingle(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

.gitignore

@@ -7,6 +7,7 @@ node_modules/
 .npm
 vv/
 venv/
+.tox
 *.pyc
 *.egg-info
 *.log

CHANGELOG.md

@@ -2,6 +2,11 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## [0.24.0] - UNRELEASED
+### Changed
+- `dash_core_components/__init__.py` now imports from python class files rather than generating classes at runtime,
+adding support for IDE autocomplete ect.
+
 ## [0.23.0] - UNRELEASED
 ### Added
 - Upgraded Plotly.js, the underlying library behind the

dash_core_components/Checklist.py

@@ -0,0 +1,70 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+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.
+Each checkbox is rendered as an input with a surrounding label.
+
+Keyword arguments:
+- id (string; optional)
+- options (list; optional): An array of options
+- values (list; 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
+- inputClassName (string; optional): The class of the <input> checkbox element
+- labelStyle (dict; optional): The style of the <label> that wraps the checkbox input
+ and the option's label
+- labelClassName (string; optional): The class of the <label> that wraps the checkbox input
+ and the option's label
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, options=[], values=Component._NO_DEFAULT_ARG, className=Component._NO_DEFAULT_ARG, style=Component._NO_DEFAULT_ARG, inputStyle={}, inputClassName='', labelStyle={}, labelClassName='', **kwargs):
+ self._prop_names = ['id', 'options', 'values', 'className', 'style', 'inputStyle', 'inputClassName', 'labelStyle', 'labelClassName']
+ self._type = 'Checklist'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'options', 'values', 'className', 'style', 'inputStyle', 'inputClassName', 'labelStyle', 'labelClassName']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(Checklist, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('Checklist(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'Checklist(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

dash_core_components/DatePickerRange.py

@@ -0,0 +1,120 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class DatePickerRange(Component):
+ """A DatePickerRange component.
+DatePickerRange is a tailor made component designed for selecting
+timespan across multiple days off of a calendar.
+
+The DatePicker integrates well with the Python datetime module with the
+startDate and endDate being returned in a string format suitable for
+creating datetime objects.
+
+This component is based off of Airbnb's react-dates react component
+which can be found here: https://github.com/airbnb/react-dates
+
+Keyword arguments:
+- id (string; optional)
+- start_date (string; optional): Specifies the starting date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- end_date (string; optional): Specifies the ending date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- min_date_allowed (string; optional): Specifies the lowest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- max_date_allowed (string; optional): Specifies the highest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- initial_visible_month (string; optional): Specifies the month that is initially presented when the user
+opens the calendar. Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- start_date_placeholder_text (string; optional): Text that will be displayed in the first input
+box of the date picker when no date is selected. Default value is 'Start Date'
+- end_date_placeholder_text (string; optional): Text that will be displayed in the second input
+box of the date picker when no date is selected. Default value is 'End Date'
+- day_size (number; optional): Size of rendered calendar days, higher number
+means bigger day size and larger calendar overall
+- calendar_orientation (a value equal to: 'vertical', 'horizontal'; optional): Orientation of calendar, either vertical or horizontal.
+Valid options are 'vertical' or 'horizontal'.
+- is_RTL (boolean; optional): Determines whether the calendar and days operate
+from left to right or from right to left
+- reopen_calendar_on_clear (boolean; optional): If True, the calendar will automatically open when cleared
+- number_of_months_shown (number; optional): Number of calendar months that are shown when calendar is opened
+- with_portal (boolean; optional): If True, calendar will open in a screen overlay portal,
+not supported on vertical calendar
+- with_full_screen_portal (boolean; optional): If True, calendar will open in a full screen overlay portal, will
+take precedent over 'withPortal' if both are set to true,
+not supported on vertical calendar
+- first_day_of_week (a value equal to: 0, 1, 2, 3, 4, 5, 6; optional): Specifies what day is the first day of the week, values must be
+from [0, ..., 6] with 0 denoting Sunday and 6 denoting Saturday
+- minimum_nights (number; optional): Specifies a minimum number of nights that must be selected between
+the startDate and the endDate
+- stay_open_on_select (boolean; optional): If True the calendar will not close when the user has selected a value
+and will wait until the user clicks off the calendar
+- show_outside_days (boolean; optional): If True the calendar will display days that rollover into
+the next month
+- month_format (string; optional): Specifies the format that the month will be displayed in the calendar,
+valid formats are variations of "MM YY". For example:
+"MM YY" renders as '05 97' for May 1997
+"MMMM, YYYY" renders as 'May, 1997' for May 1997
+"MMM, YY" renders as 'Sep, 97' for September 1997
+- display_format (string; optional): Specifies the format that the selected dates will be displayed
+valid formats are variations of "MM YY DD". For example:
+"MM YY DD" renders as '05 10 97' for May 10th 1997
+"MMMM, YY" renders as 'May, 1997' for May 10th 1997
+"M, D, YYYY" renders as '07, 10, 1997' for September 10th 1997
+"MMMM" renders as 'May' for May 10 1997
+- disabled (boolean; optional): If True, no dates can be selected.
+- 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.
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, start_date=Component._NO_DEFAULT_ARG, end_date=Component._NO_DEFAULT_ARG, min_date_allowed=Component._NO_DEFAULT_ARG, max_date_allowed=Component._NO_DEFAULT_ARG, initial_visible_month=Component._NO_DEFAULT_ARG, start_date_placeholder_text=Component._NO_DEFAULT_ARG, end_date_placeholder_text=Component._NO_DEFAULT_ARG, day_size=39, calendar_orientation=Component._NO_DEFAULT_ARG, is_RTL=False, reopen_calendar_on_clear=False, number_of_months_shown=1, with_portal=False, with_full_screen_portal=False, first_day_of_week=Component._NO_DEFAULT_ARG, minimum_nights=Component._NO_DEFAULT_ARG, stay_open_on_select=False, show_outside_days=Component._NO_DEFAULT_ARG, month_format=Component._NO_DEFAULT_ARG, display_format=Component._NO_DEFAULT_ARG, disabled=False, clearable=False, **kwargs):
+ self._prop_names = ['id', 'start_date', 'end_date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'start_date_placeholder_text', 'end_date_placeholder_text', 'day_size', 'calendar_orientation', 'is_RTL', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'minimum_nights', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self._type = 'DatePickerRange'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'start_date', 'end_date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'start_date_placeholder_text', 'end_date_placeholder_text', 'day_size', 'calendar_orientation', 'is_RTL', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'minimum_nights', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(DatePickerRange, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('DatePickerRange(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'DatePickerRange(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

dash_core_components/DatePickerSingle.py

@@ -0,0 +1,113 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class DatePickerSingle(Component):
+ """A DatePickerSingle component.
+DatePickerSingle is a tailor made component designed for selecting
+a single day off of a calendar.
+
+The DatePicker integrates well with the Python datetime module with the
+startDate and endDate being returned in a string format suitable for
+creating datetime objects.
+
+This component is based off of Airbnb's react-dates react component
+which can be found here: https://github.com/airbnb/react-dates
+
+Keyword arguments:
+- id (string; optional)
+- date (string; optional): Specifies the starting date for the component, best practice is to pass
+value via datetime object
+- min_date_allowed (string; optional): Specifies the lowest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- max_date_allowed (string; optional): Specifies the highest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- initial_visible_month (string; optional): Specifies the month that is initially presented when the user
+opens the calendar. Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- day_size (number; optional): Size of rendered calendar days, higher number
+means bigger day size and larger calendar overall
+- calendar_orientation (a value equal to: 'vertical', 'horizontal'; optional): Orientation of calendar, either vertical or horizontal.
+Valid options are 'vertical' or 'horizontal'.
+- is_RTL (boolean; optional): Determines whether the calendar and days operate
+from left to right or from right to left
+- placeholder (string; optional): Text that will be displayed in the input
+box of the date picker when no date is selected.
+Default value is 'Start Date'
+- reopen_calendar_on_clear (boolean; optional): If True, the calendar will automatically open when cleared
+- number_of_months_shown (number; optional): Number of calendar months that are shown when calendar is opened
+- with_portal (boolean; optional): If True, calendar will open in a screen overlay portal,
+not supported on vertical calendar
+- with_full_screen_portal (boolean; optional): If True, calendar will open in a full screen overlay portal, will
+take precedent over 'withPortal' if both are set to True,
+not supported on vertical calendar
+- first_day_of_week (a value equal to: 0, 1, 2, 3, 4, 5, 6; optional): Specifies what day is the first day of the week, values must be
+from [0, ..., 6] with 0 denoting Sunday and 6 denoting Saturday
+- stay_open_on_select (boolean; optional): If True the calendar will not close when the user has selected a value
+and will wait until the user clicks off the calendar
+- show_outside_days (boolean; optional): If True the calendar will display days that rollover into
+the next month
+- month_format (string; optional): Specifies the format that the month will be displayed in the calendar,
+valid formats are variations of "MM YY". For example:
+"MM YY" renders as '05 97' for May 1997
+"MMMM, YYYY" renders as 'May, 1997' for May 1997
+"MMM, YY" renders as 'Sep, 97' for September 1997
+- display_format (string; optional): Specifies the format that the selected dates will be displayed
+valid formats are variations of "MM YY DD". For example:
+"MM YY DD" renders as '05 10 97' for May 10th 1997
+"MMMM, YY" renders as 'May, 1997' for May 10th 1997
+"M, D, YYYY" renders as '07, 10, 1997' for September 10th 1997
+"MMMM" renders as 'May' for May 10 1997
+- disabled (boolean; optional): If True, no dates can be selected.
+- 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.
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, date=Component._NO_DEFAULT_ARG, min_date_allowed=Component._NO_DEFAULT_ARG, max_date_allowed=Component._NO_DEFAULT_ARG, initial_visible_month=Component._NO_DEFAULT_ARG, day_size=39, calendar_orientation=Component._NO_DEFAULT_ARG, is_RTL=False, placeholder=Component._NO_DEFAULT_ARG, reopen_calendar_on_clear=False, number_of_months_shown=1, with_portal=False, with_full_screen_portal=False, first_day_of_week=Component._NO_DEFAULT_ARG, stay_open_on_select=False, show_outside_days=True, month_format=Component._NO_DEFAULT_ARG, display_format=Component._NO_DEFAULT_ARG, disabled=False, clearable=False, **kwargs):
+ self._prop_names = ['id', 'date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'day_size', 'calendar_orientation', 'is_RTL', 'placeholder', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self._type = 'DatePickerSingle'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'day_size', 'calendar_orientation', 'is_RTL', 'placeholder', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(DatePickerSingle, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('DatePickerSingle(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'DatePickerSingle(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

.gitignore

@@ -7,6 +7,7 @@ node_modules/
 .npm
 vv/
 venv/
+.tox
 *.pyc
 *.egg-info
 *.log

CHANGELOG.md

@@ -2,6 +2,11 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## [0.24.0] - UNRELEASED
+### Changed
+- `dash_core_components/__init__.py` now imports from python class files rather than generating classes at runtime,
+adding support for IDE autocomplete ect.
+
 ## [0.23.0] - UNRELEASED
 ### Added
 - Upgraded Plotly.js, the underlying library behind the

dash_core_components/Checklist.py

@@ -0,0 +1,70 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+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.
+Each checkbox is rendered as an input with a surrounding label.
+
+Keyword arguments:
+- id (string; optional)
+- options (list; optional): An array of options
+- values (list; 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
+- inputClassName (string; optional): The class of the <input> checkbox element
+- labelStyle (dict; optional): The style of the <label> that wraps the checkbox input
+ and the option's label
+- labelClassName (string; optional): The class of the <label> that wraps the checkbox input
+ and the option's label
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, options=[], values=Component._NO_DEFAULT_ARG, className=Component._NO_DEFAULT_ARG, style=Component._NO_DEFAULT_ARG, inputStyle={}, inputClassName='', labelStyle={}, labelClassName='', **kwargs):
+ self._prop_names = ['id', 'options', 'values', 'className', 'style', 'inputStyle', 'inputClassName', 'labelStyle', 'labelClassName']
+ self._type = 'Checklist'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'options', 'values', 'className', 'style', 'inputStyle', 'inputClassName', 'labelStyle', 'labelClassName']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(Checklist, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('Checklist(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'Checklist(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

dash_core_components/DatePickerRange.py

@@ -0,0 +1,120 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class DatePickerRange(Component):
+ """A DatePickerRange component.
+DatePickerRange is a tailor made component designed for selecting
+timespan across multiple days off of a calendar.
+
+The DatePicker integrates well with the Python datetime module with the
+startDate and endDate being returned in a string format suitable for
+creating datetime objects.
+
+This component is based off of Airbnb's react-dates react component
+which can be found here: https://github.com/airbnb/react-dates
+
+Keyword arguments:
+- id (string; optional)
+- start_date (string; optional): Specifies the starting date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- end_date (string; optional): Specifies the ending date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- min_date_allowed (string; optional): Specifies the lowest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- max_date_allowed (string; optional): Specifies the highest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- initial_visible_month (string; optional): Specifies the month that is initially presented when the user
+opens the calendar. Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- start_date_placeholder_text (string; optional): Text that will be displayed in the first input
+box of the date picker when no date is selected. Default value is 'Start Date'
+- end_date_placeholder_text (string; optional): Text that will be displayed in the second input
+box of the date picker when no date is selected. Default value is 'End Date'
+- day_size (number; optional): Size of rendered calendar days, higher number
+means bigger day size and larger calendar overall
+- calendar_orientation (a value equal to: 'vertical', 'horizontal'; optional): Orientation of calendar, either vertical or horizontal.
+Valid options are 'vertical' or 'horizontal'.
+- is_RTL (boolean; optional): Determines whether the calendar and days operate
+from left to right or from right to left
+- reopen_calendar_on_clear (boolean; optional): If True, the calendar will automatically open when cleared
+- number_of_months_shown (number; optional): Number of calendar months that are shown when calendar is opened
+- with_portal (boolean; optional): If True, calendar will open in a screen overlay portal,
+not supported on vertical calendar
+- with_full_screen_portal (boolean; optional): If True, calendar will open in a full screen overlay portal, will
+take precedent over 'withPortal' if both are set to true,
+not supported on vertical calendar
+- first_day_of_week (a value equal to: 0, 1, 2, 3, 4, 5, 6; optional): Specifies what day is the first day of the week, values must be
+from [0, ..., 6] with 0 denoting Sunday and 6 denoting Saturday
+- minimum_nights (number; optional): Specifies a minimum number of nights that must be selected between
+the startDate and the endDate
+- stay_open_on_select (boolean; optional): If True the calendar will not close when the user has selected a value
+and will wait until the user clicks off the calendar
+- show_outside_days (boolean; optional): If True the calendar will display days that rollover into
+the next month
+- month_format (string; optional): Specifies the format that the month will be displayed in the calendar,
+valid formats are variations of "MM YY". For example:
+"MM YY" renders as '05 97' for May 1997
+"MMMM, YYYY" renders as 'May, 1997' for May 1997
+"MMM, YY" renders as 'Sep, 97' for September 1997
+- display_format (string; optional): Specifies the format that the selected dates will be displayed
+valid formats are variations of "MM YY DD". For example:
+"MM YY DD" renders as '05 10 97' for May 10th 1997
+"MMMM, YY" renders as 'May, 1997' for May 10th 1997
+"M, D, YYYY" renders as '07, 10, 1997' for September 10th 1997
+"MMMM" renders as 'May' for May 10 1997
+- disabled (boolean; optional): If True, no dates can be selected.
+- 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.
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, start_date=Component._NO_DEFAULT_ARG, end_date=Component._NO_DEFAULT_ARG, min_date_allowed=Component._NO_DEFAULT_ARG, max_date_allowed=Component._NO_DEFAULT_ARG, initial_visible_month=Component._NO_DEFAULT_ARG, start_date_placeholder_text=Component._NO_DEFAULT_ARG, end_date_placeholder_text=Component._NO_DEFAULT_ARG, day_size=39, calendar_orientation=Component._NO_DEFAULT_ARG, is_RTL=False, reopen_calendar_on_clear=False, number_of_months_shown=1, with_portal=False, with_full_screen_portal=False, first_day_of_week=Component._NO_DEFAULT_ARG, minimum_nights=Component._NO_DEFAULT_ARG, stay_open_on_select=False, show_outside_days=Component._NO_DEFAULT_ARG, month_format=Component._NO_DEFAULT_ARG, display_format=Component._NO_DEFAULT_ARG, disabled=False, clearable=False, **kwargs):
+ self._prop_names = ['id', 'start_date', 'end_date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'start_date_placeholder_text', 'end_date_placeholder_text', 'day_size', 'calendar_orientation', 'is_RTL', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'minimum_nights', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self._type = 'DatePickerRange'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'start_date', 'end_date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'start_date_placeholder_text', 'end_date_placeholder_text', 'day_size', 'calendar_orientation', 'is_RTL', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'minimum_nights', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(DatePickerRange, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('DatePickerRange(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'DatePickerRange(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

dash_core_components/DatePickerSingle.py

@@ -0,0 +1,113 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class DatePickerSingle(Component):
+ """A DatePickerSingle component.
+DatePickerSingle is a tailor made component designed for selecting
+a single day off of a calendar.
+
+The DatePicker integrates well with the Python datetime module with the
+startDate and endDate being returned in a string format suitable for
+creating datetime objects.
+
+This component is based off of Airbnb's react-dates react component
+which can be found here: https://github.com/airbnb/react-dates
+
+Keyword arguments:
+- id (string; optional)
+- date (string; optional): Specifies the starting date for the component, best practice is to pass
+value via datetime object
+- min_date_allowed (string; optional): Specifies the lowest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- max_date_allowed (string; optional): Specifies the highest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- initial_visible_month (string; optional): Specifies the month that is initially presented when the user
+opens the calendar. Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- day_size (number; optional): Size of rendered calendar days, higher number
+means bigger day size and larger calendar overall
+- calendar_orientation (a value equal to: 'vertical', 'horizontal'; optional): Orientation of calendar, either vertical or horizontal.
+Valid options are 'vertical' or 'horizontal'.
+- is_RTL (boolean; optional): Determines whether the calendar and days operate
+from left to right or from right to left
+- placeholder (string; optional): Text that will be displayed in the input
+box of the date picker when no date is selected.
+Default value is 'Start Date'
+- reopen_calendar_on_clear (boolean; optional): If True, the calendar will automatically open when cleared
+- number_of_months_shown (number; optional): Number of calendar months that are shown when calendar is opened
+- with_portal (boolean; optional): If True, calendar will open in a screen overlay portal,
+not supported on vertical calendar
+- with_full_screen_portal (boolean; optional): If True, calendar will open in a full screen overlay portal, will
+take precedent over 'withPortal' if both are set to True,
+not supported on vertical calendar
+- first_day_of_week (a value equal to: 0, 1, 2, 3, 4, 5, 6; optional): Specifies what day is the first day of the week, values must be
+from [0, ..., 6] with 0 denoting Sunday and 6 denoting Saturday
+- stay_open_on_select (boolean; optional): If True the calendar will not close when the user has selected a value
+and will wait until the user clicks off the calendar
+- show_outside_days (boolean; optional): If True the calendar will display days that rollover into
+the next month
+- month_format (string; optional): Specifies the format that the month will be displayed in the calendar,
+valid formats are variations of "MM YY". For example:
+"MM YY" renders as '05 97' for May 1997
+"MMMM, YYYY" renders as 'May, 1997' for May 1997
+"MMM, YY" renders as 'Sep, 97' for September 1997
+- display_format (string; optional): Specifies the format that the selected dates will be displayed
+valid formats are variations of "MM YY DD". For example:
+"MM YY DD" renders as '05 10 97' for May 10th 1997
+"MMMM, YY" renders as 'May, 1997' for May 10th 1997
+"M, D, YYYY" renders as '07, 10, 1997' for September 10th 1997
+"MMMM" renders as 'May' for May 10 1997
+- disabled (boolean; optional): If True, no dates can be selected.
+- 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.
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, date=Component._NO_DEFAULT_ARG, min_date_allowed=Component._NO_DEFAULT_ARG, max_date_allowed=Component._NO_DEFAULT_ARG, initial_visible_month=Component._NO_DEFAULT_ARG, day_size=39, calendar_orientation=Component._NO_DEFAULT_ARG, is_RTL=False, placeholder=Component._NO_DEFAULT_ARG, reopen_calendar_on_clear=False, number_of_months_shown=1, with_portal=False, with_full_screen_portal=False, first_day_of_week=Component._NO_DEFAULT_ARG, stay_open_on_select=False, show_outside_days=True, month_format=Component._NO_DEFAULT_ARG, display_format=Component._NO_DEFAULT_ARG, disabled=False, clearable=False, **kwargs):
+ self._prop_names = ['id', 'date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'day_size', 'calendar_orientation', 'is_RTL', 'placeholder', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self._type = 'DatePickerSingle'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'day_size', 'calendar_orientation', 'is_RTL', 'placeholder', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(DatePickerSingle, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('DatePickerSingle(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'DatePickerSingle(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

.gitignore

@@ -7,6 +7,7 @@ node_modules/
 .npm
 vv/
 venv/
+.tox
 *.pyc
 *.egg-info
 *.log

CHANGELOG.md

@@ -2,6 +2,11 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## [0.24.0] - UNRELEASED
+### Changed
+- `dash_core_components/__init__.py` now imports from python class files rather than generating classes at runtime,
+adding support for IDE autocomplete ect.
+
 ## [0.23.0] - UNRELEASED
 ### Added
 - Upgraded Plotly.js, the underlying library behind the

dash_core_components/Checklist.py

@@ -0,0 +1,70 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+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.
+Each checkbox is rendered as an input with a surrounding label.
+
+Keyword arguments:
+- id (string; optional)
+- options (list; optional): An array of options
+- values (list; 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
+- inputClassName (string; optional): The class of the <input> checkbox element
+- labelStyle (dict; optional): The style of the <label> that wraps the checkbox input
+ and the option's label
+- labelClassName (string; optional): The class of the <label> that wraps the checkbox input
+ and the option's label
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, options=[], values=Component._NO_DEFAULT_ARG, className=Component._NO_DEFAULT_ARG, style=Component._NO_DEFAULT_ARG, inputStyle={}, inputClassName='', labelStyle={}, labelClassName='', **kwargs):
+ self._prop_names = ['id', 'options', 'values', 'className', 'style', 'inputStyle', 'inputClassName', 'labelStyle', 'labelClassName']
+ self._type = 'Checklist'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'options', 'values', 'className', 'style', 'inputStyle', 'inputClassName', 'labelStyle', 'labelClassName']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(Checklist, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('Checklist(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'Checklist(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

dash_core_components/DatePickerRange.py

@@ -0,0 +1,120 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class DatePickerRange(Component):
+ """A DatePickerRange component.
+DatePickerRange is a tailor made component designed for selecting
+timespan across multiple days off of a calendar.
+
+The DatePicker integrates well with the Python datetime module with the
+startDate and endDate being returned in a string format suitable for
+creating datetime objects.
+
+This component is based off of Airbnb's react-dates react component
+which can be found here: https://github.com/airbnb/react-dates
+
+Keyword arguments:
+- id (string; optional)
+- start_date (string; optional): Specifies the starting date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- end_date (string; optional): Specifies the ending date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- min_date_allowed (string; optional): Specifies the lowest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- max_date_allowed (string; optional): Specifies the highest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- initial_visible_month (string; optional): Specifies the month that is initially presented when the user
+opens the calendar. Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- start_date_placeholder_text (string; optional): Text that will be displayed in the first input
+box of the date picker when no date is selected. Default value is 'Start Date'
+- end_date_placeholder_text (string; optional): Text that will be displayed in the second input
+box of the date picker when no date is selected. Default value is 'End Date'
+- day_size (number; optional): Size of rendered calendar days, higher number
+means bigger day size and larger calendar overall
+- calendar_orientation (a value equal to: 'vertical', 'horizontal'; optional): Orientation of calendar, either vertical or horizontal.
+Valid options are 'vertical' or 'horizontal'.
+- is_RTL (boolean; optional): Determines whether the calendar and days operate
+from left to right or from right to left
+- reopen_calendar_on_clear (boolean; optional): If True, the calendar will automatically open when cleared
+- number_of_months_shown (number; optional): Number of calendar months that are shown when calendar is opened
+- with_portal (boolean; optional): If True, calendar will open in a screen overlay portal,
+not supported on vertical calendar
+- with_full_screen_portal (boolean; optional): If True, calendar will open in a full screen overlay portal, will
+take precedent over 'withPortal' if both are set to true,
+not supported on vertical calendar
+- first_day_of_week (a value equal to: 0, 1, 2, 3, 4, 5, 6; optional): Specifies what day is the first day of the week, values must be
+from [0, ..., 6] with 0 denoting Sunday and 6 denoting Saturday
+- minimum_nights (number; optional): Specifies a minimum number of nights that must be selected between
+the startDate and the endDate
+- stay_open_on_select (boolean; optional): If True the calendar will not close when the user has selected a value
+and will wait until the user clicks off the calendar
+- show_outside_days (boolean; optional): If True the calendar will display days that rollover into
+the next month
+- month_format (string; optional): Specifies the format that the month will be displayed in the calendar,
+valid formats are variations of "MM YY". For example:
+"MM YY" renders as '05 97' for May 1997
+"MMMM, YYYY" renders as 'May, 1997' for May 1997
+"MMM, YY" renders as 'Sep, 97' for September 1997
+- display_format (string; optional): Specifies the format that the selected dates will be displayed
+valid formats are variations of "MM YY DD". For example:
+"MM YY DD" renders as '05 10 97' for May 10th 1997
+"MMMM, YY" renders as 'May, 1997' for May 10th 1997
+"M, D, YYYY" renders as '07, 10, 1997' for September 10th 1997
+"MMMM" renders as 'May' for May 10 1997
+- disabled (boolean; optional): If True, no dates can be selected.
+- 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.
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, start_date=Component._NO_DEFAULT_ARG, end_date=Component._NO_DEFAULT_ARG, min_date_allowed=Component._NO_DEFAULT_ARG, max_date_allowed=Component._NO_DEFAULT_ARG, initial_visible_month=Component._NO_DEFAULT_ARG, start_date_placeholder_text=Component._NO_DEFAULT_ARG, end_date_placeholder_text=Component._NO_DEFAULT_ARG, day_size=39, calendar_orientation=Component._NO_DEFAULT_ARG, is_RTL=False, reopen_calendar_on_clear=False, number_of_months_shown=1, with_portal=False, with_full_screen_portal=False, first_day_of_week=Component._NO_DEFAULT_ARG, minimum_nights=Component._NO_DEFAULT_ARG, stay_open_on_select=False, show_outside_days=Component._NO_DEFAULT_ARG, month_format=Component._NO_DEFAULT_ARG, display_format=Component._NO_DEFAULT_ARG, disabled=False, clearable=False, **kwargs):
+ self._prop_names = ['id', 'start_date', 'end_date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'start_date_placeholder_text', 'end_date_placeholder_text', 'day_size', 'calendar_orientation', 'is_RTL', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'minimum_nights', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self._type = 'DatePickerRange'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'start_date', 'end_date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'start_date_placeholder_text', 'end_date_placeholder_text', 'day_size', 'calendar_orientation', 'is_RTL', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'minimum_nights', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(DatePickerRange, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('DatePickerRange(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'DatePickerRange(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')

dash_core_components/DatePickerSingle.py

@@ -0,0 +1,113 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class DatePickerSingle(Component):
+ """A DatePickerSingle component.
+DatePickerSingle is a tailor made component designed for selecting
+a single day off of a calendar.
+
+The DatePicker integrates well with the Python datetime module with the
+startDate and endDate being returned in a string format suitable for
+creating datetime objects.
+
+This component is based off of Airbnb's react-dates react component
+which can be found here: https://github.com/airbnb/react-dates
+
+Keyword arguments:
+- id (string; optional)
+- date (string; optional): Specifies the starting date for the component, best practice is to pass
+value via datetime object
+- min_date_allowed (string; optional): Specifies the lowest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- max_date_allowed (string; optional): Specifies the highest selectable date for the component.
+Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- initial_visible_month (string; optional): Specifies the month that is initially presented when the user
+opens the calendar. Accepts datetime.datetime objects or strings
+in the format 'YYYY-MM-DD'
+- day_size (number; optional): Size of rendered calendar days, higher number
+means bigger day size and larger calendar overall
+- calendar_orientation (a value equal to: 'vertical', 'horizontal'; optional): Orientation of calendar, either vertical or horizontal.
+Valid options are 'vertical' or 'horizontal'.
+- is_RTL (boolean; optional): Determines whether the calendar and days operate
+from left to right or from right to left
+- placeholder (string; optional): Text that will be displayed in the input
+box of the date picker when no date is selected.
+Default value is 'Start Date'
+- reopen_calendar_on_clear (boolean; optional): If True, the calendar will automatically open when cleared
+- number_of_months_shown (number; optional): Number of calendar months that are shown when calendar is opened
+- with_portal (boolean; optional): If True, calendar will open in a screen overlay portal,
+not supported on vertical calendar
+- with_full_screen_portal (boolean; optional): If True, calendar will open in a full screen overlay portal, will
+take precedent over 'withPortal' if both are set to True,
+not supported on vertical calendar
+- first_day_of_week (a value equal to: 0, 1, 2, 3, 4, 5, 6; optional): Specifies what day is the first day of the week, values must be
+from [0, ..., 6] with 0 denoting Sunday and 6 denoting Saturday
+- stay_open_on_select (boolean; optional): If True the calendar will not close when the user has selected a value
+and will wait until the user clicks off the calendar
+- show_outside_days (boolean; optional): If True the calendar will display days that rollover into
+the next month
+- month_format (string; optional): Specifies the format that the month will be displayed in the calendar,
+valid formats are variations of "MM YY". For example:
+"MM YY" renders as '05 97' for May 1997
+"MMMM, YYYY" renders as 'May, 1997' for May 1997
+"MMM, YY" renders as 'Sep, 97' for September 1997
+- display_format (string; optional): Specifies the format that the selected dates will be displayed
+valid formats are variations of "MM YY DD". For example:
+"MM YY DD" renders as '05 10 97' for May 10th 1997
+"MMMM, YY" renders as 'May, 1997' for May 10th 1997
+"M, D, YYYY" renders as '07, 10, 1997' for September 10th 1997
+"MMMM" renders as 'May' for May 10 1997
+- disabled (boolean; optional): If True, no dates can be selected.
+- 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.
+
+Available events: 'change'"""
+ @_explicitize_args
+ def __init__(self, id=Component._NO_DEFAULT_ARG, date=Component._NO_DEFAULT_ARG, min_date_allowed=Component._NO_DEFAULT_ARG, max_date_allowed=Component._NO_DEFAULT_ARG, initial_visible_month=Component._NO_DEFAULT_ARG, day_size=39, calendar_orientation=Component._NO_DEFAULT_ARG, is_RTL=False, placeholder=Component._NO_DEFAULT_ARG, reopen_calendar_on_clear=False, number_of_months_shown=1, with_portal=False, with_full_screen_portal=False, first_day_of_week=Component._NO_DEFAULT_ARG, stay_open_on_select=False, show_outside_days=True, month_format=Component._NO_DEFAULT_ARG, display_format=Component._NO_DEFAULT_ARG, disabled=False, clearable=False, **kwargs):
+ self._prop_names = ['id', 'date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'day_size', 'calendar_orientation', 'is_RTL', 'placeholder', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self._type = 'DatePickerSingle'
+ self._namespace = 'dash_core_components'
+ self._valid_wildcard_attributes = []
+ self.available_events = ['change']
+ self.available_properties = ['id', 'date', 'min_date_allowed', 'max_date_allowed', 'initial_visible_month', 'day_size', 'calendar_orientation', 'is_RTL', 'placeholder', 'reopen_calendar_on_clear', 'number_of_months_shown', 'with_portal', 'with_full_screen_portal', 'first_day_of_week', 'stay_open_on_select', 'show_outside_days', 'month_format', 'display_format', 'disabled', 'clearable']
+ self.available_wildcard_properties = []
+
+ _explicit_args = kwargs.pop('_explicit_args')
+ _locals = locals()
+ args = {k: _locals[k] for k in self._prop_names
+ if k != 'children' and not k.endswith('-*')}
+ args.update(kwargs) # For wildcard attrs
+
+ for k in []:
+ if k not in _explicit_args:
+ raise TypeError(
+ 'Required argument `' + k + '` was not specified.')
+ super(DatePickerSingle, self).__init__(**args)
+
+ def __repr__(self):
+ if(any(getattr(self, c, None) is not None
+ for c in self._prop_names
+ if c is not self._prop_names[0])
+ or any(getattr(self, c, None) is not None
+ for c in self.__dict__.keys()
+ if any(c.startswith(wc_attr)
+ for wc_attr in self._valid_wildcard_attributes))):
+ props_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self._prop_names
+ if getattr(self, c, None) is not None])
+ wilds_string = ', '.join([c+'='+repr(getattr(self, c, None))
+ for c in self.__dict__.keys()
+ if any([c.startswith(wc_attr)
+ for wc_attr in
+ self._valid_wildcard_attributes])])
+ return ('DatePickerSingle(' + props_string +
+ (', ' + wilds_string if wilds_string != '' else '') + ')')
+ else:
+ return (
+ 'DatePickerSingle(' +
+ repr(getattr(self, self._prop_names[0], None)) + ')')