Metadata-Version: 2.1
Name: manage-sql
Version: 0.3.2
Summary: Biblioteca Python para gestão de bases de dados SQLite com maior eficiência
Home-page: https://github.com/webtechmoz/manage-sql
Author: Web Tech Moz
Author-email: zoidycine@gmail.com
License: MIT
Keywords: manage-sql,sqlite,sqlite manager
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
License-File: LICENCE
Requires-Dist: deprecated
Requires-Dist: dataclasses
Requires-Dist: pathlib

# SQLITE.py

`SQLITE.py` é uma classe Python para interagir com bancos de dados SQLite de forma simplificada. Esta classe fornece métodos para conectar a um banco de dados, criar tabelas, inserir dados e outras operações básicas.

## Índice
1. [Introdução](introdução)
2. [Instalação](#instalação)
3. [Uso da Classe SQLITE](#uso-da-classe-sqlite)
    1. [Instanciando a Classe](#instanciando-a-classe)
    2. [Métodos Disponíveis](#métodos-disponíveis)
        - [conectarBanco](#conectarbanco)
        - [criarTabela](#criartabela)
        - [inserirDados](#inserirdados)
        - [apagarDados](#apagardados)
        - [editarDados](#editardados)
        - [adicionarColuna](#adicionarcoluna)
        - [apagarColuna](#apagarcoluna)
        - [apagarTabela](#apagartabela)
        - [verDados](#verDados)
        - [verDadosPlus (descontinuado)](#verdadosplus-descontinuado)
        - [encryptPass (descontinuado)](#encryptpass-descontinuado)
        - [encriptarValor](#encriptarvalor)
        - [numeroTabelas](#número-de-tabelas)
        - [nomeTabelas](#nome-de-tabelas)
        - [totalLinhas](#total-linhas)
        - [ultimaLinha](#última-linha)
        - [numeroColunas](#número-de-colunas)
        - [nomeColunas](#nome-de-colunas)
4. [Contibuição](#contribuição)
5. [Licença](#licença)

## Instalação

Não há requisitos especiais de instalação além do Python 3.6+.

## Uso

Primeiro, importe a classe `SQLITE` e crie uma instância fornecendo o nome do banco de dados:

```python
# Importando a biblioteca
from manage-sql import SQLITE

# Instanciando a classe SQLITE
db = SQLITE('meu_banco')
```

## Métodos

### __init__
Inicializa a classe com o nome do banco de dados.

#### Parâmetros:
nomeBanco (str): Nome do banco de dados a ser utilizado.

#### Exemplo de uso:
```python
db = SQLITE('meu_banco')
```

### Conectar Banco
Conecta ao banco de dados e cria a pasta database se não existir.

#### Retorno:
Um objeto de conexão e cursor do banco de dados.

#### Exemplo de uso:
```python
database, cursor = db.conectarBanco()
```

### Criar Tabela
Cria uma tabela no banco de dados.

#### Parâmetros:
nomeTabela (str): Nome da tabela a ser criada.
Colunas (list): Lista com os nomes das colunas.
ColunasTipo (list): Lista com os tipos das colunas.

#### Exemplo de uso:
```python
db.criarTabela(
    nomeTabela='minha_tabela',
    Colunas=['coluna1', 'coluna2'],
    ColunasTipo=['TEXT', 'INTEGER']
)
```

### Inserir Dados
Insere dados na tabela especificada.

#### Parâmetros:
nomeTabela (str): Nome da tabela onde os dados serão inseridos.
Colunas (list): Lista com os nomes das colunas onde os dados serão inseridos.
Valores (list): Lista com os valores a serem inseridos.

#### Exemplo de uso:
```python
db.inserirDados(
    nomeTabela='minha_tabela',
    Colunas=['coluna1', 'coluna2'],
    Valores=['valor1', 123]
)
```

### Consultar Dados
Consulta dados da tabela especificada.

#### Parâmetros:
nomeTabela (str): Nome da tabela de onde os dados serão consultados.
Colunas (list): Lista com os nomes das colunas a serem consultadas.

#### Exemplo de uso:
```python
resultados = db.consultarDados(
    nomeTabela='minha_tabela',
    Colunas=['coluna1', 'coluna2']
)
```

### Apagar Dados
Deleta dados da tabela especificada com base em uma condição.

#### Parâmetros:
nomeTabela (str): Nome da tabela de onde os dados serão deletados.
Condicao (str): Condição para deletar os dados.

#### Exemplo de uso:
```python
db.deletarDados(
    nomeTabela='minha_tabela',
    Condicao='coluna1 = "valor1"'
)
```

### Número de Tabelas
Retorna o número de tabelas constantes na base de dados.

#### Exemplo de uso:
```python
db.numeroTabelas
```

### Nome de Tabelas
Retorna o nome de todas tabelas constantes na base de dados.

#### Exemplo de uso:
```python
db.nomeTabelas
```

### Total Linhas
Retorna o numero total de registos dentro de uma tabela.

#### Parâmetros:
nomeTabela (str): Nome da tabela de onde os dados serão contados.
return (int): total de registos dentro do banco de dados

#### Exemplo de uso:
```python
db.totalLinhas(
    nomeTabela='minha_tabela',
)
```

### Última Linha
Retorna todos os dados do último registo dentro de uma tabela.

#### Parâmetros:
nomeTabela (str): Nome da tabela de onde os dados serão verificados.
return (list): dados do ultimo registo da tabela

#### Exemplo de uso:
```python
db.ultimaLinhas(
    nomeTabela='minha_tabela',
)
```

### Número de Colunas
Retorna o número total de colunas dentro de uma tabela.

#### Parâmetros:
nomeTabela (str): Nome da tabela de onde as colunas serão verificadas.
return (int): número de colunas dentro da tabela

#### Exemplo de uso:
```python
db.numeroColunas(
    nomeTabela='minha_tabela',
)
```

### Nome de Colunas
Retorna o nome de todas as colunas dentro de uma tabela.

#### Parâmetros:
nomeTabela (str): Nome da tabela de onde as colunas serão verificadas.
return (list): nome de colunas dentro da tabela

#### Exemplo de uso:
```python
db.nomeColunas(
    nomeTabela='minha_tabela',
)
```

## Contribuição
Sinta-se à vontade para contribuir com melhorias e novas funcionalidades.

## Licença
Este projeto está licenciado sob a licença MIT.
