feat: GET /clientes le por_pagina da query/cookie e expoe contexto de paginacao

tests/test_router_clientes.py

@@ -33,6 +33,20 @@ def _sem_log_real(monkeypatch):
     monkeypatch.setattr(router_clientes.db_log, "registrar", lambda *args, **kwargs: None)
 
 
+@pytest.fixture(autouse=True)
+def _limpar_cookies():
+    """Limpa cookies entre testes para evitar compartilhamento de estado."""
+    # Salva os cookies iniciais (csrf_token deve persistir)
+    csrf_token = client.cookies.get("csrf_token")
+    client.cookies.clear()
+    client.cookies.set("csrf_token", CSRF_TESTE)
+    yield
+    # Limpa novamente após o teste
+    csrf_token = client.cookies.get("csrf_token")
+    client.cookies.clear()
+    client.cookies.set("csrf_token", CSRF_TESTE)
+
+
 def _form_valido(codigo: str = "000001") -> dict:
     """Monta um dict de formulário válido (todos os campos preenchidos)."""
     dados = {campo: "x" for campo in router_clientes.db_clientes.CAMPOS_CLIENTE}
@@ -87,6 +101,64 @@ def test_janela_paginas_ultima_pagina():
     assert router_clientes._janela_paginas(20, 20) == [1, None, 19, 20]
 
 
+def test_listar_clientes_por_pagina_padrao_e_15(monkeypatch):
+    capturado = {}
+    monkeypatch.setattr(
+        router_clientes.db_clientes,
+        "listar_clientes",
+        lambda busca=None, limite=100, offset=0, ordenar_por="razao", direcao="asc": capturado.setdefault("limite", limite) and [],
+    )
+    monkeypatch.setattr(router_clientes.db_clientes, "contar_clientes", lambda busca=None, ordenar_por="razao": 3)
+
+    resposta = client.get("/clientes")
+    assert resposta.status_code == 200
+    assert capturado["limite"] == 15
+
+
+def test_listar_clientes_por_pagina_da_query_e_usada_e_grava_cookie(monkeypatch):
+    capturado = {}
+    monkeypatch.setattr(
+        router_clientes.db_clientes,
+        "listar_clientes",
+        lambda busca=None, limite=100, offset=0, ordenar_por="razao", direcao="asc": capturado.setdefault("limite", limite) and [],
+    )
+    monkeypatch.setattr(router_clientes.db_clientes, "contar_clientes", lambda busca=None, ordenar_por="razao": 3)
+
+    resposta = client.get("/clientes?por_pagina=50")
+    assert resposta.status_code == 200
+    assert capturado["limite"] == 50
+    assert resposta.cookies.get(router_clientes.POR_PAGINA_COOKIE) == "50"
+
+
+def test_listar_clientes_usa_cookie_quando_sem_por_pagina_na_query(monkeypatch):
+    capturado = {}
+    monkeypatch.setattr(
+        router_clientes.db_clientes,
+        "listar_clientes",
+        lambda busca=None, limite=100, offset=0, ordenar_por="razao", direcao="asc": capturado.setdefault("limite", limite) and [],
+    )
+    monkeypatch.setattr(router_clientes.db_clientes, "contar_clientes", lambda busca=None, ordenar_por="razao": 3)
+
+    resposta = client.get("/clientes", cookies={router_clientes.POR_PAGINA_COOKIE: "30"})
+    assert resposta.status_code == 200
+    assert capturado["limite"] == 30
+
+
+def test_listar_clientes_por_pagina_invalida_na_query_cai_no_padrao_e_nao_grava_cookie(monkeypatch):
+    capturado = {}
+    monkeypatch.setattr(
+        router_clientes.db_clientes,
+        "listar_clientes",
+        lambda busca=None, limite=100, offset=0, ordenar_por="razao", direcao="asc": capturado.setdefault("limite", limite) and [],
+    )
+    monkeypatch.setattr(router_clientes.db_clientes, "contar_clientes", lambda busca=None, ordenar_por="razao": 3)
+
+    resposta = client.get("/clientes?por_pagina=999")
+    assert resposta.status_code == 200
+    assert capturado["limite"] == 15
+    assert router_clientes.POR_PAGINA_COOKIE not in resposta.cookies
+
+
 def test_listar_clientes(monkeypatch):
     monkeypatch.setattr(
         router_clientes.db_clientes,
@@ -112,7 +184,7 @@ def test_listar_clientes_pagina_com_controles_de_paginacao(monkeypatch):
     )
     monkeypatch.setattr(router_clientes.db_clientes, "contar_clientes", lambda busca=None, ordenar_por="razao": 250)
 
-    resposta = client.get("/clientes?pagina=2")
+    resposta = client.get("/clientes?pagina=2&por_pagina=100")
     assert resposta.status_code == 200
     assert "Página 2 de 3" in resposta.text
     assert "250 clientes" in resposta.text