alexei.dolgolyov cfdafa9c2b docs(gitea-python-ci-cd): venv install for monorepos + hatchling METADATA workaround
Two real failures hit during notify-bridge v0.8.1 release that section 1
and section 10.1 didn't cover:

1. New section 1.1 — backend pytest in a per-run /tmp/venv. Single-package
   ephemeral runners get away with pip install -e into the toolcache;
   monorepos on persistent Gitea Act Runners (TrueNAS) hit
   "error: uninstall-no-record-file" the second time a broken wheel
   install leaks across runs. Venv per run, fresh site-packages, no leak.

2. New section 10.1.1 — pip wheel --no-deps on hatchling has been
   observed to produce wheels with METADATA missing the Version field.
   importlib.metadata.version() returns None and the UI advertises
   0.0.0+unknown. Defense-in-depth: also expose __version__ from
   __init__.py and pick the max of (metadata, __version__, source
   pyproject) in the resolver. Documented when it's needed and when
   section 10.1 alone is fine.

3. New section 14 troubleshooting entry — quotes the exact pip error
   message and points at section 1.1 (prevention) and a one-shot
   site-packages cleanup recipe (recovery on a stuck runner).
2026-05-16 18:43:55 +03:00

Claude Code Facts

Last updated: 2026-05-16

A collection of interesting and useful facts, tips, tools, and guides for working with Claude and Claude Code.

Contents

Claude Code Tools & Extensions

MCP servers, skills, and plugins that extend Claude Code — including Context7 (library docs) and AST Index (fast code search).

Gitea Release Workflow (Minimal)

Minimal Gitea Actions workflow: push a v* tag → create a Gitea release with optional RELEASE_NOTES.md. No builds, no artifacts — just a release entry.

CI/CD for Python Apps on Gitea

Reusable reference for building CI pipelines, release automation, and installer packaging for Python apps on Gitea — covering lint/test workflows, cross-compiled Windows builds (embedded Python + NSIS), Linux tarballs, Docker images, and Gitea REST API release management.

Windows Code Signing for Open-Source Projects

Review of code signing options for Windows executables — Azure Trusted Signing ($9.99/mo, immediate SmartScreen trust), SignPath.io (free but GitHub-only), SSL.com, Certum, and self-signed. Includes CI/CD integration examples for Gitea Actions.

Gitea Act Runner — Worker Capacity (TrueNAS)

How to configure parallel job capacity for Gitea Act Runner on TrueNAS. Covers the CONFIG_FILE env var requirement, custom config.yaml mount, and capacity tuning.

S
Description
The repo contains useful information about CI/CD and Claude.
Readme 903 KiB
Languages
Markdown 100%