django-crispy-forms


Namedjango-crispy-forms JSON
Version 2.3 PyPI version JSON
download
home_pageNone
SummaryBest way to have Django DRY forms
upload_time2024-07-19 13:08:16
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseMIT
keywords forms django crispy dry
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ===================
django-crispy-forms
===================

.. image:: https://github.com/django-crispy-forms/django-crispy-forms/actions/workflows/main.yml/badge.svg

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
    :target: https://github.com/psf/black

.. image:: http://codecov.io/github/django-crispy-forms/django-crispy-forms/coverage.svg?branch=main
   :target: http://codecov.io/github/django-crispy-forms/django-crispy-forms?branch=main

The best way to have Django_ DRY forms. Build programmatic reusable layouts out of components, having full control of the rendered HTML without writing HTML in templates. All this without breaking the standard way of doing things in Django, so it plays nice with any other form application.

`django-crispy-forms` supports Django 4.2+ with Python 3.8+.

Looking for Bootstrap 5 support? See the `crispy-bootstrap5 package`_.

.. _`crispy-bootstrap5 package`: https://github.com/django-crispy-forms/crispy-bootstrap5

The application mainly provides:

* A filter named ``|crispy`` that will render elegant div based forms. Think of it as the built-in methods: ``as_table``, ``as_ul`` and ``as_p``. You cannot tune up the output, but it is easy to start using it.
* A tag named ``{% crispy %}`` that will render a form based on your configuration and specific layout setup. This gives you amazing power without much hassle, helping you save tons of time.

Django-crispy-forms supports several frontend frameworks, such as Twitter `Bootstrap`_ (versions 2, 3, and 4), `tailwind`_, `Bulma`_ and Foundation. You can also easily adapt your custom company's one, creating your own, `see the docs`_ for more information. You can easily switch among them using ``CRISPY_TEMPLATE_PACK`` setting variable.

.. _`tailwind`: https://github.com/django-crispy-forms/crispy-tailwind
.. _`Bootstrap`: https://getbootstrap.com
.. _`Bulma`: https://github.com/ckrybus/crispy-bulma
.. _`see the docs`: https://django-crispy-forms.readthedocs.io

Authors
=======

django-crispy-forms is the new django-uni-form. django-uni-form was an application created by `Daniel Greenfeld`_ that I led since version 0.8.0. The name change tries to better explain the purpose of the application, which changed in a significant way since its birth.

If you are upgrading from django-uni-form, we have `instructions`_ for helping you.

* Lead developer: `Miguel Araujo`_

.. _`Daniel Greenfeld`: https://github.com/pydanny
.. _`Miguel Araujo`: https://github.com/maraujop
.. _`instructions`: https://django-crispy-forms.readthedocs.io/en/latest/install.html#moving-from-django-uni-form-to-django-crispy-forms

Example
=======

This is a teaser of what you can do with latest django-crispy-forms. `Find here the gist`_ for generating this form:

.. image:: http://i.imgur.com/LSREg.png

.. _`Find here the gist`: https://gist.github.com/1838193

Documentation
=============

For extensive documentation see the ``docs`` folder or `read it on readthedocs`_

.. _`read it on readthedocs`: https://django-crispy-forms.readthedocs.io/en/latest/index.html

Special thanks
==============

* To Daniel Feldroy (`@pydanny`_) for his support, time and the opportunity given to me to do this.
* The name of the project was suggested by the fantastic Audrey Feldroy (`@audreyfeldroy`_)
* To Kenneth Love (`@kennethlove`_) for creating django-uni-form-contrib from which bootstrap template pack was started.

.. _`@audreyfeldroy`: https://github.com/audreyfeldroy
.. _`@pydanny`: https://github.com/pydanny
.. _`@kennethlove`: https://github.com/kennethlove


.. _Django: http://djangoproject.com

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "django-crispy-forms",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "forms, django, crispy, DRY",
    "author": null,
    "author_email": "Miguel Araujo <miguel.araujo.perez@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/04/f6/5bce7ae3512171c7c0ca3de31689e2a1ced8b030f156fcf13d2870e5468e/django_crispy_forms-2.3.tar.gz",
    "platform": null,
    "description": "===================\ndjango-crispy-forms\n===================\n\n.. image:: https://github.com/django-crispy-forms/django-crispy-forms/actions/workflows/main.yml/badge.svg\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n    :target: https://github.com/psf/black\n\n.. image:: http://codecov.io/github/django-crispy-forms/django-crispy-forms/coverage.svg?branch=main\n   :target: http://codecov.io/github/django-crispy-forms/django-crispy-forms?branch=main\n\nThe best way to have Django_ DRY forms. Build programmatic reusable layouts out of components, having full control of the rendered HTML without writing HTML in templates. All this without breaking the standard way of doing things in Django, so it plays nice with any other form application.\n\n`django-crispy-forms` supports Django 4.2+ with Python 3.8+.\n\nLooking for Bootstrap 5 support? See the `crispy-bootstrap5 package`_.\n\n.. _`crispy-bootstrap5 package`: https://github.com/django-crispy-forms/crispy-bootstrap5\n\nThe application mainly provides:\n\n* A filter named ``|crispy`` that will render elegant div based forms. Think of it as the built-in methods: ``as_table``, ``as_ul`` and ``as_p``. You cannot tune up the output, but it is easy to start using it.\n* A tag named ``{% crispy %}`` that will render a form based on your configuration and specific layout setup. This gives you amazing power without much hassle, helping you save tons of time.\n\nDjango-crispy-forms supports several frontend frameworks, such as Twitter `Bootstrap`_ (versions 2, 3, and 4), `tailwind`_, `Bulma`_ and Foundation. You can also easily adapt your custom company's one, creating your own, `see the docs`_ for more information. You can easily switch among them using ``CRISPY_TEMPLATE_PACK`` setting variable.\n\n.. _`tailwind`: https://github.com/django-crispy-forms/crispy-tailwind\n.. _`Bootstrap`: https://getbootstrap.com\n.. _`Bulma`: https://github.com/ckrybus/crispy-bulma\n.. _`see the docs`: https://django-crispy-forms.readthedocs.io\n\nAuthors\n=======\n\ndjango-crispy-forms is the new django-uni-form. django-uni-form was an application created by `Daniel Greenfeld`_ that I led since version 0.8.0. The name change tries to better explain the purpose of the application, which changed in a significant way since its birth.\n\nIf you are upgrading from django-uni-form, we have `instructions`_ for helping you.\n\n* Lead developer: `Miguel Araujo`_\n\n.. _`Daniel Greenfeld`: https://github.com/pydanny\n.. _`Miguel Araujo`: https://github.com/maraujop\n.. _`instructions`: https://django-crispy-forms.readthedocs.io/en/latest/install.html#moving-from-django-uni-form-to-django-crispy-forms\n\nExample\n=======\n\nThis is a teaser of what you can do with latest django-crispy-forms. `Find here the gist`_ for generating this form:\n\n.. image:: http://i.imgur.com/LSREg.png\n\n.. _`Find here the gist`: https://gist.github.com/1838193\n\nDocumentation\n=============\n\nFor extensive documentation see the ``docs`` folder or `read it on readthedocs`_\n\n.. _`read it on readthedocs`: https://django-crispy-forms.readthedocs.io/en/latest/index.html\n\nSpecial thanks\n==============\n\n* To Daniel Feldroy (`@pydanny`_) for his support, time and the opportunity given to me to do this.\n* The name of the project was suggested by the fantastic Audrey Feldroy (`@audreyfeldroy`_)\n* To Kenneth Love (`@kennethlove`_) for creating django-uni-form-contrib from which bootstrap template pack was started.\n\n.. _`@audreyfeldroy`: https://github.com/audreyfeldroy\n.. _`@pydanny`: https://github.com/pydanny\n.. _`@kennethlove`: https://github.com/kennethlove\n\n\n.. _Django: http://djangoproject.com\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Best way to have Django DRY forms",
    "version": "2.3",
    "project_urls": {
        "Changelog": "https://github.com/django-crispy-forms/django-crispy-forms/releases",
        "Homepage": "https://github.com/django-crispy-forms/django-crispy-forms",
        "Issues": "https://github.com/django-crispy-forms/django-crispy-forms/issues"
    },
    "split_keywords": [
        "forms",
        " django",
        " crispy",
        " dry"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4c3b5dc3faf8739d1ce7a73cedaff508b4af8f6aa1684120ded6185ca0c92734",
                "md5": "763366703f4cf4fb891a9f57cf718e70",
                "sha256": "efc4c31e5202bbec6af70d383a35e12fc80ea769d464fb0e7fe21768bb138a20"
            },
            "downloads": -1,
            "filename": "django_crispy_forms-2.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "763366703f4cf4fb891a9f57cf718e70",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 31411,
            "upload_time": "2024-07-19T13:08:14",
            "upload_time_iso_8601": "2024-07-19T13:08:14.498290Z",
            "url": "https://files.pythonhosted.org/packages/4c/3b/5dc3faf8739d1ce7a73cedaff508b4af8f6aa1684120ded6185ca0c92734/django_crispy_forms-2.3-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "04f65bce7ae3512171c7c0ca3de31689e2a1ced8b030f156fcf13d2870e5468e",
                "md5": "0ae05bacf393e83847e393a7d8263d7c",
                "sha256": "2db17ae08527201be1273f0df789e5f92819e23dd28fec69cffba7f3762e1a38"
            },
            "downloads": -1,
            "filename": "django_crispy_forms-2.3.tar.gz",
            "has_sig": false,
            "md5_digest": "0ae05bacf393e83847e393a7d8263d7c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 278849,
            "upload_time": "2024-07-19T13:08:16",
            "upload_time_iso_8601": "2024-07-19T13:08:16.264434Z",
            "url": "https://files.pythonhosted.org/packages/04/f6/5bce7ae3512171c7c0ca3de31689e2a1ced8b030f156fcf13d2870e5468e/django_crispy_forms-2.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-07-19 13:08:16",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "django-crispy-forms",
    "github_project": "django-crispy-forms",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "tox": true,
    "lcname": "django-crispy-forms"
}
        
Elapsed time: 0.40664s