File: index.rst

package info (click to toggle)
python-musicpd 0.9.2-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 484 kB
  • sloc: python: 792; makefile: 6
file content (83 lines) | stat: -rw-r--r-- 1,812 bytes parent folder | download
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
.. SPDX-FileCopyrightText: 2018-2023  kaliko <kaliko@azylum.org>
.. SPDX-License-Identifier: LGPL-3.0-or-later

.. include:: ../../README.rst

Installation
=============

**Latest stable release** from `PyPi <https://pypi.org/project/python-musicpd/>`_:

.. code:: bash

   pip install python-musicpd

**Latest development version** using pip + git:

.. code:: bash

    pip install git+https://gitlab.com/kaliko/python-musicpd.git@dev


Library overview
================
Here is a snippet allowing to list the last modified artists in the media library:

.. code:: python3

        #!/usr/bin/env python3
        # coding: utf-8
        import musicpd

        def main():
            cli = musicpd.MPDClient()
            cli.connect()
            # Gets files count in the library
            nb_files = int(cli.stats()['songs'])
            # Gets the last 100 files modified
            files = cli.search('file', '', 'sort', 'Last-Modified', 'window', (nb_files-100,))
            # Print last modified artists in media library
            print(' / '.join({f.get('albumartist') for f in files}))
            cli.disconnect()

        # Script starts here
        if __name__ == '__main__':
            main()


Build documentation
===================

.. code:: bash

    # Get the source
    git clone https://gitlab.com/kaliko/python-musicpd.git && cd python-musicpd
    # Installs sphinx if needed
    python3 -m venv venv && . ./venv/bin/activate
    pip install sphinx
    # Call sphinx
    sphinx-build -d ./doc/build/doctrees doc/source -b html ./doc/build/html


Contents
=========

.. toctree::
   :maxdepth: 2

   self
   use.rst
   doc.rst
   examples.rst
   commands.rst
   contribute.rst


Indices and tables
==================

* :ref:`genindex`
* :ref:`search`


.. vim: spell spelllang=en