Merge pull request #86 from jazzband/release/v2.0.0

Prepare release of django-simple-menu 2.0.0

Author: mbeijen

.coveragerc

@@ -1,6 +1,6 @@
 [run]
-source = menu
+source = simple_menu
 branch = 1
 
 [report]
-omit = *migrations*,.tox/*,setup.py,*settings.py
+omit = *migrations*,.tox/*,setup.py,*settings.py,menu/*

.github/workflows/test.yml

@@ -9,8 +9,8 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ['3.6', '3.7', '3.8', '3.9']
-        django-version: ['2.2', '3.0', '3.1', 'main']
+        python-version: ['3.6', '3.7', '3.8', '3.9', '3.10']
+        django-version: ['3.2', '4.0', 'main']
 
     steps:
     - uses: actions/checkout@v2

.pre-commit-config.yaml

@@ -15,7 +15,7 @@ repos:
     rev: 1.11.0
     hooks:
     -   id: django-upgrade
-        args: [--target-version, "2.2"]
+        args: [--target-version, "3.2"]
 -   repo: https://github.com/pre-commit/pygrep-hooks
     rev: v1.9.0
     hooks:

CHANGES

@@ -1,9 +1,15 @@
 django-simple-menu changelog
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Version 2.0.0 - Released ...
-- Dropped support for Django < 2.2
-- Dropped support for Python < 3.6
+upcoming: Version 2.0.0
+- BREAKING: dropped support for Python < 3.6
+- BREAKING: dropped support for Django < 3.2
+- DEPRECATION: the module is now called "simple_menu" instead of "menu" (#93)
+  - BREAKING: when using "simple_menu", the Bootstrap templates are located
+              inside the "simple_menu" subfolder
+- Moved CI to GitHub Actions (#67, #72)
+- Project is now a part of Jazzband (#54)
+- Updated the example app
 
 Version 1.2.1 - Released May 1st, 2016
 - Fixing sdist packaging

MANIFEST.in

@@ -3,6 +3,8 @@ include LICENSE
 include README.rst
 include CHANGES
 include AUTHORS
+recursive-include simple_menu/templates *
+recursive-include simple_menu/templatetags *
 recursive-include menu/templates *
 recursive-include menu/templatetags *
 recursive-include docs *

README.rst

@@ -43,22 +43,22 @@ and more.
 Quickstart
 ----------
 
-**Requirements:** Python 3.6+, Django 2.2+
+**Requirements:** Python 3.6+, Django 3.2+
 
 1. Install the ``django-simple-menu`` package.
 
-2. Add ``menu`` to your ``INSTALLED_APPS``.
+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 ``menu`` namespace.
+   the ``simple_menu`` package.
 
-4. In your templates, load the template tags (``{% load 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
+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

docs/conf.py

@@ -12,7 +12,7 @@
 
 import sys, os
 
-from menu import __version__
+from simple_menu import __version__
 
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the

docs/installation.rst

@@ -5,7 +5,7 @@ Installing django-simple-menu
 
     pip install django-simple-menu
 
-#. Add ``menu`` to your ``INSTALLED_APPS`` list in your settings
+#. Add ``simple_menu`` to your ``INSTALLED_APPS`` list in your settings
 
 #. ``django-simple-menu`` requires that the ``request`` object be available in
    the context when you call the ``{% generate_menu %}`` template tag. This

docs/usage.rst

@@ -9,17 +9,11 @@ access from within your templates. This way you can have a menu for your main
 navigation, another menu for logged in users, another menu for anonymous users,
 etc.
 
-.. note::
-
-    Since we use the ``menu`` namespace you will get ``ImportError`` if you
-    have any files named ``menu.py``, ensure you use a plural version:
-    ``menus.py``
-
 To define your menus you need to create a file named ``menus.py`` inside of the
 app that you wish to hook menus up to. In the ``menus.py`` file you should
-import the ``Menu`` and ``MenuItem`` classes from the ``menu`` package::
+import the ``Menu`` and ``MenuItem`` classes from the ``simple_menu`` package::
 
-    from menu import Menu, MenuItem
+    from simple_menu import Menu, MenuItem
 
 The ``Menu`` class exposes a class method named ``add_item`` that accepts two
 arguments; the menu name you want to add to, and the ``MenuItem`` you're going
@@ -44,7 +38,8 @@ available in your templates. For example adding ``separator=True`` could be
 used to add separators to menus ``{% if item.separator %}<li
 class="divider"></li>{% endif %}``
 
-For the full list of ``MenuItem`` options see the `menu __init__.py source file`_.
+For the full list of ``MenuItem`` options see the
+`simple_menu __init__.py source file`_.
 
 Usage Example
 -------------
@@ -92,7 +87,7 @@ Once you have your menus defined you need to incorporate them into your
 templates. This is done through the ``generate_menu`` template tag::
 
     {% extends "base.html" %}
-    {% load menu %}
+    {% load simple_menu %}
 
     {% block content %}
     {% generate_menu %}
@@ -117,7 +112,7 @@ the following items will be set in the context for you.
 
 
 See the bootstrap-navbar.html file in the templates dir of the source code for
-an example that renders menus for the `Twitter Bootstrap Navbar Component`_.
+an example that renders menus for the `Bootstrap Navbar Component`_.
 You can use it like::
 
     {% with menu=menus.main %}{% include "bootstrap-navbar.html" %}{% endwith %}
@@ -137,7 +132,7 @@ This assumes you have a ``utils`` package.
 
     from django.core.urlresolvers import resolve
 
-    from menu import MenuItem
+    from simple_menu import MenuItem
 
 
     class ViewMenuItem(MenuItem):
@@ -158,7 +153,7 @@ This assumes you have a ``utils`` package.
 
      from utils.menus import ViewMenuItem
 
-     from menu import Menu, MenuItem
+     from simple_menu import Menu, MenuItem
 
      from django.core.urlresolvers import reverse
 
@@ -175,5 +170,5 @@ This assumes you have a ``utils`` package.
                                     children=reports_children))
 
 
-.. _menu __init__.py source file: https://github.com/jazzband/django-simple-menu/blob/master/menu/__init__.py
-.. _Twitter Bootstrap Navbar Component: http://twitter.github.com/bootstrap/components.html#navbar
+.. _simple_menu __init__.py source file: https://github.com/jazzband/django-simple-menu/blob/master/simple_menu/__init__.py
+.. _Bootstrap Navbar Component: https://getbootstrap.com/docs/5.1/components/navbar/

example/.gitignore

@@ -0,0 +1,18 @@
+### Django ###
+db.sqlite3
+db.sqlite3-journal
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# PyCharm
+.idea/
+
+# Visual Studio Code
+.vscode/