Metadata-Version: 2.1
Name: django-durationwidget2
Version: 1.0.5
Summary: Django Duration field widget to handle duration field in the form
Home-page: https://github.com/pozzolana93/django-durationwidget
Author: Simone Pozzoli
Author-email: simonepozzoli1@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: Django (>=1.11)

#  Django Duration Widget

This package provides a more natural way of defining duration fields in forms. It is derived from the
work of Devang Padhiyar [here](https://github.com/devangpadhiyar/django-durationwidget) and provides a
Python2 compatible implementation.

### When to use?

You can find duration field as below which is not far good for humans to use.

![Duration](/docs/duration.png)



Django duration widget is used for simplfiend Django model's `Duration` field.


### Quick start

1. Install `django-durationwidget2` using `pip`

    `pip install django-durationwidget2`

2. Add `durationwidget` to your `INSTALLED_APPS` setting like this::

    ```python
    INSTALLED_APPS = [
        ...
        'durationwidget',
    ]
    ```
3. Make sure to set `APP_DIRS` to `True` in settings.py

    ```python
    TEMPLATES = [
        {
            'BACKEND': 'django.template.backends.django.DjangoTemplates',
            'DIRS': [
                os.path.join(BASE_DIR, 'templates'),
                ...
            ],
            'APP_DIRS': True,  # Setup this to True
            'OPTIONS': {
                ...
            },
        },
    ]
    ```

4. Cheer up you are ready to use `TimeDurationWidget` as normal widget as below.

    ```python
    from django import forms
    from durationwidget.widgets import TimeDurationWidget

    from .models import YourModel


    class CustomForm(forms.ModelForm):
        ...
        duration = forms.DurationField(widget=TimeDurationWidget(), required=False)

        class Meta:
            model = YourModel
            ...

    ```

It will render Duration field as below

![Duration field](/docs/duration_final.png)


## TimeDurationWidget

```python
duration = forms.DurationField(widget=TimeDurationWidget(
    show_days=True, show_hours=True, show_minutes=True, show_seconds=True
), required=False)
```

 Following keyword argument can be passed to show/ hide fields in duration widget.

 > By default all keyword arguments are set to `True`

`show_days` : To display/ hide days field in widget<br/>
`show_hours` : To display/ hide hours field in widget<br/>
`show_minutes` : To display/ hide minutes field in widget<br/>
`show_seconds` : To display/ hide seconds field in widget<br/>


