refactor: replace `darglint` with `pydoclint` #969

	name: Snippets

	on:
	push:
	branches: [main]
	pull_request:
	workflow_dispatch:

	env:
	POETRY_VERSION: 1.8.3

	jobs:
	snippet-test:
	name: Snippet test
	runs-on: ubuntu-latest
	strategy:
	matrix:
	python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]

	steps:
	- name: Checkout code
	uses: actions/checkout@v4

	- name: Load cached .local
	id: cache-poetry
	uses: actions/cache@v4
	with:
	path: /home/runner/.local
	key: dotlocal-${{ env.POETRY_VERSION }}

	- name: Install poetry
	if: steps.cache-poetry.outputs.cache-hit != 'true'
	run: \|
	curl -sSL https://install.python-poetry.org/ \| python - --version ${{ env.POETRY_VERSION }}
	echo "$HOME/.local/bin" >> $GITHUB_PATH

	- name: Install Python + Retrieve Poetry dependencies from cache
	uses: actions/setup-python@v5
	with:
	python-version: ${{ matrix.python-version }}
	cache: "poetry"

	- name: Display Python version
	run: \|
	python -c "import sys; print(sys.version)"

	- name: Install poetry dependencies
	run: poetry install

	- name: Run Snippets
	run: (for i in snippets/*.py; do echo "Running $i" && poetry run python $i \|\| exit 1; done)

Provide feedback