Modernize for Python 3.10-3.14

.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions: {}
+
+jobs:
+  lint:
+    name: Lint and type-check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+        with:
+          fetch-depth: 0 # hatch-vcs needs tags to build the project for pyright
+      - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+      - run: uvx pre-commit run --all-files
+        env:
+          SKIP: no-commit-to-branch # this guard is local-only; CI runs on main
+
+  test:
+    name: Test on Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+        with:
+          fetch-depth: 0 # hatch-vcs needs tags to build the project
+      - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+      - run: uv run --python ${{ matrix.python-version }} --group test pytest

.github/workflows/publish.yml

@@ -0,0 +1,24 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions: {}
+
+jobs:
+  publish:
+    name: Build and publish
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/deslackify/
+    permissions:
+      id-token: write # trusted publishing to PyPI (no API token)
+    steps:
+      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+        with:
+          fetch-depth: 0 # full history + tags so hatch-vcs can derive the version
+      - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+      - run: uv build
+      - run: uv publish --trusted-publishing always

.gitignore

@@ -1,10 +1,12 @@
-*.egg
 *.egg-info/
-*.eggs/
 *.pyc
 *~
 .coverage
+.pytest_cache/
+.ruff_cache/
+.venv/
+__pycache__/
 _build/
 build/
 dist/
-pip-wheel-metadata/
+htmlcov/

.pre-commit-config.yaml

@@ -1,8 +1,55 @@
-default_language_version:
-  python: python3.7
-fail_fast: true
 repos:
   - hooks:
-      - id: black
-    repo: https://github.com/ambv/black
-    rev: stable
+      - id: docstrfmt
+        require_serial: true
+    repo: https://github.com/LilSpazJoekp/docstrfmt
+    rev: 8688ba6420d7b5ca95a8ba0edf8a9953babdc3da  # frozen: v2.1.1
+
+  - hooks:
+      - id: codesorter
+    repo: https://github.com/praw-dev/CodeSorter
+    rev: 8aa6144b41e0f789124b2ca377d246ffd1fbb317  # frozen: v0.2.7
+
+  - hooks:
+      - id: auto-walrus
+    repo: https://github.com/MarcoGorelli/auto-walrus
+    rev: 1743edbed52f3d61886b59d98a27164a8af29c0d  # frozen: 0.4.1
+
+  - hooks:
+      - args: [--fix]
+        id: ruff-check
+      - id: ruff-format
+    repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: 3b3f7c3f57fe9925356faf5fe6230835138be230  # frozen: v0.15.17
+
+  - hooks:
+      - files: ^(.*\.toml)$
+        id: toml-sort-fix
+    repo: https://github.com/pappasam/toml-sort
+    rev: 2970ae9bb7124fe5117a27e10c10d2da051ce05a  # frozen: v0.24.4
+
+  - hooks:
+      - id: check-added-large-files
+      - id: check-executables-have-shebangs
+      - id: check-shebang-scripts-are-executable
+      - id: check-toml
+      - id: check-yaml
+      - id: end-of-file-fixer
+      - args: [--fix=lf]
+        id: mixed-line-ending
+      - args: [--pytest-test-first]
+        files: ^tests/.*\.py$
+        id: name-tests-test
+      - id: no-commit-to-branch
+      - id: trailing-whitespace
+    repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: 3e8a8703264a2f4a69428a0aa4dcb512790b2c8c  # frozen: v6.0.0
+
+  - hooks:
+      - entry: uv run --group dev pyright
+        id: pyright
+        language: system
+        name: pyright
+        pass_filenames: false
+        types: [python]
+    repo: local

README.md

@@ -6,10 +6,14 @@ A tool to remove your own slack messages.
 authenticates as your own account, so it cannot remove messages authored by
 other users.
 
+`deslackify` supports Python 3.10 through 3.14.
+
 ## Installation
 
+Install the `deslackify` command with [uv](https://docs.astral.sh/uv/):
+
 ```sh
-pip install deslackify
+uv tool install deslackify
 ```
 
 ## Obtaining a Slack Token
@@ -31,6 +35,12 @@ so they can no longer be generated. Use a Slack app user token instead:
 deslackify --token TOKEN USERNAME
 ```
 
+Or run it once without installing:
+
+```sh
+uvx deslackify --token TOKEN USERNAME
+```
+
 By default `deslackify` will remove USERNAME's messages that are more than a
 year old. You may also manually specify a `before` date via:
 
@@ -40,4 +50,4 @@ deslackify --token TOKEN --before YYYY-MM-DD USERNAME
 
 __Note__: If no results are found, you may need to replace `USERNAME` with
 `USERID`. You can find the `USERID` by going to `Profile & Account`, and then
-clicking the three dots, and at the bottom, "Copy member ID".
+clicking the three dots, and at the bottom, "Copy member ID".