Class Database()

class edit_db.database

Взаимодействия с базой данных.

create_table(level, read_ob, table_name, keys, table_root=False)

Создание таблицы БД, при её отсутствии.

Параметры:
  • level (str) – Уровень, варианты: studio, project (данные проекта или студии).
  • read_ob (edit_db.studio, edit_db.project) – Объект студии или проекта, для которого идёт взаимодействие с базой данных.
  • table_name (str) – Имя таблицы БД.
  • keys (dict) – Словарь, инициализирующий данную таблицу: ключи - заголовки, значения - типы данных (стандартные для sqlite3 + дополнительные, например json) например edit_db.studio.tasks_keys
  • table_root (str, optional) – Имя файла БД для sqlite3. Например edit_db.studio.tasks_db. Для тех случаев когда имя файла ДБ не соответствует имени таблицы (лучше передавать всегда).
Результат:

(True, „Ok!“) или (False, comment)
Тип результата:

tuple
delete(level, read_ob, table_name, where, table_root=False)

Удаление строки из таблицы БД.

Параметры:
  • level (str) – Уровень, варианты: studio, project (данные проекта или студии).
  • read_ob (edit_db.studio, edit_db.project) – Объект студии или проекта, для которого идёт взаимодействие с базой данных.
  • table_name (str) – Имя таблицы БД.
  • where (dict) – Словарь для формирования строки sql оператора WHERE, содержит ключи по keys.
  • table_root (str, optional) – Имя файла БД для sqlite3. Например edit_db.studio.tasks_db. Для тех случаев когда имя файла ДБ не соответствует имени таблицы (лучше передавать всегда).
Результат:

(True, „Ok!“) или (False, comment)
Тип результата:

tuple
get(level, read_ob, table_name, com, table_root=False)

Чтение БД, с использованием sql команды.

Параметры:
  • level (str) – Уровень, варианты: studio, project (данные проекта или студии).
  • read_ob (edit_db.studio, edit_db.project) – Объект студии или проекта, для которого идёт взаимодействие с базой данных.
  • table_name (str) – Имя таблицы БД (для проверки наличия).
  • com (str) – SQL команда.
  • table_root (str, optional) – Имя файла БД для sqlite3. Например edit_db.studio.tasks_db. Для тех случаев когда имя файла ДБ не соответствует имени таблицы (лучше передавать всегда).
Результат:

(True, [строки-словари]) или (False, comment)
Тип результата:

tuple
insert(level, read_ob, table_name, keys, write_data, table_root=False)

Добавление строки или нескольких строк в таблицу БД.

Параметры:
  • level (str) – Уровень, варианты: studio, project (данные проекта или студии).
  • read_ob (edit_db.studio, edit_db.project) – Объект студии или проекта, для которого идёт взаимодействие с базой данных.
  • table_name (str) – Имя таблицы БД.
  • keys (dict) – Словарь, инициализирующий данную таблицу: ключи - заголовки, значения - типы данных (стандартные для sqlite3 + дополнительные, например json) например edit_db.studio.tasks_keys
  • write_data (dict, list) – Словарь строки по ключам keys, также может быть списком словарей, для записи нескольких строк.
  • table_root (str, optional) – Имя файла БД для sqlite3. Например edit_db.studio.tasks_db. Для тех случаев когда имя файла ДБ не соответствует имени таблицы (лучше передавать всегда).
Результат:

(True, „Ok!“) или (False, comment)
Тип результата:

tuple
read(level, read_ob, table_name, keys, columns=False, where=False, table_root=False)

Чтение БД, используя условие.

Параметры:
  • level (str) – Уровень, варианты: studio, project (данные проекта или студии).
  • read_ob (edit_db.studio, edit_db.project) – Объект студии или проекта, для которого идёт взаимодействие с базой данных.
  • table_name (str) – Имя таблицы БД.
  • keys (dict) – Словарь, инициализирующий данную таблицу: ключи - заголовки, значения - типы данных (стандартные для sqlite3 + дополнительные, например json) например edit_db.studio.tasks_keys
  • columns (list, optional) – Список читаемых столбцов, если не передавать - то читаются все столбцы.
  • where (str, dict) –
    • Строка условия для sql оператора WHERE.
    • Словарь для формирования строки sql оператора WHERE, содержит ключи по keys, плюс может содержать condition значения из [or, end].
  • table_root (str, optional) – Имя файла БД для sqlite3. Например edit_db.studio.tasks_db. Для тех случаев когда имя файла ДБ не соответствует имени таблицы (лучше передавать всегда).
Результат:

(True, [строки-словари]) или (False, comment)
Тип результата:

tuple
set_db(level, read_ob, table_name, com, data_com=False, table_root=False)

Внесение изменений в БД, с использованием sql команды.

Параметры:
  • level (str) – Уровень, варианты: studio, project (данные проекта или студии).
  • read_ob (edit_db.studio, edit_db.project) – Объект студии или проекта, для которого идёт взаимодействие с базой данных.
  • table_name (str) – Имя таблицы БД.
  • com (str) – SQL команда.
  • data_com (tuple, optional) – Кортеж значений для com.
  • table_root (str, optional) – Имя файла БД для sqlite3. Например edit_db.studio.tasks_db. Для тех случаев когда имя файла ДБ не соответствует имени таблицы (лучше передавать всегда).
Результат:

(True, „Ok!“) или (False, comment)
Тип результата:

tuple
update(level, read_ob, table_name, keys, update_data, where, table_root=False)

Редактирование строк в таблице БД.

Параметры:
  • level (str) – Уровень, варианты: studio, project (данные проекта или студии).
  • read_ob (edit_db.studio, edit_db.project) – Объект студии или проекта, для которого идёт взаимодействие с базой данных.
  • table_name (str) – Имя таблицы БД.
  • keys (dict) – Словарь, инициализирующий данную таблицу: ключи - заголовки, значения - типы данных (стандартные для sqlite3 + дополнительные, например json) например edit_db.studio.tasks_keys
  • update_data (dict) – Данные на замену, словарь по ключам из `keys.
  • where (dict) – Словарь для формирования строки sql оператора WHERE, содержит ключи по keys.
  • table_root (str, optional) – Имя файла БД для sqlite3. Например edit_db.studio.tasks_db. Для тех случаев когда имя файла ДБ не соответствует имени таблицы (лучше передавать всегда).
Результат:

(True, „Ok!“) или (False, comment)
Тип результата:

tuple