mirror of https://github.com/Vateron-Media/XC_VM.git synced 2026-10-04 04:02:30 +02:00

Files

T

Divarion_D dbf535bcc5 docs(translate): robust {N} sentinels + possessive handling; regenerate ru

Fix Markdown-mangling artifacts the free web engine (yandex) produced in the
committed docs/ru, and regenerate the whole tree cleanly (0 fallbacks):

- Sentinel format @@N@@ -> {N}. MT engines are trained to preserve curly
  format-string placeholders, so {N} survives code-heavy lines where @@N@@ (and
  ZZZ…ZZZ, which also duplicated its Z) were split/moved — e.g. the stray
  "@0@@" in the FAQ and "load balancerZ" in the README are gone.
- Possessive: a trailing English `'s` is consumed INTO the masked span and
  dropped on restore. Every sentinel format breaks when a bare `'s` sits right
  after it, and Russian has no possessive `'s`.
- Validate + retry: after restore, any leftover brace fragment triggers a retry
  (the engine is non-deterministic); after a few failures the line stays English
  so a broken token is never emitted.
- Glossary += KeyDB, yt-dlp, Ubuntu, iptables, MAGSCAN.

Regenerated docs/ru (37 files, translators/yandex): no residual sentinels,
mkdocs build --strict clean.

2026-08-21 16:31:01 +03:00

2.8 KiB

Raw Blame History

PHPUnit PHAR: Загрузка и запуск тестов

В этом руководстве показано, как запускать тесты проекта с фиксированным двоичным кодом PHP:

PHP двоичный код: /home/xc_vm/bin/php/bin/php
Двоичный файл PHPUnit: local tools/.bin/phpunit.phar

Почему такая установка

phpunit.phar не включает PHP. Он всегда выполняется через интерпретатор PHP.

Если вы запустите ./phpunit.phar напрямую, он может использовать другой php из PATH. Используйте явный двоичный путь для обеспечения согласованности во время выполнения.

1. Проверить PHP

/home/xc_vm/bin/php/bin/php -v

2. Скачать PHPUnit PHAR

Этот проект привязан к PHP версии 8.1, поэтому используйте PHPUnit 10.

cd /home/xc_vm
mkdir -p tools/.bin
wget -O tools/.bin/phpunit.phar https://phar.phpunit.de/phpunit-10.phar
chmod +x tools/.bin/phpunit.phar

3. Проверьте PHPUnit

/home/xc_vm/bin/php/bin/php tools/.bin/phpunit.phar --version

4. Выполните все тесты

Конфигурационный файл проекта:

tests/phpunit.xml.dist

Бежать:

/home/xc_vm/bin/php/bin/php tools/.bin/phpunit.phar -c tests/phpunit.xml.dist

5. Запустите один тестовый файл

/home/xc_vm/bin/php/bin/php tools/.bin/phpunit.phar -c tests/phpunit.xml.dist tests/Unit/GitHubReleasesTest.php

6. Показать, какой тест выполняется сейчас

Используйте режим отладки для печати текущего теста:

/home/xc_vm/bin/php/bin/php tools/.bin/phpunit.phar -c tests/phpunit.xml.dist --debug --no-progress

7. Дополнительно: Выход покрытия

Если установлено значение xdebug или pcov:

XDEBUG_MODE=coverage /home/xc_vm/bin/php/bin/php tools/.bin/phpunit.phar -c tests/phpunit.xml.dist --coverage-text

Защитная записка

Не фиксируйте phpunit.phar в репозитории. Сохраняйте его локальным (tools/.bin) и обновляйте независимо.

Связанные файлы

Файл	Роль
`tools/.bin/phpunit.phar`	Закрепленный двоичный файл PHPUnit
`tests/phpunit.xml.dist`	Конфигурация PHPUnit
`tests/bootstrap.php`	Тестовый bootstrap (Composer автозагрузчик + константы)

2.8 KiB Raw Blame History