feat: update project

Author: AlexAlexandreAlves

.env

@@ -0,0 +1,5 @@
+BASE_URL=https://swapi.dev/api
+CONNECT_TIMEOUT=3.0
+READ_TIMEOUT=5.0
+RETRY_TOTAL=3
+RATE_LIMIT_SLEEP=0.1

api-batch-test/config/settings.py

@@ -0,0 +1,10 @@
+import os
+from dotenv import load_dotenv
+
+load_dotenv()
+
+BASE_URL = os.getenv("BASE_URL", "https://swapi.dev/api")
+CONNECT_TIMEOUT = float(os.getenv("CONNECT_TIMEOUT", "3.0"))
+READ_TIMEOUT = float(os.getenv("READ_TIMEOUT", "5.0"))
+RETRY_TOTAL = int(os.getenv("RETRY_TOTAL", "3"))
+RATE_LIMIT_SLEEP = float(os.getenv("RATE_LIMIT_SLEEP", "0.0"))  # seconds between requests

api-batch-test/pytest.ini

@@ -6,5 +6,7 @@ python_functions = test_*
 norecursedirs = lib bin include .venv venv build dist *.egg-info __pycache__
 addopts = --template=html1/index.html --report=./reports/html1-report.html
 markers =
-    smoke: mark a test as a smoke test.
-    testdb: mark tests that require database connection.
+    smoke: testes rápidos de disponibilidade
+    contract: validação de schema/contrato
+    pagination: validação de paginação
+    negative: casos de erro/limites

api-batch-test/requirements.txt

@@ -1,5 +1,9 @@
 pytest
-requests
+pytest-xdist
 pytest-reporter-html1
 mypy
-psycopg2-binary
+psycopg2-binary
+jsonschema
+python-dotenv
+vcrpy
+pytest-recording

api-batch-test/tests/conftest.py

@@ -1,31 +1,48 @@
+import time
 import pytest
-from src.api_client import APIClient
-from src.database import DatabaseConnection
-    
-@pytest.fixture(scope="module")
-def api_client():
-    client = APIClient(base_url="https://fakerestapi.azurewebsites.net/")
-    yield client
+import requests
+from requests.adapters import HTTPAdapter
+from urllib3.util.retry import Retry
+from config import settings
 
+class HttpClient:
+    """Cliente HTTP focado em testes: timeout, retry e rate-limit simples."""
+    def __init__(self, base_url: str, connect_timeout: float, read_timeout: float, retry_total: int, rate_sleep: float):
+        self.base_url = base_url.rstrip("/")
+        self.session = requests.Session()
+        retry = Retry(
+            total=retry_total,
+            backoff_factor=0.5,
+            status_forcelist=[429, 500, 502, 503, 504],
+            allowed_methods=["GET"],
+            respect_retry_after_header=True,
+        )
+        adapter = HTTPAdapter(max_retries=retry, pool_connections=10, pool_maxsize=10)
+        self.session.mount("https://", adapter)
+        self.session.mount("http://", adapter)
+        self.session.headers.update({"Accept": "application/json"})
+        self.timeout = (connect_timeout, read_timeout)
+        self.rate_sleep = rate_sleep
 
-@pytest.fixture(scope="module")
-def db_connection():
-    """
-    Fixture to create a conection with PostreSQL DB.
-    
-    Set up the env variables or parameters as needed:
-    - DB_HOST: localhost
-    - DB_DATABASE: seu_banco
-    - DB_USER: seu_usuario
-    - DB_PASSWORD: sua_senha
-    - DB_PORT: 5432
-    """
-    db = DatabaseConnection(
-        host="localhost",
-        database="testdb",
-        user="user",
-        password="1234",
-        port=5432
-    )
-    yield db
-    db.close()
+    def get(self, path_or_url: str, **kwargs) -> requests.Response:
+        """GET com base_url opcional e respeito a rate-limit."""
+        if path_or_url.startswith("http://") or path_or_url.startswith("https://"):
+            url = path_or_url
+        else:
+            url = f"{self.base_url}/{path_or_url.lstrip('/')}"
+        time.sleep(self.rate_sleep)  # rate-limit simples
+        return self.session.get(url, timeout=self.timeout, **kwargs)
+
+@pytest.fixture(scope="session")
+def base_url() -> str:
+    return settings.BASE_URL
+
+@pytest.fixture(scope="session")
+def http() -> HttpClient:
+    return HttpClient(
+        base_url=settings.BASE_URL,
+        connect_timeout=settings.CONNECT_TIMEOUT,
+        read_timeout=settings.READ_TIMEOUT,
+        retry_total=settings.RETRY_TOTAL,
+        rate_sleep=settings.RATE_LIMIT_SLEEP,
+    )

api-batch-test/tests/helpers/pagination.py

@@ -0,0 +1,16 @@
+from typing import Dict, Generator
+from tests.conftest import HttpClient
+
+def iter_pages(http: HttpClient, first_path: str) -> Generator[Dict, None, None]:
+    # Iterate through pages starting from first_path
+    resp = http.get(first_path)
+    resp.raise_for_status()
+    data = resp.json()
+    yield data
+    next_url = data.get("next")
+    while next_url:
+        resp = http.get(next_url)
+        resp.raise_for_status()
+        data = resp.json()
+        yield data
+        next_url = data.get("next")

api-batch-test/tests/schemas/page_schema.py

@@ -0,0 +1,11 @@
+PAGE_SCHEMA = {
+    "type": "object",
+    "required": ["count", "next", "previous", "results"],
+    "properties": {
+        "count": {"type": "integer", "minimum": 0},
+        "next": {"type": ["string", "null"]},
+        "previous": {"type": ["string", "null"]},
+        "results": {"type": "array"},
+    },
+    "additionalProperties": True,
+}

api-batch-test/tests/schemas/people_schema.py

@@ -0,0 +1,9 @@
+PEOPLE_ITEM_SCHEMA = {
+    "type": "object",
+    "required": ["name", "url"],
+    "properties": {
+        "name": {"type": "string", "minLength": 1},
+        "url": {"type": "string", "pattern": "^https?://"},
+    },
+    "additionalProperties": True,
+}