ml-initdb.py
------------
+Использование::
+
+ ml-initdb.py [-d]
+
+Опции::
+
+ -d, --database database Использовать указанную БД
+
Инициализирует базу данных и импортирует список жанров. Этот скрипт не
очень-то нужен, так как следующий скрипт делает всё указанное.
Использование::
- ml-import.py [file.inpx ...]
+ ml-import.py [-d] [file.inpx ...]
+
+Опции::
+
+ -d, --database database Использовать указанную БД
Инициализирует базу данных, импортирует список жанров и список файлов
INPX, перечисленных в командной строке. При повторных запусках не
Использование::
- ml-search.py [-i] [-I] [-t {exact,start,substring}] ...
+ ml-search.py [-d] [-i] [-I] [-t] [-s] [-f] [-v] [-c] ...
Программа выполняет поиск по базе данных и показывает список
результатов. В настоящее время может искать только в списке авторов.
Глобальные опции::
- -i, --ignore-case независимо от регистра (по умолчанию: угадать)
- -I, --case-sensitive с учётом регистра
- -t, --search-type {exact,start,substring}
- тип поиска: точный, подстрока в начале (это тип по умолчанию),
- подстрока в любом месте.
+ -d, --database database Использовать указанную БД
+ -i, --ignore-case независимо от регистра (по умолчанию: угадать)
+ -I, --case-sensitive с учётом регистра
+ -t, --start тип поиска: подстрока в начале строки
+ (это тип поиска по умолчанию)
+ -s, --substring тип поиска: подстрока в любом месте
+ -f, --full тип поиска: полное совпадение всей строки
+ -c, --count Выводить число найденных объектов, а не сами
+ объекты
+ -v, --verbose Выводить больше информации о найденных
+ объектах; повторите эту опцию несколько раз,
+ чтобы получить ещё больше деталей
Опции ``-i/-I`` не могут использованы одновременно, поскольку означают
противоположные команды. В случае, если ни одна из них не использована,
параметров есть параметры в ВЕРХНЕМ или Смешанном регистре - поиск будет
с учётом регистра.
-Опция ``-t/--search-type`` определяет тип поиска. Возможные значения:
+Опции ``-t/-s/-f`` определяют тип поиска. Возможные значения:
-* exact - поиск на точное совпадение; поиск "друг" найдёт только "друг",
- но не "другой";
* start - поиск подстроки в начале поля; поиск "друг" найдёт "друг" и
"другой", но не "подруга"; это тип по умолчанию;
* substring - поиск подстроки в любом месте; поиск "друг" найдёт "друг",
"другой" и "подруга".
+* full - поиск на точное совпадение всей строки; поиск "друг" найдёт
+ только "друг", но не "другой";
Поиск авторов
Использование::
- ml-search.py [-i] [-I] [-t ...] author [-s surname] [-n name] [-m misc]
+ ml-search.py author [-s surname] [-n name] [-m misc-name] [--id id] [fullname]
-Искать и печатать список авторов по фамилии, имени и доп. имени (обычно
-отчеству).
+Искать и печатать список авторов по фамилии, имени, доп. имени (обычно
+отчеству) или полному имени.
Опции::
- -s, --surname фамилия Искать по фамилии
- -n, --name имя Искать по имени
- -m, --misc доп. имени Искать по доп. имени
+ -s, --surname фамилия Искать по фамилии
+ -n, --name имя Искать по имени
+ -m, --misc-name доп. имени Искать по доп. имени
+ --id id Искать по id автора
Пример::
Искать и печатать список авторов, чья фамилия начинается на "друг" и имя
начинается на "в", без учёта регистра.
+При использовании опции `-v` также выводится id из БД.
+
+
+Поиск книг
+^^^^^^^^^^
+
+Использование::
+
+ ml-search.py books [-t title] [-s series] [-a archive] [-f file] [--id id] [--surname name] [--name name] [--misc-name name] [--fullname name] [--aid aid] [-e ext] [--eid eid] [--gname name] [--gtitle title] [--gid gid] [-l lang] [--lid lid]
+
+Искать и печатать список книг по заголовку, серии, архиву, имени файла.
+
+Опции::
+
+ -t, --title заголовок Искать по заголовку
+ -s, --series серия Искать по серии
+ -a, --archive архив Искать по имени архива (zip-файла)
+ -f, --file файл Искать по имени файла (без расширения)
+ --id id Искать по id книги
+ --surname surname Искать по фамилии автора
+ --name name Искать по имени автора
+ --misc-name misc. name Искать по доп. имени автора
+ --fullname name Искать по полному имени автора
+ --aid aid Искать по id автора
+ -e, --ext ext Искать по расширению имени файла
+ --eid eid Искать по id расширения
+ --gname name Искать по названию жанра
+ --gtitle title Искать по заголовку жанра
+ --gid gid Искать по id жанра
+ -l, --lang lang Искать по языку
+ --lid lid Искать по id языка
+
+По умолчанию программы выводит список заголовков найденных книг. При
+использовании опции `-v` также выводится id из БД, список авторов и
+жанров, а также серия, к которой принадлежит книга (если принадлежит) и
+порядковый номер книги в этой серии. С двумя опциями `-v` (`-v -v` или
+просто `-vv`) программа выводит дату файла и язык. С тремя `-v`
+выводятся имя архива, имя файла, расширение и размер файла, и признак,
+была ли книга помечена как удалённая.
+
+
+Поиск расширений
+^^^^^^^^^^^^^^^^
+
+Использование::
+
+ ml-search.py ext [name] [--id id]
+
+Опции::
+
+ --id id Искать по id расширения
+
+Искать и печатать список расширений имён файлов по имени.
+
+При использовании опции `-v` также выводится id из БД.
+
+
+Поиск жанров
+^^^^^^^^^^^^
+
+Использование::
+
+ ml-search.py genres [-n name] [-t title] [--id id]
+
+Искать и печатать список жанров по имени и заголовку.
+
+Опции::
+
+ -n, --name имя Искать по названию
+ -t, --title заголовок Искать по заголовку
+ --id id Искать по id жанра
+
+При использовании опции `-v` также выводится id из БД.
+
+
+Поиск языков
+^^^^^^^^^^^^
+
+Использование::
+
+ ml-search.py lang [name] [--id id]
+
+Опции::
+
+ --id id Искать по id языка
+
+Искать и печатать список языков по имени.
+
+При использовании опции `-v` также выводится id из БД.
+
.. vim: set tw=72 :