Створюйте справжні тестові файли точного розміру

Проблема

Зробити один тестовий файл легко. Зробити потрібну тисячу - ось виснажлива частина

Ви тестуєте програму, що приймає файли від людей. Рано чи пізно вам знадобляться:

• PDF рівно на 10 МБ, щоб з'ясувати, чи реальний ліміт завантаження
• три файли по обидва боки цього ліміту, щоб упіймати помилки на одиницю
• 10 000 файлів журналу, щоб побачити, що робить нічне завдання, коли тека велика
• ZIP, який справді містить 200 документів, а не порожню оболонку з правильним розширенням
• файл на 4 ГБ без зберігання файлу на 4 ГБ у вашому репозиторії
• однакові фікстури на ноутбуці та на сервері збірки, байт у байт

Саме це він замінює. Він створений для QA-інженерів, автоматизації тестування та всіх, за чиїм кодом стоїть форма завантаження, процедура імпорту, парсер чи квота сховища.

Чим він відрізняється

Інші генератори зупиняються на байтах. Цей відповідає на те, про що насправді питає ваш тест

Тека з файлами все одно залишає вам вирішувати, що має доводити кожен із них. Кожен запуск тут записує поряд із файлами manifest.json - простий перелік усього створеного та для кожного запису заявлене очікування.

Припустімо, ваша точка завантаження допускає 1 МБ. Запросіть три файли, що лежать на цій межі:

tfg generate --preset size-boundaries --limit 1mb --spread 1B --format pdf --out ./edges

Три файли, три різні відповіді, у машиночитному вигляді. Ваш тест читає маніфест замість того, щоб ви писали перевірки вручну:

import json, os

directory = "edges"
manifest = json.load(open(os.path.join(directory, "manifest.json")))

for entry in manifest["files"]:
    response = upload(os.path.join(directory, entry["path"]))
    outcome = entry["expected"]["outcome"]
    if outcome == "accept":
        assert response.ok, entry["path"]
    elif outcome == "reject":
        assert not response.ok, entry["path"]

Пресети

Виберіть питання, отримайте весь набір

Пресет - це набір тестових файлів, продуманий навколо одного тестового питання, щоб вам не довелося з'ясовувати, які файли що доводять. Кожен має сторінку про те, що він зазвичай знаходить, що входить у набір і які налаштування приймає.

• Порожні та мінімальні

  Чи пройде коректний файл, настільки малий, наскільки дозволяє формат?

  empty-and-minimal

• Обробка імен файлів

  Чи збереже, покаже та поверне моя система ім'я файлу, якого не очікувала?

  filename-handling

• Межі розміру

  Чи застосовується ліміт розміру саме там, де його оголошено?

  size-boundaries

• Імпорт таблиць

  Чи переживе мій імпорт таблиць те, що експортують справжні інструменти?

  tabular-import

• Кодування тексту

  Чи знає мій читач, у якому кодуванні файл, чи вгадує?

  text-encoding

• Перевірка завантаження

  Чи приймає моя форма завантаження те, що має, і відхиляє решту?

  upload-validation

Усі пресети та як вони пов'язані з рецептами

Швидкий старт

Три команди, щоб побачити роботу

1. Створіть файл

   Один PNG, рівно два мегабайти:

   tfg generate --format png --size 2mb --out ./fixtures

2. Створіть багато файлів

   Десять тисяч файлів журналу, кожен від одного до восьми кілобайтів, з розмірами з seed, щоб завтра вийшов той самий набір. Давайте кожному запуску власний каталог - маніфест лишається єдиним записом про те, що записав запуск, тому інструмент відмовляється записувати другий поверх нього:

   tfg generate --format log --size-range 1kb-8kb --count 10000 --out ./logs

3. Перевірте їх, потім видаліть

   verify повідомляє, що нічого не зсунулося. cleanup видаляє рівно те, що було записано, і нічого більше:

   tfg verify ./logs/manifest.json
   tfg cleanup ./logs/manifest.json --yes

Розміри рахуються по 1024, як у вашому файловому менеджері, тому 2mb означає 2097152 байти. Підійде й просте число байтів. Документація охоплює рецепти, маніфест і коди завершення.

Що ви отримуєте

Створений для набору тестів, що працює без нагляду

• Точний розмір, до байта

  Запросіть 10485761 байт і отримайте рівно стільки. Розмір, якого формат не може досягти, - це помилка з причиною, а не файл неправильного розміру.

• 26 справжніх форматів

  Не нулі-заповнювачі з розширенням. Створений PNG відкривається в переглядачі зображень, DOCX - у Word, ZIP розпаковується. Кожен формат перевіряється незалежними читачами до випуску.

• Маніфест, що править за тестовий оракул

  Шлях, розмір, SHA-256, формат, seed, версія інструмента - і те, що ваша система має зробити з файлом.

• Відтворюваність

  Той самий рецепт і той самий seed, ті самі байти на будь-якій машині. Комітьте невеликий рецепт YAML замість великих бінарних фікстур.

• Два інтерфейси, один рушій

  Командний рядок, створений для CI, і десктопне вікно для дослідницького тестування. Жоден не є урізаною версією іншого, і тест порівнює їх можливість за можливістю.

• Повністю офлайн

  Немає облікового запису, хмари, телеметрії та перевірки оновлень. У бінарний файл командного рядка взагалі не скомпільовано мережевий стек.

Завантаження

Виберіть збірку для вашої системи

Розпакуйте архів і запустіть. tfg - це командний рядок, а tfg-gui - десктопне вікно. Немає інсталятора й нічого, що треба додавати на вашу машину.

Безкоштовно, відкритий код, GPL-3.0. Без реєстрації. Збірки для Windows і macOS підписані та запускаються без попереджень.