--- inicial/consolidador.py +++ final/consolidador.py @@ -1,37 +1,98 @@ -"""Versão inicial intencionalmente falha para o exercício didático.""" +"""Implementação de referência do exercício de consolidação de tarefas.""" +from __future__ import annotations + import argparse import csv import io import json +import re +import sys +from datetime import date +from decimal import Decimal from pathlib import Path +COLUNAS = ["id", "tarefa", "responsavel", "prazo", "status", "horas_estimadas"] +STATUS = {"pendente", "em_andamento", "concluida"} -def consolidar(texto, referencia): - linhas = list(csv.DictReader(io.StringIO(texto))) - grupos = {} + +def data_iso(valor: str, campo: str = "data") -> date: + if not re.fullmatch(r"\d{4}-\d{2}-\d{2}", valor): + raise ValueError(f"{campo}: use AAAA-MM-DD") + try: + return date.fromisoformat(valor) + except ValueError as exc: + raise ValueError(f"{campo}: data inexistente") from exc + + +def consolidar(texto: str, referencia: str) -> dict: + hoje = data_iso(referencia, "referencia") + leitor = csv.DictReader(io.StringIO(texto.lstrip("\ufeff")), strict=True) + if leitor.fieldnames != COLUNAS: + raise ValueError("Cabeçalho inválido: use as seis colunas na ordem documentada") + tarefas: dict[str, dict] = {} + recebidas = 0 + try: + for linha in leitor: + recebidas += 1 + numero = leitor.line_num + if None in linha or any(v is None for v in linha.values()): + raise ValueError(f"Linha {numero}: quantidade de campos inválida") + limpa = {k: v.strip() for k, v in linha.items()} + if any(not limpa[k] for k in COLUNAS): + raise ValueError(f"Linha {numero}: campos obrigatórios vazios") + limpa["status"] = limpa["status"].casefold() + if limpa["status"] not in STATUS: + raise ValueError(f"Linha {numero}: status desconhecido") + limpa["data"] = data_iso(limpa["prazo"], f"Linha {numero}, prazo") + if not re.fullmatch(r"\d+(?:\.\d{1,2})?", limpa["horas_estimadas"]): + raise ValueError(f"Linha {numero}: horas devem ser não negativas, com até duas casas e ponto decimal") + limpa["horas"] = Decimal(limpa["horas_estimadas"]) + tarefas[limpa["id"]] = limpa + except csv.Error as exc: + raise ValueError(f"CSV inválido próximo à linha {leitor.line_num}") from exc + + por_responsavel: dict[str, dict] = {} + horas = Decimal("0") abertas = atrasadas = 0 - horas = 0.0 - for linha in linhas: - dono = linha["responsavel"] - grupo = grupos.setdefault(dono, {"responsavel": dono, "tarefas": 0, "abertas": 0, "atrasadas": 0, "horas": 0.0}) - aberta = linha["status"] != "concluida" - atrasada = linha["prazo"] <= referencia - valor = float(linha["horas_estimadas"]) - horas += valor + for tarefa in tarefas.values(): + aberta = tarefa["status"] != "concluida" + atrasada = aberta and tarefa["data"] < hoje + horas += tarefa["horas"] abertas += int(aberta) atrasadas += int(atrasada) + dono = tarefa["responsavel"] + grupo = por_responsavel.setdefault(dono, {"responsavel": dono, "tarefas": 0, "abertas": 0, "atrasadas": 0, "horas": Decimal("0")}) grupo["tarefas"] += 1 grupo["abertas"] += int(aberta) grupo["atrasadas"] += int(atrasada) - grupo["horas"] += valor - return {"referencia": referencia, "tarefas_unicas": len(linhas), "registros_substituidos": 0, - "totais": {"horas": str(horas), "abertas": abertas, "atrasadas": atrasadas}, - "por_responsavel": list(grupos.values())} + grupo["horas"] += tarefa["horas"] + grupos = [] + for nome in sorted(por_responsavel, key=lambda s: (s.casefold(), s)): + grupo = dict(por_responsavel[nome]) + grupo["horas"] = format(grupo["horas"], ".2f") + grupos.append(grupo) + return { + "referencia": hoje.isoformat(), + "tarefas_unicas": len(tarefas), + "registros_substituidos": recebidas - len(tarefas), + "totais": {"horas": format(horas, ".2f"), "abertas": abertas, "atrasadas": atrasadas}, + "por_responsavel": grupos, + } + + +def main() -> int: + parser = argparse.ArgumentParser(description="Consolidar um CSV de tarefas em JSON") + parser.add_argument("arquivo", type=Path) + parser.add_argument("--referencia", required=True, help="Data de corte no formato AAAA-MM-DD") + args = parser.parse_args() + try: + resultado = consolidar(args.arquivo.read_text(encoding="utf-8-sig"), args.referencia) + except (OSError, ValueError) as exc: + print(f"Erro: {exc}", file=sys.stderr) + return 2 + print(json.dumps(resultado, ensure_ascii=False, indent=2)) + return 0 if __name__ == "__main__": - parser = argparse.ArgumentParser() - parser.add_argument("arquivo", type=Path) - parser.add_argument("--referencia", required=True) - args = parser.parse_args() - print(json.dumps(consolidar(args.arquivo.read_text(encoding="utf-8"), args.referencia), ensure_ascii=False, indent=2)) + raise SystemExit(main())