Document variables in Makefile

Prepare for training on how to Normalize make.

* [doc] New expected output from make.py --make in README.md
* [py] Implement make.py --make as in README.md
* [sh] Use make.py --dep as in README.md

Author: Joppe

README.md

@@ -72,44 +72,6 @@ If they are already in the directory or linked to from the directory, internet a
 Dependencies:
 requests tiktoken # Needed for the --prompt option
 
-
-```
-
----
-
-Standalone variant:
-
-```sh
-$ make.py --make
-bringup: build/make.py.bringup  # Default: Make sure everything is setup OK
-tested: build/make.py.tested  # Make sure everything tested OK
-
-build/make.py.shebang: make.py | $(PYTHON)  # Make sure make.py has a working shebang
-	mkdir -p build/ && \
-	make.py --shebang > $@
-build/make.py.bringup: make.py build/make.py.shebang | $(PYTHON)  # Make sure make.py is setup OK
-	$(PYTHON) -m pip install requests tiktoken --no-warn-script-location > $@
-build/make.py.tested: make.py build/make.py.bringup   # Make sure make.py tested OK
-	make.py --test > $@
-
-```
-
----
-
-Standalone variant with dynamic bringup:
-
-```sh
-$ make.py --make --dep make.py.mk
-bringup: make.py.bringup  # Default: Make sure everything is setup OK
-tested: make.py.tested  # Make sure everything tested OK
-
-make.py.shebang: make.py | $(PYTHON)  # Make sure make.py has a working shebang
-	make.py --shebang > $@
-make.py.mk: make.py make.py.shebang | $(PYTHON)  # Make sure make.py can be setup
-	$(PYTHON) make.py --dep $@ > /dev/null
--include make.py.mk  # make.py.bringup: make.py.shebang ; <setup>
-make.py.tested: make.py make.py.bringup   # Make sure make.py tested OK
-	make.py --test > $@
 ```
 
 - Python version 3.9 or later is required, and will be installed automatically if missing on the OS.

example/README.md

@@ -41,18 +41,22 @@ Hello from greeter.cpp!
 \footnotesize
 ~~~ {.sh}
 $ cat build/greeter.py.mk
-$/build/greeter.py.bringup: $/greeter.py $/build/greeter.py.shebang $($/_EXE) | $/venv/$(VENV_PYTHON)  # Make sure $/greeter.py is setup OK
+$!greeter.py.bringup: $/greeter.py $!greeter.py.shebang $($/_EXE) | $($/_PYTHON)  # Make sure $/greeter.py is setup OK
 	$| -m pip install fire --no-warn-script-location > $@
 
 $ greeter.py --help | awk '{ print "\t" $0 }'
 	usage: greeter.py [-h] [--shebang] [--generic] [--make] [--dep DEP] [--pips]
 	                  [-c C] [--timeout TIMEOUT] [--test] [--sh-test SH_TEST]
+	                  [PYTHON_FILE]
 	
 	Greetings from the source code
 	
 		function hello: Greetings from the source code examples in this folder
 		function run: Run a command and return the decoded result
 	
+	positional arguments:
+	  PYTHON_FILE        Python file to fixup
+	
 	option...:
 	  -h, --help         show this help message and exit
 	  --shebang          Insert a local venv shebang, print its PATH configuration
@@ -94,5 +98,62 @@ $ greeter.py --help | awk '{ print "\t" $0 }'
 	$ greeter.py run example
 	Hello from main.c!
 	Hello from greeter.cpp!
+
 ~~~
 \normalsize
+
+---
+
+Standalone variant:
+
+```sh
+$ greeter.py --make --dep test/greeter.py.mk | tee test/greeter.mk
+# Path/variable prefix
+/ := $(patsubst %build/,%,$(patsubst ./%,%,$(patsubst C:/%,/c/%,$(subst \,/,$(dir $(Makefile))))))
+
+# Build directory
+! ?= $/test/
+
+# Default python interpreter
+PYTHON ?= $(shell command -v python3 || cygpath -m `which python.exe`)
+
+# Python interpreter
+$/_PYTHON ?= $(PYTHON)
+
+# Local Python modules to match
+* ?= greeter
+
+# Matched Python modules here
+*.py := $(wildcard $/$*.py)
+
+# Suggested targets
+$/bringup: $(*.py:%=$!%.bringup)  # Default: Make sure everything is setup OK
+$/tested: $(*.py:%=$!%.tested)  # Recommended: Make sure everything tested OK
+
+# Make sure a local build directory (@) exists
+ifneq (,$!)
+  $!:
+	  mkdir -p $@
+endif
+
+# Make sure the python module (<) uses make, has the right python shebang and is on PATH
+$!$*.py.shebang: $/make.py $/$*.py | $($/_PYTHON) $!
+	$(firstword $|) $^ --shebang > $@ && cat $@ && sh $@
+
+# Make sure the python module (<) has an up-to-date $!$*.py.bringup recipy
+$!$*.py.mk: $/$*.py $!$*.py.shebang
+	$< --dep $@ > /dev/null
+
+# Include all $!$*.py.bringup: $!$*.py.shebang; <bringup commands>
+-include $(*.py:%=$!%.mk)
+
+# Make sure the python module (<) tested OK
+$!$*.py.tested: $/$*.py $!$*.py.bringup
+	$< --test > $@
+
+# Clear the directory from *** ALL *** non-git files and directories
+$/clear:
+	git clean -xfd $(dir $@)
+
+$ rm -r test/
+```

example/greeter.py

@@ -5,7 +5,6 @@
 fire
 """
 import subprocess
-import argparse
 
 import make
 import fire
@@ -30,7 +29,7 @@ def hello(*world):
     print("Hello from greeter.py!")
     print(run(f"{make.path}example"))
 
-EXAMPLES = """
+EXAMPLES = """Examples:
 $ greeter.py
 NAME
     greeter.py
@@ -58,10 +57,7 @@ def hello(*world):
 """
 
 if __name__ == '__main__':
-    argparser = argparse.ArgumentParser(
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        description=make.brief(),
-        epilog=f"Examples:{EXAMPLES}")
-    make.add_arguments(argparser)
-    args = argparser.parse_known_args()
+    make.argparser.description = make.brief()
+    make.argparser.epilog = EXAMPLES
+    args = make.argparser.parse_known_args()
     fire.Fire(dict(hello=hello, run=run))