csv-mean-filter 0.1.0__py3-none-any.whl

analise.py

@@ -0,0 +1,90 @@
+"""Calcula a média de uma coluna numérica de um arquivo CSV."""
+
+import argparse
+import csv
+import os
+import sys
+
+
+def interpretar_filtro(texto: str) -> tuple[str, str]:
+    """Converte "coluna=valor" em (coluna, valor), dividindo no primeiro "="."""
+    if "=" not in texto:
+        raise ValueError(f"Filtro sem '=': {texto!r}")
+    nome, valor = (parte.strip() for parte in texto.split("=", 1))
+    if not nome:
+        raise ValueError(f"Filtro sem nome de coluna: {texto!r}")
+    return nome, valor
+
+
+def _filtro_argparse(texto: str) -> tuple[str, str]:
+    """Adapta interpretar_filtro para o type= do argparse."""
+    try:
+        return interpretar_filtro(texto)
+    except ValueError:
+        raise argparse.ArgumentTypeError("use o formato coluna=valor") from None
+
+
+def calcular_media(
+    caminho_csv: str, coluna: str, filtro: tuple[str, str] | None = None
+) -> float:
+    """Retorna a média dos valores numéricos da coluna informada.
+
+    Células vazias são ignoradas. Com filtro (coluna, valor), considera só as
+    linhas cuja coluna do filtro é igual ao valor (após strip). Levanta
+    FileNotFoundError se o arquivo não existir e ValueError para coluna
+    ausente, valor não numérico ou ausência de valores numéricos.
+    """
+    if not os.path.isfile(caminho_csv):
+        raise FileNotFoundError(f"Arquivo não encontrado: {caminho_csv}")
+
+    with open(caminho_csv, encoding="utf-8-sig", newline="") as arquivo:
+        leitor = csv.DictReader(arquivo)
+        cabecalho = leitor.fieldnames or []
+        for nome in [coluna] + ([filtro[0]] if filtro else []):
+            if nome not in cabecalho:
+                raise ValueError(f"Coluna '{nome}' não encontrada no cabeçalho")
+
+        soma = 0.0
+        quantidade = 0
+        for linha in leitor:
+            if filtro and (linha.get(filtro[0]) or "").strip() != filtro[1].strip():
+                continue
+            bruto = (linha.get(coluna) or "").strip()
+            if not bruto:
+                continue
+            try:
+                soma += float(bruto)
+            except ValueError:
+                raise ValueError(
+                    f"Valor não numérico '{bruto}' na linha {leitor.line_num}"
+                ) from None
+            quantidade += 1
+
+    if quantidade == 0:
+        sufixo = f" com o filtro {filtro[0]}={filtro[1]}" if filtro else ""
+        raise ValueError(f"Nenhum valor numérico na coluna '{coluna}'{sufixo}")
+    return soma / quantidade
+
+
+def main(argv=None) -> int:
+    """Ponto de entrada da CLI; retorna o código de saída."""
+    parser = argparse.ArgumentParser(description="Média de uma coluna de um CSV.")
+    parser.add_argument("arquivo", help="caminho do arquivo CSV")
+    parser.add_argument("coluna", help="nome da coluna")
+    parser.add_argument(
+        "--filtrar-coluna", type=_filtro_argparse, metavar="COLUNA=VALOR",
+        help="considera só as linhas em que COLUNA é igual a VALOR",
+    )
+    args = parser.parse_args(argv)
+
+    try:
+        media = calcular_media(args.arquivo, args.coluna, args.filtrar_coluna)
+    except (FileNotFoundError, ValueError) as erro:
+        print(f"Erro: {erro}", file=sys.stderr)
+        return 1
+    print(media)
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

csv_mean_filter-0.1.0.dist-info/METADATA

@@ -0,0 +1,137 @@
+Metadata-Version: 2.5
+Name: csv-mean-filter
+Version: 0.1.0
+Summary: CLI em Python para calcular a média de colunas CSV com filtros dinâmicos, zero dependências e 36 testes unitários.
+Author: jjuffagtotal-source
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# analise
+
+Script de linha de comando em Python que lê um arquivo CSV e calcula a média de uma coluna numérica, com filtro opcional por valor de outra coluna.
+
+## Funcionalidades
+
+- Calcula a média de qualquer coluna numérica de um CSV com cabeçalho.
+- Filtro opcional `--filtrar-coluna COLUNA=VALOR` para considerar só as linhas que batem com o valor.
+- Ignora células vazias.
+- Lê CSVs gravados pelo Excel (UTF-8 com BOM).
+- Mensagens de erro claras e códigos de saída previsíveis.
+- Usa apenas a biblioteca padrão: nenhuma dependência externa.
+
+## Requisitos
+
+- Python 3.10 ou superior.
+
+## Instalação
+
+Não há pacotes para instalar. Basta clonar o repositório:
+
+```bash
+git clone <url-do-repositorio>
+cd <pasta-do-repositorio>
+```
+
+## Instalação via pip
+
+O projeto também pode ser instalado como pacote, o que disponibiliza o comando `csv-mean` no terminal. Na raiz do repositório:
+
+```bash
+pip install .
+```
+
+Futuramente, quando o pacote estiver publicado no PyPI:
+
+```bash
+pip install csv-mean-filter
+```
+
+Depois de instalado, use `csv-mean` no lugar de `python src/analise.py`:
+
+```bash
+$ csv-mean dados.csv salario --filtrar-coluna idade=30
+1500.0
+```
+
+Recomenda-se instalar dentro de um ambiente virtual (`python -m venv .venv`).
+
+## Uso
+
+```bash
+python src/analise.py ARQUIVO COLUNA [--filtrar-coluna COLUNA=VALOR]
+```
+
+### Exemplos
+
+Dado o arquivo `dados.csv`:
+
+```csv
+nome,idade,salario
+Ana,30,1000
+Bia,25,3000
+Caio,30,2000
+```
+
+Média de uma coluna:
+
+```bash
+$ python src/analise.py dados.csv salario
+2000.0
+```
+
+Média só das linhas em que `idade` é `30`:
+
+```bash
+$ python src/analise.py dados.csv salario --filtrar-coluna idade=30
+1500.0
+```
+
+### Regras do filtro
+
+- O formato é `coluna=valor`. A divisão acontece no primeiro `=`, então `obs=a=b` filtra a coluna `obs` pelo valor `a=b`.
+- A comparação é exata e diferencia maiúsculas de minúsculas, após remover espaços nas pontas. `30` não bate com `30.0`.
+- `coluna=` (valor vazio) seleciona as linhas em que a coluna está vazia.
+- Valores não numéricos em linhas que não batem com o filtro são ignorados.
+
+### Códigos de saída
+
+| Código | Situação |
+|--------|----------|
+| `0` | Sucesso: a média é impressa na saída padrão. |
+| `1` | Arquivo inexistente, coluna inexistente, valor não numérico ou nenhum valor numérico (mensagem `Erro: ...` na saída de erro). |
+| `2` | Argumentos inválidos, como um filtro sem `=` (`use o formato coluna=valor`). |
+
+### Uso como módulo
+
+Com a pasta `src/` no `PYTHONPATH` (ou executando a partir dela):
+
+```python
+from analise import calcular_media, interpretar_filtro
+
+calcular_media("dados.csv", "salario")                     # 2000.0
+calcular_media("dados.csv", "salario", ("idade", "30"))    # 1500.0
+calcular_media("dados.csv", "salario", interpretar_filtro("idade=30"))
+```
+
+## Testes
+
+Os testes usam apenas o `unittest` da biblioteca padrão. Na raiz do projeto:
+
+```bash
+python -m unittest discover -s tests -v
+```
+
+## Estrutura
+
+```
+src/analise.py           # script e funções
+tests/test_analise.py    # testes unitários
+```
+
+## Licença
+
+Distribuído sob a licença MIT. Veja o arquivo [LICENSE](LICENSE).

csv_mean_filter-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+analise.py,sha256=Huof9wOXzfQEB-N7c-lSUpoiIbPwqq3ximBQZHXzEN8,3271
+csv_mean_filter-0.1.0.dist-info/METADATA,sha256=Uk7pOPoZxJb6bWbh5kjqCPEQxnlJ_KHbLJ-ggIhlCMI,3600
+csv_mean_filter-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+csv_mean_filter-0.1.0.dist-info/entry_points.txt,sha256=mVVBoJuoCaRX3PLd6G-sMPh-hApDrulU246cNaLpizo,42
+csv_mean_filter-0.1.0.dist-info/licenses/LICENSE,sha256=CKKPTH-S0Hc0AldBPYfyAwkCmSSebN63KtzgWiep_7k,1076
+csv_mean_filter-0.1.0.dist-info/RECORD,,

csv_mean_filter-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

csv_mean_filter-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+csv-mean = analise:main

csv_mean_filter-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jjuffagtotal-source
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.