[pre-commit.ci] pre-commit autoupdate

updates:
- [github.com/astral-sh/ruff-pre-commit: v0.0.286 → v0.0.287](astral-sh/ruff-pre-commit@v0.0.286...v0.0.287)

.pre-commit-config.yaml

@@ -22,21 +22,21 @@ repos:
     hooks:
       - id: isort
   - repo: https://github.com/psf/black
-    rev: 23.7.0
+    rev: 23.9.1
     hooks:
       - id: black
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: 'v0.0.286'
+    rev: 'v0.0.292'
     hooks:
       - id: ruff
   - repo: https://github.com/asottile/pyupgrade
-    rev: v3.10.1
+    rev: v3.14.0
     hooks:
       - id: pyupgrade
         args:
           - --py3-plus
   - repo: https://github.com/adamchainz/django-upgrade
-    rev: "1.14.1"
+    rev: "1.15.0"
     hooks:
       - id: django-upgrade
         args: [--target-version, "3.2"]

.readthedocs.yml

@@ -20,4 +20,3 @@ python:
       path: .
       extra_requirements:
          - docs
-  system_packages: false

CONTRIBUTING.rst

@@ -5,167 +5,4 @@ Contributing
 Contributions are welcome, and they are greatly appreciated! Every
 little bit helps, and credit will always be given.
 
-You can contribute in many ways:
-
-Types of Contributions
-**********************
-
-Report Bugs
-===========
-
-Report bugs at https://github.com/nephila/django-app-helper/issues.
-
-If you are reporting a bug, please include:
-
-* Your operating system name and version.
-* Any details about your local setup that might be helpful in troubleshooting.
-* Detailed steps to reproduce the bug.
-
-Fix Bugs
-========
-
-Look through the GitHub issues for bugs. Anything tagged with "bug"
-is open to whoever wants to implement it.
-
-Implement Features
-==================
-
-Look through the GitHub issues for features. Anything tagged with "feature"
-is open to whoever wants to implement it.
-
-Write Documentation
-===================
-
-django-app-helper could always use more documentation, whether as part of the
-official django-app-helper docs, in docstrings, or even on the web in blog posts,
-articles, and such.
-
-Submit Feedback
-===============
-
-The best way to send feedback is to file an issue at https://github.com/nephila/django-app-helper/issues.
-
-If you are proposing a feature:
-
-* Explain in detail how it would work.
-* Keep the scope as narrow as possible, to make it easier to implement.
-* Remember that this is a volunteer-driven project, and that contributions
-  are welcome :)
-
-************
-Get Started!
-************
-
-Ready to contribute? Here's how to set up ``django-app-helper`` for local development.
-
-1. Fork the ``django-app-helper`` repo on GitHub.
-2. Clone your fork locally::
-
-    $ git clone [email protected]:your_name_here/django-app-helper.git
-
-3. Install your local copy into a virtualenv. Assuming you have virtualenvwrapper
-   installed, this is how you set up your fork for local development::
-
-    $ mkvirtualenv django-app-helper
-    $ cd django-app-helper/
-    $ pip install -r requirements-test.txt
-    $ pip install -e .
-
-4. Create a branch for local development::
-
-    $ git checkout -b name-of-your-bugfix-or-feature
-
-Now you can make your changes locally.
-
-5. When you're done making changes, check that your changes pass flake8 and the
-tests, including testing other Python versions with tox::
-
-    $ tox
-
-To get tox, pip install it into your virtualenv.
-
-6. Commit your changes and push your branch to GitHub::
-
-    $ git add .
-    $ git commit -m "Your detailed description of your changes."
-    $ git push origin name-of-your-bugfix-or-feature
-
-7. Submit a pull request through the GitHub website.
-
-Development tips
-----------------
-
-This project allows you to use `pre-commit <https://pre-commit.com/>`_ to ensure an easy compliance
-to the project code styles.
-
-If you want to use it, install it globally (for example with ``pip3 install --user precommit``,
-but check `installation instruction <https://pre-commit.com/#install>`.
-When first cloning the project ensure you install the git hooks by running ``pre-commit install``.
-
-From now on every commit will be checked against our code style.
-
-Check also the available tox environments with ``tox -l``: the ones not marked with a python version number are tools
-to help you work on the project buy checking / formatting code style, running docs etc.
-
-Testing tips
-----------------
-You can test your project using any specific combination of python, django and django cms.
-
-For example ``tox -py37-django30-cms37`` runs the tests on python 3.7, Django 3.0 and django CMS 3.7.
-
-You can pass via tox all the options to the test runner by appending them after the tox environments after
-``--`` separator. Example::
-
-    tox -epy38-django30-cms37 -- -s app_helper.tests.test_commands.CommandTests.test_compilemessages
-
-
-Pull Request Guidelines
-=======================
-
-Before you submit a pull request, check that it meets these guidelines:
-
-#. Pull request must be named with the following naming scheme:
-
-   ``<type>/(<optional-task-type>-)<number>-description``
-
-   See below for available types.
-
-#. The pull request should include tests.
-#. If the pull request adds functionality, the docs should be updated.
-   Documentation must be added in ``docs`` directory, and must include usage
-   information for the end user.
-   In case of public API method, add extended docstrings with full parameters
-   description and usage example.
-#. Add a changes file in ``changes`` directory describing the contribution in
-   one line. It will be added automatically to the history file upon release.
-   File must be named as ``<issue-number>.<type>`` with type being:
-
-   * ``.feature``: For new features.
-   * ``.bugfix``: For bug fixes.
-   * ``.doc``: For documentation improvement.
-   * ``.removal``: For deprecation or removal of public API.
-   * ``.misc``: For general issues.
-
-   Check `towncrier`_ documentation for more details.
-
-#. The pull request should work for all python / django / django CMS versions
-   declared in tox.ini.
-   Check the CI and make sure that the tests pass for all supported versions.
-
-Release a version
-=================
-
-#. Update authors file
-#. Merge ``develop`` on ``master`` branch
-#. Bump release via task: ``inv tag-release (major|minor|patch)``
-#. Update changelog via towncrier: ``towncrier --yes``
-#. Commit changelog with ``git commit --amend`` to merge with bumpversion commit
-#. Create tag ``git tag <version>``
-#. Push tag to github
-#. Publish the release from the tags page
-#. If pipeline succeeds, push ``master``
-#. Merge ``master`` back on ``develop``
-#. Bump developement version via task: ``inv tag-dev -l (major|minor|patch)``
-#. Push ``develop``
-
-.. _towncrier: https://pypi.org/project/towncrier/#news-fragments
+Please read the instructions `here <https://nephila.github.io/contributing/contributing>`_ to start contributing to `django-app-helper`.

HISTORY.rst

@@ -6,6 +6,21 @@ History
 
 .. towncrier release notes start
 
+3.3.2 (2023-09-26)
+==================
+
+Features
+--------
+
+- Migrate to bump-my-version (#237)
+
+
+Bugfixes
+--------
+
+- Fix ruff linting (#232)
+
+
 3.3.1 (2023-07-09)
 ==================
 

README.rst

@@ -4,7 +4,10 @@ Django App helper
 
 |Gitter| |PyPiVersion| |PyVersion| |GAStatus| |TestCoverage| |CodeClimate| |License|
 
-.. warning:: Starting 3.0 django-app-helper only supports Django 2.2+ and django CMS 3.7+. If you need support for older (unsupported) versions, use django-app-helper 2.
+.. warning::
+    Starting from 3.3 django-app-helper only supports Django 3.2+ and django CMS 3.11. If you need support for older (unsupported) versions, use django-app-helper<3.3
+
+    Starting from 3 django-app-helper only supports Django 2.2+ and django CMS 3.7+. If you need support for older (unsupported) versions, use django-app-helper 2.
 
 ******************************************
 Helper for django applications development
@@ -25,11 +28,11 @@ It supports both tests writted using Django ``TestCase`` and pytest ones
 Supported versions
 ==================
 
-Python: 3.7, 3.8, 3.9, 3.10
+Python: 3.9, 3.10, 3.11
 
-Django: 2.2, 3.2
+Django: 3.2, 4.0, 4.1, 4.2
 
-django CMS: 3.7 - 3.11
+django CMS: 3.11
 
 Newer versions might work but are not tested yet.
 

app_helper/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "3.3.2.dev0"
+__version__ = "3.3.3.dev1"
 __author__ = "Iacopo Spalletti <[email protected]>"
 __all__ = ["runner"]
 

pyproject.toml

@@ -47,3 +47,35 @@ target-version = "py310"
 
 [tool.ruff.mccabe]
 max-complexity = 10
+
+[tool.bumpversion]
+allow_dirty = false
+commit = true
+message = "Release {new_version}"
+commit_args = "--no-verify"
+tag = false
+current_version = "3.3.3.dev1"
+parse = """(?x)
+    (?P<major>[0-9]+)
+    \\.(?P<minor>[0-9]+)
+    \\.(?P<patch>[0-9]+)
+    (?:
+        .(?P<release>dev)
+        (?:(?P<relver>[0-9]+))?
+    )?
+"""
+serialize = [
+    "{major}.{minor}.{patch}.{release}{relver}",
+    "{major}.{minor}.{patch}"
+]
+
+[tool.bumpversion.parts.release]
+values = [
+    "dev",
+    ""
+]
+optional_value = "dev"
+
+[[tool.bumpversion.files]]
+filename = "app_helper/__init__.py"
+search = "{current_version}"

setup.cfg

@@ -1,26 +1,3 @@
-[bumpversion]
-current_version = 3.3.2.dev0
-parse = (?P<major>\d+)\.(?P<minor>\d+)\.(?P<patch>\d+)(\.?)(?P<release>[a-z]*)(?P<relver>\d*)
-serialize = 
-	{major}.{minor}.{patch}.{release}{relver}
-	{major}.{minor}.{patch}
-commit = True
-tag = False
-sign_tags = True
-tag_name = {new_version}
-message = Release {new_version}
-
-[bumpversion:part:release]
-optional_value = gamma
-values = 
-	dev
-	a
-	b
-	rc
-	gamma
-
-[bumpversion:file:app_helper/__init__.py]
-
 [metadata]
 name = django-app-helper
 version = attr: app_helper.__version__
@@ -81,6 +58,8 @@ cms = django-cms>=3.7,<3.12
 async = 
 	channels
 	daphne
+docs =
+	sphinx-rtd-theme
 
 [upload]
 repository = https://upload.pypi.org/legacy/

tasks.py

@@ -39,8 +39,8 @@ def format(c):  # NOQA
 def towncrier_check(c):  # NOQA
     """Check towncrier files."""
     output = io.StringIO()
-    c.run("git branch --contains HEAD", out_stream=output)
-    skipped_branch_prefix = ["pull/", "develop", "master", "HEAD"]
+    c.run("git branch -a --contains HEAD", out_stream=output)
+    skipped_branch_prefix = ["pull/", "release/", "develop", "master", "HEAD"]
     # cleanup branch names by removing PR-only names in local, remote and disconnected branches to ensure the current
     # (i.e. user defined) branch name is used
     branches = list(
@@ -113,15 +113,18 @@ def tag_release(c, level, new_version=""):
     """Tag release version."""
     if new_version:
         new_version = f" --new-version {new_version}"
-    c.run(f"bumpversion --list {level} --no-tag{new_version}")
+    c.run(f"bump-my-version bump {level}{new_version}")
 
 
 @task
-def tag_dev(c, level="patch", new_version=""):
+def tag_dev(c, level, new_version=""):
     """Tag development version."""
     if new_version:
         new_version = f" --new-version {new_version}"
-    c.run(f"bumpversion --list {level} --message='Bump develop version [ci skip]' --no-tag{new_version}")
+    elif level == "release":
+        c.run("bump-my-version bump patch --no-commit")
+        level = "relver"
+    c.run(f"bump-my-version bump {level} --message='Bump develop version [ci skip]' {new_version} --allow-dirty")
 
 
 @task(pre=[clean])