S-Taper 0.8.4.0

Simple write-read add-on to SQLite3

Модуль для работы с таблицами в базе данных SQLite3

Этот модуль предоставляет инструменты для работы с базами данных SQLite3. Класс Taper позволяет создавать, записывать, читать и удалять данные из таблиц.

Класс Taper

Инициализация

Для инициализации модуля и подключению его к базе данных, следует выполнить два шага.

Шаг 1. Создание схемы будущей (или текущей) таблицы в базе данных.

from s_taper.consts import *
users_scheme = {
    "название первого столбца": INT + KEY,
    "название второго столбца": INT,
    "название третьего столбца": TEXT,
    "название четвертого столбца": FLT,
    "название пятого столбца": BLN,
}

Шаг 2. Создание экземпляра новой (или текущей) таблицы в базе данных.

from s_taper import Taper
# users = Taper("название таблицы", "путь до файла").create_table(схема таблицы)
users = Taper("users", "data.db").create_table(users_scheme)

Теперь можно использовать все необходимые инструменты.

Методы класса Poller

• write(values: list | tuple = None, table_name: str = None): Записывает данные в таблицу.
• read(column_name: str, key: str | int): Читает данные из таблицы по заданному столбцу и ключу.
• read_all(table_name: str): Читает все данные из таблицы.
• delete_row(column_name: str, key: str | int, all_rows: bool): Удаляет строку(и) из таблицы.
• create_table(table: dict, table_name: str): Создает новую таблицу.
• drop_table(table_name: str): Удаляет таблицу из базы данных.
• execute(sql: str, fetchall=True): Выполняет произвольный SQL-запрос.

Пример записи данных

users.write(values=["value1", "value2"])

Пример чтения данных по ключу

result = users.read(column_name="column_name", key="key_value")

Пример чтения всех данных из таблицы

all_data = users.read_all()

Пример удаления строки по ключу

users.delete_row(column_name="column_name", key="key_value")

Пример создания новой таблицы

new_table = users.create_table(table={"column1": "TEXT", "column2": "INT"})

Пример удаления таблицы

users.drop_table(table_name="example_table")

Пример выполнения SQL-запроса

result = users.execute(sql="SELECT * FROM example_table")

Внешняя документация: Ссылка