diff --git a/.github/workflows/check-links.yml b/.github/workflows/check-links.yml new file mode 100644 index 0000000..9b1dbd3 --- /dev/null +++ b/.github/workflows/check-links.yml @@ -0,0 +1,54 @@ +name: Check external links + +on: + schedule: + - cron: "0 6 * * 1" # понедельник 06:00 UTC + workflow_dispatch: + +permissions: + contents: read + issues: write + actions: write # для keepalive-шага + +jobs: + link-check: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + + - name: Run lychee + id: lychee + uses: lycheeverse/lychee-action@v2 + with: + # остальные настройки — в lychee.toml в корне репозитория + args: --no-progress './**/*.md' + fail: false + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + + # если открытый issue с меткой link-check уже есть — обновляем его, + # а не создаём дубликат каждую неделю + - name: Find open link-check issue + if: steps.lychee.outputs.exit_code != 0 + id: issue + run: | + echo "number=$(gh issue list --repo "$GITHUB_REPOSITORY" --label link-check --state open --json number --jq '.[0].number // empty')" >> "$GITHUB_OUTPUT" + env: + GH_TOKEN: ${{ github.token }} + + - name: Create or update issue on broken links + if: steps.lychee.outputs.exit_code != 0 + uses: peter-evans/create-issue-from-file@v5 + with: + title: "Битые внешние ссылки: еженедельная проверка" + content-filepath: ./lychee/out.md + labels: link-check + issue-number: ${{ steps.issue.outputs.number }} + + # GitHub отключает scheduled-workflows после 60 дней без активности + # в репозитории; повторное включение сбрасывает таймер + - name: Keep scheduled workflow enabled + if: always() + run: gh api -X PUT "repos/$GITHUB_REPOSITORY/actions/workflows/check-links.yml/enable" + env: + GH_TOKEN: ${{ github.token }} diff --git a/README.md b/README.md index 72bc739..f569218 100644 --- a/README.md +++ b/README.md @@ -135,7 +135,7 @@ SQL и моделирование данных специально идут р - [Работа с файлами в формате CSV, JSON, YAML](https://pyneng.readthedocs.io/ru/latest/book/17_serialization/index.html) - [Итераторы, итерируемые объекты и генераторы](https://pyneng.readthedocs.io/ru/latest/book/13_iterator_generator/index.html) - [Декораторы Python: пошаговое руководство](https://habr.com/ru/companies/otus/articles/727590/) - - Работа с датой/временем: [официальная документация по модулю datetime](https://docs.python.org/ru/3/library/datetime.html) + - Работа с датой/временем: [официальная документация по модулю datetime](https://docs.python.org/3/library/datetime.html) - [Сложность алгоритмов. Разбор Big O](https://habr.com/ru/articles/782608/) — короткий материал, чтобы понимать O(n) vs O(n²) на собеседованиях и в коде - ООП - [Tproger: «ООП простыми словами»](https://tproger.ru/experts/oop-in-simple-words) diff --git a/lychee.toml b/lychee.toml new file mode 100644 index 0000000..4e59466 --- /dev/null +++ b/lychee.toml @@ -0,0 +1,29 @@ +# Конфигурация lychee — CI-проверка внешних ссылок +# Используется в .github/workflows/check-links.yml (подхватывается автоматически) +# Локальный запуск: docker run --rm -v "$PWD:/input" -w /input lycheeverse/lychee './**/*.md' + +# Служебные каталоги и каталоги, исключённые из сайта +exclude_path = ["project", "site"] + +# Локальные адреса стендов (127.0.0.1, localhost и т.п.) +exclude_all_private = true + +exclude = [ + # Режут ботов и датацентровые IP (проверять вручную из браузера) + "^https?://habr\\.com", + "^https?://stepik\\.org", + "^https?://leetcode\\.com", + "^https?://realpython\\.com", + # YouTube в CI ненадёжен: 429 на пачку запросов, удалённые видео отдают 200 + "^https?://(www\\.)?youtube\\.com", + "^https?://youtu\\.be", + # Telegram отдаёт 200 даже для несуществующих каналов + "^https?://t\\.me", +] + +# 429 (rate limit) не считаем битой ссылкой +accept = ["200..=204", "429"] + +max_retries = 2 +timeout = 30 +user_agent = "Mozilla/5.0 (X11; Linux x86_64; rv:128.0) Gecko/20100101 Firefox/128.0" diff --git a/project/TODO.md b/project/TODO.md index e9b3d58..621d597 100644 --- a/project/TODO.md +++ b/project/TODO.md @@ -4,13 +4,6 @@ ## P1 -- [ ] **CI-проверка внешних ссылок.** - В роадмапе ~100 внешних ссылок, репозиторий правится редко — ссылки гниют молча. - GitHub Action (например, lychee) по расписанию раз в неделю, с игнор-листом - доменов, режущих ботов (habr, stepik, leetcode, realpython и т.п. отвечают - только браузерам). Аудит 2026-07-12 нашёл битые ссылки вручную — автоматика - избавит от повторов. - - [ ] **Подраздел «Linux и терминал» в блоке базовых инструментов.** Единственный пробел заявленной базы: в роадмапе нет ни одного упоминания bash/ssh/командной строки, при этом все стенды консольные (docker compose, @@ -54,6 +47,12 @@ ## Сделано +- [x] **CI-проверка внешних ссылок** — 2026-07-12: `lychee.toml` + workflow + `check-links.yml` (еженедельно по понедельникам, при битых ссылках создаёт + issue). Игнор-лист: habr, stepik, leetcode, realpython (режут ботов), + YouTube и t.me (проверка ненадёжна). Попутно исправлена битая ссылка на + русские доки Python в README (перевод `/ru/` на docs.python.org умер целиком). + - [x] **Убрать раздел «Понятие сложности алгоритмов» из README** — 2026-07-12, коммит `6f61c0e`: асимптотика перенесена в Python ссылкой на разбор Big O (habr), по SQL — без дублирования, тему покрывает QPT.