docs(readme): document import checker and update file map

Author: DiogoRibeiro7

.github/workflows/auto-pyproject-update.yml

@@ -0,0 +1,48 @@
+# .github/workflows/auto-pyproject-update.yml
+name: Auto update pyproject
+
+on:
+  push:
+    branches: [ "main" ]
+
+permissions:
+  contents: write
+
+jobs:
+  bump:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install editor deps
+        run: |
+          python -m pip install --upgrade pip
+          pip install tomlkit
+
+      - name: Decide bump level from commit message
+        id: decide
+        run: |
+          msg="$(git log -1 --pretty=%B)"
+          level="patch"
+          if echo "$msg" | grep -qi "breaking change"; then level="major"; fi
+          if echo "$msg" | grep -qi "^feat:"; then level="minor"; fi
+          echo "level=$level" >> "$GITHUB_OUTPUT"
+
+      - name: Bump version
+        run: |
+          python scripts/pyproject_editor.py bump-version "${{ steps.decide.outputs.level }}"
+
+      - name: Commit & push if changed
+        run: |
+          if ! git diff --quiet; then
+            git config user.name "github-actions[bot]"
+            git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+            git add pyproject.toml
+            git commit -m "chore: bump version (${{ steps.decide.outputs.level }}) [skip ci]"
+            git push
+          fi

.github/workflows/auto-upgrade-pyproject.yml

@@ -0,0 +1,47 @@
+# .github/workflows/auto-upgrade-pyproject.yml
+name: Auto upgrade pyproject constraints
+
+on:
+  schedule:
+    - cron: "0 6 * * 1"   # Mondays 06:00 UTC
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  upgrade:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install deps
+        run: |
+          python -m pip install --upgrade pip
+          pip install tomlkit packaging
+
+      - name: Run updater (caret, no majors, no pre-releases)
+        run: |
+          python scripts/pyproject_updater.py --strategy caret --groups main,dev --respect-major --no-prerelease
+
+      - name: Create PR if changed
+        run: |
+          if ! git diff --quiet; then
+            git checkout -b chore/upgrade-pyproject-constraints
+            git config user.name "github-actions[bot]"
+            git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+            git add pyproject.toml
+            git commit -m "chore: upgrade dependency constraints in pyproject"
+            git push --force --set-upstream origin chore/upgrade-pyproject-constraints
+            gh pr create --title "chore: upgrade pyproject constraints" \
+                         --body "Automated update of dependency constraints via PyPI latest." \
+                         --base "${GITHUB_REF_NAME:-main}" || true
+          fi
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

pyproject.toml

@@ -12,7 +12,9 @@ repository = "https://github.com/DiogoRibeiro7/my_python_package"
 python = ">=3.10"
 
 [tool.poetry.dev-dependencies]
-pytest = "^8.0.0"
+pytest = "^8.4.1"
+tomlkit = "^0.13.3"
+packaging = "^25.0"
 
 [build-system]
 requires = ["poetry-core"]