chore(release): bump version

Author: TheKevJames

CHANGELOG.md

@@ -1,3 +1,17 @@
+<a name="4.1.0"></a>
+## 4.1.0 (2026-02-28)
+
+### Features
+
+- *(deps)* Migrate from docopt to typer (no more deprecation warnings in recent Python versions!)
+
+### Internal
+
+- *(api)* Add more tests to improve coverage
+- *(mypy)* Enable (non-strict) type checking
+- *(lint)* Enable refurb
+- *(renovate)* Pin max compatible sphinx version
+
 <a name="4.0.2"></a>
 ## 4.0.2 (2025-11-07)
 

cliff.toml

@@ -0,0 +1,52 @@
+[changelog]
+body = """
+{% if version %}\
+    ## [{{ version | trim_start_matches(pat="v") }}] - {{ timestamp | date(format="%Y-%m-%d") }}
+{% else %}\
+    ## [unreleased]
+{% endif %}\
+{% for group, commits in commits | group_by(attribute="group") %}
+    ### {{ group | striptags | trim | upper_first }}
+    {% for commit in commits %}
+        - {% if commit.scope %}*({{ commit.scope }})* {% endif %}\
+            {% if commit.breaking %}[**breaking**] {% endif %}\
+            {{ commit.message | upper_first }}\
+    {% endfor %}
+{% endfor %}
+"""
+trim = true
+render_always = true
+postprocessors = [
+    { pattern = '<REPO>', replace = "https://github.com/TheKevJames/coveralls-python" },
+]
+# output = "CHANGELOG.md"
+
+[git]
+conventional_commits = true
+filter_unconventional = false
+require_conventional = false
+split_commits = false
+commit_preprocessors = [
+    { pattern = "(?s)\n.*$", replace = "" },
+]
+protect_breaking_commits = false
+commit_parsers = [
+    { message = "^feat", group = "<!-- 0 -->Features" },
+    { message = "^fix", group = "<!-- 1 -->Bug Fixes" },
+    { message = "^perf", group = "<!-- 2 -->Performance" },
+    { message = "^doc", group = "<!-- 3 -->Documentation" },
+    { message = "^refactor", group = "<!-- 3 -->Internal" },
+    { message = "^test", group = "<!-- 3 -->Internal" },
+    { message = "^chore\\(release\\): ", skip = true },
+    { message = "^chore\\(deps.*\\)", skip = true },
+    { message = "^chore", group = "<!-- 3 -->Internal" },
+    { message = ".*", group = "<!-- 4 -->Other Changes" },
+]
+filter_commits = false
+fail_on_unmatched_commit = false
+link_parsers = []
+use_branch_tags = false
+topo_order = false
+topo_order_commits = true
+sort_commits = "oldest"
+recurse_submodules = false

docs/release.rst

@@ -1,29 +1,37 @@
 Release
 =======
 
-This project is released on PyPI as `coveralls`_, as well as on `quay`_ and `dockerhub`_.
+This project is released on PyPI as `coveralls`_, as well as on `quay`_ and
+`dockerhub`_. To cut a new release, ensure the latest master passes all tests.
+Then, create a release commit:
 
-TODO: migrate from clog-cli to git-cliff.
+.. code-block:: bash
 
-To cut a new release, ensure the latest master passes all tests. Then, create a release commit:
+    git cliff -u | pbcopy  # prepend to CHANGELOG.md
+    poetry version (major|minor|patch)
+    poetry lock --regenerate
+    poetry sync
+    poetry run pytest
+    git commit -am 'chore(release): bump version'
+    git push
+    git tag $(poetry version | cut -f2 -d' ')
+    git push origin $(poetry version | cut -f2 -d' ')
+
+Then:
 
-#. Update the ``CHANGELOG.md`` with the new version (``clog -C CHANGELOG.md -F --setversion x.y.z``).
-#. Bump the version number with poetry: ``poetry version (major|minor|patch)``.
-#. Commit and push (``git commit -am 'chore(release): bump version' && git push``)
-#. Tag and push that commit with the version number (``git tag x.y.z && git push origin x.y.z``).
 #. Create a new `GitHub release`_.
 #. Verify the `docs build succeeded`_ then `mark it active`_.
 
-Conda should automatically create a PR on their `coveralls-feedstock`_ shortly with the updated version -- if something goes wrong, the manual process would be to:
+Conda should automatically create a PR on their `coveralls-feedstock`_ shortly
+with the updated version -- if something goes wrong, the manual process would
+be to:
 
 #. Fork `coveralls-feedstock`_.
 #. Update ``recipe/meta.yaml`` with the new version number and `sha`_.
 #. Create a PR.
 #. Comment on your own PR with: "@conda-forge-admin, please rerender".
 #. Merge along with the automated commit from Conda.
 
-Note that the ``clog`` command comes from ``cargo install clog-cli``.
-
 .. _GitHub release: https://github.com/TheKevJames/coveralls-python/releases/new
 .. _coveralls-feedstock: https://github.com/conda-forge/coveralls-feedstock
 .. _coveralls: https://pypi.org/project/coveralls/