2 Скрипты командной строки
3 ========================
19 -d, --database database Использовать указанную БД
21 Инициализирует базу данных и импортирует список жанров. Этот скрипт не
22 очень-то нужен, так как следующий скрипт делает всё указанное.
30 ml-import.py [-d] [file.inpx ...]
34 -d, --database database Использовать указанную БД
36 Инициализирует базу данных, импортирует список жанров и список файлов
37 INPX, перечисленных в командной строке. При повторных запусках не
38 переинициализирует БД и не переимпортирует жанры; так же не
39 переимпортирует уже проимпортированные книги, но импортирует в БД новые.
47 ml-search.py [-d] [-i] [-I] [-t] [-s] [-f] [-v] [-c] ...
49 Программа выполняет поиск по базе данных и показывает список
50 результатов. В настоящее время может искать только в списке авторов.
54 -d, --database database Использовать указанную БД
55 -i, --ignore-case независимо от регистра (по умолчанию: угадать)
56 -I, --case-sensitive с учётом регистра
57 -t, --start тип поиска: подстрока в начале строки
58 (это тип поиска по умолчанию)
59 -s, --substring тип поиска: подстрока в любом месте
60 -f, --full тип поиска: полное совпадение всей строки
61 -c, --count Выводить число найденных объектов, а не сами
63 -v, --verbose Выводить больше информации о найденных
64 объектах; повторите эту опцию несколько раз,
65 чтобы получить ещё больше деталей
67 Опции ``-i/-I`` не могут использованы одновременно, поскольку означают
68 противоположные команды. В случае, если ни одна из них не использована,
69 программа угадывает зависимость от регистра: если все параметры даны в
70 нижнем регистре, программы выполнит поиск без учёта регистра. Если среди
71 параметров есть параметры в ВЕРХНЕМ или Смешанном регистре - поиск будет
74 Опции ``-t/-s/-f`` определяют тип поиска. Возможные значения:
76 * start - поиск подстроки в начале поля; поиск "друг" найдёт "друг" и
77 "другой", но не "подруга"; это тип по умолчанию;
78 * substring - поиск подстроки в любом месте; поиск "друг" найдёт "друг",
80 * full - поиск на точное совпадение всей строки; поиск "друг" найдёт
81 только "друг", но не "другой";
89 ml-search.py author [-s surname] [-n name] [-m misc-name] [--id id] [fullname]
91 Искать и печатать список авторов по фамилии, имени, доп. имени (обычно
92 отчеству) или полному имени.
96 -s, --surname фамилия Искать по фамилии
97 -n, --name имя Искать по имени
98 -m, --misc-name доп. имени Искать по доп. имени
99 --id id Искать по id автора
103 ml-search.py -i author -s друг
105 Искать и печатать список авторов, чья фамилия начинается на "друг", без
108 Если использовать несколько опций, поиск будет сужен оператором "И".
111 ml-search.py -i author -s друг -n в
113 Искать и печатать список авторов, чья фамилия начинается на "друг" и имя
114 начинается на "в", без учёта регистра.
116 При использовании опции `-v` также выводится id из БД.
119 Поиск и загрузка книг
120 ^^^^^^^^^^^^^^^^^^^^^
124 ml-search.py books [-t title] [-s series] [-a archive] [-f file] [-p path] [--get] [--get-many N] [--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]
126 Искать и печатать список книг по заголовку, серии, архиву, имени файла.
130 -t, --title заголовок Искать по заголовку
131 -s, --series серия Искать по серии
132 -a, --archive архив Искать по имени архива (zip-файла)
133 -f, --file файл Искать по имени файла (без расширения)
134 -p, --path path Путь к директории с архивами библиотеки
135 --get Загрузить ровно один файл
136 --get-many N Загрузить не больше указанного числа файлов
137 --id id Искать по id книги
138 --surname surname Искать по фамилии автора
139 --name name Искать по имени автора
140 --misc-name misc. name Искать по доп. имени автора
141 --fullname name Искать по полному имени автора
142 --aid aid Искать по id автора
143 -e, --ext ext Искать по расширению имени файла
144 --eid eid Искать по id расширения
145 --gname name Искать по названию жанра
146 --gtitle title Искать по заголовку жанра
147 --gid gid Искать по id жанра
148 -l, --lang lang Искать по языку
149 --lid lid Искать по id языка
151 По умолчанию программы выводит список заголовков найденных книг. При
152 использовании опции `-v` также выводится id из БД, список авторов и
153 жанров, а также серия, к которой принадлежит книга (если принадлежит) и
154 порядковый номер книги в этой серии. С двумя опциями `-v` (`-v -v` или
155 просто `-vv`) программа выводит дату файла и язык. С тремя `-v`
156 выводятся имя архива, имя файла, расширение и размер файла, и признак,
157 была ли книга помечена как удалённая.
159 Опция `-p` задаёт путь к директории с архивами библиотеки. По умолчанию
160 этот путь берётся из файла конфигурации `m_librarian`, секция
161 `[library]`, ключ `path`, например::
164 path = /var/lib/archives
166 Опция полезна в ситуации работы с несколькими базами данных (глобальная
169 Опция `--get` позволяет загрузить книгу из библиотеки в файл. Опция
170 позволяет загрузить ровно одну книгу, поэтому самый простой способ
171 использовать эту команду — совместно с опцией `--id`. Файл сохраняется в
172 текущую директорию с тем именем, под которым он храниться в библиотеке.
174 Ключ `format` в секции `[download]` файла конфигурации m_librarian.conf
177 | format = %a/%s/%n %t
179 позволяет управлять именами директорий и именем файла, куда m_Librarian
180 будет сохранять файлы. Формат по умолчанию `%f`, т.е. просто имя файла.
181 Другие доступные спецификаторы::
183 %a - автор (один из, если их несколько)
184 %e - расширение имени файла
186 %G - жанр (один из, если их несколько), имя из БД
187 %g - жанр (один из, если их несколько), название
189 %n - номер в серии (или 0)
193 Формат не должен заканчиваться на разделитель директорий (`/` или `\\`).
194 Если спецификатор `%e` (расширение) не найден в формате, он добавляется
195 в конец с точкой в качестве разделителя. Т.о. формат `%f` эквивалентен
198 Опция `--get-many N` позволяет загрузить указанное число книг (не больше
199 чем N, где N — целое число.) Опции `--get-many N` и `--get` взаимно
200 исключают друг друга и не должны использоваться одновременно.
208 ml-search.py ext [name] [--id id]
212 --id id Искать по id расширения
214 Искать и печатать список расширений имён файлов по имени.
216 При использовании опции `-v` также выводится id из БД.
224 ml-search.py genres [-n name] [-t title] [--id id]
226 Искать и печатать список жанров по имени и заголовку.
230 -n, --name имя Искать по названию
231 -t, --title заголовок Искать по заголовку
232 --id id Искать по id жанра
234 При использовании опции `-v` также выводится id из БД.
242 ml-search.py lang [name] [--id id]
246 --id id Искать по id языка
248 Искать и печатать список языков по имени.
250 При использовании опции `-v` также выводится id из БД.