docs-ru/command_line.rst

   1
   2 Скрипты командной строки
   3 ========================
   4
   5
   6 .. contents::
   7    :local:
   8
   9
  10 ml-initdb.py
  11 ------------
  12
  13 Инициализирует базу данных и импортирует список жанров. Этот скрипт не
  14 очень-то нужен, так как следующий скрипт делает всё указанное.
  15
  16
  17 ml-import.py
  18 ------------
  19
  20 Использование::
  21
  22     ml-import.py [file.inpx ...]
  23
  24 Инициализирует базу данных, импортирует список жанров и список файлов
  25 INPX, перечисленных в командной строке. При повторных запусках не
  26 переинициализирует БД и не переимпортирует жанры; так же не
  27 переимпортирует уже проимпортированные книги, но импортирует в БД новые.
  28
  29
  30 ml-search.py
  31 ------------
  32
  33 Использование::
  34
  35     ml-search.py [-i] [-I] [-t] [-s] [-f] [-d] [-c] ...
  36
  37 Программа выполняет поиск по базе данных и показывает список
  38 результатов. В настоящее время может искать только в списке авторов.
  39
  40 Глобальные опции::
  41
  42     -i, --ignore-case     независимо от регистра (по умолчанию: угадать)
  43     -I, --case-sensitive  с учётом регистра
  44     -t, --start           тип поиска: подстрока в начале строки
  45                           (это тип поиска по умолчанию)
  46     -s, --substring       тип поиска: подстрока в любом месте
  47     -f, --full            тип поиска: полное совпадение всей строки
  48     -c, --count           Выводить число найденных объектов, а не сами
  49                           объекты
  50     -v, --verbose         Выводить больше информации о найденных
  51                           объектах; повторите эту опцию несколько раз,
  52                           чтобы получить ещё больше деталей
  53
  54 Опции ``-i/-I`` не могут использованы одновременно, поскольку означают
  55 противоположные команды. В случае, если ни одна из них не использована,
  56 программа угадывает зависимость от регистра: если все параметры даны в
  57 нижнем регистре, программы выполнит поиск без учёта регистра. Если среди
  58 параметров есть параметры в ВЕРХНЕМ или Смешанном регистре - поиск будет
  59 с учётом регистра.
  60
  61 Опции ``-t/-s/-f`` определяют тип поиска. Возможные значения:
  62
  63 * start - поиск подстроки в начале поля; поиск "друг" найдёт "друг" и
  64   "другой", но не "подруга"; это тип по умолчанию;
  65 * substring - поиск подстроки в любом месте; поиск "друг" найдёт "друг",
  66   "другой" и "подруга".
  67 * full - поиск на точное совпадение всей строки; поиск "друг" найдёт
  68   только "друг", но не "другой";
  69
  70
  71 Поиск авторов
  72 ^^^^^^^^^^^^^
  73
  74 Использование::
  75
  76     ml-search.py [-i/-I] [-t/-s/-f] author [-s surname] [-n name] [-m misc-name] [--id id] [fullname]
  77
  78 Искать и печатать список авторов по фамилии, имени, доп. имени (обычно
  79 отчеству) или полному имени.
  80
  81 Опции::
  82
  83     -s, --surname фамилия       Искать по фамилии
  84     -n, --name имя              Искать по имени
  85     -m, --misc-name доп. имени  Искать по доп. имени
  86     --id id                     Искать по id автора
  87
  88 Пример::
  89
  90     ml-search.py -i author -s друг
  91
  92 Искать и печатать список авторов, чья фамилия начинается на "друг", без
  93 учёта регистра.
  94
  95 Если использовать несколько опций, поиск будет сужен оператором "И".
  96 Пример::
  97
  98     ml-search.py -i author -s друг -n в
  99
 100 Искать и печатать список авторов, чья фамилия начинается на "друг" и имя
 101 начинается на "в", без учёта регистра.
 102
 103 При использовании опции `-d` также выводится id из БД.
 104
 105
 106 Поиск книг
 107 ^^^^^^^^^^
 108
 109 Использование::
 110
 111     ml-search.py [-i/-I] [-t/-s/-f] 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]
 112
 113 Искать и печатать список книг по заголовку, серии, архиву, имени файла.
 114
 115 Опции::
 116
 117     -t, --title заголовок  Искать по заголовку
 118     -s, --series серия     Искать по серии
 119     -a, --archive архив    Искать по имени архива (zip-файла)
 120     -f, --file файл        Искать по имени файла (без расширения)
 121     --id id                Искать по id книги
 122     --surname surname      Искать по фамилии автора
 123     --name name            Искать по имени автора
 124     --misc-name misc. name Искать по доп. имени автора
 125     --fullname name        Искать по полному имени автора
 126     --aid aid              Искать по id автора
 127     -e, --ext ext          Искать по расширению имени файла
 128     --eid eid              Искать по id расширения
 129     --gname name           Искать по названию жанра
 130     --gtitle title         Искать по заголовку жанра
 131     --gid gid              Искать по id жанра
 132     -l, --lang lang        Искать по языку
 133     --lid lid              Искать по id языка
 134
 135 По умолчанию программы выводит список заголовков найденных книг. При
 136 использовании опции `-d` также выводится id из БД, список авторов и
 137 жанров, а также серия, к которой принадлежит книга (если принадлежит) и
 138 порядковый номер книги в этой серии. С двумя опциями `-d` (`-d -d` или
 139 просто `-dd`) программа выводит дату файла и язык. С тремя `-d`
 140 выводятся имя архива, имя файла, расширение и размер файла, и признак,
 141 была ли книга помечена как удалённая.
 142
 143
 144 Поиск расширений
 145 ^^^^^^^^^^^^^^^^
 146
 147 Использование::
 148
 149     ml-search.py [-i/-I] [-t/-s/-f] ext [name] [--id id]
 150
 151 Опции::
 152
 153     --id id                Искать по id расширения
 154
 155 Искать и печатать список расширений имён файлов по имени.
 156
 157 При использовании опции `-d` также выводится id из БД.
 158
 159
 160 Поиск жанров
 161 ^^^^^^^^^^^^
 162
 163 Использование::
 164
 165     ml-search.py [-i/-I] [-t/-s/-f] genres [-n name] [-t title] [--id id]
 166
 167 Искать и печатать список жанров по имени и заголовку.
 168
 169 Опции::
 170
 171     -n, --name имя         Искать по названию
 172     -t, --title заголовок  Искать по заголовку
 173     --id id                Искать по id жанра
 174
 175 При использовании опции `-d` также выводится id из БД.
 176
 177
 178 Поиск языков
 179 ^^^^^^^^^^^^
 180
 181 Использование::
 182
 183     ml-search.py [-i/-I] [-t/-s/-f] lang [name] [--id id]
 184
 185 Опции::
 186
 187     --id id                Искать по id языка
 188
 189 Искать и печатать список языков по имени.
 190
 191 При использовании опции `-d` также выводится id из БД.
 192
 193 .. vim: set tw=72 :