Frequenz Repository Configuration Release Notes
Summary
This release brings support for `pytest` 8, a couple of bug fixes and many improvements to the cookiecutter template.
Upgrading
- Once you upgraded, you'll be able to upgrade to `pytest` 8, and indirectly to `sybil` 6, which includes types hints. If you do so, you should remove the `mypy` exception for `sybil` in the `pyproject.toml` file.
Search for the `tool.mypy.overrides` section and remove the `"sybil", "sybil.*"` enties from the `module` list.
Cookiecutter template
To upgrade without regenerating the project, you can follow these steps:
- Run the following command to add the new `pylint` ignore rules:
sh
sed '/ Checked by flake8/a\ "redefined-outer-name",\n "unused-import",' -i pyproject.toml
- It is recommended to update this rule in your repository to use the new bypass rule for the `Protect version branches` ruleset that allows maintainers to force-merge.
You can do this by re-importing the ruleset or manually:
Go to the repository settings -> **Rules** -> **Rulesets** -> **Protect version branches** -> **Bypass list** -> **Add bypass** -> Select **Maintain** role and change the dropdown bypass rule to use **Pull requests** instead of **Always**.
- The `labeler` action was upgraded to 5.0.0. This needs a new configuration file.
If you haven't diverged much from the default configuration (and you are not using exclusion rules), you can update the configuration file by running this script in the root of your repository:
python
import sys
lines = []
state = "looking"
with open(".github/labeler.yml", encoding="utf-8") as fin:
for line in fin:
if "changed-files:" in line:
sys.stderr.write("Already fixed, aborting...\n")
sys.exit(1)
match state:
case "looking":
if not line.startswith(("", " ", "\t")) and line.rstrip().endswith(":"):
line = f"{line} - changed-files:\n - any-glob-to-any-file:\n"
state = "in-label"
case "in-label":
if not line.lstrip().startswith("-"):
state = "looking"
else:
line = f" {line}"
lines.append(line)
with open(".github/labeler.yml", "w", encoding="utf-8") as fout:
fout.writelines(lines)
This will update the file in place, you can inspect the changes with `git diff`.
- For API projects, you can manually add instructions to update the `mkdocs.yml` when the `frequenz-api-common` dependency is updated.
sh
awk -i inplace '/^sed s..frequenz-api-common/ { print; print "sed '"'"'s|https://frequenz-floss.github.io/frequenz-api-common/v[0-9].[0-9]/objects.inv|https://frequenz-floss.github.io/frequenz-api-common/v'"'"'${ver_minor}'"'"'/objects.inv|'"'"' -i mkdocs.yml"; next }1' CONTRIBUTING.md
- Run the following command to fix the `test-installation` CI job when using git URLs in `pyproject.toml`:
sh
patch -p1 <<'EOF'
diff --git a/.github/containers/test-installation/Dockerfile b/.github/containers/test-installation/Dockerfile
index 772b2ae..2494545 100644
--- a/.github/containers/test-installation/Dockerfile
+++ b/.github/containers/test-installation/Dockerfile
-6,7 +6,12
FROM --platform=${TARGETPLATFORM} python:3.11-slim
-RUN python -m pip install --upgrade --no-cache-dir pip
+RUN apt-get update -y && \
+ apt-get install --no-install-recommends -y \
+ git && \
+ apt-get clean && \
+ rm -rf /var/lib/apt/lists/* && \
+ python -m pip install --upgrade --no-cache-dir pip
COPY dist dist
RUN pip install dist/*.whl && \
EOF
- If your repository uses submodules and do cross-arch tests, you need to update the `nox-cross-arch` job in the `.github/workflows/ci.yaml` workflow and add the option `submodules: true` to the `checkout` action, for example:
yaml
steps:
- name: Fetch sources
uses: actions/checkoutv4
with:
submodules: recursive
New Features
- Add support for `pytest` 8.
Cookiecutter template
- Some checks that are already performed by `flake8` are now disabled in `pylint` to avoid double reporting.
- The repository ruleset `Protect version branches` has been updated to allow repository maintainers to skip protection rules in PRs.
- The `labeler` action was upgraded to 5.0.0, which allows for more complex matching rules.
- Instruction were added to update the `mkdocs.yml` when the `frequenz-api-common` dependency is updated.
Bug Fixes
Cookiecutter template
- Fix the `test-installation` CI job when dependencies in `pyproject.toml` contain git URLs.
- Fix cross-arch testing for respositories with submodules.
What's Changed
* Clear release notes by llucax in https://github.com/frequenz-floss/frequenz-repo-config-python/pull/206
* Make copyright year fakable in golden tests by llucax in https://github.com/frequenz-floss/frequenz-repo-config-python/pull/212
* Make GitHub Pages configuration more accesible by llucax in https://github.com/frequenz-floss/frequenz-repo-config-python/pull/214
* Add a few more checks to the `pylint` ignore list by llucax in https://github.com/frequenz-floss/frequenz-repo-config-python/pull/208
* Allow repository maintainers to force-merge by llucax in https://github.com/frequenz-floss/frequenz-repo-config-python/pull/213
* Upgrade to labeler 5.0.0 by llucax in https://github.com/frequenz-floss/frequenz-repo-config-python/pull/211
* Add missing instruction to update dependencies by llucax in https://github.com/frequenz-floss/frequenz-repo-config-python/pull/223
* ci: Support using git for dependencies in `test-installation` by Marenz in https://github.com/frequenz-floss/frequenz-repo-config-python/pull/222
* Update pytest and sybil by Marenz in https://github.com/frequenz-floss/frequenz-repo-config-python/pull/221
* Fetch submodules when doing cross-arch tests by llucax in https://github.com/frequenz-floss/frequenz-repo-config-python/pull/225
* Prepare release notes for v0.9.0 by llucax in https://github.com/frequenz-floss/frequenz-repo-config-python/pull/227
**Full Changelog**: https://github.com/frequenz-floss/frequenz-repo-config-python/compare/v0.8.0...v0.9.0