{ "info": { "author": "Nathan Swain", "author_email": "nathan.swain@byu.net", "bugtrack_url": null, "classifiers": [ "Environment :: Web Environment", "Framework :: Django", "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Topic :: Internet :: WWW/HTTP", "Topic :: Internet :: WWW/HTTP :: Dynamic Content" ], "description": "=============\nTethys Gizmos\n=============\n\nGizmos are building blocks that can be used to create beautiful interactive controls for web apps. Using gizmos,\ndevelopers can add date-pickers, plots, and maps to their templates with minimal coding.\n\nInstallation\n------------\n\nTethys Gizmos can be installed via pip or by downloading the source. To install via pip or easy_install::\n\n pip install django-tethys_gizmos\n\nTo install via download::\n\n git clone https://github.com/CI-WATER/django-tethys_gizmos.git\n cd django-tethys_gizmos\n python setup.py install\n\nDjango Configuration\n--------------------\n\n1. Add \"tethys_gizmos\" to your INSTALLED_APPS setting like this::\n\n INSTALLED_APPS = (\n ...\n 'tethys_gizmos',\n )\n\n2. Add the context processor to settings. For example::\n\n TEMPLATE_CONTEXT_PROCESSORS = ('django.contrib.auth.context_processors.auth',\n 'django.core.context_processors.debug',\n 'django.core.context_processors.i18n',\n 'django.core.context_processors.media',\n 'django.core.context_processors.static',\n 'django.core.context_processors.tz',\n 'tethys_gizmos.context_processors.tethys_gizmos_context')\n\n3. Include the Tethys Gizmos URLconf to your project urls.py with the \"gizmos\" namespace::\n\n url(r'^gizmos/', include('tethys_gizmos.urls', namespace='gizmos'))\n\n4. Tethys Gizmos makes extensive use of Twitter Bootstrap and Jquery. These libraries must be included in all templates\nthat use gizmos. Because of the prevalent use of these two libraries, we leave it to the developer to decide how to\nprovide these dependencies. It is suggested that you include them in your \"page.html\" (see below) or some other base\ntemplate that all pages in your website use.\n\n\n5. Tethys Gizmos includes a showcase of all the available gizmos including live demos and code examples. To get this page\nworking you will need to create a template called \"page.html\" in your base \"templates\" directory that includes blocks\ncalled \"styles\", \"bodytag\", \"primary_content\", and \"scripts\". Also include the Bootstrap and Jquery dependencies. Your\n\"page.html\" should look something like this::\n\n\n \n \n \n \n \n \n {% block styles %}\n {% endblock %}\n \n \n {% block primary_content %}\n {% endblock %}\n\n {% block scripts %}\n {% endblock %}\n \n \n\n\n.. note:: The gizmos work best if your Jquery and Bootstrap JavaScript scripts are included in the head of your document as is depicted above.\n\n\nQuick Start\n-----------\n\nWhat does \"minimal coding\" mean? Take a look at the following example. Let's say you want to include a date\npicker in your template using a gizmo. First, create a dictionary with all the configuration options\nfor the date picker (more on that later) in your view/controller for the template and add it to the context::\n\n def my_view(request):\n date_picker_options = {'display_text': 'Date',\n 'name': 'date1',\n 'autoclose': True,\n 'format': 'MM d, yyyy',\n 'start_date': '2/15/2014',\n 'start_view': 'decade',\n 'today_button': True,\n 'initial': 'February 15, 2014'}\n \n context = {'date_picker_options': date_picker_options}\n \n return render(request, 'path/to/my/template.html', context)\n\n\nNext, open the template you intend to add the gizmo to and load the **tethys_gizmos** library. Be sure to\ndo this somewhere near *the top* of your template--before any gizmo occurrences. This only needs to be\ndone once for each template that uses gizmos::\n\n {% load tethys_gizmos %}\n\n\nNow, use the **gizmo** tag to insert the date picker anywhere in your template. Pass the name of the gizmo\nand the options dictionary that you passed to the template from your view as arguments::\n\n {% gizmo date_picker date_picker_options %}\n\nFinally, *at the end* of your template--after all of the **gizmo** tags--insert the **gizmo_dependencies**\ntag. This only needs to be done once for each template that uses gizmos.\n\n::\n \n {% gizmo_dependencies %}\n\n.. note:: When using Tethys Gizmos in Tethys App development, it is not necessary to include the **gizmo_dependencies** tag in the template. The dependencies are already included in the **app_base** template.\n\nAll together your template may look something like this::\n\n {% load tethys_gizmos %}\n \n \n \n ...\n \n \n ...\n {% gizmo date_picker date_picker_options %}\n ...\n {% gizmo_dependencies %}\n \n \n\nHow it Works\n------------\n\nGizmos are composed of HTML, JavaScript, and CSS. When the template is rendered, each of the **gizmo**\ntags are replaced by the HTML that is needed to render the gizmo. All gizmos accept a Python dictionary\nwith options for configuring the gizmo. The options for each gizmo are documented on this page.\n\nThe JavaScript and CSS dependencies are loaded into the template at the location of the **gizmo_dependencies**\ntag. Note that the **gizmo_dependencies** tag must be called *after* all of the **gizmo** tags\notherwise some of the dependencies may not be loaded properly.\n\nOptionally, the **gizmo_dependencies** tag can be called with either **js** or **css** to load only\nthe JavaScript or only the CSS dependencies, respectively. The rule that this tag must be called after all\n**gizmo** tags still applies. The **gizmo_dependencies** *must* be called twice (once for each option)\nwhen this feature is used.\n\n::\n\n {% gizmo_dependencies js %}\n {% gizmo_dependencies css %}\n\n\nThe **tethys_gizmos** library must be loaded at the top of the template to provide the **gizmo** and\n**gizmo_dependencies** template tags.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "UNKNOWN", "keywords": null, "license": "BSD 2-Clause License", "maintainer": null, "maintainer_email": null, "name": "django-tethys_gizmos", "package_url": "https://pypi.org/project/django-tethys_gizmos/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/django-tethys_gizmos/", "project_urls": { "Download": "UNKNOWN", "Homepage": "UNKNOWN" }, "release_url": "https://pypi.org/project/django-tethys_gizmos/1.0.5/", "requires_dist": null, "requires_python": null, "summary": "An app to enable Tethys gizmos in your site.", "version": "1.0.5" }, "last_serial": 1460445, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "cbabad0ef5014f841b6238551bed60ee", "sha256": "b85b19348d54ce29488d7c18dc8806a864e37c00d2312355153fecf5db481479" }, "downloads": -1, "filename": "django-tethys_gizmos-0.1.0.tar.gz", "has_sig": false, "md5_digest": "cbabad0ef5014f841b6238551bed60ee", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16006197, "upload_time": "2014-10-09T03:43:36", "url": "https://files.pythonhosted.org/packages/7c/e1/d59dab70539eebce0ad8f7b910382cac105eb34caa509b05467639ede844/django-tethys_gizmos-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "17ced974baf8c1bbcbe812ea8c9f4b83", "sha256": "7456c8300d9d55034d9895bc9f2afb359055f9607985b2c40da2a2ecc4228398" }, "downloads": -1, "filename": "django-tethys_gizmos-0.1.1.tar.gz", "has_sig": false, "md5_digest": "17ced974baf8c1bbcbe812ea8c9f4b83", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16037212, "upload_time": "2014-10-20T23:30:59", "url": "https://files.pythonhosted.org/packages/cd/4a/c052d3ce5ab003563a183473402539fe01bc283c6f7838d24f3d3677b21b/django-tethys_gizmos-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "badc52443559d04c14e50f8f8125e68a", "sha256": "2280a8b4c197e3061d4dc2b23fb87c5ba05d66f76767d7c95c26552c9891d29f" }, "downloads": -1, "filename": "django-tethys_gizmos-0.1.2.tar.gz", "has_sig": false, "md5_digest": "badc52443559d04c14e50f8f8125e68a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16037247, "upload_time": "2014-10-21T02:37:43", "url": "https://files.pythonhosted.org/packages/84/46/7fd3cb6cb67eb750c4092e747d1bb26e09d04c1031772e3166cc33b4e451/django-tethys_gizmos-0.1.2.tar.gz" } ], "0.1.3": [ { "comment_text": "", "digests": { "md5": "e89d0d5ce83825cfe3c92eb3821fe7a9", "sha256": "936990f8b87b67080916259d99d534ab8d0f74a8c78f98a8f8d9e2923af67b13" }, "downloads": -1, "filename": "django-tethys_gizmos-0.1.3.tar.gz", "has_sig": false, "md5_digest": "e89d0d5ce83825cfe3c92eb3821fe7a9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16042003, "upload_time": "2014-10-29T22:38:21", "url": "https://files.pythonhosted.org/packages/7f/1e/745320b6749dd0d84ec4ed8a854c509642fd9541e1f4cdff98a1f5832090/django-tethys_gizmos-0.1.3.tar.gz" } ], "0.1.4": [ { "comment_text": "", "digests": { "md5": "4b4488139642f59caf5796a48ea4a8c2", "sha256": "fb9b22189f59d07afbaa671de07fdb34494e75bb5f6306e0c1dc38099b7cc25a" }, "downloads": -1, "filename": "django-tethys_gizmos-0.1.4.tar.gz", "has_sig": false, "md5_digest": "4b4488139642f59caf5796a48ea4a8c2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16042323, "upload_time": "2014-10-30T21:19:53", "url": "https://files.pythonhosted.org/packages/0f/93/68a04d0366fb123e0cb17480c89742b7e6ba51d2fccb92cab5a557bd537d/django-tethys_gizmos-0.1.4.tar.gz" } ], "1.0.0": [ { "comment_text": "", "digests": { "md5": "bdcebf8660b7ef6ad40057750e783ba5", "sha256": "40dda8dee915c92343166089328eb90fffa5ba1bfcb09b100870bfa0013b3e09" }, "downloads": -1, "filename": "django-tethys_gizmos-1.0.0.tar.gz", "has_sig": false, "md5_digest": "bdcebf8660b7ef6ad40057750e783ba5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16059642, "upload_time": "2015-02-06T05:32:42", "url": "https://files.pythonhosted.org/packages/45/07/af354c35cd2647c424acb2c44c662f9f9b559d265125bb3f141995a0b1a2/django-tethys_gizmos-1.0.0.tar.gz" } ], "1.0.1": [ { "comment_text": "", "digests": { "md5": "b4ed9e0f1f97db17e2c79e37331f449b", "sha256": "6890b6ac22406102db61912081007fb4d4d1a5f73c6012cdaac4f840ae0143c3" }, "downloads": -1, "filename": "django-tethys_gizmos-1.0.1.tar.gz", "has_sig": false, "md5_digest": "b4ed9e0f1f97db17e2c79e37331f449b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16059915, "upload_time": "2015-02-13T05:31:03", "url": "https://files.pythonhosted.org/packages/f2/48/01f62763c98ccd3a2cf0da76e369ca632b64ed22ef7fab814463cea998b2/django-tethys_gizmos-1.0.1.tar.gz" } ], "1.0.2": [ { "comment_text": "", "digests": { "md5": "6f9b9b3720275118280c613af94e4c65", "sha256": "2059b645041c0058bf9cb33e907b1896f9ffabc864f74462da15567f111a3932" }, "downloads": -1, "filename": "django-tethys_gizmos-1.0.2.tar.gz", "has_sig": false, "md5_digest": "6f9b9b3720275118280c613af94e4c65", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16059091, "upload_time": "2015-03-05T19:48:23", "url": "https://files.pythonhosted.org/packages/76/3f/4741a787e4907ab59c4726c8ab7f32882ac57d5440eefe1564cc4a3ee430/django-tethys_gizmos-1.0.2.tar.gz" } ], "1.0.3": [ { "comment_text": "", "digests": { "md5": "922580e612dc00d00d4609bf1bdc8fca", "sha256": "779ae3652c379864fecd6117ca941db7ab6cf80b80b8b6ad94a0ae140e7ed679" }, "downloads": -1, "filename": "django-tethys_gizmos-1.0.3.tar.gz", "has_sig": false, "md5_digest": "922580e612dc00d00d4609bf1bdc8fca", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16059280, "upload_time": "2015-03-05T19:57:05", "url": "https://files.pythonhosted.org/packages/bb/20/334e87af926994502887b6a024aa5bb6d312116f8533dc5a9b23b28879aa/django-tethys_gizmos-1.0.3.tar.gz" } ], "1.0.4": [ { "comment_text": "", "digests": { "md5": "2609e15759a1dd4fe02f8ee2f02b5442", "sha256": "a190188ecda21e6e056ac85a36e122bd4857e923cd4058922160240b8726f101" }, "downloads": -1, "filename": "django-tethys_gizmos-1.0.4.tar.gz", "has_sig": false, "md5_digest": "2609e15759a1dd4fe02f8ee2f02b5442", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16059219, "upload_time": "2015-03-05T19:59:54", "url": "https://files.pythonhosted.org/packages/5f/a9/c303f3d6ce628c8b0b21e78515e2c73cd3b8f3ed43ff884995ed135fb9e1/django-tethys_gizmos-1.0.4.tar.gz" } ], "1.0.5": [ { "comment_text": "", "digests": { "md5": "27fa9959cd2599b581857cfb7857ef61", "sha256": "25e9c71d309066554b1174023d2eb99816d581c0f49622ba60f73ba48ef4cd35" }, "downloads": -1, "filename": "django-tethys_gizmos-1.0.5.tar.gz", "has_sig": false, "md5_digest": "27fa9959cd2599b581857cfb7857ef61", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16059060, "upload_time": "2015-03-13T20:35:28", "url": "https://files.pythonhosted.org/packages/a0/52/f38987e4f9d4c63bb4bca7db886b95f3246c01148bac4cb763bb7cd1f38a/django-tethys_gizmos-1.0.5.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "27fa9959cd2599b581857cfb7857ef61", "sha256": "25e9c71d309066554b1174023d2eb99816d581c0f49622ba60f73ba48ef4cd35" }, "downloads": -1, "filename": "django-tethys_gizmos-1.0.5.tar.gz", "has_sig": false, "md5_digest": "27fa9959cd2599b581857cfb7857ef61", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16059060, "upload_time": "2015-03-13T20:35:28", "url": "https://files.pythonhosted.org/packages/a0/52/f38987e4f9d4c63bb4bca7db886b95f3246c01148bac4cb763bb7cd1f38a/django-tethys_gizmos-1.0.5.tar.gz" } ] }