mockable 0.1.2__tar.gz → 0.1.4__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (30) hide show
  1. {mockable-0.1.2 → mockable-0.1.4}/PKG-INFO +119 -1
  2. mockable-0.1.2/src/mockable.egg-info/PKG-INFO → mockable-0.1.4/README.md +620 -517
  3. {mockable-0.1.2 → mockable-0.1.4}/pyproject.toml +1 -1
  4. {mockable-0.1.2 → mockable-0.1.4}/src/mockable/decorator.py +18 -6
  5. mockable-0.1.4/src/mockable/http/cases.py +46 -0
  6. {mockable-0.1.2 → mockable-0.1.4}/src/mockable/http/models.py +35 -3
  7. {mockable-0.1.2 → mockable-0.1.4}/src/mockable/scenario_mock.py +2 -1
  8. mockable-0.1.2/README.md → mockable-0.1.4/src/mockable.egg-info/PKG-INFO +635 -502
  9. {mockable-0.1.2 → mockable-0.1.4}/src/mockable.egg-info/SOURCES.txt +4 -1
  10. mockable-0.1.4/tests/test_http_variants.py +69 -0
  11. mockable-0.1.4/tests/test_session_cases.py +110 -0
  12. {mockable-0.1.2 → mockable-0.1.4}/LICENSE +0 -0
  13. {mockable-0.1.2 → mockable-0.1.4}/setup.cfg +0 -0
  14. {mockable-0.1.2 → mockable-0.1.4}/src/mockable/__init__.py +0 -0
  15. {mockable-0.1.2 → mockable-0.1.4}/src/mockable/http/__init__.py +0 -0
  16. {mockable-0.1.2 → mockable-0.1.4}/src/mockable/http/context.py +0 -0
  17. {mockable-0.1.2 → mockable-0.1.4}/src/mockable/http/exceptions.py +0 -0
  18. {mockable-0.1.2 → mockable-0.1.4}/src/mockable/http/matcher.py +0 -0
  19. {mockable-0.1.2 → mockable-0.1.4}/src/mockable/http/runtime.py +0 -0
  20. {mockable-0.1.2 → mockable-0.1.4}/src/mockable/http/transport.py +0 -0
  21. {mockable-0.1.2 → mockable-0.1.4}/src/mockable/side_effects.py +0 -0
  22. {mockable-0.1.2 → mockable-0.1.4}/src/mockable.egg-info/dependency_links.txt +0 -0
  23. {mockable-0.1.2 → mockable-0.1.4}/src/mockable.egg-info/requires.txt +0 -0
  24. {mockable-0.1.2 → mockable-0.1.4}/src/mockable.egg-info/top_level.txt +0 -0
  25. {mockable-0.1.2 → mockable-0.1.4}/tests/test_automatic_class.py +0 -0
  26. {mockable-0.1.2 → mockable-0.1.4}/tests/test_examples_simple.py +0 -0
  27. {mockable-0.1.2 → mockable-0.1.4}/tests/test_examples_start_like.py +0 -0
  28. {mockable-0.1.2 → mockable-0.1.4}/tests/test_function_compatibility.py +0 -0
  29. {mockable-0.1.2 → mockable-0.1.4}/tests/test_http.py +0 -0
  30. {mockable-0.1.2 → mockable-0.1.4}/tests/test_json_variables.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: mockable
3
- Version: 0.1.2
3
+ Version: 0.1.4
4
4
  Summary: mockable for ses
5
5
  Author-email: Arimaqqe <beebo120103@gmail.com>
6
6
  License: MIT
@@ -216,6 +216,67 @@ if __name__ == "__main__":
216
216
 
217
217
  ## Кейсы
218
218
 
219
+ ### Выбор кейсов из текущей сессии
220
+
221
+ Чтобы выбирать HTTP-кейсы через переменные сессии, включите опцию класса:
222
+
223
+ ```python
224
+ @mockable_class(
225
+ config_factory=build_mock_config,
226
+ http_cases_variable="mockable_http_active_cases",
227
+ )
228
+ class MedicineApi:
229
+ ...
230
+ ```
231
+
232
+ В возвращаемом фабрикой MockConfig добавьте `http_aliases` — соответствие
233
+ короткого имени существующему HttpKey:
234
+
235
+ ```python
236
+ http_aliases={
237
+ "appointment_list": appointment_list,
238
+ "cancel_appointment": cancel_appointment,
239
+ }
240
+ ```
241
+
242
+ Это поле MockConfig, а не отдельный глобальный словарь. Фикстуры остаются
243
+ в `http_requests`, базовый выбор — в `http_active_cases`.
244
+ Вызывайте метод как обычно, передавая данные сессии:
245
+
246
+ ```python
247
+ session = {
248
+ "variables": {
249
+ "mockable_http_active_cases": "appointment_list:NEGATIVE,cancel_appointment:POSITIVE",
250
+ },
251
+ }
252
+ appointments = api.get_appointments(session=session, patient_id="test")
253
+ ```
254
+
255
+ Если платформа передаёт handler объект args с вложенными данными, методам API
256
+ нужно передать `session=args["data"]`, а не весь args. Библиотека читает
257
+ непосредственно `session["variables"]`. Также поддерживается параметр `sessiondata`.
258
+ Позиционная передача этих аргументов поддерживается; они должны быть явно
259
+ объявлены в сигнатуре внешнего вызываемого метода, не спрятаны в **kwargs.
260
+
261
+ В start.py больше не нужны глобальный выбор кейсов, парсер строки или настройка
262
+ моков из handler. Каждый внешний вызов получает свою копию выбора кейсов,
263
+ не изменяя сохранённый конфиг объекта. Неперечисленные ключи используют базовый
264
+ выбор из http_active_cases, а при его отсутствии — POSITIVE. Пустая или отсутствующая
265
+ переменная тоже использует базовый выбор, не предыдущую сессию.
266
+
267
+ Пробелы вокруг элементов допускаются; регистр кейса не важен, регистр короткого
268
+ имени важен. Неизвестные имена, кейсы, повторы и неверный формат вызывают
269
+ MockConfigurationError до исполнения метода. При is_mock=False строка не читается.
270
+
271
+ Настройки фиксируются на время внешнего вызова: вложенные методы того же объекта
272
+ используют его выбор. Изменение строки подхватится следующим внешним вызовом,
273
+ без пересоздания объекта. Если вложенный метод того же объекта получает другую
274
+ сессию, она не переключает активный выбор. Для другой сессии нужен отдельный
275
+ внешний вызов. Методы без session/sessiondata используют базовый конфиг.
276
+
277
+ Эта возможность требует обновлённой библиотеки; классы без http_cases_variable
278
+ сохраняют прежнее поведение.
279
+
219
280
  | Кейс | Что проверять |
220
281
  | --- | --- |
221
282
  | `TestCaseType.POSITIVE` | Штатное успешное выполнение |
@@ -240,6 +301,63 @@ if __name__ == "__main__":
240
301
 
241
302
  ## Фикстуры: данные, файлы и ошибки
242
303
 
304
+ ### Именованные варианты HTTP-кейсов
305
+
306
+ Для нескольких ответов одного типа добавьте `variants` в HttpMockConfig:
307
+
308
+ ```python
309
+ appointment_mock = HttpMockConfig(
310
+ positive=HttpFixture(result={"appointment_list": []}),
311
+ variants={
312
+ TestCaseType.POSITIVE: {
313
+ "one_appointment": HttpFixture(
314
+ file_path=f"{MOCKS_DIR}/appointment_list/one.json",
315
+ ),
316
+ "multiple_appointments": HttpFixture(
317
+ file_path=f"{MOCKS_DIR}/appointment_list/multiple.json",
318
+ ),
319
+ },
320
+ TestCaseType.SPECIAL: {
321
+ "missing_address": HttpFixture(
322
+ file_path=f"{MOCKS_DIR}/appointment_list/missing_address.json",
323
+ ),
324
+ },
325
+ },
326
+ )
327
+ ```
328
+
329
+ Поместите эту настройку в `http_requests[appointment_list]`. Файлы из примера
330
+ нужно подготовить самостоятельно; структура ответов должна соответствовать API.
331
+ В переменной сессии выберите вариант через точку:
332
+
333
+ ```text
334
+ appointment_list:POSITIVE.multiple_appointments,cancel_appointment:NEGATIVE
335
+ ```
336
+
337
+ Для вашей платформы:
338
+
339
+ ```text
340
+ ${var.mockable_http_active_cases=appointment_list:POSITIVE.multiple_appointments}
341
+ ```
342
+
343
+ Базовый выбор также может быть строкой:
344
+ `http_active_cases={appointment_list: "SPECIAL.missing_address"}`.
345
+ Значения TestCaseType по-прежнему поддерживаются. Простой выбор POSITIVE
346
+ возвращает обычную positive-фикстуру, даже если базовый выбор был именованным.
347
+ Отсутствие настройки в сессии сохраняет базовый выбор, иначе применяется POSITIVE.
348
+
349
+ Имена вариантов состоят из латинских букв, цифр, `_` и `-`, чувствительны
350
+ к регистру. Регистр названия кейса не важен. Неизвестный вариант вызывает
351
+ MockConfigurationError, без перехода на другую фикстуру или настоящий сервер.
352
+ positive остаётся обязательным; special/negative/error можно не заполнять,
353
+ даже если у этих кейсов есть варианты. Старое поведение для простого выбранного
354
+ незаполненного кейса сохраняется: используется positive.
355
+
356
+ Каждый вариант — полноценная HttpFixture с result, file_path, side_effect,
357
+ exception, status_code и headers. Все совпавшие запросы используют выбранную
358
+ фикстуру, автоматического переключения по числу обращений нет.
359
+ Эта настройка относится к HTTP-мокам; MethodMockConfig не изменён.
360
+
243
361
  `MockFixture` для функций и `HttpFixture` для HTTP поддерживают:
244
362
 
245
363
  | Поле | Назначение |