Metadata-Version: 1.1
Name: django-bootstrap-daterangepicker
Version: 1.0.3
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(required=False)
        
               # 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(required=False)
        
               # DateTime Range Fields
               datetime_range_normal = fields.DateTimeRangeField()
               datetime_range_with_format = fields.DateTimeRangeField(
                   input_formats=['%d/%m/%Y (%I:%M:%S)'],
                   widget=widgets.DateTimeRangeWidget(
                       format='%d/%m/%Y (%I:%M:%S)'
                   )
               )
               datetime_range_clearable = fields.DateTimeRangeField(required=False)
        
        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 :: 3
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
