feat: switch to meson / mesonpep517 build system

Signed-off-by: Christopher Arndt <chris@chrisarndt.de>

Author: SpotlightKid

.flake8

@@ -0,0 +1,4 @@
+[flake8]
+ignore = E116, E265, E266, E731, W504
+max-line-length = 100
+exclude = docs,.tox,.git

.gitignore

@@ -8,14 +8,10 @@ src/_rtmidi.cpp
 # C extensions
 *.so
 
-# Generated documentation
-#INSTALL.rst
-
 # Packages
 *.egg
 *.egg-info
 dist/
-build/
 *.eggs/
 eggs/
 parts/
@@ -49,6 +45,8 @@ output/*/index.html
 
 # Sphinx
 docs/_build
+# docs build artifact
+rtmidi/version.py
 
 # Geany project
 python-rtmidi.geany

MANIFEST.in

@@ -1,18 +1,16 @@
-include fill_template.py
-include LICENSE.txt
 include Makefile
+include *.md
 include requirements-dev.txt
-include tox.ini
-include *.rst
-include src/_rtmidi.pyx
 include src/_rtmidi.cpp
-include src/pyinit.h
+include src/_rtmidi.pyx
 include src/rtmidi/RtMidi.cpp
 include src/rtmidi/RtMidi.h
+include tox.ini
 
 exclude .appveyor.yml
+exclude .gitignore
+exclude .gitmodules
 exclude .travis.yml
-exclude *.rst.in
 
 graft examples
 graft tests
@@ -22,4 +20,4 @@ prune ci
 recursive-exclude * __pycache__
 recursive-exclude * *.py[co]
 
-recursive-include docs *.rst *.inc conf.py Makefile make.bat
+recursive-include docs *.md *.rst *.inc conf.py Makefile make.bat

Makefile

@@ -1,6 +1,8 @@
 .PHONY: clean-pyc clean-build clean coverage docs dist lint release release_upload requirements test
 
-PYTHON ?= python
+BUILDDIR ?= builddir
+PREFIX ?= /usr/local
+PYTHON ?= python3
 SOURCES = src/_rtmidi.pyx src/rtmidi/RtMidi.cpp
 
 help:
@@ -19,16 +21,20 @@ help:
 	@echo "test - run tests on every supported Python version with tox"
 
 build: $(SOURCES)
-	$(PYTHON) setup.py build_ext --inplace
+	if [[ -d "$(BUILDDIR)" ]]; then \
+		meson setup --reconfigure "--prefix=$(PREFIX)" --buildtype=plain $(BUILDDIR); \
+	else \
+		meson setup "--prefix=$(PREFIX)" --buildtype=plain $(BUILDDIR); \
+	fi
+	meson compile -C $(BUILDDIR)
 
 check-docs:
-	pydocstyle rtmidi src
+	$(PYTHON) -m pydocstyle rtmidi
 
 clean: clean-build clean-docs clean-pyc
 	rm -fr htmlcov/
 
 clean-build:
-	rm -fr build/
 	rm -fr dist/
 	rm -fr *.egg-info
 	rm -fr rtmidi/*.so
@@ -44,37 +50,39 @@ clean-pyc:
 	find . -name __pycache__ -type d -exec rm -rf {} +
 
 coverage:
-	coverage run --source rtmidi setup.py test
-	coverage report -m
-	coverage html
-	xdg-open htmlcov/index.html
+	$(PYTHON) -mcoverage run --source rtmidi test
+	$(PYTHON) -mcoverage report -m
+	$(PYTHON) -mcoverage html
+	-xdg-open htmlcov/index.html
 
 dist: clean release
 	ls -l dist
 
-docs: release
+docs: build
+	cp -f $(BUILDDIR)/rtmidi/_rtmidi.*.so rtmidi/
+	cp -f $(BUILDDIR)/rtmidi/version.py rtmidi/
 	rm -f docs/rtmidi.rst
 	rm -f docs/modules.rst
-	$(PYTHON) setup.py build_ext --inplace
-	sphinx-apidoc -o docs/ rtmidi rtmidi/release.py
+	sphinx-apidoc -o docs rtmidi
 	cat docs/api.rst.inc >> docs/rtmidi.rst
 	$(MAKE) -C docs clean
 	$(MAKE) -C docs html
-	xdg-open docs/_build/html/index.html
+	-rm -f rtmidi/*.so rtmidi/version.py
+	-xdg-open docs/_build/html/index.html
 
 lint:
-	flake8 rtmidi tests examples
+	$(PYTHON) -m flake8 rtmidi tests examples
 
-release: clean
-	$(PYTHON) setup.py release
+release:
+	$(PYTHON) -m build
 
 release_upload: release
-	twine upload --skip-existing dist/*.tar.gz
+	$(PYTHON) -m twine upload --skip-existing dist/*.tar.gz dist/*.whl
 
 requirements-dev.txt: requirements-dev.in
 	pip-compile --quiet --resolver=backtracking --no-emit-index-url "$<" > "$@"
 
 requirements: requirements-dev.txt
 
 test:
-	PYTHONPATH=examples $(PYTHON) setup.py test
+	pytest -v tests

deploy.sh

@@ -13,7 +13,6 @@
 # All configuration values have a default; values that are commented out
 # serve to show the default.
 
-import configparser
 import sys
 import os
 
@@ -34,8 +33,6 @@
 
 
 meta = {}
-setupcfg = configparser.ConfigParser()
-setupcfg.read(os.path.join(project_root, 'setup.cfg'))
 version = os.path.join(project_root, 'rtmidi', 'version.py')
 exec(compile(open(version).read(), version, 'exec'), {}, meta)
 
@@ -61,8 +58,9 @@
 master_doc = 'index'
 
 # General information about the project.
-project = setupcfg['metadata']['name']
-copyright = u'2012 - 2022, %s' % setupcfg['metadata']['author']
+project = 'python-rtmidi'
+author = 'Christopher Arndt'
+copyright = f'2012 - 2022, {author}'
 
 # The version info for the project you're documenting, acts as replacement
 # for |version| and |release|, also used in various other places throughout
@@ -216,8 +214,8 @@
 # [howto/manual]).
 latex_documents = [
     ('index', 'rtmidi.tex',
-     u'python-rtmidi Documentation',
-     setupcfg['metadata']['author'], 'manual'),
+     'python-rtmidi Documentation',
+     author, 'manual'),
 ]
 
 # The name of an image file (relative to this directory) to place at
@@ -247,8 +245,8 @@
 # (source start file, name, description, authors, manual section).
 man_pages = [
     ('index', 'rtmidi',
-     u'python-rtmidi Documentation',
-     [setupcfg['metadata']['author']], 1)
+     f'{project} Documentation',
+     author, 1)
 ]
 
 # If true, show URL addresses after external links.
@@ -262,10 +260,10 @@
 #  dir menu entry, description, category)
 texinfo_documents = [
     ('index', 'rtmidi',
-     u'python-rtmidi Documentation',
-     setupcfg['metadata']['author'],
-     setupcfg['metadata']['name'],
-     setupcfg['metadata']['description'],
+     f'{project} Documentation',
+     author,
+     project,
+     '',
      'Miscellaneous'),
 ]
 

docs/conf.py

@@ -0,0 +1,56 @@
+project(
+    'python-rtmidi',
+    'cpp',
+    version: '1.5.0rc1',
+    license: 'MIT',
+    default_options: [
+        'warning_level=2'
+    ],
+    meson_version: '>=0.53.0'
+)
+
+# Dependencies
+cpp = meson.get_compiler('cpp')
+jack2_dep = dependency('jack', version:'>=1.9.11', required: false)
+jack1_dep = dependency('jack', version:'>=0.125.0, <1.0', required: false)
+alsa_dep = dependency('alsa', required: false)
+thread_dep = dependency('threads')
+coremidi_dep = dependency('threads', required: false)
+winmm_dep = dependency('threads', required: false)
+
+if not jack2_dep.found() and jack1_dep.found()
+    jack_dep = jack1_dep
+elif jack2_dep.found()
+    jack_dep = jack2_dep
+else
+    warning('No version of JACK found, which is recent enough (jack2>=1.9.11 or jack1>=0.125.0)')
+endif
+
+pymod = import('python')
+python = pymod.find_installation(
+    get_option('python'),
+    required: true
+)
+
+# Installation directories
+prefix = get_option('prefix')
+bindir = join_paths(prefix, get_option('bindir'))
+
+# Build jack_mix_box and generate _jack_mixer extension source
+subdir('src')
+
+# Build & install C extension module and Python package
+subdir('rtmidi')
+
+if not get_option('wheel')
+    meson.add_install_script('meson_postinstall.py')
+endif
+
+summary({
+    'Debug messages (verbose)': get_option('verbose'),
+    'Build for wheel': get_option('wheel'),
+    'ALSA support': target_machine.system() == 'linux' and alsa_dep.found() and get_option('alsa'),
+    'CoreMIDI support': target_machine.system() == 'darwin' and coremidi_dep.found() and get_option('coremidi'),
+    'JACK support': jack_dep.found() and get_option('jack'),
+    'Window MM support': target_machine.system() == 'windows' and winmm_dep.found() and get_option('winmm'),
+}, section: 'Configuration')

fill_template.py

@@ -0,0 +1,35 @@
+option('alsa',
+    type: 'boolean',
+    value: true,
+    description: 'Enable ALSA MIDI support'
+)
+option('coremidi',
+    type: 'boolean',
+    value: true,
+    description: 'Enable CoreMIDI support'
+)
+option('jack',
+    type: 'boolean',
+    value: true,
+    description: 'Enable JACK MIDI support'
+)
+option('python',
+    type: 'string',
+    value: 'python3',
+    description: 'Set name (or path) of Python interpreter'
+)
+option('verbose',
+    type: 'boolean',
+    value: false,
+    description: 'Turn on debug logging (for development)'
+)
+option('wheel',
+    type: 'boolean',
+    value: false,
+    description: 'Turn on build mode for creating a Python wheel (should not be used directly)'
+)
+option('winmm',
+    type: 'boolean',
+    value: true,
+    description: 'Enable Windows MultiMedia support'
+)