Объяснение YAML: синтаксис, проблема Норвегии и другие ловушки, которые мы тестировали

  1. Главная
  2. Блог
  3. DevOps

DevOps

Объяснение YAML: Синтаксис, проблема Норвегии и другие ловушки, которые мы тестировали

YAML запускает Kubernetes, Docker Compose, GitHub Actions и бесчисленное множество файлов конфигурации. Это выглядит дружелюбно, но значения без кавычек могут незаметно превращаться в логические значения, числа с плавающей запятой и восьмеричные числа. Мы передали тестовый файл реальному парсеру, чтобы точно показать, что происходит.

10 мин чтения
Объяснение YAML: синтаксис, проблема Норвегии и другие ловушки, которые мы тестировали

Главное

  • YAML представляет данные с отступами: карты ключ-значение, списки с дефисами и скалярные значения.
  • Значения без кавычек являются угаданными: в нашем тесте NO стало False, а версия 1.10 стала 1.1.
  • Цитата строки, которые выглядят как логические значения, числа, времена или версии.
  • Никогда не загружайте ненадежный YAML с помощью небезопасного загрузчика; используйте yaml.safe_load в Python.

В файле конфигурации перечислены страны, для которых включена функция: GB, SE, FI и NO. Все работает кроме Норвегии. Код получает False вместо строки «НЕТ», поскольку парсер YAML решил, что «НЕТ» означает «нет». Это знаменитая норвежская проблема, и это лишь один из нескольких способов, с помощью которых YAML незаметно меняет ваши данные.

Мы проанализировали намеренно сложный файл с помощью PyYAML 6.0 на Python 3.13. Все значения и типы, показанные ниже, получены в результате этого прогона. Другие парсеры, особенно те, которые следуют YAML 1.2, могут давать разные результаты, и это является частью проблемы.

Что такое ЯМЛ?

YAML, сокращение от «YAML не является языком разметки», представляет собой удобный для человека формат структурированных данных. Он содержит те же элементы, что и JSON: карты, списки, строки, числа, логические значения и значения NULL, но использует отступы вместо фигурных скобок и допускает комментарии. Фактически, действительный JSON почти всегда является действительным YAML. Его читаемость сделала его стандартным для конфигурации в инструментах DevOps: манифестах Kubernetes, файлах Docker Compose, рабочих процессах GitHub Actions и сборниках сценариев Ansible.

Основной синтаксис

# a comment
name: shop-api            # a map: key, colon, space, value
replicas: 3
enabled: true
tags:                     # a list: each item starts with "- "
  - web
  - payments
database:                 # a nested map, indented by two spaces
  host: db.internal
  port: 5432
inline_list: [a, b, c]
inline_map: {x: 1, y: 2}

Отступ показывает вложенность, после двоеточий и тире необходимы пробелы. Два помещения на уровень — общепринятое соглашение. Списки карт, очень распространенные в Kubernetes, сочетают в себе оба варианта: каждая - запускает новую карту, ключи которой выстраиваются под ней.

Как YAML угадывает типы

Значение без кавычек не является автоматически строкой. Анализатор просматривает его и решает, является ли это логическим значением, числом, нулевым значением или строкой. Вот что PyYAML создал из нашего тестового файла:

ЯМЛ Разобранное значение Тип
страна: НЕТ Ложь логическое значение
включено: да Правда логическое значение
отладка: выключено Ложь логическое значение
версия: 1.10 1.1 плавать
питон: 3.10 3.1 плавать
почтовый индекс: 01234 668 интервал
восьмеричный: 0755 493 интервал
порт: 08 '08' ул.
время: 12:30 750 интервал
ша: 1e10 '1e10' ул.
пусто: Нет НетТип
тильда: ~ Нет НетТип
Quote_no: "НЕТ" «НЕТ» ул.
цитируемая_версия: "1.10" '1.10' ул.

Только указанные значения оказались точно такими, как написано. Каждая строка над цитируемыми является потенциальной ошибкой.

Проблема Норвегии

countries: [GB, NO, SE, FI]
# parsed: ['GB', False, 'SE', 'FI']

Согласно правилам YAML 1.1, которым следует PyYAML, слова yes, no, on, off, y и n в различных регистрах являются логическими значениями. Таким образом, код страны Норвегии стал False, а код ее соседей остался строковым. То же самое может произойти с ответами в файле опроса, с флажками с именем «включено» или с любым коротким кодом, соответствующим одному из этих слов. Исправить это просто, если вы это знаете: укажите значение "NO".

Числа, которые меняются

Версии становятся плавающими

1.10 и 3.10 были проанализированы как числа 1.1 и 3.1, теряя конечный ноль. Файл CI, запрашивающий Python 3.10, на самом деле может запрашивать Python 3.1. Пользователи GitHub Actions столкнулись именно с этим, и стандартный совет — цитировать версии: python-version: "3.10". См. также наше руководство по семантическому управлению версиями, чтобы узнать, почему версии не являются числами.

Ведущие нули означают восьмеричное число.

Почтовый индекс 01234 стал 668, поскольку ведущий ноль обозначает восьмеричное число (по основанию 8) в YAML 1.1. Это полезно для прав доступа к файлам, таких как 0755, которые стали 493, но губительно для почтовых индексов, номеров телефонов и идентификаторов. Как ни странно, 08 остался строкой, поскольку 8 не является допустимой восьмеричной цифрой, поэтому похожие значения могут оказаться в одном файле с разными типами.

Время становится секундой

12:30 стало 750. YAML 1.1 считывает числа, разделенные двоеточием, по основанию 60, «шестидесятеричный» формат, поэтому 12 × 60 + 30 = 750. Расписание или сопоставление портов, такое как 22:22, можно преобразовать автоматически. По этой причине в документации Docker Compose рекомендуется указывать сопоставления портов.

И обратный сюрприз

1e10 остался строкой в PyYAML, поскольку его шаблон с плавающей запятой требует десятичной точки. Другой парсер мог бы считать это число десятью миллиардами. Полагаться на то, что синтаксический анализатор догадается, является корнем каждой проблемы в этом разделе.

Практическое правило: если значение должно быть текстовым и состоит только из цифр, точек, двоеточий или представляет собой короткое слово, например «да», «нет», «включено» или «выключено», заключите его в кавычки. Цитирование строки никогда не является ошибкой.

ЯМЛ 1.1 против 1.2

В YAML 1.2, опубликованном в 2009 году, многое из этого исправлено. Он принимает только true и false в качестве логических значений, использует 0o для восьмеричных чисел и отбрасывает числа по основанию 60. Но многие широко используемые библиотеки, включая PyYAML, по-прежнему следуют версии 1.1 по умолчанию, а инструменты, созданные на их основе, наследуют это поведение. Такие библиотеки, как ruamel.yaml для Python, реализуют версию 1.2. Поскольку два инструмента могут читать один и тот же файл по-разному, единственная безопасная привычка — заключать в кавычки неоднозначные значения независимо от версии.

Отступы и табуляции

YAML не допускает использования символов табуляции для отступов. Наш тест с вкладкой выдал ошибку, начиная с while scanning for the next token. Неправильное выравнивание отступов столь же фатально: элемент списка имеет отступ на один пробел меньше, чем его родственные элементы while parsing a block mapping. Настройте свой редактор для вставки пробелов и отображения пробелов и всегда проверяйте после редактирования. Ошибки отступов являются наиболее распространенной причиной сбоя развертывания сразу после «небольшого изменения конфигурации».

Дублирующиеся ключи

name: first
name: second
# parsed: {'name': 'second'}

PyYAML молча принял дубликат и сохранил последнее значение. Спецификация YAML гласит, что ключи должны быть уникальными, и некоторые парсеры отвергают дубликаты, но многие этого не делают. В длинном манифесте Kubernetes дублированный ключ может незаметно переопределить настройку, определенную ранее. Линтеры это надежно улавливают.

Многострочные строки

literal: |
  line one
  line two
folded: >
  line one
  line two

# literal: 'line one\nline two\n'
# folded:  'line one line two\n'

Канал | сохраняет разрывы строк, что подходит для сценариев, сертификатов и SQL. > объединяет строки в одну, что подходит для длинных описаний. Добавление -, как и в |-, удаляет последний символ новой строки, который имеет значение, когда значение точно сравнивается или используется как секрет.

Якоря и ключи слияния

defaults: &defaults
  retries: 3
  timeout: 30
prod:
  <<: *defaults
  timeout: 60

# prod: {'retries': 3, 'timeout': 60}

&defaults дает блоку имя, *defaults повторно использует его и << объединяет его в карту, при этом выигрывают локальные ключи. Это позволяет избежать повторения в файлах Docker Compose и CI. Используйте его экономно: интенсивное использование привязки затрудняет чтение файлов, а ключ слияния << не является частью YAML 1.2, поэтому поддержка варьируется в зависимости от инструмента.

Безопасная загрузка

Некоторые загрузчики YAML могут создавать произвольные объекты языка программирования из специальных тегов, что означает, что загрузка ненадежного YAML может запускать код. PyYAML safe_load отказывается от таких тегов. Когда мы попытались загрузить документ, запрашивающий os.system, нам не удалось загрузить could not determine a constructor for the tag 'tag:yaml.org,2002:python/object/apply:os.system'. Всегда используйте yaml.safe_load, если у вас нет особых причин не делать этого, и никогда не используйте небезопасные загрузчики для файлов пользователей или из Интернета.

Линтинг и проверка

  • yamllint распознает табуляцию, неправильные отступы, повторяющиеся ключи, конечные пробелы и правдивые значения, такие как yes.
  • Схемы проверяют структуру и типы; редакторы, такие как VS Code, могут проверять файлы Kubernetes, Compose и GitHub Actions на соответствие схемам JSON по мере ввода.
  • Проверки, специфичные для инструмента,, такие как kubectl apply --dry-run=server или docker compose config, проверяют, что инструмент фактически принимает.
  • Запустите их в CI, чтобы сломанная конфигурация не удалась при запросе на включение, а не при развертывании.

Для этой статьи мы не запускали yamllint или проверки этих инструментов. Что касается секретов, вообще держите их вне файлов YAML и загружайте из переменных среды или из менеджера секретов.

Итоги

YAML приятно читать, но ему опасно слепо доверять. В нашем тесте угадывание типа превратило код страны в логическое значение, версии в числа с плавающей запятой, почтовый индекс в восьмеричное число и время в секунды. Цитируйте все, что должно быть текстом, используйте пробелы, а не табуляции, загружайте безопасным загрузчиком и добавляйте линтер в свой конвейер.

Часто задаваемые вопросы

В чем проблема Норвегии в YAML?

Согласно правилам YAML 1.1 код страны NO без кавычек читается как логическое значение false. В нашем тесте [GB, NO, SE, FI] превратилось в [‘GB’, False, ‘SE’, ‘FI’]. Цитирование «НЕТ» исправляет это.

Почему моя версия 3.10 стала 3.1?

Незаключенное в кавычки число 3.10 анализируется как число с плавающей запятой, из которого отбрасывается конечный ноль. Версии цитирования, например «3.10».

Могу ли я использовать вкладки в YAML?

Нет. YAML требует пробелов для отступов. Табуляция вызывает ошибку синтаксического анализа, как это было в нашем тесте.

В чем разница между | и > в YAML?

| style точно сохраняет разрывы строк. Стиль > складывает строки в одну, соединяя их пробелами.

Является ли YAML расширенным набором JSON?

YAML 1.2 разработан как расширение JSON, поэтому почти все документы JSON являются допустимыми YAML. Обратное неверно.

Продолжайте учиться

Работайте с Stack Quora

Нужна помощь с тестированием, WordPress или SEO?

Мы помогаем командам выпускать лучшее программное обеспечение и развивать свои сайты. Расскажите нам, над чем вы работаете, и мы предложим четкий следующий шаг.

Продолжайте читать

Больше руководств по тестирование, искусственный интеллект и современные разработки

Понравилась эта статья? Выберите тему и сразу приступайте к нашим новейшим руководствам.

Искусственный интеллект

Объяснение стратегий разделения RAG: фиксированное, перекрытие, предложение, рекурсивное и заголовки, измеренное

Стратегии фрагментирования RAG в одном документе с tiktoken 0,14: фиксированный размер, перекрытие, упаковка предложений, рекурсивное разделение и ф…

Читать статью →
Разработка ПО

Объяснение идемпотентности API: проверенные ключи идемпотентности и безопасные повторы

Идемпотентность API, объясненная на примере сервера и клиента Python, которые мы запускали: потеря ответа вызывала двойную оплату без ключа и единст…

Читать статью →
DevOps

Объяснение Git Stash: сохранение, применение, удаление и неотслеживаемые файлы, протестировано

Git stash объясняется с помощью команд, которые мы запускали в Git 2.56: push с сообщением, неотслеживаемые файлы, список и отображение, применение …

Читать статью →
Тестирование ПО

Объяснение парного тестирования: как все пары сокращают 216 тестов до 13, протестированных

Попарное тестирование объясняется с помощью генератора, который мы запускали в Python 3.13: проверка с 216 комбинациями, охватываемыми 13 тестами, п…

Читать статью →
Автоматизация тестирования

Объяснение тестовых двойников: манекен, заглушка, шпион, макет и подделка, с протестированным кодом Python

Двойные тесты объяснены на одном примере Python, запущенном в pytest 9.2: манекен, заглушка, шпион, макет и подделка, когда использовать каждый из н…

Читать статью →
Базы данных и SQL

Объяснение SQL COALESCE: значения по умолчанию, NULLIF, IFNULL против ISNULL и ловушки, протестировано

SQL COALESCE объясняется с помощью запросов, которые мы выполняли в SQLite 3.50: первые ненулевые значения, пустые строки, NULL в математике, NULLIF…

Читать статью →
Базы данных и SQL

Объяснение самосоединения SQL: сотрудник-менеджер, сравнение пар и строк, протестировано

Самосоединение SQL объясняется с помощью запросов, которые мы выполняли в SQLite 3.50: сотрудник и менеджер, заработок больше, чем менеджер, уникаль…

Читать статью →
Разработка ПО

Объяснение оператора расширения JavaScript: распространение против остальных, копии и ошибки, протестировано

Оператор расширения JavaScript, объясненный с помощью кода, который мы запускали на узле 24: массивы, объекты, мелкие копии, остальные параметры, ог…

Читать статью →
Разработка ПО

Объяснение модуля коллекций Python: счетчик, defaultdict, deque и многое другое, протестировано

Коллекции Python объяснены с помощью кода, который мы запускали в Python 3.13: Counter, defaultdict, deque, Nametuple, OrderedDict и ChainMap, а так…

Читать статью →
Искусственный интеллект

Объяснение контекстного окна LLM: токены, ограничения и способы вместить больше, измеренное

Контекстное окно LLM поясняется количеством токенов, которые мы измеряли с помощью tiktoken: слова и токены для прозы, кода и хинди, входные и выход…

Читать статью →
Разработка ПО

Объяснение вебхуков: как они работают и как безопасно их получать

Веб-хуки объясняются с помощью получателя и отправителя, которые мы запускали на Python: push и опрос, подписи HMAC-SHA256, отклонение подделанных и…

Читать статью →
DevOps

Объяснение Git Cherry-Pick: скопируйте нужный вам коммит, безопасно и протестировано

Git Cherry-Pick объяснил это командами, которые мы запускали в Git 2.56: копирование исправления в ветку выпуска, новые хэши и идентификаторы патчей…

Читать статью →
Автоматизация тестирования

Объяснение моментального тестирования: как оно работает, когда помогает, а когда вредит

Тестирование снимков объясняется с помощью pytest и сладкой демонстрации, которую мы запускали: создание снимков, чтение различий после изменения ко…

Читать статью →
Тестирование ПО

Объяснение мутационного тестирования: почему при 100% покрытии все еще не обнаружена наша ошибка

Тестирование мутаций объясняется с помощью небольшого инструмента мутаций, который мы создали и запустили: 14 мутантов, набор тестов со 100%-ным пок…

Читать статью →
Искусственный интеллект

Объяснение быстрого внедрения: как обманывают приложения искусственного интеллекта и как их защитить

Быстрое внедрение, объясненное для разработчиков: прямые и косвенные атаки, почему фильтры ключевых слов не работают (наш тест заблокировал 1 из 4),…

Читать статью →
DevOps

Объяснение DNS-записей: A, AAAA, CNAME, MX, TXT и TTL с реальным поиском

Записи DNS объяснены с помощью выполненных нами поисков: как работает разрешение, A и AAAA, правила CNAME, MX и нулевой MX, TXT для SPF и проверки, …

Читать статью →
DevOps

Объяснение флагов функций: безопасные выпуски, постепенное развертывание и гигиена флагов

Флаги функций объяснены с помощью моделирования развертывания, которое мы провели: типы флагов, процентное развертывание со стабильным хешированием,…

Читать статью →
Автоматизация тестирования

Генерация тестовых данных с помощью Python Faker: реалистичные, повторяемые и безопасные данные

Генерация тестовых данных с помощью Python Faker, запуск и измерение: заполнение повторяющихся данных, локали, уникальные значения, записи в форме д…

Читать статью →
Тестирование ПО

Объяснение тестирования с помощью Shift-Left: находите ошибки раньше, не замедляя работу команды

Сдвиг влево при тестировании объяснил: что это значит, почему ранние дефекты обходятся дешевле, практики от проверки требований до CI-проверок, меня…

Читать статью →
Базы данных и SQL

Объяснение строковых функций SQL: TRIM, SUBSTR, REPLACE, CONCAT и очистка данных

Строковые функции SQL, объясненные с помощью выполненных нами запросов: конкатенация и NULL, TRIM, UPPER и LOWER, SUBSTR и INSTR, REPLACE, заполнени…

Читать статью →
Базы данных и SQL

Объяснение триггеров SQL: триггеры ДО и ПОСЛЕ, журналы аудита и подводные камни

Триггеры SQL объяснены с помощью триггеров, которые мы запускали: ДО и ПОСЛЕ, СТАРЫЙ и НОВЫЙ, журналы аудита, проверка, обновления запасов, условия …

Читать статью →
Разработка ПО

Объяснение модуля Python JSON: дампы, загрузки, пользовательские типы и распространенные ошибки

Модуль Python JSON, объясненный с помощью кода, который мы выполнили: дампы и загрузки, файлы, преобразования типов, даты и десятичные дроби, пользо…

Читать статью →
Разработка ПО

Модули ES против CommonJS: как работает импорт JavaScript в Node.js, протестировано

Модули ES и CommonJS объяснены с помощью кода, который мы запускали в Node.js: синтаксис импорта и экспорта, требование, живые привязки, кэширование…

Читать статью →
Разработка ПО

Объяснение регулярных выражений Python: шаблоны, группы, предварительные просмотры и подводные камни, протестировано

Регулярное выражение Python объясняется с помощью шаблонов, которые мы использовали: поиск против совпадения, поиск, группы и именованные группы, жа…

Читать статью →
Искусственный интеллект

Объяснение структурированного вывода LLM: получение надежного JSON из моделей искусственного интеллекта

Структурированный вывод LLM объясняется проверкой, которую мы проводили в Pydantic: режим и схемы JSON, ограниченное декодирование, способы моделиро…

Читать статью →
DevOps

Объяснение ключей SSH: как они работают, ssh-keygen, Ed25519 и безопасные привычки

Ключи SSH объяснены ключами, которые мы сгенерировали: открытые и закрытые ключи, ssh-keygen, Ed25519 и RSA, отпечатки пальцев, парольные фразы, ssh…

Читать статью →
DevOps

Объяснение HTTP-кэширования: Cache-Control, ETag и ответы 304, с живым тестом

Объяснение HTTP-кеширования на небольшом сервере, который мы запускали: директивы Cache-Control, максимальный возраст, отсутствие кэша и отсутствие …

Читать статью →
Автоматизация тестирования

Объяснение тестирования контрактов API: уловите критические изменения до их выпуска

Тестирование контрактов API объясняется с помощью проведенной нами проверки схемы: что такое контракт, контракты, управляемые потребителем, Pact, Op…

Читать статью →
Тестирование ПО

Объяснение тестирования на основе рисков: оцените риски, постройте матрицу и протестируйте то, что имеет значение

Тестирование на основе рисков объясняется шаг за шагом: выявление рисков, оценка вероятности и воздействия, построение матрицы рисков, сопоставление…

Читать статью →
Базы данных и SQL

Объяснение ограничений SQL: NOT NULL, UNIQUE, CHECK и FOREIGN KEY, протестировано

Ограничения SQL объяснены с помощью проведенных нами тестов: NOT NULL, UNIQUE, CHECK, DEFAULT, PRIMARY и FOREIGN KEY, лазейки NULL, настройка внешне…

Читать статью →
Базы данных и SQL

Объяснение функций даты SQL: добавление, сравнение и группировка дат без ошибок

Функции даты SQL, объясненные с помощью запросов, которые мы выполняли: добавление интервалов, сюрпризы в конце месяца, различия в датах, ловушка МЕ…

Читать статью →
Разработка ПО

Объяснение Python asyncio: асинхронность, ожидание, сбор и группа задач с реальным временем

Python asyncio объяснен с помощью кода, который мы запланировали: сопрограммы, ожидание, сбор, TaskGroup, обработка ошибок, тайм-ауты, ограничение п…

Читать статью →
Разработка ПО

Debounce против Throttle в JavaScript: как они работают, когда использовать каждый, протестировано

Сравнение Debounce и Throttle в JavaScript объясняется с помощью таймингов, которые мы измеряли в Node.js: как каждый из них работает, простые реали…

Читать статью →
Разработка ПО

Объяснение менеджеров контекста Python: оператор with, contextlib и реальное использование

Контекстные менеджеры Python объяснили с помощью кода, который мы запускали: как работает, __enter__ и __exit__, contextlib.contextmanager, подавлен…

Читать статью →
Искусственный интеллект

Объяснение температуры LLM и Top-p: как модели ИИ выбирают свое следующее слово

Температура LLM и top-p объяснены с помощью моделирования, которое мы провели: как изменяются вероятности, что сохраняет top-p, рекомендуемые настро…

Читать статью →
DevOps

Объяснение YAML: синтаксис, проблема Норвегии и другие ловушки, которые мы тестировали

YAML объясняется с помощью теста парсера: базовый синтаксис, списки и карты, проблема Норвегии, версии, превращающиеся в числа с плавающей запятой, …

Читать статью →
DevOps

Объяснение Cron Jobs: синтаксис, реальные расписания и ошибки, которые их нарушают

Задания Cron объясняются графиками, которые мы проверили: пять полей, операторы, реальные примеры, ловушка дня месяца ИЛИ дня недели, проблемы окруж…

Читать статью →
Искусственный интеллект

Объяснение галлюцинаций искусственного интеллекта: почему языковые модели все выдумывают и как их уменьшить

Галлюцинации ИИ объяснили: что это такое, почему языковые модели их создают, распространенные типы, как уменьшить их с помощью заземления и подсказо…

Читать статью →
DevOps

Объяснение переменных среды: файлы .env, секреты и правильно выполненная конфигурация

Переменные среды объясняются на примерах Python, которые мы запускали: их чтение и установка, почему каждое значение является строкой, файлы .env, н…

Читать статью →
Разработка ПО

Объяснение ограничения скорости API: алгоритмы, заголовки и обработка ошибок 429

Ограничение скорости API объясняется с помощью проведенного нами моделирования: сегмент токенов, фиксированное окно, скользящее окно, 429 ответов, з…

Читать статью →
Автоматизация тестирования

Издевательство в Python: unittest.mock, патч и ошибки, из-за которых тесты лгут

Издевательство на Python с помощью unittest.mock, протестировано: Mock и return_value, Side_effect, исправление использования имени, спецификация и …

Читать статью →
Тестирование ПО

Объяснение покрытия кода: покрытие линий или ветвей и что на самом деле означает 100%

Покрытие кода объяснено с помощью реального запуска покрытия.py: покрытие строк, ветвей и условий, чтение отчета, почему 100%-ное покрытие все еще м…

Читать статью →
Базы данных и SQL

DELETE, TRUNCATE и DROP в SQL: различия, откат и когда использовать каждый из них

Объяснение DELETE, TRUNCATE и DROP на примере протестированного SQL: что каждый из них удаляет, откат, триггеры, сброс идентификаторов, скорость и ч…

Читать статью →
Базы данных и SQL

Объяснение представлений SQL: создавайте, используйте и избегайте ловушек, с примерами

Представления SQL, объясненные с помощью запросов, которые мы выполняли: создание представления, результаты в реальном времени, скрытие столбцов, пр…

Читать статью →
Разработка ПО

Интерфейс TypeScript и тип: реальные различия, протестированные с помощью компилятора

Интерфейс TypeScript против типа, проверенный реальным компилятором: что могут делать оба, что может делать только один, слияние объявлений, расшире…

Читать статью →
Разработка ПО

Объяснение Python *args и **kwargs: гибкие функции с понятными примерами

Python *args и **kwargs, объясненные с помощью кода, который мы запускали: упаковка и распаковка, порядок параметров, аргументы только по ключевым с…

Читать статью →
Разработка ПО

Лямбда-функции Python: синтаксис, реальное использование и когда их не следует использовать

Лямбда-функции Python, объясненные с помощью кода, который мы запускали: синтаксис, сортировка с помощью ключа, карты и фильтра, замыкания, ловушка …

Читать статью →
Искусственный интеллект

Что такое ИИ-агенты? Как они работают: можно запустить простой цикл агента

Что такое агенты ИИ? Простое руководство по циклу агента, инструментам, памяти и ограничениям, с небольшим циклом Python, который мы запустили, реал…

Читать статью →
DevOps

Мониторинг и наблюдаемость: реальная разница с журналами, метриками и трассировками

Объяснение мониторинга и наблюдаемости: известные и неизвестные сбои, журналы, метрики и трассировки, пошаговое руководство по инцидентам при оформл…

Читать статью →
DevOps

Docker Volumes против Bind Mounts: правильное сохранение данных контейнера

Объяснение томов Docker и монтирования привязки: почему исчезают данные контейнера, именованные тома, монтирование привязки, tmpfs, примеры создания…

Читать статью →
Автоматизация тестирования

TDD против BDD: ключевые различия, одна функция, созданная для обоих способов, и когда использовать каждый

TDD и BDD объясняются с помощью одной функции скидки, созданной в обоих направлениях: красно-зеленый рефакторинг с кодом, который мы запускали, сцен…

Читать статью →
Тестирование ПО

Пользовательское приемочное тестирование (UAT): процесс, контрольный список и реальные примеры

Приемочное тестирование пользователей объяснило: кто его проводит, чем оно отличается от контроля качества, семиэтапный процесс, шаблон тестового сц…

Читать статью →
Базы данных и SQL

Объяснение значений NULL в SQL: IS NULL, COALESCE, NULLIF и ловушки, которых следует избегать

Значения SQL NULL объяснены с помощью запросов, которые мы выполнили: трехзначная логика, IS NULL, COALESCE, NULLIF, как агрегаты, соединения и сорт…

Читать статью →
Базы данных и SQL

Оператор SQL CASE WHEN: синтаксис, реальные примеры и распространенные ошибки

SQL CASE WHEN объяснен с помощью запросов, которые мы выполняли: простые формы и формы для поиска, порядок условий, повороты с помощью SUM, трюки CO…

Читать статью →
Разработка ПО

Что такое JWT? Веб-токены JSON, объясненные на рабочем примере

Что такое JWT? Объяснение JSON Web Tokens: три части: токен, созданный и измененный в коде, который мы запускали, JWT и сеансы, хранилище, токены об…

Читать статью →
Разработка ПО

Объяснение цикла событий JavaScript: стек вызовов, микрозадачи и таймеры с примерами

Цикл событий JavaScript объясняется с помощью кода, который мы запускали: стек вызовов, очереди задач и микрозадач, почему setTimeout 0 не является …

Читать статью →
Разработка ПО

Генераторы Python и объяснение доходности: экономьте память с помощью реальных примеров

Генераторы Python и доходность, объясненные с помощью кода, который мы запускали: как они приостанавливаются и возобновляются, измеряют экономию пам…

Читать статью →
Искусственный интеллект

Что такое вложения? Простое объяснение векторов и косинусного сходства

Что такое вложения? Простое руководство по векторам, косинусному подобию и семантическому поиску с небольшим примером, который мы использовали, общи…

Читать статью →
DevOps

Сине-зеленое и канареечное развертывание: различия, компромиссы и как выбрать

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

Читать статью →
Автоматизация тестирования

Ненадежные тесты: что их вызывает и как их исправить навсегда

Ненадежные тесты объясняются на демонстрациях, которые мы запускали: основные причины, способы подтверждения и диагностики, правильные исправления в…

Читать статью →
Тестирование ПО

Нагрузочное тестирование и стресс-тестирование: различия, метрики и примеры k6

Объяснение нагрузочного и стресс-тестирования: что доказывает каждое из них, тесты на всплески и выдержки, важные метрики, почему средние значения в…

Читать статью →
Тестирование ПО

Тестовый пример и тестовый сценарий: ключевые различия, примеры и когда использовать каждый

Объяснение тестового случая и тестового сценария: четкие определения, параллельная таблица, одна функция сброса пароля, взятая из сценариев в случаи…

Читать статью →
Базы данных и SQL

Оптимизация SQL-запросов: чтение планов выполнения и исправление медленных запросов с указанием времени

Оптимизация SQL-запросов проверена на миллионе строк: читайте планы выполнения, добавляйте правильные индексы, исправляйте неразмещаемые фильтры, ис…

Читать статью →
Базы данных и SQL

SQL UNION против UNION ALL: различия, примеры и проверка производительности

SQL UNION и UNION ALL объяснены с помощью запросов, которые мы выполнили: дубликаты, правила, которым следуют оба, реальная ошибка данных, измеренна…

Читать статью →
Разработка ПО

Учебное пособие по API JavaScript Fetch: GET, POST, обработка ошибок и тайм-ауты

Учебное пособие по API JavaScript Fetch, протестированное на локальном сервере: GET и POST, почему не выдается ошибка 404, многоразовый помощник, ст…

Читать статью →
Разработка ПО

Обработка файлов Python: чтение, запись, CSV, JSON и pathlib с примерами

Обработка файлов Python объясняется с помощью кода, который мы запускали: открытые режимы, чтение больших файлов, CSV, JSON, pathlib, двоичные файлы…

Читать статью →
Разработка ПО

Классы и объекты Python: учебник ООП с реальными примерами

Классы и объекты Python, объясненные с помощью кода, который мы запускали: __init__, методы, атрибуты класса и экземпляра, наследование, свойства, м…

Читать статью →
Искусственный интеллект

Что такое большая языковая модель? Как работают LLM, объяснено без шумихи

Что такое большая языковая модель? LLM объясняется простым языком: токены, встраивания, внимание, обучение, температурные и контекстные окна, крошеч…

Читать статью →
DevOps

Команды Linux для начинающих: основное руководство по терминалу с примерами

Команды Linux для начинающих, сгруппированные по задачам: навигация, файлы, просмотр журналов, grep, каналы, разрешения, процессы и архивы, с практи…

Читать статью →
Автоматизация тестирования

Selenium vs Playwright: ключевые различия, сравнение кода и что выбрать

Сравнение Selenium и Playwright: архитектура, ожидание, поддержка браузера и языка, отладка, одинаковый тест в обоих инструментах, советы по миграци…

Читать статью →
Тестирование ПО

Разделение эквивалентности: метод проектирования тестов, объясненный на рабочих примерах

Объяснение эквивалентного разделения: как найти действительные и недействительные разделы, рабочие примеры для возрастов, паролей и купонов, проведе…

Читать статью →
Тестирование ПО

Серьезность и приоритет в тестировании программного обеспечения: различия, матрица и реальные примеры

Объяснение серьезности и приоритета при тестировании программного обеспечения: четкие определения, четырехсторонняя матрица с примерами, шкалы уровн…

Читать статью →
Базы данных и SQL

Учебное пособие по подзапросам SQL: типы, коррелирующие подзапросы и EXISTS с примерами

Руководство по подзапросам SQL с выполненными нами запросами: скалярные подзапросы, IN, FROM и SELECT, коррелированные подзапросы, EXISTS, ловушка N…

Читать статью →
Базы данных и SQL

Объяснение транзакций SQL и ACID: COMMIT, ROLLBACK и уровни изоляции

Транзакции SQL и ACID, объясненные с помощью банковского перевода, который мы выполнили: COMMIT, ROLLBACK, точки сохранения, блокировки, уровни изол…

Читать статью →
Разработка ПО

Git Commands Cheat Sheet: The Commands You Actually Use, With Examples

Шпаргалка по командам Git, сгруппированная по задачам: настройка, промежуточный этап, ветки, удаленные устройства, тайник, история и исправление оши…

Читать статью →
Разработка ПО

Объяснение промисов в JavaScript: then, catch, Promise.all и распространенные ошибки

Обещания JavaScript, объясненные с помощью кода, который мы запускали: состояния, цепочки then и catch, обработка ошибок, Promise.all, allSettled, R…

Читать статью →
Разработка ПО

Учебное пособие по словарю Python: методы, примеры и общие шаблоны

Учебное пособие по словарю Python с кодом, который мы выполнили: создание, чтение и обновление словарей, ключевые методы, слияние, понимание, шаблон…

Читать статью →
Искусственный интеллект

Что такое РАГ? Генерация с расширенным поиском, объясненная на рабочем примере

Что такое РАГ? Retrieval-augmented generation explained step by step: indexing, chunking, embeddings, retrieval, a small working Python example, eva…

Читать статью →
DevOps

Учебное пособие по Terraform для начинающих: инфраструктура как код от первого файла до модулей

Учебное пособие по Terraform для начинающих: начните без облачной учетной записи, изучите инициализацию, планирование и применение, затем переменные…

Читать статью →
DevOps

Docker и Kubernetes: ключевые различия, как они работают вместе и что вам нужно

Объяснение Docker и Kubernetes: что делает каждый из них, одно и то же приложение работает с обоими, сравнение Docker Compose и Swarm, изменение doc…

Читать статью →
Автоматизация тестирования

Учебное пособие по Pytest для начинающих: фикстуры, параметризация и реальные примеры

Учебное пособие по pytest для начинающих с тестами, которые мы запускали на pytest 9.2: утверждения, фикстуры, параметризация, conftest, маркеры, tm…

Читать статью →
Тестирование ПО

Жизненный цикл тестирования программного обеспечения (STLC): 6 этапов, критерии входа и выхода, пример

Объясняется жизненный цикл тестирования программного обеспечения: шесть этапов STLC с критериями входа и выхода, результаты, пример проработанной фу…

Читать статью →
Разработка ПО

Git merge vs rebase: отличия, примеры и когда что использовать

Git merge vs rebase с реальным выводом log, сравнительной таблицей, золотым правилом rebase и безопасным рабочим процессом для команды.

Читать статью →
Разработка ПО

Генераторы списков в Python: синтаксис, примеры и когда их избегать

Генераторы списков в Python: синтаксис, фильтры, if-else, вложенные циклы, измеренное время и случаи, когда обычный цикл for лучше.

Читать статью →
Базы данных и SQL

SQL JOIN: объяснение с примерами (Inner, Left, Right, Full)

Разберите SQL JOIN шаг за шагом на примерах таблиц и запросов: INNER, LEFT, RIGHT, FULL, CROSS и SELF, а также частые ошибки и советы по производите…

Читать статью →