{"id":27188,"library":"nsj-sql-utils-lib","title":"nsj-sql-utils-lib","description":"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.","status":"active","version":"2.1.3","language":"python","source_language":"en","source_url":"https://github.com/Nasajon/nsj-sql-utils-lib","tags":["sql","utils","database","postgresql"],"install":[{"cmd":"pip install nsj-sql-utils-lib","lang":"bash","label":"Install via pip"}],"dependencies":[],"imports":[{"note":"O nome do pacote é com hífen, mas o módulo usa underscore.","wrong":"from nsj_sql_utils_lib import Geral","symbol":"Geral","correct":"from nsj_utils.sql_utils import Geral"},{"note":"","wrong":"","symbol":"SyncUtils","correct":"from nsj_utils.sql_utils import SyncUtils"},{"note":"","wrong":"","symbol":"AsyncUtils","correct":"from nsj_utils.sql_utils import AsyncUtils"}],"quickstart":{"code":"import os\nfrom nsj_utils.sql_utils import Geral\n\ndb_config = {\n    'host': os.environ.get('DB_HOST', 'localhost'),\n    'port': os.environ.get('DB_PORT', '5432'),\n    'database': os.environ.get('DB_NAME', 'test'),\n    'user': os.environ.get('DB_USER', 'user'),\n    'password': os.environ.get('DB_PASSWORD', 'password')\n}\n\n# Exemplo de consulta sincrona com Geral\ngeral = Geral()\nsql = \"SELECT NOW() as current_time\"\nresult = geral.execute(sql, db_config=db_config)\nprint(result)","lang":"python","description":"Quickstart: configure variáveis de ambiente e execute uma consulta SQL simples."},"warnings":[{"fix":"Use `from nsj_utils.sql_utils import ...`","message":"O nome do pacote PyPI usa hífem (nsj-sql-utils-lib), mas os imports usam underscores (nsj_utils). Não confunda.","severity":"gotcha","affected_versions":"all"},{"fix":"Consulte o changelog no GitHub.","message":"A versão 2.x pode ter breaking changes em relação à 1.x. Verifique a documentação para migração.","severity":"deprecated","affected_versions":"2.0.0+"},{"fix":"Use Python 3.6 ou superior.","message":"A biblioteca requer Python >=3.4, mas versões recentes podem não ser testadas com Python 3.4. Recomenda-se Python 3.6+.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Use `from nsj_utils.sql_utils import Geral` (pacote instalado como nsj-sql-utils-lib, mas módulo é nsj_utils).","cause":"Tentativa de import usando o nome do pacote com hífem ou underscore errado.","error":"ModuleNotFoundError: No module named 'nsj_sql_utils_lib'"},{"fix":"Certifique-se de instalar corretamente e importe `from nsj_utils.sql_utils import Geral`.","cause":"Pacote instalado incompleto ou import direto de nsj_utils sem o submódulo sql_utils.","error":"AttributeError: module 'nsj_utils' has no attribute 'sql_utils'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}