nsj-sql-utils-lib

2.1.3 verified Mon Apr 27 auth: no python

Biblioteca de utilitários Python para facilitar a implementação de sistemas com acesso a banco de dados (PostgreSQL). Versão atual 2.1.3, mantida ativamente pela Nasajon. Suporta Python >=3.4. Fornece abstrações para conexão, consultas e transações.

pip install nsj-sql-utils-lib

Common errors

error ModuleNotFoundError: No module named 'nsj_sql_utils_lib' ↓

cause Tentativa de import usando o nome do pacote com hífem ou underscore errado.

fix

Use from nsj_utils.sql_utils import Geral (pacote instalado como nsj-sql-utils-lib, mas módulo é nsj_utils).

error AttributeError: module 'nsj_utils' has no attribute 'sql_utils' ↓

cause Pacote instalado incompleto ou import direto de nsj_utils sem o submódulo sql_utils.

fix

Certifique-se de instalar corretamente e importe from nsj_utils.sql_utils import Geral.

Warnings

gotcha O nome do pacote PyPI usa hífem (nsj-sql-utils-lib), mas os imports usam underscores (nsj_utils). Não confunda. ↓

fix Use `from nsj_utils.sql_utils import ...`

deprecated A versão 2.x pode ter breaking changes em relação à 1.x. Verifique a documentação para migração. ↓

fix Consulte o changelog no GitHub.

gotcha A biblioteca requer Python >=3.4, mas versões recentes podem não ser testadas com Python 3.4. Recomenda-se Python 3.6+. ↓

fix Use Python 3.6 ou superior.

Imports

Geral

wrong

from nsj_sql_utils_lib import Geral

correct

from nsj_utils.sql_utils import Geral

O nome do pacote é com hífen, mas o módulo usa underscore.

SyncUtils

from nsj_utils.sql_utils import SyncUtils

AsyncUtils

from nsj_utils.sql_utils import AsyncUtils

Quickstart

Quickstart: configure variáveis de ambiente e execute uma consulta SQL simples.

import os
from nsj_utils.sql_utils import Geral

db_config = {
    'host': os.environ.get('DB_HOST', 'localhost'),
    'port': os.environ.get('DB_PORT', '5432'),
    'database': os.environ.get('DB_NAME', 'test'),
    'user': os.environ.get('DB_USER', 'user'),
    'password': os.environ.get('DB_PASSWORD', 'password')
}

# Exemplo de consulta sincrona com Geral
geral = Geral()
sql = "SELECT NOW() as current_time"
result = geral.execute(sql, db_config=db_config)
print(result)