Упрощаем тесты с участием файлов

Представим, что мы написали функцию parseCSVFile, которая принимает путь до CSV-файла и возвращает распарсенные данные в удобном нам формате. Как её протестировать?

Первая мысль — написать несколько CSV-файликов, положить их рядом с тестом, а в самом тесте сравнить результат их парсинга с ожидаемыми значениями. Очень просто, но неудобно: тест разбросан по нескольким файлам, сложно читать и вносить изменения.

Вторая мысль — mikey179/vfsstream. Это пакет, который позволяет налету в памяти создавать файловую систему и взаимодействовать с ней как с реальной. Круто, но для тестирования нашей простенькой функции слишком мощно.

А теперь третий вариант, оптимальный. В PHP есть data stream wrapper (а-ля RFC 2397), который позволяет инлайнить содержимое файла прямо в "путь". Формула проста: data://{MIME-тип},{Содержимое}. В итоге тест будет выглядеть так:

$csv = <<<'CSV'
    data://text/csv,PHP Version,2022-01,2022-07,2023-01,2023-07
    8.0,23.9%,20.6%,16.2%,12.3%
    8.1,9.1%,24.5%,38.8%,39.3%
    8.2,0.0%,0.0%,4.7%,17.2%
    CSV;
$expected = [...];

$parsed = parseCSVFile($csv);

self::assertSame($expected, $parsed);

https://www.php.net/manual/ru/wrappers.data.php

Курсы, деньги, две работы

Вчера с Петром записали подкаст про мои пертурбации в этом году. Рассказал, почему я ушёл с двух работ подряд, как запустил курс хардкорного PHP ну и конечно же про доходы.

https://news.1rj.ru/str/tg_5minphp/1214

Service Dumper Bundle

При работе с DI в Symfony бывает полезно вывести сервис на экран, чтобы убедиться, что он правильно сконфигурирован. Да, есть очень полезные команды debug:container, debug:autowiring и lint:container, они помогают отладить контейнер, но это не то же самое, что увидеть дамп реального объекта.

Год назад я добавил в проект консольную команду, которая выводила на экран любой сервис. Для простоты она переиспользовала test.service_container из FrameworkBundle для доступа к приватным сервисам.

Недавно утилитка пригодилась мне на курсе. Когда мы проходим Symfony Dependency Injection, я всегда показываю, как выглядят сконфигурированные серисы в рантайме. Становится гораздо понятнее, как работает тот же tagged_locator или inline_service.

До сих пор я таскал команду из проекта в проект, но вчера, наконец, оформил её в виде бандла. На этот раз я скопировал и упростил оригинальные TestServiceContainerWeakRefPass и TestServiceContainerRealRefPass, чтобы не зависеть от FrameworkBundle и деталей объявления test.service_container, добавил разные варианты вывода сервисов на экран (var_dump, symfony/var-dumper, xdebug_break, кастом), а также разрешил менять алгоритм поиска сервисов по id.

В общем, ставьте, пробуйте, предлагайте идеи по улучшению!

https://github.com/phpyh/service-dumper-bundle

Кэш через OPcache на RnD PHP #6

Трансляция: https://www.youtube.com/live/8ZzAqhgmBFg?t=204
Слайды: https://vudaltsov.github.io/cache-via-opcache/

Мои слайды: https://vudaltsov.github.io/php83-slides/

new MyClass()->method() без скобок!

Вдохновлённый митапом, разобрался с синтаксисом Bison и закинул свой первый Pull Request в исходники PHP. Это изменение позволит обращаться к объектам, созданным через new, не оборачивая их в скобки. Во избежание неоднозначности работать будет только при наличии скобок аргументов конструктора.

final class A
{
   const CONSTANT = 'constant';
   public static $staticProperty = 'staticProperty';
   public static function staticMethod() {}
   public $property = 'property';
   public function method() {}
   public function __invoke() {}
}

new A()::CONSTANT;
new A()::$staticProperty;
new A()::staticMethod();
new A()->property;
new A()->method();
new A()();

Поддерживаются также динамические имена классов и анонимные классы (см. тесты).

После первичного одобрения сделаю RFC. Пока накидайте лайков в PR, пожалуйста.

https://github.com/php/php-src/pull/13029

Разберу самый частый комментарий к моему PR.

Многие полагают, что конструкция new A()->method() неоднозначна. Это заблуждение. По этой логике само выражение new A() в текущем PHP тоже неоднозначно, потому что можно представить, что сначала вызывается функция A(), а потом к её результату применяется new. Но это не так.

Грамматика для new выглядит следующим образом: T_NEW class_name_reference constructor_arguments, где class_name_reference — это либо class_name, либо new_variable, либо (expr) (именно в скобках). В свою очередь new_variable организована специально для new таким образом, что в ней не может быть вызовов со скобками. Получается, что сечайс в PHP мы можем создать объект через new тремя способами: new MyClass(), new $class(), new (getMyClass())(). То есть если хочется для имени класса использовать полноценное выражение с вызовами, нужно обязательно обернуть его в дополнительные скобки. Таким образом разрешается эта неоднозначность.

Мой PR никак не нарушает ничего из вышесказанного, лишь делает скобки вокруг всего new-выражения опциональными. По сути, это как вместо (MyClass::new())->method() писать просто MyClass::new()->method(). Приоритет однозначен и не требует уточнения, код легко читается слева направо. В Java и C# испокон веков можно писать именно так. То, что для вас сейчас непривычно, для джавистов и шарпистов — база.

Подтверждением моих слов служит также и то, что по изменённой мной грамматике Bison безошибочно генерирует LR(1) парсер, который потом успешно компилируется в PHP и проходит все тесты. LR(1) парсер является детерминированным и не допускает неоднозначностей в описании грамматики.

Публичный собес на Senior PHP разработчика!

Завтра в 12:00 по Москве на YouTube-канале { между скобок } я проведу собеседование с Виталием Лихачевым.

У Виталия отличное CV: он занимался и фронтом, и бэком, и devops, владеет PHP, Python и Go. Ну а я со времён первого собеседования на PHP Point придумал новые вопросы по PHP и вокруг него, так что мне самому очень интересно, что у нас получится!

Подключайтесь завтра к YouTube трансляции или в Zoom, а также подписывайтесь на Telegram-канал { между скобок }, чтобы не пропустить анонсы других крутых стримов.

Начинаем!

https://youtu.be/oQdQIjiN-pE

Нужен алгоритмист для публичного собеседования!

Канал, у нас тут в Пыхтелке назрела идея провести публичный литкод собес по алгоритмам на канале PHP Point. Собеседуемый — отважный Иван Лещёв из Авито. А вот интервьюер сходу не нашёлся.

Отпишитесь в комментариях, кто готов задать ему жару!

Update. Всё, интервьюер есть, ждите анонса.

В Питере — Пых!*

15 февраля на Live PHP SPb будет мощный лайн-ап:

▸ Кирилл Несмеянов продемонстрирует Анастейше все оттенки асинхронности,
▸ Дмитрий Елисеев принесёт переносное окружение для разработки и тестов,
▸ ну а я расскажу про половой полиморфизм туркестанского термита.

Ждём всех завтра в 19:00 в баре Failover (к сожалению, только тех, кто ранее прошёл регистрацию) и в трансляции.

* Автор заголовка — Дима Елисеев, завтра мы попробуем его обыграть. 😉