pytest-typed-schema-shot 0.1.3

Pytest plugin for automatic JSON Schema generation and validation from examples

pytest: Typed Schema Shot

Plugin for pytest that automatically generates JSON Schemas based on data examples and validates data against saved schemas.

Плагин для pytest, который автоматически генерирует JSON Schema на основе примеров данных и проверяет данные по сохраненным схемам.

Features

• Automatic JSON Schema generation from data examples (using the genson library).

  Автоматическая генерация JSON Schema по примерам данных (на основе библиотеки genson).

• Schema storage and management.

  Хранение и управление схемами.

• Validation of data against saved schemas.

  Валидация данных по сохраненным схемам.

• Schema update via --schema-update (create new schemas, remove unused ones, update existing).

  Обновление схем через --schema-update (создание новых, удаление неиспользуемых, обновление существующих).

• Support for both async and synchronous functions.

  Поддержка асинхронных (async) и синхронных функций.

• Support for Union types and optional fields.

  Поддержка Union типов и опциональных полей.

• Built-in diff comparison of changes

  Встроенный diff сравнения изменений:

  - ["complex_structure"]["mail"].format: "email"
  
  r ["complex_structure"]["age"].type:
  -   [
  -     "integer",
  -     "number"
  -   ]
  +   "number"
  
  - ["multitype_array"]: {"key": {"type": "string"}}
  
  - ["multitype_array"].type: "object"
  
  - ["multitype_array"].required:
  -    "ключ"
  
  + ["multitype_array"].anyOf:
  +    {"type": ["null", "string"]},
  +    {"type": "object", "properties": {"key": {"type": "string"}}, "required": ["key"]}
  

Installation

pip install pytest-typed-schema-shot

Usage

1. Use the schemashot fixture in your tests

   В тестах используйте фикстуру schemashot:

   from typed_schema_shot import SchemaShot
   
   @pytest.mark.asyncio
   async def test_something(schemashot: SchemaShot):
       data = await API.data()
       schemashot.assert_match(data, "data")
   

2. On first run, generate schemas with the --schema-update flag

   При первом запуске создайте схемы --schema-update:

   pytest --schema-update
   

3. On subsequent runs, tests will validate data against saved schemas

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

   pytest
   

Key Capabilities

• Union Types: support multiple possible types for fields

  Поддержка множественных типов полей.

• Optional Fields: automatic detection of required and optional fields

  Автоматическое определение обязательных и необязательных полей.

• Cleanup: automatic removal of unused schemas when running in update mode

  Автоматическое удаление неиспользуемых схем в режиме обновления.