{
    "info": {
        "author": "Pablo Escodebar",
        "author_email": "escodebar@gmail.com",
        "bugtrack_url": null,
        "classifiers": [
            "Environment :: Web Environment",
            "Framework :: Django",
            "Intended Audience :: Developers",
            "License :: OSI Approved :: Apache Software License",
            "Operating System :: OS Independent",
            "Programming Language :: Python",
            "Programming Language :: Python :: 3",
            "Topic :: Software Development :: Libraries",
            "Topic :: Utilities"
        ],
        "description": "# django-datetimepicker\n\nUses xdsoft's datetimepicker to make a datetimepicker widget for django.\nThis is inspired by the `django-bootstrap3-datetimepicker` application.\n\n![datetimepicker preview](https://cloud.githubusercontent.com/assets/26252388/24758585/1c485514-1ae3-11e7-8907-efe6db0155fd.png)\n\n## Installation\n\n- Run `pip install django-datetimepicker`\n- Add `'datetimepicker'` to your `INSTALLED_APPS`\n\n## Basic usage\n\nHere is an example of how to use the widget.\nFurther examples can be found in the example project.\n\n1. Assign the `DateTimePicker` to a `DateTimeField`, `DateField` or `TimeField`.\n\n```python\nfrom django import forms\nfrom datetimepicker.widgets import DateTimePicker\n\n\nclass SampleForm(forms.Form):\n\n    datetime = forms.DateTimeField(\n        widget=DateTimePicker(),\n    )\n```\n\nThis will render the following `html` code:\n```html\n<div  class=\" date input-group\" id=\"datetimepicker_id_datetime\">\n\t<input  class=\" form-control\" id=\"id_datetime\" name=\"datetime\" type=\"text\" required/>\n</div>\n<script>(function () {\n\t$(document).ready(function() {\n\t\t$(\"#id_datetime\").datetimepicker();\n\t});\n})(jQuery);\n</script>\n```\n\n## Passing options to `jQuery.datetimepicker`\n\nYou can add `jQuery.datetimepicker` options according to your needs.\n[See XDSoft's documentation for a full list of options.](http://xdsoft.net/jqplugins/datetimepicker/ \"XDSoft's DateTimePicker documentation.\")\n\n```python\n    datetime = forms.DateTimeField(\n        widget=DateTimePicker(options={\n\t    'format': '%Y-%m-%d %H:%M',\n\t    'language': 'en-us',\n\t}),\n    )\n```\n\n## Customization with template overloading\n\n`django-datetimepicker` uses Django's own templating engine to render the field itself and the script tag needed to run it.\nThis allows to overload the templates to adapt the widget and javascript to your needs.\n\n- [`datetimepicker/div.html`](https://github.com/escodebar/django-datetimepicker/blob/master/datetimepicker/templates/datetimepicker/div.html)\n- [`datetimepicker/script.html`](https://github.com/escodebar/django-datetimepicker/blob/master/datetimepicker/templates/datetimepicker/div.html)\n- [`datetimepicker/loader.js`](https://github.com/escodebar/django-datetimepicker/blob/master/datetimepicker/templates/datetimepicker/loader.js)\n\n## Form javascript media\n\nAs seen in the basic example, a `<script>`-tag containing the logic to load the widget is rendered below the input field by default.\nThis can be prevented by setting the `script_tag` argument of the widget's initialiser.\n\n```python\nfrom django import forms\nfrom datetimepicker.widgets import DateTimePicker\n\n\nclass SampleForm(forms.Form):\n\n    datetimepicker_without_script_tag = forms.DateTimeField(\n    \twidget=DateTimePicker(script_tag=False),\n    )\n```\n\nThe javascript to initialise the widget can be provided as external file with the form media using the `js_loader_url` helper.\nThe media is added [dynamically](https://docs.djangoproject.com/en/dev/topics/forms/media/#media-as-a-dynamic-property).\n\n```diff\n from django import forms\n+from datetimepicker.helpers import js_loader_url\n from datetimepicker.widgets import DateTimePicker\n\n\n class SampleForm(forms.Form):\n\n     datetimepicker_without_script_tag = forms.DateTimeField(\n\t widget=DateTimePicker(script_tag=False),\n     )\n\n+    @property\n+    def media(self):\n+       form_media = forms.Media(js=[\n+           js_loader_url(\n+               fields=self.fields,\n+               input_ids=['id_datetimepicker_without_script_tag'],\n+           ),\n+       ])\n+       return super(SampleForm, self).media + form_media\n```\n\n`js_loader_url` requires to include the `datetimepicker.urls` to your `urls.py`.\n\n```diff\n urlpatterns = [\n     ...\n+    url(r'^datetimepicker/', include('datetimepicker.urls')),\n     ...\n ]\n```\n",
        "description_content_type": null,
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/escodebar/django-datetimepicker.git",
        "keywords": "",
        "license": "Apache License 2.0",
        "maintainer": "",
        "maintainer_email": "",
        "name": "django-datetimepicker",
        "package_url": "https://pypi.org/project/django-datetimepicker/",
        "platform": "",
        "project_url": "https://pypi.org/project/django-datetimepicker/",
        "project_urls": {
            "Homepage": "https://github.com/escodebar/django-datetimepicker.git"
        },
        "release_url": "https://pypi.org/project/django-datetimepicker/3.14/",
        "requires_dist": null,
        "requires_python": "",
        "summary": "Datetimepicker for Django projects.",
        "version": "3.14"
    },
    "last_serial": 3083904,
    "releases": {
        "2.3.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "b510b850a49c7bf2da8ee33c1eb74f40",
                    "sha256": "74a85550b8f8711563c34b2fdb277182edb63977096785e9705a63d952869f74"
                },
                "downloads": -1,
                "filename": "django-datetimepicker-2.3.1.tar.gz",
                "has_sig": false,
                "md5_digest": "b510b850a49c7bf2da8ee33c1eb74f40",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 256965,
                "upload_time": "2017-03-30T08:40:24",
                "url": "https://files.pythonhosted.org/packages/8a/c1/4a4737afbaaa3c845f860b7632f7a9f2b0afbad3622c3fa10cd5f358d5e6/django-datetimepicker-2.3.1.tar.gz"
            }
        ],
        "3.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "1908fa5c986f61288897b7b62e52bd0c",
                    "sha256": "aed8ab26f4ec51328a64b32e123f6142ef067b02c0dc091a07db5f5975ca31c0"
                },
                "downloads": -1,
                "filename": "django-datetimepicker-3.1.tar.gz",
                "has_sig": false,
                "md5_digest": "1908fa5c986f61288897b7b62e52bd0c",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 8600,
                "upload_time": "2017-06-19T06:18:42",
                "url": "https://files.pythonhosted.org/packages/88/67/f6f5fde71d6f8bc30d78bd103fe711bd7a38f78f07e1996c40b115cc302c/django-datetimepicker-3.1.tar.gz"
            }
        ],
        "3.14": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "4d005116621572e1e1f8bdad931aa045",
                    "sha256": "e3d576d384bd990c3a6ac41f62821950e69fab030b8170ffb295b0374382b571"
                },
                "downloads": -1,
                "filename": "django-datetimepicker-3.14.tar.gz",
                "has_sig": false,
                "md5_digest": "4d005116621572e1e1f8bdad931aa045",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 8876,
                "upload_time": "2017-08-09T12:30:36",
                "url": "https://files.pythonhosted.org/packages/97/75/5456a203dd230f547df71870e6f83b135520dacd0789cd4053379cf239d7/django-datetimepicker-3.14.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "4d005116621572e1e1f8bdad931aa045",
                "sha256": "e3d576d384bd990c3a6ac41f62821950e69fab030b8170ffb295b0374382b571"
            },
            "downloads": -1,
            "filename": "django-datetimepicker-3.14.tar.gz",
            "has_sig": false,
            "md5_digest": "4d005116621572e1e1f8bdad931aa045",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 8876,
            "upload_time": "2017-08-09T12:30:36",
            "url": "https://files.pythonhosted.org/packages/97/75/5456a203dd230f547df71870e6f83b135520dacd0789cd4053379cf239d7/django-datetimepicker-3.14.tar.gz"
        }
    ]
}