Standardize dev env, build and upload scripts

Author: edudobay

.gitignore

@@ -3,4 +3,6 @@
 MANIFEST
 build/
 dist/
-*.egg-info/
+*.egg-info/
+
+/venv

CONTRIBUTING.md

@@ -7,14 +7,18 @@ Project Conventions
 * **Source code formatting:** use [black][]. A recipe for running it is provided in the Makefile: just `make format`.
 
 
-Development Dependencies
-------------------------
+Development setup
+-----------------
 
-After setting up your virtual environment, install development dependencies:
+* Set up a Python virtual environment with `python -m venv venv` at the root of this project.
+* Run `make dev` to install the project in editable mode and install dependencies.
 
 ```shell
-$ pip install -r requirements-dev.in
+$ python -m venv venv
+$ make dev
 ```
 
+The Makefile is already configured to use Python from the virtual environment `venv`; for running other commands, activate it using `source venv/bin/activate`.
+
 
 [black]: https://black.readthedocs.io/en/stable/

Makefile

@@ -1,9 +1,16 @@
+project_dir := $(patsubst %/,%,$(dir $(realpath $(lastword $(MAKEFILE_LIST)))))
+PATH := $(project_dir)/venv/bin:$(PATH)
+
+all:
 
 format:
 	python -m black mingus mingus_examples unittest
 
+dev:
+	pip install -e '.[fft,fluidsynth]' -r requirements-dev.in
+
 install:
-	python setup.py install
+	pip install .
 
 test:
 	(cd unittest; python run_tests.py)
@@ -19,13 +26,19 @@ test-all: test test-fluidsynth test-lilypond
 clean:
 	rm -rf build/ dist/
 
-register:
-	python setup.py register
+build:
+	python setup.py sdist bdist_wheel
 
 upload:
-	python setup.py sdist upload
+	twine upload dist/*
 
 tag:
 	git tag $$(python setup.py --version)
 
-release: clean register upload tag
+release: clean build upload tag
+
+.PHONY: format \
+	dev install \
+	test test-fluidsynth test-lilypond test-all \
+	clean build \
+	upload tag release

requirements-dev.in

@@ -1 +1,3 @@
 black
+twine
+wheel