fast-sql-manager 1.2.4

Um pacote simples para realizar operações no banco

Introdução

Essa biblioteca foi criada como uma forma de abstração das operações mais simples de um banco de dados MySQL.

Início

Após fazer a instalação com o pip install fast_sql_manager é necessário que você importe a classe correspondente ao banco que deseja manipular.

from fast_sql_manager.implementations.mysql import MySQLRepository

ou

from fast_sql_manager.implementations.sqlite import SQLiteRepository

Ao importar a classe você pode instância-la ou usa-la diretamente preenchendo os parâmetros necessários.

db = Repository(
    host='localhost', 
    port=3307, 
    user='root', 
    passwd='root', 
    db_name='sys'
)

Métodos

createDataBase

Para criar um Banco de Dados basta inserir o primeiro parâmetro db_name com o nome do Banco que deseja Criar.

db.create_database('nome_do_banco')

createTable

Para criar um tabela é necessário informar apenas o nome no parâmetro name através de uma String.

Para informar como devem ser as colunas o parâmetro coluns deve ser um dicionário, onde a chave seria o nome da coluna e o valor os atributos da coluna.

db.create_table(
    name='minha_tabela', 
    columns={'id': 'int not null primary key auto_increment'}
)

selectAll

Para selecionar todos os dados de uma tabela é necessário apenas preencher através de uma string o parâmetro table_name para informar qual tabela você deseja puxar o dados

db.select_all(table_name='nome_da_tabela') 

insert

Para inserir os dados em uma tabela é necessário informar o nome da tabela no table_name como String, as colunas de deseja inserir no table_columns como uma Lista e os valores que deseja inserir no insert_values como uma Tupla.

db.insert(
    table_name='pessoas',
    tb_columns=['cpf', 'nome', 'idade'], 
    insert_values=('000000000', 'João', 19)
)

update

Para realizar o update informe o parâmetro tb_name como String. O parâmetro set deve ser um Dicionário, sendo a chave a coluna que deseja alterar, e o valor sendo o novo valor dessa coluna. O parâmetro where também é um Dicionário contendo seu primeiro par de chave e valor com a coluna que deseja realizar o filtro where e o valor que a coluna deve conter.

db.update(
    table_name='tab_pessoa',
    set={'nome': 'Joãozinho', 'idade': 17},
    where={'cpf': '123456789'}
)

É possível também inserir dentro do where operadores condicionais, porém o parametro muda um pouco pois é necessário dentro do dicionário informar qual a condicional que deseja usar.

db.update(
    tb_name='tab_pessoa',
    set={'nome': 'Joãozinho', 'idade': 17},
    where={
        'cpf': {'value':'123456789', 'condicional': 'and'}, 
        'name': 'João',
    }
)

delete

Para realizar o update informe o parâmetro tb_name como String.

O parâmetro where também é um Dicionário contendo seu primeiro par de chave e valor com a coluna que deseja realizar o filtro where e o valor que a coluna deve conter.

    db.delete('tab_pessoa', {'cpf': '123456789'})

É possível também inserir dentro do where operadores condicionais, porém o parâmetro muda um pouco pois é necessário dentro do dicionário informar qual a condicional que deseja usar.

db.delete(
    tb_name='tab_pessoa',
    where={
        'cpf': {'value':'123456789', 'condicional': 'and'}, 
        'name': 'João',
        }
)