File: configuration.rst

package info (click to toggle)
cumin 5.1.1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 928 kB
  • sloc: python: 4,359; sh: 126; makefile: 21
file content (32 lines) | stat: -rw-r--r-- 1,264 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
Configuration
=============

.. _config.yaml:

config.yaml
-----------

The default configuration file for ``cumin`` is expected to be found at ``/etc/cumin/config.yaml``. Its path can
be changed in the CLI via the command-line switch ``--config PATH``. A commented example configuration is available in
the source code at ``doc/examples/config.yaml`` and included here below:

.. literalinclude:: ../examples/config.yaml
   :language: yaml

The example file is also shipped, depending on the installation method, to:

* ``$VENV_PATH/share/doc/cumin/examples/config.yaml`` when installed in a Python ``virtualenv`` via ``pip``.
* ``/usr/local/share/doc/cumin/examples/config.yaml`` when installed globally via ``pip``.
* ``/usr/share/doc/cumin/examples/config.yaml`` when installed via the Debian package.

aliases.yaml
------------

Cumin will also automatically load any aliases defined in a ``aliases.yaml`` file, if present in the same directory
of the main configuration file. An aliases example file is available in the source code at
``doc/examples/aliases.yaml`` and included here below:

.. literalinclude:: ../examples/aliases.yaml
   :language: yaml

The file is also shipped in the same directory of the example configuration file, see `config.yaml`_.