docs/install.rst

   1 Installation using pip
   2 ======================
   3
   4 System-wide
   5 -----------
   6
   7 ::
   8
   9     sudo pip install m_librarian
  10
  11 User mode
  12 ---------
  13
  14 ::
  15
  16     pip install --user m_librarian
  17
  18 Virtual envs
  19 ------------
  20
  21 ::
  22
  23     pip install m_librarian
  24
  25 Progress bar
  26 ============
  27
  28 To allow ``ml-import.py`` to display progress bar the program requires
  29 library ``m_lib``. You can install the library separately using, e.g.,
  30 command ``pip install m_lib``. Or you can install the library with
  31 ``m_librarian``: ``pip install m_librarian[pbar]``.
  32
  33 Other extras
  34 ============
  35
  36 ``pip install m_librarian[web]`` installs libraries needed for web-ui.
  37
  38 Installation from sources
  39 =========================
  40
  41 To install the library from sources system-wide run run the following
  42 command:
  43
  44 ::
  45
  46     sudo python setup.py install
  47
  48 If you don't want to install it system-wide you can install it in your
  49 home directory; run run the following command:
  50
  51 ::
  52
  53     python setup.py install --user
  54
  55 Option '--user' installs m_librarian into
  56 $HOME/.local/lib/python$MAJOR.$MINOR/site-packages/ where python finds it
  57 automatically. It also installs m_librarian scripts into $HOME/.local/bin;
  58 add the directory to your $PATH or move the scripts to a directory in your
  59 $PATH.