Updated Makefile

Makefile

@@ -1,3 +1,7 @@
+REQUIREMENTS_TXT ?= requirements.txt requirements-dev.txt
+.DEFAULT_GOAL := help
+
+.PHONY: help dev test
 include Makefile.venv
 Makefile.venv:
 	curl \
@@ -7,28 +11,31 @@ Makefile.venv:
 		| sha256sum --check - \
 		&& mv Makefile.fetched Makefile.venv
 
-all: pip dev
+help:	# Help for the Makefile
+	@egrep -h '\s##\s' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'
 
-.PHONY: dev
+dev: venv  ## Create the virtualenv with all the requirements installed
-dev: venv
 
-clean: clean-venv
+docs: build
+	cp README.rst docs/readme.rst
+	cp Changelog docs/changelog.rst
+	tox -edocs
+
+clean: clean-venv  ## Clean out any build artifacts to start over
 	rm -rf dist/*
 
-.PHONY: test
+test: dev  ## Run all the tox tests
-test: dev
 	tox -p all
 
-build: test
+build: test  ## Make the build artifact prior to doing an upload
 	$(VENV)/python3 setup.py sdist bdist_wheel
 	$(VENV)/twine check dist/*
 
-upload: build
+upload: build  ## Upload a new version of the plugin
-	$(VENV)/twine upload dist/*a
+	$(VENV)/twine upload dist/*
 
-check: dev # Code format check with isort and black
+check: dev ## Code format check with tox and pep8
-	tox -efmt-check
 	tox -epep8
 
-fix: dev # fixes code formatting with isort and black
+fix: dev ## fixes code formatting with gray
 	tox -efmt

requirements-dev.txt

@@ -1,11 +1,12 @@
-pip==19.2.3
+pip
-bump2version==0.5.11
+pip-tools
-wheel==0.33.6
+bump2version
-watchdog==0.9.0
+wheel
-flake8==3.7.8
+watchdog
-tox==3.14.0
+flake8
-coverage==4.5.4
+tox
-Sphinx==1.8.5
+coverage
-twine==1.14.0
+Sphinx
-pytest==6.2.4
+twine
+pytest==6.2.5
 gray