feat: add new folder configuration

Author: AlexAlexandreAlves

.gitignore

@@ -11,3 +11,4 @@ api-batch-test/tests/data/__pycache__/*
 api-batch-test/tests/helpers/__pycache__/*
 api-batch-test/tests/schemas/__pycache__/*
 api-batch-test/config/__pycache__/settings.cpython-314.pyc
+reports/html1-report.html

.vscode/settings.json

@@ -1,5 +1,5 @@
 {
   "python.testing.pytestEnabled": true,
-  "python.testing.cwd": "${workspaceFolder}/api-batch-test",
-  "python.testing.pytestArgs": ["tests"]
+  "python.testing.cwd": "${workspaceFolder}",
+  "python.testing.pytestArgs": ["api-batch-test/tests"]
 }

api-batch-test/requirements.txt

@@ -5,5 +5,4 @@ mypy
 psycopg2-binary
 jsonschema
 python-dotenv
-vcrpy
-pytest-recording
+vcrpy

api-batch-test/tests/cassettes/test_not_found_or_bounds[page-999].yaml

@@ -0,0 +1,40 @@
+interactions:
+- request:
+    body: null
+    headers:
+      Accept:
+      - application/json
+      Accept-Encoding:
+      - gzip, deflate, zstd
+      Connection:
+      - keep-alive
+      User-Agent:
+      - python-requests/2.32.5
+    method: GET
+    uri: https://swapi.dev/api/people/?page=999
+  response:
+    body:
+      string: '{"detail":"Not found"}'
+    headers:
+      Allow:
+      - GET, HEAD, OPTIONS
+      Connection:
+      - keep-alive
+      Content-Type:
+      - application/json
+      Date:
+      - Wed, 03 Dec 2025 17:43:15 GMT
+      ETag:
+      - '"8bee5c3ad44d6c57f19e49e8e76ee09e"'
+      Server:
+      - nginx/1.16.1
+      Transfer-Encoding:
+      - chunked
+      Vary:
+      - Accept, Cookie
+      X-Frame-Options:
+      - SAMEORIGIN
+    status:
+      code: 404
+      message: NOT FOUND
+version: 1

api-batch-test/tests/cassettes/test_not_found_or_bounds[people-99999].yaml

@@ -0,0 +1,40 @@
+interactions:
+- request:
+    body: null
+    headers:
+      Accept:
+      - application/json
+      Accept-Encoding:
+      - gzip, deflate, zstd
+      Connection:
+      - keep-alive
+      User-Agent:
+      - python-requests/2.32.5
+    method: GET
+    uri: https://swapi.dev/api/people/99999/
+  response:
+    body:
+      string: '{"detail":"Not found"}'
+    headers:
+      Allow:
+      - GET, HEAD, OPTIONS
+      Connection:
+      - keep-alive
+      Content-Type:
+      - application/json
+      Date:
+      - Wed, 03 Dec 2025 17:43:14 GMT
+      ETag:
+      - '"8bee5c3ad44d6c57f19e49e8e76ee09e"'
+      Server:
+      - nginx/1.16.1
+      Transfer-Encoding:
+      - chunked
+      Vary:
+      - Accept, Cookie
+      X-Frame-Options:
+      - SAMEORIGIN
+    status:
+      code: 404
+      message: NOT FOUND
+version: 1

api-batch-test/tests/conftest.py

@@ -1,4 +1,22 @@
 from src.api_client import base_url, http
+from pathlib import Path
+import pytest
 
 # Re-exporting fixtures from src.api_client
 __all__ = ["base_url", "http"]
+
+# Diretório onde os cassetes serão salvos/carregados
+@pytest.fixture(scope="session")
+def vcr_cassette_dir():
+    # Sempre "tests/cassettes" ao lado deste conftest, independente do cwd
+    return str(Path(__file__).parent / "cassettes")
+
+@pytest.fixture(scope="session")
+def vcr_config():
+    return {
+        "filter_headers": ["Authorization"],
+        "filter_query_parameters": ["api_key", "token"],
+        "filter_post_data_parameters": ["timestamp"],
+        "match_on": ["method", "scheme", "host", "port", "path", "query"],
+        "decode_compressed_response": True,
+    }

api-batch-test/tests/contract/__pycache__/test_people_contract.cpython-314-pytest-9.0.1.pyc

@@ -0,0 +1,18 @@
+import pytest
+
+# Util para gravar os cassetes VCR, mas em CI continua usando o -record-mode=none para replay.
+@pytest.mark.vcr(record_mode="once")
+@pytest.mark.negative
+@pytest.mark.parametrize(
+    "path",
+    [
+        pytest.param("/people/99999/", id="people-99999"),
+        pytest.param("/people/?page=999", id="page-999"),
+    ],
+)
+def test_not_found_or_bounds(http, path):
+    r = http.get(path)
+    assert r.status_code in (404, 200)
+    # Se 200 para page=999 na API pública, valide que results pode estar vazio:
+    if r.status_code == 200:
+        assert isinstance(r.json().get("results"), list)