mididings 20230114__tar.gz → 20250818__tar.gz

mididings-20250818/.github/workflows/python-package.yml

@@ -0,0 +1,44 @@
+# This workflow will install Python dependencies, run tests and lint with a variety of Python versions
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python
+
+name: Python package
+
+on:
+  push:
+    branches: [ "primary", "github-ci" ]
+  pull_request:
+    branches: [ "primary" ]
+
+jobs:
+  build:
+
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: ["ubuntu-22.04", "ubuntu-24.04"]
+        python-version: ["3.9", "3.10", "3.11"]
+        exclude:
+          # ubuntu-22.04 and python 3.11 don't work for mididings
+          - os: "ubuntu-22.04"
+            python-version: "3.11"
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v3
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install System dependencies
+      run: |
+        python -m pip install yq
+        tomlq '."${{ matrix.os }}"."pkgs"[]' pkglist.toml | xargs sudo apt-get install
+    - name: Install Python dependencies
+      run: |
+        python -m pip install --upgrade pip
+        python -m pip install flake8 pytest meson-python
+    - name: Build and Install
+      run: |
+        python -m pip install .
+    - name: Test with pytest
+      run: |
+        pytest

mididings-20250818/.gitignore

@@ -0,0 +1,11 @@
+build
+dist
+*.egg-info
+__pycache__
+.pytest_cache
+.ruff_cache
+doc/man/*.1
+# emacs temporary files
+*~
+\#*
+.\#*

{mididings-20230114 → mididings-20250818}/MANIFEST.in

@@ -14,7 +14,7 @@ include .reuse/dep5
 recursive-include mididings *.py
 
 # extension source
-recursive-include src SConstruct *.hh *.cc
+recursive-include src *.hh *.cc
 
 # tests
 recursive-include tests *.py

{mididings-20230114 → mididings-20250818}/PKG-INFO

@@ -1,40 +1,36 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: mididings
-Version: 20230114
+Version: 20250818
 Summary: A MIDI router/processor
-Author-email: Dominic Sacré <dominic.sacre@gmx.de>
-Maintainer-email: George Rawlinson <george@rawlinson.net.nz>
-License: # Licenses
-        
-        mididings is available under the terms of the
-        [GNU General Public License, version 2 or later][spdx-gpl2].
-        
-        The example scripts in `doc/examples` are available under the terms of the
-        [GNU Free Documentation License 1.3 or later][spdx-gfdl].
-        
-        For your convenience, a copy of all licenses can be found in the `LICENSES`
-        directory.
-        
-        [spdx-gpl2]: https://spdx.org/licenses/GPL-2.0-or-later.html
-        [spdx-gfdl]: https://spdx.org/licenses/GFDL-1.3-or-later.html
-        
-Project-URL: homepage, https://github.com/mididings/mididings
-Project-URL: documentation, https://mididings.github.io/mididings/
+Author-Email: =?utf-8?q?Dominic_Sacr=C3=A9?= <dominic.sacre@gmx.de>
+Maintainer-Email: George Rawlinson <george@rawlinson.net.nz>
+License-File: LICENSE.md
+License-File: LICENSES/GFDL-1.3-or-later.txt
+License-File: LICENSES/GPL-2.0-or-later.txt
 Classifier: Topic :: Multimedia :: Sound/Audio :: MIDI
 Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)
-Classifier: License :: OSI Approved :: GNU Free Documentation License (FDL)
 Classifier: Development Status :: 5 - Production/Stable
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
+Project-URL: homepage, https://github.com/mididings/mididings
+Project-URL: documentation, https://mididings.github.io/mididings/
+Requires-Python: >=3.9
+Requires-Dist: decorator
+Requires-Dist: boost
 Provides-Extra: osc
+Requires-Dist: pyliblo3; extra == "osc"
 Provides-Extra: smf
+Requires-Dist: pysmf; extra == "smf"
 Provides-Extra: autorestart
+Requires-Dist: pyinotify>=0.8; extra == "autorestart"
 Provides-Extra: dbus
+Requires-Dist: dbus-python; extra == "dbus"
 Provides-Extra: xdg
+Requires-Dist: pyxdg; extra == "xdg"
 Provides-Extra: doc
+Requires-Dist: sphinx; extra == "doc"
+Requires-Dist: sphinxcontrib-fulltoc; extra == "doc"
 Provides-Extra: test
-License-File: LICENSE.md
+Requires-Dist: pytest; extra == "test"
+Description-Content-Type: text/markdown
 
 # mididings
 
@@ -82,8 +78,8 @@ mididings is available as [`mididings`][pkg-pypi] on PyPi:
 pip install mididings
 ```
 
-Optional dependencies can be installed, see next section
-(Dependencies/Optional)for a list of optional dependencies.
+Additionally you can tell pip to install dependencies for optional features (called `extras`)
+Which ones there are you can lookup in `pyproject.toml`, too.
 
 ```sh
 pip install mididings[osc,smf,dbus,autorestart,xdg]
@@ -98,6 +94,63 @@ official repositories:
 pacman -Syu mididings
 ```
 
+### Source
+
+If you want to test a new version of mididings or develop it, it's easiest to use a virtual environment (venv) into which mididings and all its dependencies are installed without touching a possibly system-wide installation of mididings.
+Execute this in the root of this repository:
+```sh
+# create and activate the venv
+python -m venv venv
+source venv/bin/activate
+# install mididings
+pip install . 
+```
+
+Optional dependencies work just as when installing mididings from PyPI.
+If you want e.g., MIDI file support and the tools to generate html documentation, you'd activate `smf` and `doc`:
+```sh
+pip install .[smf,doc]
+```
+
+You can check if mididings installed correctly by looking up it's path.
+```sh
+which mididings
+```
+
+This should point to a file inside `venv`.
+As long as you are in this environment you can edit the sources and rebuild by executing pip again.
+
+If you want to come back at a later time or have a second shell in the environment, just source the `activate` script:
+```sh
+source venv/bin/activate
+```
+
+#### System-wide installation
+Make sure you have all dependencies installed, either through your package manager, pip or any other method (have a look at the list of dependencies in `pyproject.toml`)
+If you want documentation, you also need [scdoc][scdoc] & [sphinx][sphinx] installed during the build process.
+
+```sh
+meson build --prefix=/usr/local
+meson compile -C build
+meson install -C build
+```
+
+### Packaging
+There are a few build options that might be of interest to you if you are a package maintainer.
+You can disable generating the documentation:
+```sh
+meson build -Ddocs=disabled -Dman=disabled
+```
+
+You can also generate the docs separately:
+```sh
+meson build -Ddocs-only=true
+meson compile -C build
+meson install
+```
+Note: You need to have mididings (and the matching version of it) installed, possibly in a venv, during build when using `docs-only=true`.
+
+## Development
 ## Dependencies
 
 ### Required
@@ -111,13 +164,17 @@ pacman -Syu mididings
 
 ### Optional
 
-* [pyliblo][pyliblo]: to send or receieve OSC messages
+* [pyliblo3][pyliblo3]: to send or receieve OSC messages
 * [pysmf][pysmf]: to read/write standard MIDI files using the `process_file()` function
 * [dbus-python][dbus-python]: to send DBUS messages
 * [pyinotify][pyinotify]: to automatically restart when a script changes
 * [tkinter][tkinter]: for the livedings GUI
 * [pyxdg][pyxdg]: so mididings knows where to look for configuration files
 
+### During Build
+* [scdoc][scdoc]: to generate man pages
+* [sphinx][sphinx]: and potentially more modules for it to generate html documentation (see `pyproject.toml`)
+
 ## Documentation
 
 * [API documentation][api-docs]
@@ -147,7 +204,7 @@ The example scripts in `doc/examples` are available under the terms of the
 [GNU Free Documentation License 1.3 or later][spdx-gfdl].
 
 [pkg-pypi]: https://pypi.org/project/mididings/
-[pkg-arch]: https://archlinux.org/packages/community/x86_64/mididings/
+[pkg-arch]: https://archlinux.org/packages/extra/x86_64/mididings/
 [original-home]: https://das.nasophon.de/mididings/
 [original-docs]: https://dsacre.github.io/mididings/doc/
 [python]: https://www.python.org
@@ -156,7 +213,9 @@ The example scripts in `doc/examples` are available under the terms of the
 [boost]: https://www.boost.org
 [glib]: https://docs.gtk.org/glib/
 [decorator]: https://github.com/micheles/decorator
-[pyliblo]: https://github.com/dsacre/pyliblo
+[scdoc]: https://git.sr.ht/~sircmpwn/scdoc
+[just]: https://github.com/casey/just
+[pyliblo]: https://github.com/gesellkammer/pyliblo3
 [pysmf]: https://github.com/dsacre/pysmf
 [dbus-python]: https://www.freedesktop.org/wiki/Software/dbus/
 [pyinotify]: https://github.com/seb-m/pyinotify
@@ -170,3 +229,4 @@ The example scripts in `doc/examples` are available under the terms of the
 [mailing-list]: https://groups.google.com/g/mididings
 [spdx-gpl2]: https://spdx.org/licenses/GPL-2.0-or-later.html
 [spdx-gfdl]: https://spdx.org/licenses/GFDL-1.3-or-later.html
+[sphinx]: https://www.sphinx-doc.org/en/master/

mididings-20230114/mididings.egg-info/PKG-INFO → mididings-20250818/README.md

@@ -1,41 +1,3 @@
-Metadata-Version: 2.1
-Name: mididings
-Version: 20230114
-Summary: A MIDI router/processor
-Author-email: Dominic Sacré <dominic.sacre@gmx.de>
-Maintainer-email: George Rawlinson <george@rawlinson.net.nz>
-License: # Licenses
-        
-        mididings is available under the terms of the
-        [GNU General Public License, version 2 or later][spdx-gpl2].
-        
-        The example scripts in `doc/examples` are available under the terms of the
-        [GNU Free Documentation License 1.3 or later][spdx-gfdl].
-        
-        For your convenience, a copy of all licenses can be found in the `LICENSES`
-        directory.
-        
-        [spdx-gpl2]: https://spdx.org/licenses/GPL-2.0-or-later.html
-        [spdx-gfdl]: https://spdx.org/licenses/GFDL-1.3-or-later.html
-        
-Project-URL: homepage, https://github.com/mididings/mididings
-Project-URL: documentation, https://mididings.github.io/mididings/
-Classifier: Topic :: Multimedia :: Sound/Audio :: MIDI
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)
-Classifier: License :: OSI Approved :: GNU Free Documentation License (FDL)
-Classifier: Development Status :: 5 - Production/Stable
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-Provides-Extra: osc
-Provides-Extra: smf
-Provides-Extra: autorestart
-Provides-Extra: dbus
-Provides-Extra: xdg
-Provides-Extra: doc
-Provides-Extra: test
-License-File: LICENSE.md
-
 # mididings
 
 A MIDI router/processor based on Python, supporting ALSA and JACK MIDI.
@@ -82,8 +44,8 @@ mididings is available as [`mididings`][pkg-pypi] on PyPi:
 pip install mididings
 ```
 
-Optional dependencies can be installed, see next section
-(Dependencies/Optional)for a list of optional dependencies.
+Additionally you can tell pip to install dependencies for optional features (called `extras`)
+Which ones there are you can lookup in `pyproject.toml`, too.
 
 ```sh
 pip install mididings[osc,smf,dbus,autorestart,xdg]
@@ -98,6 +60,63 @@ official repositories:
 pacman -Syu mididings
 ```
 
+### Source
+
+If you want to test a new version of mididings or develop it, it's easiest to use a virtual environment (venv) into which mididings and all its dependencies are installed without touching a possibly system-wide installation of mididings.
+Execute this in the root of this repository:
+```sh
+# create and activate the venv
+python -m venv venv
+source venv/bin/activate
+# install mididings
+pip install . 
+```
+
+Optional dependencies work just as when installing mididings from PyPI.
+If you want e.g., MIDI file support and the tools to generate html documentation, you'd activate `smf` and `doc`:
+```sh
+pip install .[smf,doc]
+```
+
+You can check if mididings installed correctly by looking up it's path.
+```sh
+which mididings
+```
+
+This should point to a file inside `venv`.
+As long as you are in this environment you can edit the sources and rebuild by executing pip again.
+
+If you want to come back at a later time or have a second shell in the environment, just source the `activate` script:
+```sh
+source venv/bin/activate
+```
+
+#### System-wide installation
+Make sure you have all dependencies installed, either through your package manager, pip or any other method (have a look at the list of dependencies in `pyproject.toml`)
+If you want documentation, you also need [scdoc][scdoc] & [sphinx][sphinx] installed during the build process.
+
+```sh
+meson build --prefix=/usr/local
+meson compile -C build
+meson install -C build
+```
+
+### Packaging
+There are a few build options that might be of interest to you if you are a package maintainer.
+You can disable generating the documentation:
+```sh
+meson build -Ddocs=disabled -Dman=disabled
+```
+
+You can also generate the docs separately:
+```sh
+meson build -Ddocs-only=true
+meson compile -C build
+meson install
+```
+Note: You need to have mididings (and the matching version of it) installed, possibly in a venv, during build when using `docs-only=true`.
+
+## Development
 ## Dependencies
 
 ### Required
@@ -111,13 +130,17 @@ pacman -Syu mididings
 
 ### Optional
 
-* [pyliblo][pyliblo]: to send or receieve OSC messages
+* [pyliblo3][pyliblo3]: to send or receieve OSC messages
 * [pysmf][pysmf]: to read/write standard MIDI files using the `process_file()` function
 * [dbus-python][dbus-python]: to send DBUS messages
 * [pyinotify][pyinotify]: to automatically restart when a script changes
 * [tkinter][tkinter]: for the livedings GUI
 * [pyxdg][pyxdg]: so mididings knows where to look for configuration files
 
+### During Build
+* [scdoc][scdoc]: to generate man pages
+* [sphinx][sphinx]: and potentially more modules for it to generate html documentation (see `pyproject.toml`)
+
 ## Documentation
 
 * [API documentation][api-docs]
@@ -147,7 +170,7 @@ The example scripts in `doc/examples` are available under the terms of the
 [GNU Free Documentation License 1.3 or later][spdx-gfdl].
 
 [pkg-pypi]: https://pypi.org/project/mididings/
-[pkg-arch]: https://archlinux.org/packages/community/x86_64/mididings/
+[pkg-arch]: https://archlinux.org/packages/extra/x86_64/mididings/
 [original-home]: https://das.nasophon.de/mididings/
 [original-docs]: https://dsacre.github.io/mididings/doc/
 [python]: https://www.python.org
@@ -156,7 +179,9 @@ The example scripts in `doc/examples` are available under the terms of the
 [boost]: https://www.boost.org
 [glib]: https://docs.gtk.org/glib/
 [decorator]: https://github.com/micheles/decorator
-[pyliblo]: https://github.com/dsacre/pyliblo
+[scdoc]: https://git.sr.ht/~sircmpwn/scdoc
+[just]: https://github.com/casey/just
+[pyliblo]: https://github.com/gesellkammer/pyliblo3
 [pysmf]: https://github.com/dsacre/pysmf
 [dbus-python]: https://www.freedesktop.org/wiki/Software/dbus/
 [pyinotify]: https://github.com/seb-m/pyinotify
@@ -170,3 +195,4 @@ The example scripts in `doc/examples` are available under the terms of the
 [mailing-list]: https://groups.google.com/g/mididings
 [spdx-gpl2]: https://spdx.org/licenses/GPL-2.0-or-later.html
 [spdx-gfdl]: https://spdx.org/licenses/GFDL-1.3-or-later.html
+[sphinx]: https://www.sphinx-doc.org/en/master/

mididings-20250818/REUSE.toml

@@ -0,0 +1,69 @@
+version = 1
+SPDX-PackageName = "mididings"
+SPDX-PackageSupplier = "George Rawlinson <george@rawlinson.net.nz>"
+SPDX-PackageDownloadLocation = "https://github.com/mididings/mididings"
+
+# documentation
+[[annotations]]
+path = [
+  "doc/conf.py",
+  "doc/**.rst",
+  "doc/**.html",
+  "doc/**.css",
+  "doc/**.conf",
+  "doc/**.png"
+]
+precedence = "aggregate"
+SPDX-FileCopyrightText = "2008-2015  Dominic Sacré  <dominic.sacre@gmx.de>, mididings contributors"
+SPDX-License-Identifier = "GPL-2.0-or-later"
+
+# documentation - example scripts
+[[annotations]]
+path = "doc/examples/**.py"
+precedence = "aggregate"
+SPDX-FileCopyrightText = "2008-2015  Dominic Sacré  <dominic.sacre@gmx.de>, mididings contributors"
+SPDX-License-Identifier = "GFDL-1.3-or-later"
+
+# build scripts
+[[annotations]]
+path = [
+  "meson.build",
+  "meson_options.txt",
+  "justfile",
+  "dev/get-buildpath.py",
+  "dev/update-version-strings.sh",
+  "doc/meson.build",
+  "doc/mesonconf.py.in",
+  ".github/workflows/python-package.yml",
+  "pkglist.toml"
+]
+precedence = "aggregate"
+SPDX-FileCopyrightText = "mididings contributors"
+SPDX-License-Identifier = "GFDL-1.3-or-later"
+
+# more documentation
+[[annotations]]
+path = [
+  "NEWS",
+  "README.md",
+  "MANIFEST.in",
+  "setup.py",
+  "pyproject.toml",
+  ".gitignore",
+  "doc/man/**"
+]
+precedence = "aggregate"
+SPDX-FileCopyrightText = "mididings contributors"
+SPDX-License-Identifier = "GPL-2.0-or-later"
+
+# source code
+[[annotations]]
+path = [
+  "mididings/**",
+  "src/**",
+  "tests/**",
+  "scripts/**",
+]
+precedence = "aggregate"
+SPDX-FileCopyrightText = "mididings contributors"
+SPDX-License-Identifier = "GPL-2.0-or-later"

mididings-20250818/dev/get-buildpath.py

@@ -0,0 +1,17 @@
+#!/usr/bin/env python3
+
+import platform
+import os
+
+# python -m build creates temporary directories when building the package,
+# we can use these temporary directories instead of installing the package
+# afterwards. the format of this path is as follows:
+# $(pwd)/build/lib.linux-x86_64-cpython-310
+
+cwd = os.getcwd()
+system = platform.system().lower()
+arch = platform.machine()
+impl = platform.python_implementation().lower()
+pyver = "".join(map(str, platform.python_version_tuple()[:2]))
+
+print(f"{cwd}/build/lib.{system}-{arch}-{impl}-{pyver}")

mididings-20250818/dev/update-version-strings.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+
+NEW_VERSION="$(date +%Y%m%d)"
+
+# pyproject.toml
+sed -e "s/\(^project.*,\) *version *: *'[^']*'/\1 version: '${NEW_VERSION}'/" -i meson.build
+

mididings-20250818/doc/conf.py

@@ -0,0 +1,64 @@
+# -*- coding: utf-8 -*-
+#
+import re
+
+from sphinx.domains.python import PyFunction
+from sphinx import addnodes
+
+import mesonconf
+
+# project-specific configuration
+project = "mididings"
+copyright = "mididings contributors"
+version = mesonconf.version
+
+# general configuration
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinxcontrib.fulltoc",
+]
+root_doc = "index"
+exclude_patterns = ["build"]
+templates_path = ["templates"]
+add_module_names = False
+
+# html configuration
+html_theme = "nasophon"
+html_theme_path = ["theme"]
+html_copy_source = False
+
+# extension configuration - autodoc
+autodoc_member_order = "bysource"
+autodoc_default_options = {
+    "members": True,
+    "undoc-members": True,
+}
+
+
+class DingsFunction(PyFunction):
+    """
+    Stripped-down version of the 'function::' directive that accepts an
+    additional argument in angle brackets, used to specify the node's
+    'fullname' attribute. This allows proper cross-references to mididings
+    operators.
+    """
+
+    def handle_signature(self, sig, signode):
+        m = re.match("(.*) <([\w.]*)>", sig)
+        if m:
+            op = m.group(1)
+            name = m.group(2)
+            modname = self.options.get("module", self.env.temp_data.get("py:module"))
+
+            signode["module"] = modname
+            signode["class"] = ""
+            signode["fullname"] = name
+            signode += addnodes.desc_name(op, op)
+
+            return name, None
+        else:
+            return super(PyFunction, self).handle_signature(sig, signode)
+
+
+def setup(app):
+    app.add_directive("dingsfun", DingsFunction)

{mididings-20230114 → mididings-20250818}/doc/engine.rst

@@ -5,4 +5,6 @@ This module contains functions to query or control the state of the mididings
 event processing engine from Python code.
 
 .. automodule:: mididings.engine
-    :exclude-members: run, process_file, Engine
+  :members:
+  :no-undoc-members:
+  :exclude-members: run, Engine

{mididings-20230114 → mididings-20250818}/doc/examples/router.py

@@ -6,8 +6,8 @@
 # /mididings/switch_scene <port> <channel>
 # to UDP port 56418.
 #
-# For example, using the send_osc command from pyliblo:
-# $ send_osc 56418 /mididings/switch_scene 13 1
+# For example, using the send_osc command from pyliblo3:
+# $ send_osc.py 56418 /mididings/switch_scene 13 1
 #
 
 from mididings import *

{mididings-20230114 → mididings-20250818}/doc/extra-units.rst

@@ -86,7 +86,7 @@ Messaging
 .. autofunction:: mididings.extra.osc.SendOSC
 
     Defined in :mod:`mididings.extra.osc`.
-    Requires `pyliblo <http://das.nasophon.de/pyliblo/>`_.
+    Requires `pyliblo3 <https://github.com/gesellkammer/pyliblo3>`_.
 
 .. autofunction:: mididings.extra.dbus.SendDBUS
 

{mididings-20230114 → mididings-20250818}/doc/extra.rst

@@ -32,7 +32,7 @@ function.
     :no-members:
 
     Defined in :mod:`mididings.extra.osc`.
-    Requires `pyliblo <http://das.nasophon.de/pyliblo/>`_.
+    Requires `pyliblo3 <https://github.com/gesellkammer/pyliblo3>`_.
 
 
 

mididings-20250818/doc/man/meson.build

@@ -0,0 +1,26 @@
+scdoc = find_program('scdoc', required: false)
+if get_option('man').enabled() and scdoc.found()
+
+  man_pages = {
+    'mididings': '1',
+    'livedings': '1',
+    'send_midi': '1',
+  }
+
+  foreach page, section : man_pages
+    name = f'@page@.@section@'
+    input = f'@page@.scd'
+    custom_target(input,
+                  input: files(input),
+                  output: name,
+                  command: scdoc,
+                  feed: true,
+                  capture: true,
+                  install: true,
+                  install_dir: get_option('mandir') / f'man@section@',
+                 )
+  endforeach
+
+elif get_option('man').enabled()
+  warning('The program scdoc could not be found, man pages will not be available.')
+endif

mididings-20250818/doc/meson.build

@@ -0,0 +1,47 @@
+sphinx = find_program('sphinx-build', required: false)
+
+if get_option('docs').enabled() and sphinx.found()
+
+configure_file(input: 'mesonconf.py.in',
+               output: 'mesonconf.py',
+               configuration: config)
+
+doc_rst_sources = [
+  'main',
+  'units',
+  'extra-units',
+  'connect',
+  'start',
+  'util',
+  'extra',
+  'misc',
+  'engine',
+  'index',
+  'event',
+  'tools',
+]
+
+doc_sources = []
+foreach rst: doc_rst_sources
+  doc_sources += [rst + '.rst']
+endforeach
+
+if get_option('docs-only')
+  sphinx_deps = []
+else
+  sphinx_deps = [mididings_extension_module]
+endif
+
+custom_target('docs',
+              command: [sphinx, '-q', '-b', 'html', meson.current_source_dir(), meson.current_build_dir() / 'html'],
+              input: files(doc_sources),
+              depends: sphinx_deps,
+              output: 'html',
+              env: {'PYTHONPATH': meson.current_build_dir()},  # PYTHONPATH for mesonconf.py
+              install_dir: get_option('datadir') / 'doc/mididings',
+              install: true,
+             )
+
+elif get_option('docs').enabled()
+  warning('The program sphinx-build could not be found, html docs will not be available.')
+endif