Metadata-Version: 2.1
Name: fast_sql_manager
Version: 0.1.7
Summary: Um pacote simples para realizar operações no banco
Home-page: https://github.com/OscarSilvaOfficial/easy_sql
Author: Oscar da Silva
Author-email: oscarkaka222@gmail.com
License: UNKNOWN
Description: # 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_orm
        é necessário que você importe a classe Repository.
        
        ```python
        from fast_orm.repository import Repository
        ```
        
        Ao importar a classe você pode instância-la ou
        usa-la diretamente preenchendo os parâmetros necessários.
        
        ```python
        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.
        
        ```python
        db.createDataBase('nome_do_banco')
        ```
        
        ## createTable
        
        Para criar um tabela é necessário informar apenas o nome
        no parâmetro `tb_name` através  de uma String.
        
        Para informar como devem ser as colunas o parâmetro
        `tb_coluns` deve ser um dicionário, onde a chave seria o nome 
        da coluna e o valor os atributos da coluna.
        
        ```python
        db.createTable(
            'minha_tabela', 
            {'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 `tb_name` para informar 
        qual tabela você deseja puxar o dados
        
        ```python
        db.selectAll('nome_da_tabela') 
        ```
        
        ## insert
        
        Para inserir os dados em uma tabela é necessário informar o nome da tabela no `tb_name` como String, as colunas de deseja inserir no `tb_columns` como uma Lista e os valores que deseja inserir no `insert_values` como uma Tupla.
        
        ```python
        db.inser(
            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.
        
        ```python
        db.update(
            'tab_pessoa',
            {'nome': 'Joãozinho', 'idade': 17},
            {'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.
        
        ```python
        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.
        
        ```python
            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.
        
        ```python
        db.delete(
            tb_name='tab_pessoa',
            where={
                'cpf': {'value':'123456789', 'condicional': 'and'}, 
                'name': 'João',
                }
        )
        ```
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
