Metadata-Version: 1.1
Name: django-bootstrap-daterangepicker
Version: 1.0.0
Summary: A Django form field and widget wrapper for bootstrap-daterangepicker
Home-page: https://github.com/jckw/django-bootstrap-daterangepicker/
Author: Yuri Malinov, Jack Weatherilt
Author-email: yurik.m@gmail.com, jackweatherilt@outlook.com
License: MIT
Description: django-bootstrap-daterangepicker
        ================================
        
        This is Django form field wrapper for
        `bootstrap-daterangepicker <http://www.daterangepicker.com/>`__, for use
        with Bootstrap 3 and 4.
        
        This module allows for: single date pickers, date range selectors and
        datetime range selectors.
        
        Ranges are returned as tuples of format ``(start, end)``, where
        ``start`` and ``end`` are datetime.date or datetime.datetime objects
        depending on the field type.
        
        The DateField is a replacement for Django's built-in
        ``forms.DateField``, with the only difference being that it accepts an
        optional ``clearable`` parameter, and the default widget is the
        DatePickerWidget specified in this module.
        
        Installation
        ============
        
        1. ``pip install django-bootstrap-daterangepicker``
        2. Add ``'bootstrap_daterangepicker'`` to your ``INSTALLED_APPS``
        3. Add the resource links required for
           `bootstrap-daterangepicker <http://www.daterangepicker.com/>`__ into
           the ``<head>`` of the relevant HTML files
        
        Example usage
        -------------
        
        .. code:: python
        
            from django import forms
            from bootstrap_daterangepicker import widgets, fields
        
        
            class DemoForm(forms.Form):
                # Date Picker Fields
                date_single_normal = fields.DateField()
                date_single_with_format = fields.DateField(
                    input_formats=['%d/%m/%Y'],
                    widget=widgets.DatePickerWidget(
                        format='%d/%m/%Y'
                    )
                )
                date_single_clearable = fields.DateField(clearable=True)
        
                # Date Range Fields
                date_range_normal = fields.DateRangeField()
                date_range_with_format = fields.DateRangeField(
                    input_formats=['%d/%m/%Y'],
                    widget=widgets.DateRangeWidget(
                        format='%d/%m/%Y'
                    )
                )
                date_range_clearable = fields.DateRangeField(clearable=True)
        
                # DateTime Range Fields
                datetime_range_normal = fields.DateTimeRangeField()
                datetime_range_with_format = fields.DateTimeRangeField(
                    input_formats=['%d/%m/%Y (%H:%M:%S)'],
                    widget=widgets.DateTimeRangeWidget(
                        format='%d/%m/%Y (%H:%M:%S)'
                    )
                )
                datetime_range_clearable = fields.DateTimeRangeField(clearable=True)
        
        Requirements
        ~~~~~~~~~~~~
        
        -  `Bootstrap <http://getbootstrap.com/>`__ >= 3
        -  `jQuery <http://www.jquery.com/>`__ >= 1
        -  `Moment.js <http://momentjs.com/>`__ >= 2.10.6
        -  `bootstrap-daterangepicker <http://www.daterangepicker.com/>`__ >= 2
        -  `Django <https://www.djangoproject.com/>`__ >= 1.8
        
Keywords: django daterange datetime date bootstrap picker
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
