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 {exact,start,substring}] ...
  36
  37 Программа выполняет поиск по базе данных и показывает список
  38 результатов. В настоящее время может искать только в списке авторов.
  39
  40 Глобальные опции::
  41
  42     -i, --ignore-case     независимо от регистра (по умолчанию: угадать)
  43     -I, --case-sensitive  с учётом регистра
  44     -t, --search-type {exact,start,substring}
  45         тип поиска: точный, подстрока в начале (это тип по умолчанию),
  46         подстрока в любом месте.
  47
  48 Опции ``-i/-I`` не могут использованы одновременно, поскольку означают
  49 противоположные команды. В случае, если ни одна из них не использована,
  50 программа угадывает зависимость от регистра: если все параметры даны в
  51 нижнем регистре, программы выполнит поиск без учёта регистра. Если среди
  52 параметров есть параметры в ВЕРХНЕМ или Смешанном регистре - поиск будет
  53 с учётом регистра.
  54
  55 Опция ``-t/--search-type`` определяет тип поиска. Возможные значения:
  56
  57 * exact - поиск на точное совпадение; поиск "друг" найдёт только "друг",
  58   но не "другой";
  59 * start - поиск подстроки в начале поля; поиск "друг" найдёт "друг" и
  60   "другой", но не "подруга"; это тип по умолчанию;
  61 * substring - поиск подстроки в любом месте; поиск "друг" найдёт "друг",
  62   "другой" и "подруга".
  63
  64
  65 Поиск авторов
  66 ^^^^^^^^^^^^^
  67
  68 Использование::
  69
  70     ml-search.py [-i] [-I] [-t ...] author [-s surname] [-n name] [-m misc-name]
  71
  72 Искать и печатать список авторов по фамилии, имени и доп. имени (обычно
  73 отчеству).
  74
  75 Опции::
  76
  77     -s, --surname фамилия       Искать по фамилии
  78     -n, --name имя              Искать по имени
  79     -m, --misc-name доп. имени  Искать по доп. имени
  80
  81 Пример::
  82
  83     ml-search.py -i author -s друг
  84
  85 Искать и печатать список авторов, чья фамилия начинается на "друг", без
  86 учёта регистра.
  87
  88 Если использовать несколько опций, поиск будет сужен оператором "И".
  89 Пример::
  90
  91     ml-search.py -i author -s друг -n в
  92
  93 Искать и печатать список авторов, чья фамилия начинается на "друг" и имя
  94 начинается на "в", без учёта регистра.
  95
  96 Поиск расширений
  97 ^^^^^^^^^^^^^^^^
  98
  99 Использование::
 100
 101     ml-search.py [-i] [-I] [-t ...] ext name
 102
 103 Искать и печатать список расширений имён файлов по имени.
 104
 105 Поиск жанров
 106 ^^^^^^^^^^^^
 107
 108 Использование::
 109
 110     ml-search.py [-i] [-I] [-t ...] genres [-n name] [-t title]
 111
 112 Искать и печатать список жанров по имени и заголовку.
 113
 114 Опции::
 115
 116     -n, --name имя         Искать по названию
 117     -t, --title заголовок  Искать по заголовку
 118
 119 .. vim: set tw=72 :