chore: better attempt at migrating to modern tooling

Author: foosel

.github/workflows/build.yml

@@ -18,10 +18,10 @@ jobs:
           python-version: "3.10"
       - name: 🏗 Install build dependencies
         run: >-
-          python -m pip install wheel --user
+          python -m pip install build --user
       - name: 🔨 Build a binary wheel and a source tarball
         run: >-
-          python setup.py sdist bdist_wheel
+          python -m build
       - name: ⬆ Upload build result
         uses: actions/upload-artifact@v4
         with:
@@ -44,6 +44,23 @@ jobs:
         run: |
           pre-commit run --all-files --show-diff-on-failure
 
+  test-install:
+    name: 🧪 Installation test
+    strategy:
+      matrix:
+        python: ["3.7", "3.8", "3.9", "3.10", "3.11", "3.12"]
+    runs-on: ubuntu-22.04 # change back to ubuntu-latest once we drop Python 3.7
+    steps:
+      - uses: actions/checkout@v4
+      - name: 🏗 Set up Python ${{ matrix.python }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python }}
+      - name: 🚀 Set up test dependencies & run test install
+        run: |
+          pip install octoprint
+          pip install -e .[develop]
+
   e2e:
     name: 🧪 E2E tests
     needs: build

Taskfile.yml

@@ -0,0 +1,82 @@
+
+# https://taskfile.dev
+
+version: "3"
+
+env:
+    LOCALES: ['de']  # list your included locales here, e.g. ["de", "fr"]
+    TRANSLATIONS: "octoprint_file_check/translations"  # translations folder, do not touch
+
+
+tasks:
+    install:
+        desc: Installs the plugin into the current venv
+        cmds:
+          - "python -m pip install -e .[develop]"
+
+    ### Build related
+
+    build:
+        desc: Builds sdist & wheel
+        cmds:
+          - python -m build --sdist --wheel
+
+    build-sdist:
+        desc: Builds sdist
+        cmds:
+          - python -m build --sdist
+
+    build-wheel:
+        desc: Builds wheel
+        cmds:
+          - python -m build --wheel
+
+    ### Translation related
+
+    babel-new:
+        desc: Create a new translation for a locale
+        cmds:
+          - task: babel-extract
+          - |
+                pybabel init --input-file=translations/messages.pot --output-dir=translations --locale="{{ .CLI_ARGS }}"
+
+    babel-extract:
+        desc: Update pot file from source
+        cmds:
+          - pybabel extract --mapping-file=babel.cfg --output-file=translations/messages.pot --msgid-bugs-address=i18n@octoprint.org --copyright-holder="The OctoPrint Project" .
+
+    babel-update:
+        desc: Update translation files from pot file
+        cmds:
+          - for:
+                var: LOCALES
+            cmd: pybabel update --input-file=translations/messages.pot --output-dir=translations --locale={{ .ITEM }}
+
+    babel-refresh:
+        desc: Update translation files from source
+        cmds:
+          - task: babel-extract
+          - task: babel-update
+
+    babel-compile:
+        desc: Compile translation files
+        cmds:
+          - pybabel compile --directory=translations
+
+    babel-bundle:
+        desc: Bundle translations
+        preconditions:
+          - test -d {{ .TRANSLATIONS }}
+        cmds:
+          - for:
+                var: LOCALES
+            cmd: |
+                locale="{{ .ITEM }}"
+                source="translations/${locale}"
+                target="{{ .TRANSLATIONS }}/${locale}"
+
+                [ ! -d "${target}" ] || rm -r "${target}"
+
+                echo "Copying translations for locale ${locale} from ${source} to ${target}..."
+                cp -r "${source}" "${target}"
+

pyproject.toml

@@ -1,10 +1,49 @@
 [build-system]
-requires = ["setuptools>=40.8.0", "wheel"]
+requires = [
+    "setuptools>=68",
+]
 build-backend = "setuptools.build_meta"
 
+[project]
+name = "OctoPrint-FileCheck"
+version = "2024.11.12"
+description = "Checks for common issues in uploaded files"
+authors = [
+    { name = "Gina Häußge", email = "gina@octoprint.org" },
+]
+requires-python = ">=3.7,<4"
+dependencies = []
+dynamic = [
+    "license",
+]
+
+[project.entry-points."octoprint.plugin"]
+file_check = "octoprint_file_check"
+
+[project.urls]
+Homepage = "https://github.com/OctoPrint/OctoPrint-FileCheck"
+
+[project.optional-dependencies]
+develop = [
+    "pre-commit",
+    "go-task-bin",
+]
+
+[project.readme]
+file = "README.md"
+content-type = "markdown"
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+include = [
+    "octoprint_file_check",
+    "octoprint_file_check.*",
+]
+
 [tool.ruff]
 exclude = [
-    # standard stuff
     ".bzr",
     ".direnv",
     ".eggs",
@@ -32,15 +71,20 @@ exclude = [
     "site-packages",
     "venv",
 ]
-
 line-length = 90
 indent-width = 4
-
-# Assume Python 3.7
 target-version = "py37"
 
 [tool.ruff.lint]
-select = ["B", "C", "E", "F", "I", "W", "B9"]
+select = [
+    "B",
+    "C",
+    "E",
+    "F",
+    "I",
+    "W",
+    "B9",
+]
 ignore = [
     "E203",
     "E231",
@@ -53,9 +97,11 @@ ignore = [
     "W605",
     "C901",
 ]
-fixable = ["I", "C4", "E"]
-
-# Allow unused variables when underscore-prefixed.
+fixable = [
+    "I",
+    "C4",
+    "E",
+]
 dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
 
 [tool.ruff.lint.isort]
@@ -68,17 +114,5 @@ quote-style = "double"
 indent-style = "space"
 skip-magic-trailing-comma = false
 line-ending = "lf"
-
-# Enable auto-formatting of code examples in docstrings. Markdown,
-# reStructuredText code/literal blocks and doctests are all supported.
-#
-# This is currently disabled by default, but it is planned for this
-# to be opt-out in the future.
 docstring-code-format = false
-
-# Set the line length limit used when formatting code snippets in
-# docstrings.
-#
-# This only has an effect when the `docstring-code-format` setting is
-# enabled.
 docstring-code-line-length = "dynamic"