django-simple-menu


Namedjango-simple-menu JSON
Version 2.1.3 PyPI version JSON
download
home_page
SummarySimple, yet powerful, code-based menus for Django applications
upload_time2023-10-04 17:44:07
maintainer
docs_urlNone
author
requires_python>=3.6
licenseBSD 2-Clause
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ===================================
django-simple-menu |latest-version|
===================================

|jazzband| |build-status| |coverage| |docs| |python-support| |django-support|

.. |latest-version| image:: https://img.shields.io/pypi/v/django-simple-menu.svg
   :target: https://pypi.python.org/pypi/django-simple-menu
   :alt: Latest version on PyPI

.. |jazzband| image:: https://jazzband.co/static/img/badge.svg
   :target: https://jazzband.co/
   :alt: Jazzband

.. |build-status| image:: https://github.com/jazzband/django-simple-menu/actions/workflows/test.yml/badge.svg
   :target: https://github.com/jazzband/django-simple-menu/actions
   :alt: Build Status

.. |coverage| image:: https://img.shields.io/codecov/c/github/jazzband/django-simple-menu.svg
   :target: https://codecov.io/github/jazzband/django-simple-menu
   :alt: Test coverage status

.. |docs| image:: https://img.shields.io/readthedocs/django-simple-menu/latest.svg
   :target: https://django-simple-menu.readthedocs.io/
   :alt: Documentation status

.. |python-support| image:: https://img.shields.io/pypi/pyversions/django-simple-menu
   :target: https://pypi.python.org/pypi/django-simple-menu
   :alt: Supported Python versions

.. |django-support| image:: https://img.shields.io/pypi/djversions/django-simple-menu
   :target: https://pypi.org/project/django-simple-menu
   :alt: Supported Django versions

``django-simple-menu`` is an entirely code based menu system, because, who
really wants to define their menus inside Django Admin?..

It's simple to use, yet provides enough flexibility to provide unlimited
children menus, per-request generation and checking of menu items, badges,
and more.


Quickstart
----------

**Requirements:** Python 3.6+, Django 3.2+

**Note:** While this package does support Python 3.6 and 3.7 as well as
Django 4.0, we do not test the package under these versions and may miss some
bugs.

1. Install the ``django-simple-menu`` package.

2. Add ``simple_menu`` to your ``INSTALLED_APPS``.

   - please ensure that you have ``django.template.context_processors.request``
     listed under ``TEMPLATES[...]["OPTIONS"]["context_processors"]``.

3. Create ``menus.py`` inside each app you want to create a menu for and define
   said menus using the ``Menu`` and ``MenuItem`` classes you can import from
   the ``simple_menu`` package.

4. In your templates, load the template tags (``{% load simple_menu %}``) and
   call ``{% generate_menu %}`` inside a block. Your context will be populated
   with a new object named ``menus``. You can now iterate over it to render your
   menus.

To quickly see ``django-simple-menu`` in action, check out the
`example project`_.

.. _example project: https://github.com/jazzband/django-simple-menu/tree/master/example


More
----

Full documentation, including installation and configuration instructions, is
available at https://django-simple-menu.readthedocs.io/.

``django-simple-menu`` is released under the *BSD 2-Clause "Simplified" License*.
If you like it, please consider contributing!

``django-simple-menu`` was originally created by
Evan Borgstom <evan@borgstrom.ca> and was further developed by many
contributors_.

.. _contributors: https://github.com/jazzband/django-simple-menu/graphs/contributors

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "django-simple-menu",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.6",
    "maintainer_email": "",
    "keywords": "",
    "author": "",
    "author_email": "Evan Borgstrom <evan@borgstrom.ca>",
    "download_url": "https://files.pythonhosted.org/packages/f3/4b/0ac243423896a21d9d4ce06024004605087e52ecdc7427feacdedc8f8d9b/django-simple-menu-2.1.3.tar.gz",
    "platform": null,
    "description": "===================================\ndjango-simple-menu |latest-version|\n===================================\n\n|jazzband| |build-status| |coverage| |docs| |python-support| |django-support|\n\n.. |latest-version| image:: https://img.shields.io/pypi/v/django-simple-menu.svg\n   :target: https://pypi.python.org/pypi/django-simple-menu\n   :alt: Latest version on PyPI\n\n.. |jazzband| image:: https://jazzband.co/static/img/badge.svg\n   :target: https://jazzband.co/\n   :alt: Jazzband\n\n.. |build-status| image:: https://github.com/jazzband/django-simple-menu/actions/workflows/test.yml/badge.svg\n   :target: https://github.com/jazzband/django-simple-menu/actions\n   :alt: Build Status\n\n.. |coverage| image:: https://img.shields.io/codecov/c/github/jazzband/django-simple-menu.svg\n   :target: https://codecov.io/github/jazzband/django-simple-menu\n   :alt: Test coverage status\n\n.. |docs| image:: https://img.shields.io/readthedocs/django-simple-menu/latest.svg\n   :target: https://django-simple-menu.readthedocs.io/\n   :alt: Documentation status\n\n.. |python-support| image:: https://img.shields.io/pypi/pyversions/django-simple-menu\n   :target: https://pypi.python.org/pypi/django-simple-menu\n   :alt: Supported Python versions\n\n.. |django-support| image:: https://img.shields.io/pypi/djversions/django-simple-menu\n   :target: https://pypi.org/project/django-simple-menu\n   :alt: Supported Django versions\n\n``django-simple-menu`` is an entirely code based menu system, because, who\nreally wants to define their menus inside Django Admin?..\n\nIt's simple to use, yet provides enough flexibility to provide unlimited\nchildren menus, per-request generation and checking of menu items, badges,\nand more.\n\n\nQuickstart\n----------\n\n**Requirements:** Python 3.6+, Django 3.2+\n\n**Note:** While this package does support Python 3.6 and 3.7 as well as\nDjango 4.0, we do not test the package under these versions and may miss some\nbugs.\n\n1. Install the ``django-simple-menu`` package.\n\n2. Add ``simple_menu`` to your ``INSTALLED_APPS``.\n\n   - please ensure that you have ``django.template.context_processors.request``\n     listed under ``TEMPLATES[...][\"OPTIONS\"][\"context_processors\"]``.\n\n3. Create ``menus.py`` inside each app you want to create a menu for and define\n   said menus using the ``Menu`` and ``MenuItem`` classes you can import from\n   the ``simple_menu`` package.\n\n4. In your templates, load the template tags (``{% load simple_menu %}``) and\n   call ``{% generate_menu %}`` inside a block. Your context will be populated\n   with a new object named ``menus``. You can now iterate over it to render your\n   menus.\n\nTo quickly see ``django-simple-menu`` in action, check out the\n`example project`_.\n\n.. _example project: https://github.com/jazzband/django-simple-menu/tree/master/example\n\n\nMore\n----\n\nFull documentation, including installation and configuration instructions, is\navailable at https://django-simple-menu.readthedocs.io/.\n\n``django-simple-menu`` is released under the *BSD 2-Clause \"Simplified\" License*.\nIf you like it, please consider contributing!\n\n``django-simple-menu`` was originally created by\nEvan Borgstom <evan@borgstrom.ca> and was further developed by many\ncontributors_.\n\n.. _contributors: https://github.com/jazzband/django-simple-menu/graphs/contributors\n",
    "bugtrack_url": null,
    "license": "BSD 2-Clause",
    "summary": "Simple, yet powerful, code-based menus for Django applications",
    "version": "2.1.3",
    "project_urls": {
        "Source Code": "https://github.com/jazzband/django-simple-menu"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "5701a1305b1dead7e80f454df15569ddc1a1273fb9dcc8dbdd3e5e3b83ada12f",
                "md5": "5c29b4faf16ca14d465b8bef776a6a88",
                "sha256": "371ed124cc35c72496c2b99672fac759d268950454984c7f15f2cbdedb4f2840"
            },
            "downloads": -1,
            "filename": "django_simple_menu-2.1.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "5c29b4faf16ca14d465b8bef776a6a88",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6",
            "size": 13865,
            "upload_time": "2023-10-04T17:43:49",
            "upload_time_iso_8601": "2023-10-04T17:43:49.138517Z",
            "url": "https://files.pythonhosted.org/packages/57/01/a1305b1dead7e80f454df15569ddc1a1273fb9dcc8dbdd3e5e3b83ada12f/django_simple_menu-2.1.3-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f34b0ac243423896a21d9d4ce06024004605087e52ecdc7427feacdedc8f8d9b",
                "md5": "1bc70240b6ff6ddb79b1ad856a27ba40",
                "sha256": "4246c12fa267598e4652793dfec5d123f97f82430965bd34a8c42d38d5be1801"
            },
            "downloads": -1,
            "filename": "django-simple-menu-2.1.3.tar.gz",
            "has_sig": false,
            "md5_digest": "1bc70240b6ff6ddb79b1ad856a27ba40",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 184588,
            "upload_time": "2023-10-04T17:44:07",
            "upload_time_iso_8601": "2023-10-04T17:44:07.090041Z",
            "url": "https://files.pythonhosted.org/packages/f3/4b/0ac243423896a21d9d4ce06024004605087e52ecdc7427feacdedc8f8d9b/django-simple-menu-2.1.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-10-04 17:44:07",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "jazzband",
    "github_project": "django-simple-menu",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "tox": true,
    "lcname": "django-simple-menu"
}
        
Elapsed time: 0.12111s