Configuring with plone/meta

.editorconfig

@@ -0,0 +1,39 @@
+# Generated from:
+# https://github.com/plone/meta/tree/master/config/default
+#
+# EditorConfig Configuration file, for more details see:
+# http://EditorConfig.org
+# EditorConfig is a convention description, that could be interpreted
+# by multiple editors to enforce common coding conventions for specific
+# file types
+
+# top-most EditorConfig file:
+# Will ignore other EditorConfig files in Home directory or upper tree level.
+root = true
+
+
+[*]  # For All Files
+# Unix-style newlines with a newline ending every file
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+# Set default charset
+charset = utf-8
+# Indent style default
+indent_style = space
+# Max Line Length - a hard line wrap, should be disabled
+max_line_length = off
+
+[*.{py,cfg,ini}]
+# 4 space indentation
+indent_size = 4
+
+[*.{yml,zpt,pt,dtml,zcml}]
+# 2 space indentation
+indent_size = 2
+
+[{Makefile,.gitmodules}]
+# Tab indentation (no size specified, but view as 4 spaces)
+indent_style = tab
+indent_size = unset
+tab_width = unset

.github/workflows/linting.yml

@@ -0,0 +1,39 @@
+# Generated from:
+# https://github.com/plone/meta/tree/master/config/default
+name: Linting
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+  workflow_dispatch:
+
+jobs:
+  test:
+    name: Lint code
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        python-version: ["3.8"]
+        os: ["ubuntu-22.04"]
+    steps:
+      - uses: actions/checkout@v3
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Cache packages
+        uses: actions/cache@v3
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ matrix.python-version }}-${{ hashFiles('lint-requirements.txt', 'tox.ini') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-${{ matrix.python-version }}-
+            ${{ runner.os }}-pip-
+      - name: Install dependencies
+        run: python -m pip install tox
+      - name: Run formatters
+        run: tox -e format
+      # linters
+      - name: QA
+        run: tox -e lint

.meta.toml

@@ -0,0 +1,5 @@
+# Generated from:
+# https://github.com/plone/meta/tree/master/config/default
+[meta]
+template = "default"
+commit-id = "c0d7e43c"

lint-requirements.txt

@@ -0,0 +1,8 @@
+# Generated from:
+# https://github.com/plone/meta/tree/master/config/default
+black==22.12.0
+check-manifest==0.49
+codespell==2.2.2
+flake8==6.0.0
+isort==5.11.4
+pyupgrade==3.3.1

pyproject.toml

@@ -1,3 +1,5 @@
+# Generated from:
+# https://github.com/plone/meta/tree/master/config/default
 [tool.towncrier]
 filename = "CHANGES.rst"
 directory = "news/"
@@ -18,3 +20,24 @@ showcontent = true
 directory = "bugfix"
 name = "Bug fixes:"
 showcontent = true
+
+[[tool.towncrier.type]]
+directory = "internal"
+name = "Internal:"
+showcontent = true
+
+[[tool.towncrier.type]]
+directory = "documentation"
+name = "Documentation:"
+showcontent = true
+
+[[tool.towncrier.type]]
+directory = "tests"
+name = "Tests"
+showcontent = true
+
+[tool.isort]
+profile = "plone"
+
+[tool.black]
+target-version = ["py38"]

setup.cfg

@@ -1,2 +1,23 @@
+# Generated from:
+# https://github.com/plone/meta/tree/master/config/default
 [bdist_wheel]
 universal = 0
+
+[flake8]
+doctests = 1
+ignore =
+    # black takes care of line length
+    E501,
+    # black takes care of where to break lines
+    W503,
+    # black takes care of spaces within slicing (list[:])
+    E203,
+    # black takes care of spaces after commas
+    E231,
+
+[check-manifest]
+ignore =
+    .editorconfig
+    .meta.toml
+    tox.ini
+    lint-requirements.txt

tox.ini

@@ -0,0 +1,39 @@
+# Generated from:
+# https://github.com/plone/meta/tree/master/config/default
+[tox]
+envlist =
+    format
+    lint
+
+[testenv]
+py_files = git ls-files "*.py"
+text_files = git ls-files "*.rst" "*.md"
+allowlist_externals =
+    sh
+
+[testenv:format]
+description = automatically reformat python code
+skip_install = true
+deps =
+    pyupgrade
+    isort
+    black
+    -c lint-requirements.txt
+commands =
+    sh -c '{[testenv]py_files} | xargs pyupgrade --py38-plus'
+    sh -c '{[testenv]py_files} | xargs isort'
+    sh -c '{[testenv]py_files} | xargs black'
+
+[testenv:lint]
+description = run linters that will help improve the code style
+skip_install = true
+deps =
+    flake8
+    codespell
+    check-manifest
+    -c lint-requirements.txt
+commands =
+    sh -c '{[testenv]py_files} | xargs flake8'
+    sh -c '{[testenv]py_files} | xargs codespell'
+    sh -c '{[testenv]text_files} | xargs codespell'
+    check-manifest