nsj-sql-utils-lib
Biblioteca de utilitários Python para facilitar a implementação de sistemas com acesso a banco de dados.
Principais utilitários:
-
dao_util: Módulo com utilitátios para implementação de classes DAO (exemplo: facilitar a criação da lista de fileds de um select, ou fields e values de um insert).
- dbadapter3: Classe adapter para utilizar conexões de banco de dados (útil para conexões psycopg2).
- dbconection_psycopg2: Classe para abertura de conexão com postgres, utilizando o drive psycopg2 (sem pool de conexões, nem uso do SQL Alchemy).
- db-updater: Modulo para atualização de bancos pensado para ser em um formato parecido com o erp-3
- create-script: Modulo para criação de arquivos de scripts padronizados
Utilização do db-updater:
- São duas as formas de utilizar o db-updater uma seria instalando via pip em seu projeto e chamando o mesmo da seguinte forma
python -m nsj_sql_utils_lib.updater.db_updater [parametros]
Os parametros que podem ser passados são:
parâmetro valor default descrição --dbhost DBHOST '' Database host --dbname DBNAME '' Database name --dbuser DBUSER '' Database user --dbpass DBPASS '' Database password --dbport DBPORT '' Database port --dbpath DBPATH './database' Database updatable files path --version VERSION '' Version of database files Se não informar os parametros na chamada pode-se usar as variaveis de ambiente.
variavel valor default descrição DATABASE_PATH /database Caminho para os arquivos de atualização DATABASE_HOST '' Database host DATABASE_NAME '' Database name DATABASE_PORT '' Database port DATABASE_USER '' Database user DATABASE_PASS '' Database password VERSION '' Version of database files A variável Version serve somente para que o console printe a versão dos arquivos, para poder ter um log informando qual a versão que está sendo atualizada.
-
O formato dos arquivos para a atualização precisarão serem como descrito na pasta skeleton_db:
--database ├-- functions ├-- scripts └-- views -
Exemplo de uso:
python -m nsj_sql_utils_lib.updater.db_updater [-h] [--dbhost DBHOST] [--dbname DBNAME] [--dbuser DBUSER] [--dbpass DBPASS] [--dbport DBPORT] [--dbpath DBPATH] [--version VERSION]
- Também pode-se gerar uma imagem docker para chamar sem a necessidade de instalar via pip.
- No momento deste documento a imagem ainda não se encontra no repositório do docker então seria necessário baixar este repositorio e executar o seguinte comando:
docker build -f ./dockerfiles/updater/Dockerfile -t db-updater .
- E em seguida utilizar a imagem para chamar o atualizador
docker run -v "$PWD/database:/src/database" db-updater python -m nsj_sql_utils_lib.updater.db_updater [-h] [--dbhost DBHOST] [--dbname DBNAME] [--dbuser DBUSER] [--dbpass DBPASS] [--dbport DBPORT] [--dbpath DBPATH] [--version VERSION]
Utilização do create_script
-
Foi criado para padronizar a criação do arquivo script, pode ser instalado pelo mesmo pacote do db-updater:
parâmetro valor default descrição --filename FILENAME '' Database nome do arquivo a ser criado --scriptspath SCRIPTSPATH './database/scripts/' Caminho da pasta de scripts
python -m nsj_sql_utils_lib.updater.create_script[-h] [--filename FILENAME] [--scriptspath SCRIPTSPATH]
- Pode ser usado a forma como imagem docker:
-
docker run -v "$PWD/database:/src/database" db-updater python -m nsj_sql_utils_lib.updater.create_script [-h] [--filename FILENAME] [--scriptspath SCRIPTSPATH]
Metadata
Release files for nsj-sql-utils-lib 2.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| nsj_sql_utils_lib-2.1.3.tar.gz | 11.8 kB | Without provenance | Details for nsj_sql_utils_lib-2.1.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| nsj_sql_utils_lib-2.1.3-py3-none-any.whl | Python 3 | none | any | Details for nsj_sql_utils_lib-2.1.3-py3-none-any.whl |
Total release size: 24.5 kB
Release files / nsj_sql_utils_lib-2.1.3.tar.gz
| Download URL | nsj_sql_utils_lib-2.1.3.tar.gz |
|---|---|
| Size | 11.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
369720fa6edd117ee4941a16e96892ab40ad601446393b3ed767b4ed01319c67
|
|
BLAKE2b-256 checksum How to use checksums |
921fda1390bd2c638905556d9c9c38531ca1491a6e3662328f1adcbb3ee94939
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.11.2
|
Release files / nsj_sql_utils_lib-2.1.3-py3-none-any.whl
| Download URL | nsj_sql_utils_lib-2.1.3-py3-none-any.whl |
|---|---|
| Size | 12.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cdee4c560fcb91542c906f162567d6d71ecc9a8e940b6f735b82d77a6e663878
|
|
BLAKE2b-256 checksum How to use checksums |
24ce1085219763d57f2197a3ce0603d39690f92e8d2ea60ebfebd79c84604bcd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.11.2
|
Security for nsj-sql-utils-lib 2.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.