Dev database tasks

[futorio]

Примеры использования методов класса TasksDatabase

Подключение базы данных задач

from tasksdb import TasksDatabase
from task import Task

# Если базы данных не существует произойдёт исключение OSError("database does not exist")
tasks_db = TasksDatabase("bot/dbs/tasks")

Для сохранения изменений базу данных необходимо закрыть методом close

# Закрыть базу данных с сохранением изменений
tasks_db.close()

# Так же можно вызвать метод, явно указав параметр save=True
tasks_db.close(save=True)

# Для того, чтобы отменить изменения, нужно вызвать метод с параметром save=False
tasks_db.close(save=False)

Поиск в базе данных

По имени:

# Метод вернёт все объекты класса Task, в имени которых есть подстрока "Найти"
tasks = tasks_db.find_tasks_by_name("Найти")

По номеру:

# Метод вернёт объект класса Task.
# Если такого номера нет, происходит исключение ValueError("task number out of range")
task = tasks_db.find_task_by_number(10)

По тегам:

# Теги можно передавать в двух режимах. За выбор режима отвечает параметр mode
# mode="or" - хотя бы один тег должен присутвовать в тегах задания
# mode="and" - все теги должны присутствовать в тегах задания
# по умолчанию mode="or"

tags = ["char", "string"]
tasks = tasks_db.find_tasks_by_tags(tags)
tasks = tasks_db.find_tasks_by_tags(tags, mode="and")

По уровню сложности:

# Метод оперирует классом Complexity и возвращает все задания с данным уровнем сложности
tasks = tasks_db.find_tasks_by_level(Complexity.Easy)

Добавление новых задач

# Метод записывает новый объек класса Task в базу данных
tasks_db.add_task(task)

Редактирование существующих задач

# Редактирование производится по номеру задания
# Параметры редактирования задаются словарём
# Ключ словаря - название столбца

task_number = 10
# Здесь теги передаются в виде строки, а не в виде списка, я перепишу в скором времени
task_params = {"tags": "char|string|chars"}
tasks_db.edit_task(task_number, task_params)

UPD

Добавлен атрибут объекта last_task_number. Он создаётся при инициализации нового объекта класса и хранит номер последней задачи. Пример использования - получение рандомной задачи:

def get_random_task() -> Task:
	random_number = randomint(1, tasks_db.last_task_number)
	return tasks_db.find_by_number(random_number)

[LostInKadath]

Кто будет устанавливать mode? И кто будет обрабатывать исключения? Если пользователь, то ему это не нужно. Он должен вводить несколько тегов в окошко и получать результат. Значит, должен быть код-обертка над find_tasks_by_tags, который принимает от пользователя строку, парсит ее на теги, упаковывает их в список, устанавливает mode и вызывает метод TasksDatabase.find_tasks_by_tags. Этот код реализован?

[LostInKadath]

Предлагаю сделать поиск только по mode=='or' и выдавать вариант с наибольшим количеством совпадений тегов. Если пользователь ввел один тег, то искать его наличие. Если несколько, то подбирать несколько записей - здесь совпали все теги, здесь не найден один, здесь не найдены два - и из этих записей выбирать ответ пользователю.

Плюс сейчас, насколько я понимаю, никак не распознается ошибка по тегам - типа "такого тега не существует" или "не найдено задач". Кто будет выполнять такую проверку?

[Davletov]

@futorio, сделай изменения, про ктр написал @LostInKadath
Остальное выглядит отлично!

[LostInKadath]

Database: DB development

[LostInKadath]

По коду последних пяти коммитов вопросов нет. Однако придержим эту ветку разработки до тех пор, пока не появится кристальная ясность - как дальше жить. =)