mirror of
https://github.com/daylinmorgan/task.mk.git
synced 2024-12-22 18:00:44 -06:00
Compare commits
4 commits
a1285a03ef
...
1fbf19d612
| Author | SHA1 | Date | |
|---|---|---|---|
| 1fbf19d612 | |||
| 981b29d57a | |||
| a901dc63c5 | |||
| 3e649ab027 |
49 changed files with 347 additions and 3114 deletions
4
.gitignore
vendored
4
.gitignore
vendored
|
|
@ -1,4 +1,6 @@
|
||||||
.task.cfg.dev.mk
|
.task.cfg.dev.mk
|
||||||
.task.mk
|
.task.mk
|
||||||
env/
|
.venv
|
||||||
|
|
||||||
|
!docs/examples/**/.task.mk
|
||||||
|
|
||||||
|
|
|
||||||
6
Makefile
6
Makefile
|
|
@ -7,12 +7,12 @@ msg = $(if $(tprint),$(call tprint,{a.bold}==> {a.magenta}$(1){a.end}),@echo '==
|
||||||
bootstrap: env hooks ## generate local dev environment |> -ms b_magenta -gs b_cyan
|
bootstrap: env hooks ## generate local dev environment |> -ms b_magenta -gs b_cyan
|
||||||
env: ##
|
env: ##
|
||||||
$(call msg,Bootstrapping Environment)
|
$(call msg,Bootstrapping Environment)
|
||||||
@mamba create -p ./env python jinja2 black -y
|
@python -m venv .venv
|
||||||
@mamba run -p ./env pip install yartsu
|
@./.venv/bin/pip install jinja2 black yartsu
|
||||||
hooks: ##
|
hooks: ##
|
||||||
@git config core.hooksPath .githooks
|
@git config core.hooksPath .githooks
|
||||||
docs-env: ##
|
docs-env: ##
|
||||||
@mamba run -p ./env pip install mkdocs-material mkdocs-git-revision-date-localized-plugin
|
@./.venv/bin/pip install -r ./requirements-docs.txt
|
||||||
|
|
||||||
l lint: ## lint the python
|
l lint: ## lint the python
|
||||||
$(call msg,Linting)
|
$(call msg,Linting)
|
||||||
|
|
|
||||||
34
README.md
34
README.md
|
|
@ -7,9 +7,7 @@
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<a href="https://gh.dayl.in/task.mk">Documentation</a>
|
<a href="https://gh.dayl.in/task.mk">Documentation</a>
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
</br>
|
</br>
|
||||||
|
|
||||||
GNU make is an excellent build tool and the task runner we love to hate, but can't escape.
|
GNU make is an excellent build tool and the task runner we love to hate, but can't escape.
|
||||||
|
|
@ -19,20 +17,22 @@ So let's improve the UX to make it the best task runner it can be.
|
||||||
to add some QOL improvements for your users and fellow maintainers.
|
to add some QOL improvements for your users and fellow maintainers.
|
||||||
|
|
||||||
Current Features:
|
Current Features:
|
||||||
- ANSI escape code support (including NO_COLOR)
|
|
||||||
|
- ANSI escape code support (including NO_COLOR)
|
||||||
- formatted help output
|
- formatted help output
|
||||||
- custom print function
|
- custom print function
|
||||||
- confirmation prompt
|
- confirmation prompt
|
||||||
|
- goal phonifier (disabled by default)
|
||||||
|
|
||||||
Depends on `GNU Make`, obviously and `Python >=3.7`, and `bash` (or `zsh`).
|
Depends on `GNU Make`, obviously and `Python >=3.7`, and `bash` (or `zsh`).
|
||||||
|
|
||||||
Wait python?!?!, I'm not `pip` installing some package just to parse my makefile.
|
Wait python?!?!, I'm not `pip` installing some package just to parse my makefile.
|
||||||
I agree, all you need is one file [`.task.mk`](./task.mk).
|
I agree, all you need is one file [`.task.mk`](./task.mk).
|
||||||
You can automagically include it with just two additional lines to your `Makefile` (and probably one to your `.gitignore`) and your good to go.
|
You can automagically include it with just two additional lines to your `Makefile` (and probably one to your `.gitignore`) and you're good to go.
|
||||||
|
|
||||||
## Setup
|
## Setup
|
||||||
|
|
||||||
One line setup:
|
One line setup to download .task.mk and add appropriate includes to your `Makefile`.
|
||||||
```bash
|
```bash
|
||||||
bash <(curl -fsSL gh.dayl.in/task.mk/init) # or w/ TASKMK_VERSION=
|
bash <(curl -fsSL gh.dayl.in/task.mk/init) # or w/ TASKMK_VERSION=
|
||||||
```
|
```
|
||||||
|
|
@ -42,32 +42,14 @@ If someone tries to invoke `make help` it will download `.task.mk` for them.
|
||||||
|
|
||||||
```make
|
```make
|
||||||
-include .task.mk
|
-include .task.mk
|
||||||
$(if $(filter help,$(MAKECMDGOALS)),$(if $(wildcard .task.mk),,.task.mk: ; curl -fsSL https://raw.githubusercontent.com/daylinmorgan/task.mk/v23.1.1/task.mk -o .task.mk))
|
$(if $(filter help,$(MAKECMDGOALS)),$(if $(wildcard .task.mk),,.task.mk: ; curl -fsSL https://raw.githubusercontent.com/daylinmorgan/task.mk/v23.1.2/task.mk -o .task.mk))
|
||||||
```
|
```
|
||||||
|
|
||||||
You might also consider making it a consistently downloaded dependency if you plan to use any of it's advanced feature set, by dropping the `$(MAKECMDGOALS)` check.
|
If you plan to use any features besides the help prompt you may want to instead commit `.task.mk` to version control or drop the `$(MAKECMDGOALS)` check so it's always downloaded once `make` is invoked.
|
||||||
|
|
||||||
```make
|
```make
|
||||||
-include .task.mk
|
-include .task.mk
|
||||||
$(if $(wildcard .task.mk),,.task.mk: ; curl -fsSL https://raw.githubusercontent.com/daylinmorgan/task.mk/v23.1.1/task.mk -o .task.mk)
|
$(if $(wildcard .task.mk),,.task.mk: ; curl -fsSL https://raw.githubusercontent.com/daylinmorgan/task.mk/v23.1.2/task.mk -o .task.mk)
|
||||||
```
|
```
|
||||||
|
|
||||||
For more info see the [documentation](https://gh.dayl.in/task.mk).
|
For more info see the [documentation](https://gh.dayl.in/task.mk).
|
||||||
|
|
||||||
## Simpler Alternative
|
|
||||||
|
|
||||||
But I just want a basic help output, surely I don't need python for this... you would be right.
|
|
||||||
`Task.mk` replaces my old `make help` recipe boilerplate which may better serve you (so long as you have `sed`/`awk`).
|
|
||||||
|
|
||||||
|
|
||||||
```make
|
|
||||||
## h, help | show this help
|
|
||||||
### additional text printed with the help
|
|
||||||
.PHONY: help h
|
|
||||||
help h: Makefile
|
|
||||||
@awk -v fill=$(shell sed -n 's/^## \(.*\) | .*/\1/p' $< | wc -L)\
|
|
||||||
'match($$0,/^## (.*) \|/,name) && match($$0,/\| (.*)$$/,help)\
|
|
||||||
{printf "\033[1;93m%*s\033[0m | \033[30m%s\033[0m\n",\
|
|
||||||
fill,name[1],help[1];} match($$0,/^### (.*)/,str) \
|
|
||||||
{printf "%*s \033[30m%s\033[0m\n",fill," ",str[1];}' $<
|
|
||||||
```
|
|
||||||
|
|
|
||||||
|
|
@ -1,4 +1,4 @@
|
||||||
<svg class="rich-terminal shadow" viewBox="0 0 720.3333333333334 716.7333333333333" xmlns="http://www.w3.org/2000/svg">
|
<svg class="rich-terminal shadow" viewBox="0 0 573.3333333333334 521.5333333333333" xmlns="http://www.w3.org/2000/svg">
|
||||||
<!-- Generated with Rich https://www.textualize.io -->
|
<!-- Generated with Rich https://www.textualize.io -->
|
||||||
<style>
|
<style>
|
||||||
@font-face {
|
@font-face {
|
||||||
|
|
@ -16,14 +16,14 @@
|
||||||
font-weight: 700;
|
font-weight: 700;
|
||||||
}
|
}
|
||||||
|
|
||||||
.terminal-1053897658-matrix {
|
.terminal-3478059149-matrix {
|
||||||
font-family: Fira Code, monospace;
|
font-family: Fira Code, monospace;
|
||||||
font-size: 20px;
|
font-size: 20px;
|
||||||
line-height: 24.4px;
|
line-height: 24.4px;
|
||||||
font-variant-east-asian: full-width;
|
font-variant-east-asian: full-width;
|
||||||
}
|
}
|
||||||
|
|
||||||
.terminal-1053897658-title {
|
.terminal-3478059149-title {
|
||||||
font-size: 18px;
|
font-size: 18px;
|
||||||
font-weight: bold;
|
font-weight: bold;
|
||||||
font-family: arial;
|
font-family: arial;
|
||||||
|
|
@ -33,133 +33,100 @@
|
||||||
-webkit-filter: drop-shadow( 2px 5px 2px rgba(0, 0, 0, .7));
|
-webkit-filter: drop-shadow( 2px 5px 2px rgba(0, 0, 0, .7));
|
||||||
filter: drop-shadow( 2px 5px 2px rgba(0, 0, 0, .7));
|
filter: drop-shadow( 2px 5px 2px rgba(0, 0, 0, .7));
|
||||||
}
|
}
|
||||||
.terminal-1053897658-r1 { fill: #94e2d5;font-weight: bold }
|
.terminal-3478059149-r1 { fill: #94e2d5;font-weight: bold }
|
||||||
.terminal-1053897658-r2 { fill: #c6d0f5 }
|
.terminal-3478059149-r2 { fill: #c6d0f5 }
|
||||||
.terminal-1053897658-r3 { fill: #f5c2e7;font-weight: bold }
|
.terminal-3478059149-r3 { fill: #f5c2e7;font-weight: bold }
|
||||||
.terminal-1053897658-r4 { fill: #c6d0f5;font-style: italic;;text-decoration: underline; }
|
.terminal-3478059149-r4 { fill: #c6d0f5;font-style: italic;;text-decoration: underline; }
|
||||||
.terminal-1053897658-r5 { fill: #a6e3a1;font-weight: bold }
|
.terminal-3478059149-r5 { fill: #a6e3a1;font-weight: bold }
|
||||||
.terminal-1053897658-r6 { fill: #f9e2af;font-weight: bold }
|
.terminal-3478059149-r6 { fill: #f9e2af;font-weight: bold }
|
||||||
.terminal-1053897658-r7 { fill: #8288a5 }
|
.terminal-3478059149-r7 { fill: #8288a5 }
|
||||||
.terminal-1053897658-r8 { fill: #f38ba8;font-weight: bold }
|
|
||||||
</style>
|
</style>
|
||||||
|
|
||||||
<defs>
|
<defs>
|
||||||
<clipPath id="terminal-1053897658-clip-terminal">
|
<clipPath id="terminal-3478059149-clip-terminal">
|
||||||
<rect x="0" y="0" width="682.1999999999999" height="633.4" />
|
<rect x="0" y="0" width="535.8" height="438.2" />
|
||||||
</clipPath>
|
</clipPath>
|
||||||
<clipPath id="terminal-1053897658-line-0">
|
<clipPath id="terminal-3478059149-line-0">
|
||||||
<rect x="0" y="1.5" width="683.2" height="24.65"/>
|
<rect x="0" y="1.5" width="536.8" height="24.65"/>
|
||||||
</clipPath>
|
</clipPath>
|
||||||
<clipPath id="terminal-1053897658-line-1">
|
<clipPath id="terminal-3478059149-line-1">
|
||||||
<rect x="0" y="25.9" width="683.2" height="24.65"/>
|
<rect x="0" y="25.9" width="536.8" height="24.65"/>
|
||||||
</clipPath>
|
</clipPath>
|
||||||
<clipPath id="terminal-1053897658-line-2">
|
<clipPath id="terminal-3478059149-line-2">
|
||||||
<rect x="0" y="50.3" width="683.2" height="24.65"/>
|
<rect x="0" y="50.3" width="536.8" height="24.65"/>
|
||||||
</clipPath>
|
</clipPath>
|
||||||
<clipPath id="terminal-1053897658-line-3">
|
<clipPath id="terminal-3478059149-line-3">
|
||||||
<rect x="0" y="74.7" width="683.2" height="24.65"/>
|
<rect x="0" y="74.7" width="536.8" height="24.65"/>
|
||||||
</clipPath>
|
</clipPath>
|
||||||
<clipPath id="terminal-1053897658-line-4">
|
<clipPath id="terminal-3478059149-line-4">
|
||||||
<rect x="0" y="99.1" width="683.2" height="24.65"/>
|
<rect x="0" y="99.1" width="536.8" height="24.65"/>
|
||||||
</clipPath>
|
</clipPath>
|
||||||
<clipPath id="terminal-1053897658-line-5">
|
<clipPath id="terminal-3478059149-line-5">
|
||||||
<rect x="0" y="123.5" width="683.2" height="24.65"/>
|
<rect x="0" y="123.5" width="536.8" height="24.65"/>
|
||||||
</clipPath>
|
</clipPath>
|
||||||
<clipPath id="terminal-1053897658-line-6">
|
<clipPath id="terminal-3478059149-line-6">
|
||||||
<rect x="0" y="147.9" width="683.2" height="24.65"/>
|
<rect x="0" y="147.9" width="536.8" height="24.65"/>
|
||||||
</clipPath>
|
</clipPath>
|
||||||
<clipPath id="terminal-1053897658-line-7">
|
<clipPath id="terminal-3478059149-line-7">
|
||||||
<rect x="0" y="172.3" width="683.2" height="24.65"/>
|
<rect x="0" y="172.3" width="536.8" height="24.65"/>
|
||||||
</clipPath>
|
</clipPath>
|
||||||
<clipPath id="terminal-1053897658-line-8">
|
<clipPath id="terminal-3478059149-line-8">
|
||||||
<rect x="0" y="196.7" width="683.2" height="24.65"/>
|
<rect x="0" y="196.7" width="536.8" height="24.65"/>
|
||||||
</clipPath>
|
</clipPath>
|
||||||
<clipPath id="terminal-1053897658-line-9">
|
<clipPath id="terminal-3478059149-line-9">
|
||||||
<rect x="0" y="221.1" width="683.2" height="24.65"/>
|
<rect x="0" y="221.1" width="536.8" height="24.65"/>
|
||||||
</clipPath>
|
</clipPath>
|
||||||
<clipPath id="terminal-1053897658-line-10">
|
<clipPath id="terminal-3478059149-line-10">
|
||||||
<rect x="0" y="245.5" width="683.2" height="24.65"/>
|
<rect x="0" y="245.5" width="536.8" height="24.65"/>
|
||||||
</clipPath>
|
</clipPath>
|
||||||
<clipPath id="terminal-1053897658-line-11">
|
<clipPath id="terminal-3478059149-line-11">
|
||||||
<rect x="0" y="269.9" width="683.2" height="24.65"/>
|
<rect x="0" y="269.9" width="536.8" height="24.65"/>
|
||||||
</clipPath>
|
</clipPath>
|
||||||
<clipPath id="terminal-1053897658-line-12">
|
<clipPath id="terminal-3478059149-line-12">
|
||||||
<rect x="0" y="294.3" width="683.2" height="24.65"/>
|
<rect x="0" y="294.3" width="536.8" height="24.65"/>
|
||||||
</clipPath>
|
</clipPath>
|
||||||
<clipPath id="terminal-1053897658-line-13">
|
<clipPath id="terminal-3478059149-line-13">
|
||||||
<rect x="0" y="318.7" width="683.2" height="24.65"/>
|
<rect x="0" y="318.7" width="536.8" height="24.65"/>
|
||||||
</clipPath>
|
</clipPath>
|
||||||
<clipPath id="terminal-1053897658-line-14">
|
<clipPath id="terminal-3478059149-line-14">
|
||||||
<rect x="0" y="343.1" width="683.2" height="24.65"/>
|
<rect x="0" y="343.1" width="536.8" height="24.65"/>
|
||||||
</clipPath>
|
</clipPath>
|
||||||
<clipPath id="terminal-1053897658-line-15">
|
<clipPath id="terminal-3478059149-line-15">
|
||||||
<rect x="0" y="367.5" width="683.2" height="24.65"/>
|
<rect x="0" y="367.5" width="536.8" height="24.65"/>
|
||||||
</clipPath>
|
</clipPath>
|
||||||
<clipPath id="terminal-1053897658-line-16">
|
<clipPath id="terminal-3478059149-line-16">
|
||||||
<rect x="0" y="391.9" width="683.2" height="24.65"/>
|
<rect x="0" y="391.9" width="536.8" height="24.65"/>
|
||||||
</clipPath>
|
|
||||||
<clipPath id="terminal-1053897658-line-17">
|
|
||||||
<rect x="0" y="416.3" width="683.2" height="24.65"/>
|
|
||||||
</clipPath>
|
|
||||||
<clipPath id="terminal-1053897658-line-18">
|
|
||||||
<rect x="0" y="440.7" width="683.2" height="24.65"/>
|
|
||||||
</clipPath>
|
|
||||||
<clipPath id="terminal-1053897658-line-19">
|
|
||||||
<rect x="0" y="465.1" width="683.2" height="24.65"/>
|
|
||||||
</clipPath>
|
|
||||||
<clipPath id="terminal-1053897658-line-20">
|
|
||||||
<rect x="0" y="489.5" width="683.2" height="24.65"/>
|
|
||||||
</clipPath>
|
|
||||||
<clipPath id="terminal-1053897658-line-21">
|
|
||||||
<rect x="0" y="513.9" width="683.2" height="24.65"/>
|
|
||||||
</clipPath>
|
|
||||||
<clipPath id="terminal-1053897658-line-22">
|
|
||||||
<rect x="0" y="538.3" width="683.2" height="24.65"/>
|
|
||||||
</clipPath>
|
|
||||||
<clipPath id="terminal-1053897658-line-23">
|
|
||||||
<rect x="0" y="562.7" width="683.2" height="24.65"/>
|
|
||||||
</clipPath>
|
|
||||||
<clipPath id="terminal-1053897658-line-24">
|
|
||||||
<rect x="0" y="587.1" width="683.2" height="24.65"/>
|
|
||||||
</clipPath>
|
</clipPath>
|
||||||
</defs>
|
</defs>
|
||||||
|
|
||||||
<rect fill="#1e1e2e" stroke="rgba(255,255,255,0.35)" stroke-width="1" x="10.1667" y="1" width="700" height="682.4" rx="8"/><text class="terminal-1053897658-title" fill="#c6d0f5" text-anchor="middle" x="350" y="27">make help</text>
|
<rect fill="#1e1e2e" stroke="rgba(255,255,255,0.35)" stroke-width="1" x="10.1667" y="1" width="553" height="487.2" rx="8"/><text class="terminal-3478059149-title" fill="#c6d0f5" text-anchor="middle" x="276" y="27">make help</text>
|
||||||
<g transform="translate(32,22)">
|
<g transform="translate(32,22)">
|
||||||
<circle cx="0" cy="0" r="7" fill="#ff5f57"/>
|
<circle cx="0" cy="0" r="7" fill="#ff5f57"/>
|
||||||
<circle cx="22" cy="0" r="7" fill="#febc2e"/>
|
<circle cx="22" cy="0" r="7" fill="#febc2e"/>
|
||||||
<circle cx="44" cy="0" r="7" fill="#28c840"/>
|
<circle cx="44" cy="0" r="7" fill="#28c840"/>
|
||||||
</g>
|
</g>
|
||||||
|
|
||||||
<g transform="translate(18.166666666666664, 41) scale(.95)" clip-path="url(#terminal-1053897658-clip-terminal)">
|
<g transform="translate(18.166666666666664, 41) scale(.95)" clip-path="url(#terminal-3478059149-clip-terminal)">
|
||||||
|
|
||||||
<g class="terminal-1053897658-matrix">
|
<g class="terminal-3478059149-matrix">
|
||||||
<text class="terminal-1053897658-r1" x="0" y="20" textLength="73.2" clip-path="url(#terminal-1053897658-line-0)">usage:</text><text class="terminal-1053897658-r2" x="683.2" y="20" textLength="12.2" clip-path="url(#terminal-1053897658-line-0)">
|
<text class="terminal-3478059149-r1" x="0" y="20" textLength="61" clip-path="url(#terminal-3478059149-line-0)">usage</text><text class="terminal-3478059149-r2" x="61" y="20" textLength="12.2" clip-path="url(#terminal-3478059149-line-0)">:</text><text class="terminal-3478059149-r2" x="536.8" y="20" textLength="12.2" clip-path="url(#terminal-3478059149-line-0)">
|
||||||
</text><text class="terminal-1053897658-r2" x="97.6" y="44.4" textLength="158.6" clip-path="url(#terminal-1053897658-line-1)">make <recipe></text><text class="terminal-1053897658-r2" x="683.2" y="44.4" textLength="12.2" clip-path="url(#terminal-1053897658-line-1)">
|
</text><text class="terminal-3478059149-r2" x="97.6" y="44.4" textLength="158.6" clip-path="url(#terminal-3478059149-line-1)">make <recipe></text><text class="terminal-3478059149-r2" x="536.8" y="44.4" textLength="12.2" clip-path="url(#terminal-3478059149-line-1)">
|
||||||
</text><text class="terminal-1053897658-r2" x="683.2" y="68.8" textLength="12.2" clip-path="url(#terminal-1053897658-line-2)">
|
</text><text class="terminal-3478059149-r2" x="536.8" y="68.8" textLength="12.2" clip-path="url(#terminal-3478059149-line-2)">
|
||||||
</text><text class="terminal-1053897658-r2" x="0" y="93.2" textLength="146.4" clip-path="url(#terminal-1053897658-line-3)">  Turn your </text><text class="terminal-1053897658-r3" x="146.4" y="93.2" textLength="122" clip-path="url(#terminal-1053897658-line-3)">`Makefile`</text><text class="terminal-1053897658-r2" x="268.4" y="93.2" textLength="61" clip-path="url(#terminal-1053897658-line-3)"> into</text><text class="terminal-1053897658-r2" x="683.2" y="93.2" textLength="12.2" clip-path="url(#terminal-1053897658-line-3)">
|
</text><text class="terminal-3478059149-r2" x="0" y="93.2" textLength="146.4" clip-path="url(#terminal-3478059149-line-3)">  Turn your </text><text class="terminal-3478059149-r3" x="146.4" y="93.2" textLength="122" clip-path="url(#terminal-3478059149-line-3)">`Makefile`</text><text class="terminal-3478059149-r2" x="268.4" y="93.2" textLength="61" clip-path="url(#terminal-3478059149-line-3)"> into</text><text class="terminal-3478059149-r2" x="536.8" y="93.2" textLength="12.2" clip-path="url(#terminal-3478059149-line-3)">
|
||||||
</text><text class="terminal-1053897658-r2" x="0" y="117.6" textLength="73.2" clip-path="url(#terminal-1053897658-line-4)">  the </text><text class="terminal-1053897658-r4" x="73.2" y="117.6" textLength="134.2" clip-path="url(#terminal-1053897658-line-4)">task runner</text><text class="terminal-1053897658-r2" x="207.4" y="117.6" textLength="231.8" clip-path="url(#terminal-1053897658-line-4)"> you always needed.</text><text class="terminal-1053897658-r2" x="683.2" y="117.6" textLength="12.2" clip-path="url(#terminal-1053897658-line-4)">
|
</text><text class="terminal-3478059149-r2" x="0" y="117.6" textLength="73.2" clip-path="url(#terminal-3478059149-line-4)">  the </text><text class="terminal-3478059149-r4" x="73.2" y="117.6" textLength="134.2" clip-path="url(#terminal-3478059149-line-4)">task runner</text><text class="terminal-3478059149-r2" x="207.4" y="117.6" textLength="231.8" clip-path="url(#terminal-3478059149-line-4)"> you always needed.</text><text class="terminal-3478059149-r2" x="536.8" y="117.6" textLength="12.2" clip-path="url(#terminal-3478059149-line-4)">
|
||||||
</text><text class="terminal-1053897658-r2" x="0" y="142" textLength="378.2" clip-path="url(#terminal-1053897658-line-5)">  See the example output below.</text><text class="terminal-1053897658-r2" x="683.2" y="142" textLength="12.2" clip-path="url(#terminal-1053897658-line-5)">
|
</text><text class="terminal-3478059149-r2" x="0" y="142" textLength="378.2" clip-path="url(#terminal-3478059149-line-5)">  See the example output below.</text><text class="terminal-3478059149-r2" x="536.8" y="142" textLength="12.2" clip-path="url(#terminal-3478059149-line-5)">
|
||||||
</text><text class="terminal-1053897658-r2" x="683.2" y="166.4" textLength="12.2" clip-path="url(#terminal-1053897658-line-6)">
|
</text><text class="terminal-3478059149-r2" x="536.8" y="166.4" textLength="12.2" clip-path="url(#terminal-3478059149-line-6)">
|
||||||
</text><text class="terminal-1053897658-r5" x="24.4" y="190.8" textLength="475.8" clip-path="url(#terminal-1053897658-line-7)">          task.mk development          </text><text class="terminal-1053897658-r2" x="683.2" y="190.8" textLength="12.2" clip-path="url(#terminal-1053897658-line-7)">
|
</text><text class="terminal-3478059149-r5" x="24.4" y="190.8" textLength="475.8" clip-path="url(#terminal-3478059149-line-7)">          task.mk development          </text><text class="terminal-3478059149-r2" x="536.8" y="190.8" textLength="12.2" clip-path="url(#terminal-3478059149-line-7)">
|
||||||
</text><text class="terminal-1053897658-r2" x="0" y="215.2" textLength="536.8" clip-path="url(#terminal-1053897658-line-8)">  ──────────────────────────────────────────</text><text class="terminal-1053897658-r2" x="683.2" y="215.2" textLength="12.2" clip-path="url(#terminal-1053897658-line-8)">
|
</text><text class="terminal-3478059149-r2" x="0" y="215.2" textLength="536.8" clip-path="url(#terminal-3478059149-line-8)">  ──────────────────────────────────────────</text><text class="terminal-3478059149-r2" x="536.8" y="215.2" textLength="12.2" clip-path="url(#terminal-3478059149-line-8)">
|
||||||
</text><text class="terminal-1053897658-r6" x="0" y="239.6" textLength="134.2" clip-path="url(#terminal-1053897658-line-9)">  bootstrap</text><text class="terminal-1053897658-r2" x="134.2" y="239.6" textLength="36.6" clip-path="url(#terminal-1053897658-line-9)"> │ </text><text class="terminal-1053897658-r7" x="170.8" y="239.6" textLength="366" clip-path="url(#terminal-1053897658-line-9)">generate local dev environment</text><text class="terminal-1053897658-r2" x="683.2" y="239.6" textLength="12.2" clip-path="url(#terminal-1053897658-line-9)">
|
</text><text class="terminal-3478059149-r1" x="0" y="239.6" textLength="134.2" clip-path="url(#terminal-3478059149-line-9)">  bootstrap</text><text class="terminal-3478059149-r2" x="134.2" y="239.6" textLength="36.6" clip-path="url(#terminal-3478059149-line-9)"> │ </text><text class="terminal-3478059149-r3" x="170.8" y="239.6" textLength="366" clip-path="url(#terminal-3478059149-line-9)">generate local dev environment</text><text class="terminal-3478059149-r2" x="536.8" y="239.6" textLength="12.2" clip-path="url(#terminal-3478059149-line-9)">
|
||||||
</text><text class="terminal-1053897658-r6" x="0" y="264" textLength="134.2" clip-path="url(#terminal-1053897658-line-10)">    l, lint</text><text class="terminal-1053897658-r2" x="134.2" y="264" textLength="36.6" clip-path="url(#terminal-1053897658-line-10)"> │ </text><text class="terminal-1053897658-r7" x="170.8" y="264" textLength="183" clip-path="url(#terminal-1053897658-line-10)">lint the python</text><text class="terminal-1053897658-r2" x="683.2" y="264" textLength="12.2" clip-path="url(#terminal-1053897658-line-10)">
|
</text><text class="terminal-3478059149-r6" x="0" y="264" textLength="134.2" clip-path="url(#terminal-3478059149-line-10)">     l lint</text><text class="terminal-3478059149-r2" x="134.2" y="264" textLength="36.6" clip-path="url(#terminal-3478059149-line-10)"> │ </text><text class="terminal-3478059149-r7" x="170.8" y="264" textLength="183" clip-path="url(#terminal-3478059149-line-10)">lint the python</text><text class="terminal-3478059149-r2" x="536.8" y="264" textLength="12.2" clip-path="url(#terminal-3478059149-line-10)">
|
||||||
</text><text class="terminal-1053897658-r6" x="0" y="288.4" textLength="134.2" clip-path="url(#terminal-1053897658-line-11)">     assets</text><text class="terminal-1053897658-r2" x="134.2" y="288.4" textLength="36.6" clip-path="url(#terminal-1053897658-line-11)"> │ </text><text class="terminal-1053897658-r7" x="170.8" y="288.4" textLength="183" clip-path="url(#terminal-1053897658-line-11)">generate assets</text><text class="terminal-1053897658-r2" x="683.2" y="288.4" textLength="12.2" clip-path="url(#terminal-1053897658-line-11)">
|
</text><text class="terminal-3478059149-r6" x="0" y="288.4" textLength="134.2" clip-path="url(#terminal-3478059149-line-11)">     assets</text><text class="terminal-3478059149-r2" x="134.2" y="288.4" textLength="36.6" clip-path="url(#terminal-3478059149-line-11)"> │ </text><text class="terminal-3478059149-r7" x="170.8" y="288.4" textLength="183" clip-path="url(#terminal-3478059149-line-11)">generate assets</text><text class="terminal-3478059149-r2" x="536.8" y="288.4" textLength="12.2" clip-path="url(#terminal-3478059149-line-11)">
|
||||||
</text><text class="terminal-1053897658-r6" x="0" y="312.8" textLength="134.2" clip-path="url(#terminal-1053897658-line-12)">    release</text><text class="terminal-1053897658-r2" x="134.2" y="312.8" textLength="36.6" clip-path="url(#terminal-1053897658-line-12)"> │ </text><text class="terminal-1053897658-r7" x="170.8" y="312.8" textLength="366" clip-path="url(#terminal-1053897658-line-12)">release new version of task.mk</text><text class="terminal-1053897658-r2" x="683.2" y="312.8" textLength="12.2" clip-path="url(#terminal-1053897658-line-12)">
|
</text><text class="terminal-3478059149-r6" x="0" y="312.8" textLength="134.2" clip-path="url(#terminal-3478059149-line-12)">    release</text><text class="terminal-3478059149-r2" x="134.2" y="312.8" textLength="36.6" clip-path="url(#terminal-3478059149-line-12)"> │ </text><text class="terminal-3478059149-r7" x="170.8" y="312.8" textLength="366" clip-path="url(#terminal-3478059149-line-12)">release new version of task.mk</text><text class="terminal-3478059149-r2" x="536.8" y="312.8" textLength="12.2" clip-path="url(#terminal-3478059149-line-12)">
|
||||||
</text><text class="terminal-1053897658-r6" x="0" y="337.2" textLength="134.2" clip-path="url(#terminal-1053897658-line-13)">   c, clean</text><text class="terminal-1053897658-r2" x="134.2" y="337.2" textLength="36.6" clip-path="url(#terminal-1053897658-line-13)"> │ </text><text class="terminal-1053897658-r7" x="170.8" y="337.2" textLength="317.2" clip-path="url(#terminal-1053897658-line-13)">remove the generated files</text><text class="terminal-1053897658-r2" x="683.2" y="337.2" textLength="12.2" clip-path="url(#terminal-1053897658-line-13)">
|
</text><text class="terminal-3478059149-r6" x="0" y="337.2" textLength="134.2" clip-path="url(#terminal-3478059149-line-13)">    c clean</text><text class="terminal-3478059149-r2" x="134.2" y="337.2" textLength="36.6" clip-path="url(#terminal-3478059149-line-13)"> │ </text><text class="terminal-3478059149-r7" x="170.8" y="337.2" textLength="317.2" clip-path="url(#terminal-3478059149-line-13)">remove the generated files</text><text class="terminal-3478059149-r2" x="536.8" y="337.2" textLength="12.2" clip-path="url(#terminal-3478059149-line-13)">
|
||||||
</text><text class="terminal-1053897658-r2" x="0" y="361.6" textLength="536.8" clip-path="url(#terminal-1053897658-line-14)">  ──────────────────────────────────────────</text><text class="terminal-1053897658-r2" x="683.2" y="361.6" textLength="12.2" clip-path="url(#terminal-1053897658-line-14)">
|
</text><text class="terminal-3478059149-r6" x="0" y="361.6" textLength="134.2" clip-path="url(#terminal-3478059149-line-14)">       info</text><text class="terminal-3478059149-r2" x="134.2" y="361.6" textLength="36.6" clip-path="url(#terminal-3478059149-line-14)"> │ </text><text class="terminal-3478059149-r7" x="170.8" y="361.6" textLength="329.4" clip-path="url(#terminal-3478059149-line-14)">demonstrate usage of tprint</text><text class="terminal-3478059149-r2" x="536.8" y="361.6" textLength="12.2" clip-path="url(#terminal-3478059149-line-14)">
|
||||||
</text><text class="terminal-1053897658-r2" x="683.2" y="386" textLength="12.2" clip-path="url(#terminal-1053897658-line-15)">
|
</text><text class="terminal-3478059149-r6" x="0" y="386" textLength="134.2" clip-path="url(#terminal-3478059149-line-15)">     h help</text><text class="terminal-3478059149-r2" x="134.2" y="386" textLength="36.6" clip-path="url(#terminal-3478059149-line-15)"> │ </text><text class="terminal-3478059149-r7" x="170.8" y="386" textLength="170.8" clip-path="url(#terminal-3478059149-line-15)">show this help</text><text class="terminal-3478059149-r2" x="536.8" y="386" textLength="12.2" clip-path="url(#terminal-3478059149-line-15)">
|
||||||
</text><text class="terminal-1053897658-r8" x="24.4" y="410.4" textLength="475.8" clip-path="url(#terminal-1053897658-line-16)">      examples of task.mk features     </text><text class="terminal-1053897658-r2" x="683.2" y="410.4" textLength="12.2" clip-path="url(#terminal-1053897658-line-16)">
|
</text><text class="terminal-3478059149-r2" x="536.8" y="410.4" textLength="12.2" clip-path="url(#terminal-3478059149-line-16)">
|
||||||
</text><text class="terminal-1053897658-r2" x="0" y="434.8" textLength="536.8" clip-path="url(#terminal-1053897658-line-17)">  ──────────────────────────────────────────</text><text class="terminal-1053897658-r2" x="683.2" y="434.8" textLength="12.2" clip-path="url(#terminal-1053897658-line-17)">
|
</text><text class="terminal-3478059149-r2" x="0" y="434.8" textLength="402.6" clip-path="url(#terminal-3478059149-line-17)">for more info: gh.dayl.in/task.mk</text><text class="terminal-3478059149-r2" x="536.8" y="434.8" textLength="12.2" clip-path="url(#terminal-3478059149-line-17)">
|
||||||
</text><text class="terminal-1053897658-r6" x="0" y="459.2" textLength="134.2" clip-path="url(#terminal-1053897658-line-18)">     list-%</text><text class="terminal-1053897658-r2" x="134.2" y="459.2" textLength="36.6" clip-path="url(#terminal-1053897658-line-18)"> │ </text><text class="terminal-1053897658-r7" x="170.8" y="459.2" textLength="366" clip-path="url(#terminal-1053897658-line-18)">use pathlib.Path to list files</text><text class="terminal-1053897658-r2" x="683.2" y="459.2" textLength="12.2" clip-path="url(#terminal-1053897658-line-18)">
|
|
||||||
</text><text class="terminal-1053897658-r7" x="170.8" y="483.6" textLength="512.4" clip-path="url(#terminal-1053897658-line-19)">name the directory in rule (make list-src)</text><text class="terminal-1053897658-r2" x="683.2" y="483.6" textLength="12.2" clip-path="url(#terminal-1053897658-line-19)">
|
|
||||||
</text><text class="terminal-1053897658-r6" x="0" y="508" textLength="134.2" clip-path="url(#terminal-1053897658-line-20)">       info</text><text class="terminal-1053897658-r2" x="134.2" y="508" textLength="36.6" clip-path="url(#terminal-1053897658-line-20)"> │ </text><text class="terminal-1053897658-r7" x="170.8" y="508" textLength="329.4" clip-path="url(#terminal-1053897658-line-20)">demonstrate usage of tprint</text><text class="terminal-1053897658-r2" x="683.2" y="508" textLength="12.2" clip-path="url(#terminal-1053897658-line-20)">
|
|
||||||
</text><text class="terminal-1053897658-r6" x="0" y="532.4" textLength="134.2" clip-path="url(#terminal-1053897658-line-21)">      check</text><text class="terminal-1053897658-r2" x="134.2" y="532.4" textLength="36.6" clip-path="url(#terminal-1053897658-line-21)"> │ </text><text class="terminal-1053897658-r7" x="170.8" y="532.4" textLength="353.8" clip-path="url(#terminal-1053897658-line-21)">get user confirmation or exit</text><text class="terminal-1053897658-r2" x="683.2" y="532.4" textLength="12.2" clip-path="url(#terminal-1053897658-line-21)">
|
|
||||||
</text><text class="terminal-1053897658-r2" x="0" y="556.8" textLength="536.8" clip-path="url(#terminal-1053897658-line-22)">  ──────────────────────────────────────────</text><text class="terminal-1053897658-r2" x="683.2" y="556.8" textLength="12.2" clip-path="url(#terminal-1053897658-line-22)">
|
|
||||||
</text><text class="terminal-1053897658-r6" x="0" y="581.2" textLength="134.2" clip-path="url(#terminal-1053897658-line-23)">    h, help</text><text class="terminal-1053897658-r2" x="134.2" y="581.2" textLength="36.6" clip-path="url(#terminal-1053897658-line-23)"> │ </text><text class="terminal-1053897658-r7" x="170.8" y="581.2" textLength="170.8" clip-path="url(#terminal-1053897658-line-23)">show this help</text><text class="terminal-1053897658-r2" x="683.2" y="581.2" textLength="12.2" clip-path="url(#terminal-1053897658-line-23)">
|
|
||||||
</text><text class="terminal-1053897658-r2" x="683.2" y="605.6" textLength="12.2" clip-path="url(#terminal-1053897658-line-24)">
|
|
||||||
</text><text class="terminal-1053897658-r2" x="0" y="630" textLength="561.2" clip-path="url(#terminal-1053897658-line-25)">for more info: github.com/daylinmorgan/task.mk</text><text class="terminal-1053897658-r2" x="683.2" y="630" textLength="12.2" clip-path="url(#terminal-1053897658-line-25)">
|
|
||||||
</text>
|
</text>
|
||||||
</g>
|
</g>
|
||||||
</g>
|
</g>
|
||||||
|
|
|
||||||
|
Before Width: | Height: | Size: 16 KiB After Width: | Height: | Size: 12 KiB |
|
|
@ -1 +0,0 @@
|
||||||
export PS1='task.mk demo % '
|
|
||||||
|
|
@ -1,18 +1,13 @@
|
||||||
MAKEFLAGS += --no-print-directory
|
MAKEFLAGS += --no-print-directory
|
||||||
COLS ?= 60
|
EXAMPLES := check embedded recipe-help phonify
|
||||||
ROWS ?= 20
|
GIFS := $(addsuffix /demo.gif, $(EXAMPLES))
|
||||||
EXAMPLES := check embedded recipe-help
|
|
||||||
CASTS := $(addsuffix /demo.cast, $(EXAMPLES))
|
|
||||||
|
|
||||||
all: $(CASTS)
|
all: $(GIFS)
|
||||||
|
|
||||||
%/demo.cast: %/record.sh
|
%/demo.gif: %/demo.tape %/Makefile
|
||||||
asciinema rec --cols $(COLS) --rows $(ROWS) --overwrite -c $< $@
|
cd $* && vhs < demo.tape
|
||||||
|
|
||||||
check/demo.cast: COLS = 48
|
|
||||||
check/demo.cast: ROWS = 12
|
|
||||||
|
|
||||||
clean:
|
clean:
|
||||||
rm -rf $(CASTS)
|
rm -rf $(GIFS)
|
||||||
|
|
||||||
.PHONY:all clean
|
.PHONY: all clean
|
||||||
|
|
|
||||||
1
docs/examples/check/.task.mk
Symbolic link
1
docs/examples/check/.task.mk
Symbolic link
|
|
@ -0,0 +1 @@
|
||||||
|
../../../task.mk
|
||||||
11
docs/examples/check/Makefile
Normal file
11
docs/examples/check/Makefile
Normal file
|
|
@ -0,0 +1,11 @@
|
||||||
|
.PHONY: check
|
||||||
|
check: ## get user confirmation or exit
|
||||||
|
$(call tconfirm,Would you like to proceed?)
|
||||||
|
@echo "you said yes!"
|
||||||
|
|
||||||
|
define USAGE
|
||||||
|
{a.$(HEADER_STYLE)}usage:{a.end}\n make <recipe>\n\n interactivity w/ task.mk\n
|
||||||
|
endef
|
||||||
|
|
||||||
|
.DEFAULT_GOAL = help
|
||||||
|
include .task.mk
|
||||||
|
|
@ -1,16 +0,0 @@
|
||||||
## check | get user confirmation or exit
|
|
||||||
.PHONY: check
|
|
||||||
check:
|
|
||||||
$(call tconfirm,Would you like to proceed?)
|
|
||||||
@echo "you said yes!"
|
|
||||||
|
|
||||||
define USAGE
|
|
||||||
{a.$(HEADER_STYLE)}usage:{a.end}
|
|
||||||
make <recipe>
|
|
||||||
|
|
||||||
interactivity w/ task.mk\n
|
|
||||||
endef
|
|
||||||
|
|
||||||
.DEFAULT_GOAL = help
|
|
||||||
include $(shell git rev-parse --show-toplevel)/task.mk
|
|
||||||
|
|
||||||
BIN
docs/examples/check/demo.gif
Normal file
BIN
docs/examples/check/demo.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 335 KiB |
15
docs/examples/check/demo.tape
Normal file
15
docs/examples/check/demo.tape
Normal file
|
|
@ -0,0 +1,15 @@
|
||||||
|
Output demo.gif
|
||||||
|
|
||||||
|
Set FontSize 32
|
||||||
|
Set Width 1600
|
||||||
|
Set Height 800
|
||||||
|
Set Theme "Catppuccin Mocha"
|
||||||
|
|
||||||
|
Type "make help" Sleep 1s Enter Sleep 2s
|
||||||
|
Type "make check" Sleep 1s Enter Sleep 2s
|
||||||
|
Type "y" Sleep 1s Enter Sleep 2s
|
||||||
|
Type "# Let's try again but instead say no this time" Sleep 1s Enter
|
||||||
|
Type "make check" Sleep 1s Enter Sleep 2s
|
||||||
|
Type "n" Sleep 1s Enter Sleep 2s
|
||||||
|
Sleep 2s
|
||||||
|
|
||||||
|
|
@ -1,12 +1,8 @@
|
||||||
---
|
|
||||||
asciinema: true
|
|
||||||
---
|
|
||||||
|
|
||||||
# Check
|
# Check
|
||||||
|
|
||||||
<div id="demo-cast"></div>
|
|
||||||
|
|
||||||
```make title="check.mk"
|
```make title="Makefile (check)"
|
||||||
--8<-- "docs/examples/check/check.mk"
|
--8<-- "docs/examples/check/Makefile"
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,10 +0,0 @@
|
||||||
#!/usr/bin/env bash
|
|
||||||
|
|
||||||
source "$(dirname "${BASH_SOURCE[0]}")/../functions.sh"
|
|
||||||
|
|
||||||
cmd 'make -f check/check.mk help'
|
|
||||||
cmd 'make -f check/check.mk check'
|
|
||||||
msg "# Let's try again but instead say no this time"
|
|
||||||
cmd 'make -f check/check.mk check'
|
|
||||||
|
|
||||||
sleep 1
|
|
||||||
1
docs/examples/embedded/.task.mk
Symbolic link
1
docs/examples/embedded/.task.mk
Symbolic link
|
|
@ -0,0 +1 @@
|
||||||
|
../../../task.mk
|
||||||
35
docs/examples/embedded/Makefile
Normal file
35
docs/examples/embedded/Makefile
Normal file
|
|
@ -0,0 +1,35 @@
|
||||||
|
### examples of task.mk features |> --divider --align center --msg-style b_red
|
||||||
|
define list_files_py
|
||||||
|
from pathlib import Path
|
||||||
|
print("files in $(2)")
|
||||||
|
print([f.name for f in (Path("$(2)").iterdir())])
|
||||||
|
endef
|
||||||
|
|
||||||
|
## list-% |> use pathlib.Path to list files
|
||||||
|
### name the directory in rule (make list-src) |> --align sep
|
||||||
|
list-%:
|
||||||
|
$(call py,list_files_py,$*)
|
||||||
|
|
||||||
|
# dollar signs will always be a problem :|
|
||||||
|
define bash_script
|
||||||
|
echo "Is the process running bash? We can check with ps"
|
||||||
|
ps -o args= -p $$$$ | grep -E -m 1 -o '\w{0,5}sh'
|
||||||
|
echo "Get input at runtime"
|
||||||
|
printf "type input now! "
|
||||||
|
read -r name
|
||||||
|
echo "you typed -> $$name"
|
||||||
|
echo "the argument below as given in the makefile itself"
|
||||||
|
echo "it's expanded before the script is passed to bash"
|
||||||
|
printf "%s\n" "$(2)"
|
||||||
|
endef
|
||||||
|
|
||||||
|
.PHONY: embedded-bash
|
||||||
|
embedded-bash: ## bash script with pipes and make input
|
||||||
|
$(call tbash,bash_script,bash multiline is working 🤞)
|
||||||
|
|
||||||
|
define USAGE
|
||||||
|
{a.$(HEADER_STYLE)}usage:{a.end}\n make <recipe>\n\n examples of embedded scripts in `{a.magenta}Makefile{a.end}`\n
|
||||||
|
endef
|
||||||
|
|
||||||
|
.DEFAULT_GOAL = help
|
||||||
|
include .task.mk
|
||||||
|
|
@ -1,83 +0,0 @@
|
||||||
{"version": 2, "width": 60, "height": 20, "timestamp": 1664060088, "env": {"SHELL": "/usr/bin/zsh", "TERM": "xterm-256color"}}
|
|
||||||
[0.008131, "o", "\u001b[H\u001b[2J\u001b[3J"]
|
|
||||||
[0.008522, "o", "bash >> "]
|
|
||||||
[0.008683, "o", "ma"]
|
|
||||||
[0.189166, "o", "ke"]
|
|
||||||
[0.279481, "o", " -"]
|
|
||||||
[0.369776, "o", "f "]
|
|
||||||
[0.460021, "o", "em"]
|
|
||||||
[0.550229, "o", "be"]
|
|
||||||
[0.640359, "o", "dd"]
|
|
||||||
[0.730591, "o", "ed"]
|
|
||||||
[0.820572, "o", "/e"]
|
|
||||||
[0.910745, "o", "mb"]
|
|
||||||
[1.091087, "o", "ed"]
|
|
||||||
[1.181312, "o", "de"]
|
|
||||||
[1.271441, "o", "d."]
|
|
||||||
[1.361501, "o", "mk"]
|
|
||||||
[1.451615, "o", " h"]
|
|
||||||
[1.541783, "o", "el"]
|
|
||||||
[1.63204, "o", "p\r\n"]
|
|
||||||
[2.664242, "o", "\u001b[1;36musage:\u001b[0m\r\n\tmake <recipe>\r\n\t\r\n\texamples of embedded scripts in `\u001b[35mMakefile\u001b[0m`\r\n\r\n \u001b[1;31m examples of task.mk features \u001b[0m\r\n\u001b[38m ─────────────────────────────────────────────────────\u001b[0m\r\n\u001b[1;33m list-%\u001b[0m │ \u001b[2muse pathlib.Path to list files\u001b[0m\r\n \u001b[2mname the directory in rule (make list-src)\u001b[0m\r\n\u001b[1;33m embedded-bash\u001b[0m │ \u001b[2mbash script with pipes and make input\u001b[0m\r\n\u001b[1;33m h, help\u001b[0m │ \u001b[2mshow this help\u001b[0m\r\n\r\n"]
|
|
||||||
[4.671801, "o", "\u001b[H\u001b[2J\u001b[3Jbash >> "]
|
|
||||||
[4.67392, "o", "ma"]
|
|
||||||
[4.854455, "o", "ke"]
|
|
||||||
[4.944728, "o", " -"]
|
|
||||||
[5.034921, "o", "f "]
|
|
||||||
[5.124982, "o", "em"]
|
|
||||||
[5.215103, "o", "be"]
|
|
||||||
[5.305188, "o", "dd"]
|
|
||||||
[5.395353, "o", "ed"]
|
|
||||||
[5.485457, "o", "/e"]
|
|
||||||
[5.576246, "o", "mb"]
|
|
||||||
[5.75589, "o", "ed"]
|
|
||||||
[5.846014, "o", "de"]
|
|
||||||
[5.93612, "o", "d."]
|
|
||||||
[6.026298, "o", "mk"]
|
|
||||||
[6.11644, "o", " l"]
|
|
||||||
[6.206464, "o", "is"]
|
|
||||||
[6.296631, "o", "t-"]
|
|
||||||
[6.386781, "o", "em"]
|
|
||||||
[6.477052, "o", "be"]
|
|
||||||
[6.657201, "o", "dd"]
|
|
||||||
[6.747412, "o", "ed"]
|
|
||||||
[6.837566, "o", "\r\n"]
|
|
||||||
[7.867599, "o", "files in embedded\r\n['embedded.mk', 'demo.cast', 'record.sh', 'index.md']\r\n"]
|
|
||||||
[9.872436, "o", "\u001b[H\u001b[2J\u001b[3J"]
|
|
||||||
[9.872754, "o", "bash >> "]
|
|
||||||
[9.874651, "o", "ma"]
|
|
||||||
[10.055031, "o", "ke"]
|
|
||||||
[10.145171, "o", " -"]
|
|
||||||
[10.235256, "o", "f "]
|
|
||||||
[10.325347, "o", "em"]
|
|
||||||
[10.415525, "o", "be"]
|
|
||||||
[10.505721, "o", "dd"]
|
|
||||||
[10.595814, "o", "ed"]
|
|
||||||
[10.685931, "o", "/e"]
|
|
||||||
[10.776068, "o", "mb"]
|
|
||||||
[10.956362, "o", "ed"]
|
|
||||||
[11.046547, "o", "de"]
|
|
||||||
[11.136692, "o", "d."]
|
|
||||||
[11.226851, "o", "mk"]
|
|
||||||
[11.316894, "o", " e"]
|
|
||||||
[11.406996, "o", "mb"]
|
|
||||||
[11.497205, "o", "ed"]
|
|
||||||
[11.58725, "o", "de"]
|
|
||||||
[11.677471, "o", "d-"]
|
|
||||||
[11.85761, "o", "ba"]
|
|
||||||
[11.947917, "o", "sh"]
|
|
||||||
[12.038071, "o", "\r\n"]
|
|
||||||
[13.045213, "o", "Is the process running bash? We can check with ps\r\n"]
|
|
||||||
[13.051057, "o", "bash\r\n"]
|
|
||||||
[13.051385, "o", "What text to figlet? \r\n"]
|
|
||||||
[14.434504, "o", "t"]
|
|
||||||
[14.503239, "o", "a"]
|
|
||||||
[14.605384, "o", "s"]
|
|
||||||
[14.745978, "o", "k"]
|
|
||||||
[14.946139, "o", "."]
|
|
||||||
[15.080651, "o", "m"]
|
|
||||||
[15.228545, "o", "k"]
|
|
||||||
[15.617669, "o", "\r\n"]
|
|
||||||
[15.618495, "o", " _ _ _ \r\n| |_ __ _ ___| | __ _ __ ___ | | __\r\n| __/ _` / __| |/ / | '_ ` _ \\| |/ /\r\n| || (_| \\__ \\ < _| | | | | | < \r\n \\__\\__,_|___/_|\\_(_)_| |_| |_|_|\\_\\\r\n \r\n"]
|
|
||||||
[15.618636, "o", "the argument below as given in the makefile itself\r\n"]
|
|
||||||
[15.618695, "o", "it's expanded before the script is passed to bash\r\nbash multiline is probably working\r\n"]
|
|
||||||
BIN
docs/examples/embedded/demo.gif
Normal file
BIN
docs/examples/embedded/demo.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 701 KiB |
13
docs/examples/embedded/demo.tape
Normal file
13
docs/examples/embedded/demo.tape
Normal file
|
|
@ -0,0 +1,13 @@
|
||||||
|
Output demo.gif
|
||||||
|
|
||||||
|
Set FontSize 32
|
||||||
|
Set Width 1600
|
||||||
|
Set Height 800
|
||||||
|
Set Theme "Catppuccin Mocha"
|
||||||
|
|
||||||
|
Type "make help" Sleep 1s Enter Sleep 2s
|
||||||
|
Type "make list-'.'" Sleep 1s Enter Sleep 2s
|
||||||
|
Type "make embedded-bash" Sleep 1s Enter Sleep 2s
|
||||||
|
Type "input!!" Sleep 500ms Enter Sleep 2s
|
||||||
|
Sleep 2s
|
||||||
|
|
||||||
|
|
@ -1,43 +0,0 @@
|
||||||
### examples of task.mk features | args: --divider --align center --msg-style b_red
|
|
||||||
define list_files_py
|
|
||||||
from pathlib import Path
|
|
||||||
print("files in $(2)")
|
|
||||||
print([f.name for f in (Path("$(2)").iterdir())])
|
|
||||||
endef
|
|
||||||
|
|
||||||
## list-% | use pathlib.Path to list files
|
|
||||||
### name the directory in rule (make list-src) | args: --align sep
|
|
||||||
list-%:
|
|
||||||
$(call py,list_files_py,$*)
|
|
||||||
|
|
||||||
# dollar signs will always be a problem
|
|
||||||
define bash_script
|
|
||||||
echo "Is the process running bash? We can check with ps"
|
|
||||||
ps -o args= -p $$$$ | grep -E -m 1 -o '\w{0,5}sh'
|
|
||||||
if [ -x "$(command -v figlet)" ]; then
|
|
||||||
echo 'no figlet :('
|
|
||||||
else
|
|
||||||
echo "What text to figlet? "
|
|
||||||
read name
|
|
||||||
figlet $$name
|
|
||||||
fi
|
|
||||||
echo "the argument below as given in the makefile itself"
|
|
||||||
echo "it's expanded before the script is passed to bash"
|
|
||||||
printf "%s\n" "$(2)"
|
|
||||||
endef
|
|
||||||
|
|
||||||
## embedded-bash | bash script with pipes and make input
|
|
||||||
.PHONY: embedded-bash
|
|
||||||
embedded-bash:
|
|
||||||
$(call tbash,bash_script,bash multiline is probably working)
|
|
||||||
|
|
||||||
define USAGE
|
|
||||||
{a.$(HEADER_STYLE)}usage:{a.end}
|
|
||||||
make <recipe>
|
|
||||||
|
|
||||||
examples of embedded scripts in `{a.magenta}Makefile{a.end}`
|
|
||||||
|
|
||||||
endef
|
|
||||||
.DEFAULT_GOAL = help
|
|
||||||
include $(shell git rev-parse --show-toplevel)/task.mk
|
|
||||||
|
|
||||||
|
|
@ -1,12 +1,8 @@
|
||||||
---
|
|
||||||
asciinema: true
|
|
||||||
---
|
|
||||||
|
|
||||||
# Embedded
|
# Embedded
|
||||||
|
|
||||||
<div id="demo-cast"></div>
|
|
||||||
|
|
||||||
```make title="embedded.mk"
|
```make title="Makefile (embedded)"
|
||||||
--8<-- "docs/examples/embedded/embedded.mk"
|
--8<-- "docs/examples/embedded/Makefile"
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,9 +0,0 @@
|
||||||
#!/usr/bin/env bash
|
|
||||||
|
|
||||||
source "$(dirname "${BASH_SOURCE[0]}")/../functions.sh"
|
|
||||||
|
|
||||||
cmd 'make -f embedded/embedded.mk help'
|
|
||||||
cmd 'make -f embedded/embedded.mk list-embedded'
|
|
||||||
cmd 'make -f embedded/embedded.mk embedded-bash'
|
|
||||||
sleep 1
|
|
||||||
|
|
||||||
|
|
@ -1,15 +0,0 @@
|
||||||
#!/usr/bin/env bash
|
|
||||||
|
|
||||||
msg() {
|
|
||||||
printf '%s\n' "$1" | pv -qL 20
|
|
||||||
sleep 1
|
|
||||||
}
|
|
||||||
|
|
||||||
cmd (){
|
|
||||||
clear
|
|
||||||
printf 'bash >> '
|
|
||||||
msg "$1"
|
|
||||||
$1
|
|
||||||
sleep 2
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
@ -12,3 +12,7 @@
|
||||||
[Recipe Help](./recipe-help)
|
[Recipe Help](./recipe-help)
|
||||||
|
|
||||||
: Display the target, docstring and recipe for a given target then exit.
|
: Display the target, docstring and recipe for a given target then exit.
|
||||||
|
|
||||||
|
[Phonify](./phonify)
|
||||||
|
|
||||||
|
: Automatically generate the phony call for any documented tasks.
|
||||||
|
|
|
||||||
1
docs/examples/phonify/.task.mk
Symbolic link
1
docs/examples/phonify/.task.mk
Symbolic link
|
|
@ -0,0 +1 @@
|
||||||
|
../../../task.mk
|
||||||
22
docs/examples/phonify/Makefile
Normal file
22
docs/examples/phonify/Makefile
Normal file
|
|
@ -0,0 +1,22 @@
|
||||||
|
a-task: ## will be marked phony
|
||||||
|
@echo a-task executed
|
||||||
|
|
||||||
|
b-task: ## wont be marked phony |> --not-phony
|
||||||
|
@echo b-task executed
|
||||||
|
|
||||||
|
c-task:
|
||||||
|
@echo c-task executed
|
||||||
|
|
||||||
|
.PHONY: gen-task-files
|
||||||
|
gen-task-files:
|
||||||
|
touch a-task b-task c-task
|
||||||
|
|
||||||
|
define USAGE
|
||||||
|
{a.$(HEADER_STYLE)}usage:{a.end}\n make <recipe>\n
|
||||||
|
phonifying tasks
|
||||||
|
{a.faint}hint: there is also a c-task...{a.end}\n
|
||||||
|
endef
|
||||||
|
|
||||||
|
PHONIFY = true
|
||||||
|
.DEFAULT_GOAL = help
|
||||||
|
include .task.mk
|
||||||
0
docs/examples/phonify/a-task
Normal file
0
docs/examples/phonify/a-task
Normal file
0
docs/examples/phonify/b-task
Normal file
0
docs/examples/phonify/b-task
Normal file
0
docs/examples/phonify/c-task
Normal file
0
docs/examples/phonify/c-task
Normal file
BIN
docs/examples/phonify/demo.gif
Normal file
BIN
docs/examples/phonify/demo.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 395 KiB |
14
docs/examples/phonify/demo.tape
Normal file
14
docs/examples/phonify/demo.tape
Normal file
|
|
@ -0,0 +1,14 @@
|
||||||
|
Output demo.gif
|
||||||
|
|
||||||
|
Set FontSize 32
|
||||||
|
Set Width 1600
|
||||||
|
Set Height 800
|
||||||
|
Set Theme "Catppuccin Mocha"
|
||||||
|
|
||||||
|
Type "make help" Sleep 1s Enter Sleep 2s
|
||||||
|
Type "ls" Sleep 1s Enter Sleep 2s
|
||||||
|
Type "make a-task" Sleep 1s Enter Sleep 2s
|
||||||
|
Type "make b-task" Sleep 1s Enter Sleep 2s
|
||||||
|
Type "make c-task" Sleep 1s Enter Sleep 2s
|
||||||
|
Sleep 2s
|
||||||
|
|
||||||
8
docs/examples/phonify/index.md
Normal file
8
docs/examples/phonify/index.md
Normal file
|
|
@ -0,0 +1,8 @@
|
||||||
|
# Phonify
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
```make title="Makefile (phonify)"
|
||||||
|
--8<-- "docs/examples/phonify/Makefile"
|
||||||
|
```
|
||||||
|
|
||||||
1
docs/examples/recipe-help/.task.mk
Symbolic link
1
docs/examples/recipe-help/.task.mk
Symbolic link
|
|
@ -0,0 +1 @@
|
||||||
|
../../../task.mk
|
||||||
|
|
@ -1,10 +1,8 @@
|
||||||
## deps-only | a task/target with dependencies
|
|
||||||
.PHONY: deps-only
|
.PHONY: deps-only
|
||||||
deps-only: foo
|
deps-only: foo ## a task/target with dependencies
|
||||||
|
|
||||||
## foo | a dummy rule that depends on the local files
|
|
||||||
.PHONY: foo
|
.PHONY: foo
|
||||||
foo: $(wildcard *)
|
foo: $(wildcard *) ## a dummy rule that depends on the local files
|
||||||
@echo 'this is a dummy rule'
|
@echo 'this is a dummy rule'
|
||||||
|
|
||||||
# bar but no docstring
|
# bar but no docstring
|
||||||
|
|
@ -20,5 +18,5 @@ define USAGE
|
||||||
endef
|
endef
|
||||||
|
|
||||||
.DEFAULT_GOAL = help
|
.DEFAULT_GOAL = help
|
||||||
include $(shell git rev-parse --show-toplevel)/task.mk
|
include .task.mk
|
||||||
|
|
||||||
|
|
@ -1,138 +0,0 @@
|
||||||
{"version": 2, "width": 60, "height": 20, "timestamp": 1664060106, "env": {"SHELL": "/usr/bin/zsh", "TERM": "xterm-256color"}}
|
|
||||||
[0.007806, "o", "\u001b[H\u001b[2J\u001b[3J"]
|
|
||||||
[0.008354, "o", "bash >> "]
|
|
||||||
[0.008532, "o", "ma"]
|
|
||||||
[0.189207, "o", "ke"]
|
|
||||||
[0.279458, "o", " -"]
|
|
||||||
[0.369697, "o", "f "]
|
|
||||||
[0.459892, "o", "re"]
|
|
||||||
[0.550111, "o", "ci"]
|
|
||||||
[0.640099, "o", "pe"]
|
|
||||||
[0.730309, "o", "-h"]
|
|
||||||
[0.820408, "o", "el"]
|
|
||||||
[0.910572, "o", "p/"]
|
|
||||||
[1.090837, "o", "re"]
|
|
||||||
[1.180944, "o", "ci"]
|
|
||||||
[1.271024, "o", "pe"]
|
|
||||||
[1.36131, "o", "-h"]
|
|
||||||
[1.451464, "o", "el"]
|
|
||||||
[1.541712, "o", "p."]
|
|
||||||
[1.631676, "o", "mk"]
|
|
||||||
[1.721815, "o", " h"]
|
|
||||||
[1.812133, "o", "el"]
|
|
||||||
[1.99248, "o", "p\r\n"]
|
|
||||||
[3.025715, "o", "\u001b[1;36musage:\u001b[0m\r\n\tmake <recipe>\r\n\tmake help <recipe>\r\n\r\n\u001b[1;33m deps-only\u001b[0m │ \u001b[2ma task/target with dependencies\u001b[0m\r\n\u001b[1;33m foo\u001b[0m │ \u001b[2ma dummy rule that depends on the local files\u001b[0m\r\n\u001b[1;33m h, help\u001b[0m │ \u001b[2mshow this help\u001b[0m\r\n\r\n"]
|
|
||||||
[5.032814, "o", "\u001b[H\u001b[2J\u001b[3Jbash >> "]
|
|
||||||
[5.034705, "o", "ma"]
|
|
||||||
[5.215256, "o", "ke"]
|
|
||||||
[5.305482, "o", " -"]
|
|
||||||
[5.395504, "o", "f "]
|
|
||||||
[5.485805, "o", "re"]
|
|
||||||
[5.576036, "o", "ci"]
|
|
||||||
[5.666095, "o", "pe"]
|
|
||||||
[5.756177, "o", "-h"]
|
|
||||||
[5.846563, "o", "el"]
|
|
||||||
[5.93671, "o", "p/"]
|
|
||||||
[6.11689, "o", "re"]
|
|
||||||
[6.206935, "o", "ci"]
|
|
||||||
[6.297128, "o", "pe"]
|
|
||||||
[6.387205, "o", "-h"]
|
|
||||||
[6.477454, "o", "el"]
|
|
||||||
[6.567496, "o", "p."]
|
|
||||||
[6.657713, "o", "mk"]
|
|
||||||
[6.747729, "o", " h"]
|
|
||||||
[6.838006, "o", "el"]
|
|
||||||
[7.018242, "o", "p "]
|
|
||||||
[7.108261, "o", "he"]
|
|
||||||
[7.198405, "o", "lp"]
|
|
||||||
[7.288809, "o", "\r\n"]
|
|
||||||
[8.318829, "o", "\u001b[1;36mtask.mk recipe help\u001b[0m\r\n\r\n"]
|
|
||||||
[8.325694, "o", " \u001b[1;33mh help\u001b[0m\r\n\u001b[38m ────────────────────────────────────────────────────────\u001b[0m\r\n $(call py,help_py) || { echo \"exiting early!\"; exit 1; }\r\n\r\n"]
|
|
||||||
[8.329695, "o", "exiting early!\r\nmake[1]: *** [/home/daylin/dev/github/mine/task.mk/task.mk:30: help] Error 1\r\n"]
|
|
||||||
[10.332715, "o", "\u001b[H\u001b[2J\u001b[3J"]
|
|
||||||
[10.333056, "o", "bash >> "]
|
|
||||||
[10.335005, "o", "ma"]
|
|
||||||
[10.515605, "o", "ke"]
|
|
||||||
[10.605896, "o", " -"]
|
|
||||||
[10.696226, "o", "f "]
|
|
||||||
[10.78629, "o", "re"]
|
|
||||||
[10.876669, "o", "ci"]
|
|
||||||
[10.966704, "o", "pe"]
|
|
||||||
[11.056858, "o", "-h"]
|
|
||||||
[11.146831, "o", "el"]
|
|
||||||
[11.236969, "o", "p/"]
|
|
||||||
[11.417281, "o", "re"]
|
|
||||||
[11.507468, "o", "ci"]
|
|
||||||
[11.597442, "o", "pe"]
|
|
||||||
[11.687589, "o", "-h"]
|
|
||||||
[11.777832, "o", "el"]
|
|
||||||
[11.867969, "o", "p."]
|
|
||||||
[11.958105, "o", "mk"]
|
|
||||||
[12.048177, "o", " h"]
|
|
||||||
[12.138291, "o", "el"]
|
|
||||||
[12.318676, "o", "p "]
|
|
||||||
[12.408796, "o", "de"]
|
|
||||||
[12.498823, "o", "ps"]
|
|
||||||
[12.588985, "o", "-o"]
|
|
||||||
[12.679133, "o", "nl"]
|
|
||||||
[12.769237, "o", "y\r\n"]
|
|
||||||
[13.807661, "o", "\u001b[1;36mtask.mk recipe help\u001b[0m\r\n\r\n"]
|
|
||||||
[13.816448, "o", "\u001b[1;33m deps-only\u001b[0m │ \u001b[2ma task/target with dependencies\u001b[0m\r\n \u001b[38mdeps\u001b[0m: \u001b[2mfoo\u001b[0m\r\n\r\n"]
|
|
||||||
[13.820255, "o", "exiting early!\r\n"]
|
|
||||||
[13.820461, "o", "make[1]: *** [/home/daylin/dev/github/mine/task.mk/task.mk:30: help] Error 1\r\n"]
|
|
||||||
[15.823763, "o", "\u001b[H\u001b[2J\u001b[3J"]
|
|
||||||
[15.824036, "o", "bash >> "]
|
|
||||||
[15.826016, "o", "ma"]
|
|
||||||
[16.006673, "o", "ke"]
|
|
||||||
[16.09685, "o", " -"]
|
|
||||||
[16.186936, "o", "f "]
|
|
||||||
[16.277228, "o", "re"]
|
|
||||||
[16.367339, "o", "ci"]
|
|
||||||
[16.45744, "o", "pe"]
|
|
||||||
[16.547483, "o", "-h"]
|
|
||||||
[16.637622, "o", "el"]
|
|
||||||
[16.727742, "o", "p/"]
|
|
||||||
[16.907989, "o", "re"]
|
|
||||||
[16.99817, "o", "ci"]
|
|
||||||
[17.088391, "o", "pe"]
|
|
||||||
[17.178352, "o", "-h"]
|
|
||||||
[17.268476, "o", "el"]
|
|
||||||
[17.358766, "o", "p."]
|
|
||||||
[17.448842, "o", "mk"]
|
|
||||||
[17.539039, "o", " h"]
|
|
||||||
[17.629197, "o", "el"]
|
|
||||||
[17.809354, "o", "p "]
|
|
||||||
[17.899578, "o", "fo"]
|
|
||||||
[17.989694, "o", "o\r\n"]
|
|
||||||
[19.020047, "o", "\u001b[1;36mtask.mk recipe help\u001b[0m\r\n\r\n"]
|
|
||||||
[19.03039, "o", "\u001b[1;33m foo\u001b[0m │ \u001b[2ma dummy rule that depends on the local files\u001b[0m\r\n \u001b[38mdeps\u001b[0m: \u001b[2mcheck embedded functions.sh index.md Makefile recipe-help\u001b[0m\r\n\u001b[38m ────────────────────────────\u001b[0m\r\n @echo 'this is a dummy rule'\r\n\r\n"]
|
|
||||||
[19.035496, "o", "exiting early!\r\n"]
|
|
||||||
[19.035706, "o", "make[1]: *** [/home/daylin/dev/github/mine/task.mk/task.mk:30: help] Error 1\r\n"]
|
|
||||||
[21.039168, "o", "\u001b[H\u001b[2J\u001b[3J"]
|
|
||||||
[21.03927, "o", "bash >> "]
|
|
||||||
[21.041378, "o", "ma"]
|
|
||||||
[21.221916, "o", "ke"]
|
|
||||||
[21.31205, "o", " -"]
|
|
||||||
[21.402214, "o", "f "]
|
|
||||||
[21.492482, "o", "re"]
|
|
||||||
[21.582638, "o", "ci"]
|
|
||||||
[21.672609, "o", "pe"]
|
|
||||||
[21.762748, "o", "-h"]
|
|
||||||
[21.853045, "o", "el"]
|
|
||||||
[21.943154, "o", "p/"]
|
|
||||||
[22.123286, "o", "re"]
|
|
||||||
[22.2134, "o", "ci"]
|
|
||||||
[22.303509, "o", "pe"]
|
|
||||||
[22.393685, "o", "-h"]
|
|
||||||
[22.483815, "o", "el"]
|
|
||||||
[22.574005, "o", "p."]
|
|
||||||
[22.664056, "o", "mk"]
|
|
||||||
[22.754229, "o", " h"]
|
|
||||||
[22.844432, "o", "el"]
|
|
||||||
[23.02464, "o", "p "]
|
|
||||||
[23.114692, "o", "ba"]
|
|
||||||
[23.205123, "o", "r\r\n"]
|
|
||||||
[24.260098, "o", "\u001b[1;36mtask.mk recipe help\u001b[0m\r\n\r\n"]
|
|
||||||
[24.267129, "o", " \u001b[1;33mbar\u001b[0m\r\n\u001b[38m ─────────────────────────────────────\u001b[0m\r\n @echo 'some rule with no help string'\r\n\r\n"]
|
|
||||||
[24.271004, "o", "exiting early!\r\n"]
|
|
||||||
[24.271137, "o", "make[1]: *** [/home/daylin/dev/github/mine/task.mk/task.mk:30: help] Error 1\r\n"]
|
|
||||||
BIN
docs/examples/recipe-help/demo.gif
Normal file
BIN
docs/examples/recipe-help/demo.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 1 MiB |
14
docs/examples/recipe-help/demo.tape
Normal file
14
docs/examples/recipe-help/demo.tape
Normal file
|
|
@ -0,0 +1,14 @@
|
||||||
|
Output demo.gif
|
||||||
|
|
||||||
|
Set FontSize 32
|
||||||
|
Set Width 1600
|
||||||
|
Set Height 800
|
||||||
|
Set Theme "Catppuccin Mocha"
|
||||||
|
|
||||||
|
Type "make help" Sleep 1s Enter Sleep 2s
|
||||||
|
Type "make help help" Sleep 1s Enter Sleep 2s
|
||||||
|
Type "make help deps-only" Sleep 1s Enter Sleep 2s
|
||||||
|
Type "make help foo" Sleep 1s Enter Sleep 2s
|
||||||
|
Type "make help bar" Sleep 1s Enter Sleep 2s
|
||||||
|
Sleep 2s
|
||||||
|
|
||||||
|
|
@ -1,12 +1,8 @@
|
||||||
---
|
|
||||||
asciinema: true
|
|
||||||
---
|
|
||||||
|
|
||||||
# Recipe Help
|
# Recipe Help
|
||||||
|
|
||||||
<div id="demo-cast"></div>
|
|
||||||
|
|
||||||
```make title="recipe-help.mk"
|
```make title="Makefile (recipe-help)"
|
||||||
--8<-- "docs/examples/recipe-help/recipe-help.mk"
|
--8<-- "docs/examples/recipe-help/Makefile"
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,11 +0,0 @@
|
||||||
#!/usr/bin/env bash
|
|
||||||
|
|
||||||
source "$(dirname "${BASH_SOURCE[0]}")/../functions.sh"
|
|
||||||
|
|
||||||
cmd 'make -f recipe-help/recipe-help.mk help'
|
|
||||||
cmd 'make -f recipe-help/recipe-help.mk help help'
|
|
||||||
cmd 'make -f recipe-help/recipe-help.mk help deps-only'
|
|
||||||
cmd 'make -f recipe-help/recipe-help.mk help foo'
|
|
||||||
cmd 'make -f recipe-help/recipe-help.mk help bar'
|
|
||||||
|
|
||||||
sleep 1
|
|
||||||
|
|
@ -1,9 +1,12 @@
|
||||||
<div align="center">
|
<div align="center">
|
||||||
<h1 align="center"> task.mk </h1>
|
<h1 align="center"> task.mk </h1>
|
||||||
<img src="https://raw.githubusercontent.com/daylinmorgan/task.mk/main/assets/help.svg" alt="help" width=400 >
|
<img src="./assets/help.svg" alt="help" width=400 >
|
||||||
<p align="center">
|
<p align="center">
|
||||||
the task runner for GNU Make you've been missing
|
the task runner for GNU Make you've been missing
|
||||||
</p>
|
</p>
|
||||||
|
<p align="center">
|
||||||
|
<a href="https://gh.dayl.in/task.mk">Documentation</a>
|
||||||
|
</p>
|
||||||
</div>
|
</div>
|
||||||
</br>
|
</br>
|
||||||
|
|
||||||
|
|
@ -15,75 +18,38 @@ to add some QOL improvements for your users and fellow maintainers.
|
||||||
|
|
||||||
Current Features:
|
Current Features:
|
||||||
|
|
||||||
- ANSI escape code support (including NO\_COLOR)
|
- ANSI escape code support (including NO_COLOR)
|
||||||
- formatted help output
|
- formatted help output
|
||||||
- custom print function
|
- custom print function
|
||||||
- confirmation prompt
|
- confirmation prompt
|
||||||
|
- goal phonifier (disabled by default)
|
||||||
|
|
||||||
Depends on `GNU Make`, obviously and `Python >=3.7`, and `bash` (or `zsh`).
|
Depends on `GNU Make`, obviously and `Python >=3.7`, and `bash` (or `zsh`).
|
||||||
|
|
||||||
Wait python?!?!, I'm not `pip` installing some package just to parse my makefile.
|
Wait python?!?!, I'm not `pip` installing some package just to parse my makefile.
|
||||||
I agree, all you need is one file [`.task.mk`](https://github.com/daylinmorgan/task.mk/v23.1.1/task.mk).
|
I agree, all you need is one file [`.task.mk`](./task.mk).
|
||||||
You can automagically include it with just two additional lines to your `Makefile` (and probably one to your `.gitignore`) and your good to go.
|
You can automagically include it with just two additional lines to your `Makefile` (and probably one to your `.gitignore`) and you're good to go.
|
||||||
|
|
||||||
## Setup
|
## Setup
|
||||||
|
|
||||||
|
One line setup to download .task.mk and add appropriate includes to your `Makefile`.
|
||||||
|
```bash
|
||||||
|
bash <(curl -fsSL gh.dayl.in/task.mk/init) # or w/ TASKMK_VERSION=
|
||||||
|
```
|
||||||
|
|
||||||
You can include this as an optional dependency on your project by adding the below lines to the end of your `Makefile`.
|
You can include this as an optional dependency on your project by adding the below lines to the end of your `Makefile`.
|
||||||
If someone tries to invoke `make help` it will download `.task.mk` for them.
|
If someone tries to invoke `make help` it will download `.task.mk` for them.
|
||||||
|
|
||||||
```make
|
```make
|
||||||
-include .task.mk
|
-include .task.mk
|
||||||
$(if $(filter help,$(MAKECMDGOALS)),$(if $(wildcard .task.mk),,.task.mk: ; curl -fsSL https://raw.githubusercontent.com/daylinmorgan/task.mk/v23.1.1/task.mk -o .task.mk))
|
$(if $(filter help,$(MAKECMDGOALS)),$(if $(wildcard .task.mk),,.task.mk: ; curl -fsSL https://raw.githubusercontent.com/daylinmorgan/task.mk/v23.1.2/task.mk -o .task.mk))
|
||||||
```
|
```
|
||||||
|
|
||||||
You might also consider making it a consistently downloaded dependency if you plan to use any of it's advanced feature set, by dropping the `$(MAKECMDGOALS)` check.
|
If you plan to use any features besides the help prompt you may want to instead commit `.task.mk` to version control or drop the `$(MAKECMDGOALS)` check so it's always downloaded once `make` is invoked.
|
||||||
|
|
||||||
```make
|
```make
|
||||||
-include .task.mk
|
-include .task.mk
|
||||||
$(if $(wildcard .task.mk),,.task.mk: ; curl -fsSL https://raw.githubusercontent.com/daylinmorgan/task.mk/v23.1.1/task.mk -o .task.mk)
|
$(if $(wildcard .task.mk),,.task.mk: ; curl -fsSL https://raw.githubusercontent.com/daylinmorgan/task.mk/v23.1.2/task.mk -o .task.mk)
|
||||||
```
|
```
|
||||||
|
|
||||||
Alternatively, you can use the builtin rule `_update-task.mk` to update to the latest development version.
|
For more info see the [documentation](https://gh.dayl.in/task.mk).
|
||||||
|
|
||||||
See [Usage](./usage) to get started running all your tasks.
|
|
||||||
See [Examples](./examples) for more use cases.
|
|
||||||
|
|
||||||
## Zsh Completions for GNU Make
|
|
||||||
|
|
||||||
If you use `GNU Make` with zsh you may want to add the following
|
|
||||||
line to your rc file to allow `make` to handle the autocomplete.
|
|
||||||
|
|
||||||
```zsh
|
|
||||||
zstyle ':completion::complete:make:*:targets' call-command true
|
|
||||||
```
|
|
||||||
|
|
||||||
## Why Make?
|
|
||||||
|
|
||||||
There are lot of `GNU Make` alternatives but none have near the same level of ubiquity.
|
|
||||||
This project attaches to `make` some of the native features of [`just`](https://github.com/casey/just), a command runner.
|
|
||||||
|
|
||||||
Just is a great task runner, but it suffers two problems, users probably don't have it installed already, and there is no way to define file specific recipes.
|
|
||||||
Most of my `Makefile`'s are comprised primarily of handy `.PHONY` recipes, but I always end up with a few file specific recipes.
|
|
||||||
|
|
||||||
Another interesting project I've evaluated for these purposes is [`go-task/task`](https://github.com/go-task/task).
|
|
||||||
`Task` has many of the features of `GNU Make` and some novel features of it's own.
|
|
||||||
But like `just` it's a tool people don't usually already have and it's configured using a `yaml` file.
|
|
||||||
`Yaml` files can be finicky to work with and and it uses a golang based shell runtime, not your native shell, which might lead to unexpected behavior.
|
|
||||||
|
|
||||||
|
|
||||||
## Simpler Alternative
|
|
||||||
|
|
||||||
But I just want a basic help output, surely I don't need python for this... you would be right.
|
|
||||||
`Task.mk` replaces my old `make help` recipe boilerplate which may better serve you (so long as you have `sed`/`awk`).
|
|
||||||
|
|
||||||
|
|
||||||
```make
|
|
||||||
## h, help | show this help
|
|
||||||
.PHONY: help h
|
|
||||||
help h: Makefile
|
|
||||||
@awk -v fill=$(shell sed -n 's/^## \(.*\) | .*/\1/p' $< | wc -L)\
|
|
||||||
'match($$0,/^## (.*) \|/,name) && match($$0,/\| (.*)$$/,help)\
|
|
||||||
{printf "\033[1;93m%*s\033[0m | \033[30m%s\033[0m\n",\
|
|
||||||
fill,name[1],help[1];} match($$0,/^### (.*)/,str) \
|
|
||||||
{printf "%*s \033[30m%s\033[0m\n",fill," ",str[1];}' $<
|
|
||||||
```
|
|
||||||
|
|
|
||||||
18
docs/init
18
docs/init
|
|
@ -1,6 +1,6 @@
|
||||||
#!/usr/bin/env bash
|
#!/usr/bin/env bash
|
||||||
set -e
|
set -e
|
||||||
LATEST_TASKMK_VERSION="v23.1.1"
|
LATEST_TASKMK_VERSION="v23.1.2"
|
||||||
VERSION=${TASKMK_VERSION:-$LATEST_TASKMK_VERSION}
|
VERSION=${TASKMK_VERSION:-$LATEST_TASKMK_VERSION}
|
||||||
printf "Initializing Task.mk (%s) for repo\n" "$VERSION"
|
printf "Initializing Task.mk (%s) for repo\n" "$VERSION"
|
||||||
if [ -f "./.task.mk" ]; then
|
if [ -f "./.task.mk" ]; then
|
||||||
|
|
@ -11,20 +11,22 @@ if [ -f "./.task.mk" ]; then
|
||||||
fi
|
fi
|
||||||
curl -fsSL "https://raw.githubusercontent.com/daylinmorgan/task.mk/$VERSION/task.mk" -o .task.mk
|
curl -fsSL "https://raw.githubusercontent.com/daylinmorgan/task.mk/$VERSION/task.mk" -o .task.mk
|
||||||
echo .task.mk >>.gitignore
|
echo .task.mk >>.gitignore
|
||||||
printf '\n-include .task.cfg.mk .task.mk\n' >>Makefile
|
printf '\n-include .task.cfg.mk\n' >>Makefile
|
||||||
printf '$(if $(filter help,$(MAKECMDGOALS)),$(if $(wildcard .task.mk),,.task.mk: ; curl -fsSL https://raw.githubusercontent.com/daylinmorgan/task.mk/%s/task.mk -o .task.mk))' \
|
printf '%s %s\n' '-include' '.task.mk' >>.task.cfg.mk
|
||||||
|
printf '$(if $(filter help,$(MAKECMDGOALS)),$(if $(wildcard .task.mk),,.task.mk: ; curl -fsSL https://raw.githubusercontent.com/daylinmorgan/task.mk/%s/task.mk -o .task.mk))\n' \
|
||||||
"$VERSION" \
|
"$VERSION" \
|
||||||
>>Makefile
|
>>.task.cfg.mk
|
||||||
|
|
||||||
printf ".task.mk files added to repo\n\n"
|
printf ".task.mk files added to repo\n\n"
|
||||||
echo "Do you want to commit these changes?"
|
echo "Do you want to commit these changes?"
|
||||||
printf "RUN COMMAND: %s (Y/n) " \
|
printf "Run the below command?\n\n %s (Y/n) " \
|
||||||
"git add Makefile .gitignore && git commit -m \"chore: initialize .task.mk\""
|
"git add Makefile .gitignore .task.cfg.mk && git commit -m \"chore: initialize .task.mk\""
|
||||||
|
|
||||||
read -r answer
|
read -r answer </dev/tty
|
||||||
# if echo "$answer" | grep -iq "^y" ;then
|
# if echo "$answer" | grep -iq "^y" ;then
|
||||||
if [ "$answer" != "${answer#[Yy]}" ]; then
|
if [ "$answer" != "${answer#[Yy]}" ]; then
|
||||||
git add Makefile .gitignore && git commit -m "chore: initialize .task.mk"
|
git add Makefile .gitignore .task.cfg.mk &&
|
||||||
|
git commit -m "chore: initialize .task.mk"
|
||||||
echo finished.
|
echo finished.
|
||||||
else
|
else
|
||||||
echo finished.
|
echo finished.
|
||||||
|
|
|
||||||
1
docs/javascripts/asciinema-player.min.js
vendored
1
docs/javascripts/asciinema-player.min.js
vendored
File diff suppressed because one or more lines are too long
|
|
@ -1,16 +0,0 @@
|
||||||
{% extends "base.html" %}
|
|
||||||
|
|
||||||
{% block scripts %}
|
|
||||||
|
|
||||||
{{ super() }}
|
|
||||||
|
|
||||||
{% if page.meta %}
|
|
||||||
{% if page.meta.asciinema %}
|
|
||||||
<script async>
|
|
||||||
AsciinemaPlayer.create('./demo.cast', document.getElementById('demo-cast'),{loop: true});
|
|
||||||
</script>
|
|
||||||
{% endif %}
|
|
||||||
{% endif %}
|
|
||||||
|
|
||||||
|
|
||||||
{% endblock %}
|
|
||||||
File diff suppressed because it is too large
Load diff
|
|
@ -1,30 +1,71 @@
|
||||||
# Usage
|
# Usage
|
||||||
|
|
||||||
`Task.mk` will add access to a recipe `help` (also aliased to `h`).
|
`Task.mk` can be included in any standard `GNUMakefile`.
|
||||||
In order to use `make help` to you will need to add some custom comments to your `Makefile`.
|
If it's been properly sourced you will have access to the below features/recipes.
|
||||||
|
|
||||||
Deliberately, I don't get names from recipes themselves.
|
See [examples](/task.mk/examples) for more info.
|
||||||
This not only greatly simplifies the parsing but add's some opportunity to customize the output.
|
|
||||||
Such as to document wildcard or redundant recipes.
|
|
||||||
|
|
||||||
You can place these anywhere, but I recommend adding these notes directly above their relevant recipes.
|
## Builtin Recipes
|
||||||
The format is `## <recipe> | <msg>`
|
|
||||||
|
### Help
|
||||||
|
|
||||||
|
Invoked with either `make help` or `make h`.
|
||||||
|
|
||||||
|
Adding goals to the builtin help recipe just requires documenting your `Makefile` with comments.
|
||||||
|
The format is `## <recipe> |> <msg>` or `<recipe>: ## <msg>`
|
||||||
|
|
||||||
```make
|
```make
|
||||||
## build | build the project
|
## build |> build the project
|
||||||
.PHONY: build
|
|
||||||
build:
|
build:
|
||||||
...
|
...
|
||||||
|
|
||||||
|
build: ## build the project
|
||||||
```
|
```
|
||||||
|
|
||||||
Now when you invoke `make help` it will parse these and generate your help output.
|
Now when you invoke `make help` it will parse these and generate your help output.
|
||||||
|
In addition you can add raw text to the help output using the format `### <rawmsg>`.
|
||||||
|
|
||||||
In addition to a generic help output you can expose some configuration settings with `make vars`.
|
Both recipe documentation and raw messages can be modified with additional arguments delimited by `|>`.
|
||||||
|
|
||||||
|
For example:
|
||||||
|
|
||||||
|
```make
|
||||||
|
### build related recipes |> --align center --divider
|
||||||
|
build: ## build the project |> --msg-style bold
|
||||||
|
...
|
||||||
|
package: ## package the project |> -gs b_cyan
|
||||||
|
```
|
||||||
|
|
||||||
|
`Task.mk` can also generate recipe specific help regardless of whether a goal is documented.
|
||||||
|
This can be invoked by appending the name of a recipe to help call: `make help build`.
|
||||||
|
|
||||||
|
All recipes prefixed with and underscore will be hidden even if documented.
|
||||||
|
However, they can be viewed by invoking `make _help`.
|
||||||
|
|
||||||
|
### Vars
|
||||||
|
|
||||||
|
In addition to a generic help output you can expose some configuration settings with `make vars` or `make v`.
|
||||||
To do so define the variables you'd like to print with `PRINT_VARS := VAR1 VAR2 VAR3`.
|
To do so define the variables you'd like to print with `PRINT_VARS := VAR1 VAR2 VAR3`.
|
||||||
|
|
||||||
In addition to the `help` and `vars` recipes you can use a custom make function to format your text for fancier output.
|
## Builtin Functions
|
||||||
For this there are two options depending on your needs `tprint` or `tprint-sh`. (`tprint-sh` is for use within a multiline sub-shell that has already been silenced, see the version-check rule of this project's `Makefile` for an example.)
|
|
||||||
|
|
||||||
|
### Phonify
|
||||||
|
|
||||||
|
Phonify is a new experimental feature of `task.mk` that solves one of the biggest gotchas of using `make` as a task runner!
|
||||||
|
It stands to reason the tasks you document are likely to all be phony recipes
|
||||||
|
Rather than write `.PHONY: <goal>` repeatedly, simply enable `task.mk`'s phonifier.
|
||||||
|
|
||||||
|
`Task.mk` will then parse your `Makefile` for documented tasks and
|
||||||
|
generate the necessary `.PHONY: <recipes>` line to ensure they are always executed.
|
||||||
|
To use this feature set the `PHONIFY` environment variable before including `.task.mk`.
|
||||||
|
To avoid adding a documented task/recipe to `.PHONY`, use `|> --not-phony` after the recipe message.
|
||||||
|
|
||||||
|
### Tprint
|
||||||
|
|
||||||
|
Besides the `help` and `vars` recipes you can use a custom make function to format your text for fancier output.
|
||||||
|
For this there are two options depending on your needs `tprint` or `tprint-verbose`
|
||||||
|
(`tprint-verbose` is for use within a multiline sub-shell that has already been silenced,
|
||||||
|
see the version-check rule of this project's `Makefile` for an example).
|
||||||
|
|
||||||
To use `tprint` you call it with the builtin `make` call function.
|
To use `tprint` you call it with the builtin `make` call function.
|
||||||
It accepts only one argument: an unquoted f-string literal.
|
It accepts only one argument: an unquoted f-string literal.
|
||||||
|
|
@ -32,20 +73,17 @@ All strings passed to `tprint` have access to an object `ansi` or `a` for simpli
|
||||||
This stores ANSI escape codes which can be used to style your text.
|
This stores ANSI escape codes which can be used to style your text.
|
||||||
|
|
||||||
```make
|
```make
|
||||||
## build | compile the source
|
|
||||||
.PHONY: build
|
.PHONY: build
|
||||||
build:
|
build: ## compile the source
|
||||||
$(call tprint,{a.cyan}Build Starting{a.end})
|
$(call tprint,{a.cyan}Build Starting{a.end})
|
||||||
...
|
...
|
||||||
$(call tprint,{a.green}Build Finished{a.end})
|
$(call tprint,{a.green}Build Finished{a.end})
|
||||||
```
|
```
|
||||||
|
|
||||||
See this projects `make info` for more examples of `tprint`.
|
See this projects `make info` for more examples of `tprint`.
|
||||||
|
|
||||||
To see the available colors and formatting(bold,italic,etc.) use the hidden recipe `make _print-ansi`.
|
To see the available colors and formatting(bold,italic,etc.) use the hidden recipe `make _print-ansi`.
|
||||||
|
|
||||||
**Note**: Any help commands starting with an underscore will be ignored.
|
|
||||||
To view hidden `tasks` (or recipes in GNU Make land) you can use `make _help`.
|
|
||||||
|
|
||||||
In addition, you can use custom colors using the builtin `ansi.custom` or (`a.custom`) method.
|
In addition, you can use custom colors using the builtin `ansi.custom` or (`a.custom`) method.
|
||||||
It has two optional arguments `fg` and `bg`. Which can be used to specify either an 8-bit color from the [256 colors](https://en.wikipedia.org/wiki/8-bit_color).
|
It has two optional arguments `fg` and `bg`. Which can be used to specify either an 8-bit color from the [256 colors](https://en.wikipedia.org/wiki/8-bit_color).
|
||||||
Or a tuple/list to define an RBG 24-bit color, for instance `a.custom(fg=(5,10,255))`.
|
Or a tuple/list to define an RBG 24-bit color, for instance `a.custom(fg=(5,10,255))`.
|
||||||
|
|
@ -54,7 +92,7 @@ See this project's `make info` for an example.
|
||||||
## Configuration
|
## Configuration
|
||||||
|
|
||||||
You can quickly customize some of the default behavior of `task.mk` by overriding the below variables prior to the `-include .task.mk`.
|
You can quickly customize some of the default behavior of `task.mk` by overriding the below variables prior to the `-include .task.mk`.
|
||||||
These can also be included in a seperate file `.task.cfg.mk`.
|
These can also for instance included in a seperate file `.task.cfg.mk`.
|
||||||
|
|
||||||
```make
|
```make
|
||||||
# ---- [config] ---- #
|
# ---- [config] ---- #
|
||||||
|
|
@ -69,7 +107,8 @@ HELP_SEP ?= │
|
||||||
# python f-string literals
|
# python f-string literals
|
||||||
EPILOG ?=
|
EPILOG ?=
|
||||||
USAGE ?={ansi.$(HEADER_STYLE)}usage{ansi.end}:\n make <recipe>\n
|
USAGE ?={ansi.$(HEADER_STYLE)}usage{ansi.end}:\n make <recipe>\n
|
||||||
INHERIT_SHELL ?=
|
TASKMK_SHELL ?=
|
||||||
|
PHONIFY ?=
|
||||||
```
|
```
|
||||||
|
|
||||||
To use a custom color for one of the predefined configuration variables specify only the custom method.
|
To use a custom color for one of the predefined configuration variables specify only the custom method.
|
||||||
|
|
@ -80,7 +119,7 @@ HEADER_STYLE = custom(fg=171,bg=227)
|
||||||
|
|
||||||
**NOTE**: `HELP_SEP` does not change the argument definitions syntax only the format of `make help`.
|
**NOTE**: `HELP_SEP` does not change the argument definitions syntax only the format of `make help`.
|
||||||
|
|
||||||
## Advanced Usage: Embedded Python Scripts
|
## Advanced Usage: Embedded Scripts
|
||||||
|
|
||||||
You can take advantage of the builtin python script runner and write multi-line python scripts of your own.
|
You can take advantage of the builtin python script runner and write multi-line python scripts of your own.
|
||||||
This is a simple example but a few lines of python in your `Makefile`
|
This is a simple example but a few lines of python in your `Makefile`
|
||||||
|
|
|
||||||
|
|
@ -3,18 +3,15 @@ site_url: https://gh.dayl.in/task.mk
|
||||||
repo_url: https://github.com/daylinmorgan/task.mk
|
repo_url: https://github.com/daylinmorgan/task.mk
|
||||||
edit_uri: edit/main/docs/
|
edit_uri: edit/main/docs/
|
||||||
repo_name: daylinmorgan/task.mk
|
repo_name: daylinmorgan/task.mk
|
||||||
|
|
||||||
theme:
|
theme:
|
||||||
name: material
|
name: material
|
||||||
custom_dir: docs/overrides
|
|
||||||
features:
|
features:
|
||||||
- navigation.indexes
|
- navigation.indexes
|
||||||
palette:
|
palette:
|
||||||
- scheme: default
|
- scheme: default
|
||||||
extra_css:
|
extra_css:
|
||||||
- stylesheets/extra.css
|
- stylesheets/extra.css
|
||||||
- stylesheets/asciinema-player.css
|
|
||||||
extra_javascript:
|
|
||||||
- javascripts/asciinema-player.min.js
|
|
||||||
plugins:
|
plugins:
|
||||||
- search
|
- search
|
||||||
- git-revision-date-localized:
|
- git-revision-date-localized:
|
||||||
|
|
|
||||||
|
|
@ -25,8 +25,7 @@ tprint = $(call py,print_py,$(1))
|
||||||
tprint-verbose= $(call py-verbose,print_py,$(1))
|
tprint-verbose= $(call py-verbose,print_py,$(1))
|
||||||
tconfirm = $(call py,confirm_py,$(1))
|
tconfirm = $(call py,confirm_py,$(1))
|
||||||
.PHONY: h help _help _print-ansi _update-task.mk
|
.PHONY: h help _help _print-ansi _update-task.mk
|
||||||
TASK_MAKEFILE_LIST := $(filter-out .task.cfg.mk .task.mk,$(MAKEFILE_LIST))
|
export MAKEFILE_LIST MAKE
|
||||||
export MAKEFILE_LIST MAKE TASK_MAKEFILE_LIST
|
|
||||||
ifdef PHONIFY
|
ifdef PHONIFY
|
||||||
$(shell MAKEFILE_LIST='$(MAKEFILE_LIST)' $(call py-verbose,phonify_py))
|
$(shell MAKEFILE_LIST='$(MAKEFILE_LIST)' $(call py-verbose,phonify_py))
|
||||||
endif
|
endif
|
||||||
|
|
|
||||||
|
|
@ -11,4 +11,4 @@ WRAP ?= 100
|
||||||
# python f-string literals
|
# python f-string literals
|
||||||
EPILOG ?=
|
EPILOG ?=
|
||||||
USAGE ?={ansi.header}usage{ansi.end}:\n make <recipe>\n
|
USAGE ?={ansi.header}usage{ansi.end}:\n make <recipe>\n
|
||||||
INHERIT_SHELL ?=
|
PHONIFY ?=
|
||||||
|
|
|
||||||
|
|
@ -2,6 +2,7 @@
|
||||||
#% block name %#help#% endblock %#
|
#% block name %#help#% endblock %#
|
||||||
#% block script %#
|
#% block script %#
|
||||||
from collections import namedtuple
|
from collections import namedtuple
|
||||||
|
from pathlib import Path
|
||||||
import subprocess
|
import subprocess
|
||||||
from textwrap import wrap
|
from textwrap import wrap
|
||||||
|
|
||||||
|
|
@ -39,11 +40,15 @@ def recipe_help_header(goal):
|
||||||
else:
|
else:
|
||||||
return f" {ansi.style(goal,'goal')}"
|
return f" {ansi.style(goal,'goal')}"
|
||||||
|
|
||||||
|
def get_makefile_list():
|
||||||
|
pattern = re.compile(r'^\.?task.*?\.mk$$') ###- make needs a double dollar -###
|
||||||
|
makefiles = os.getenv("MAKEFILE_LIST", "").split()
|
||||||
|
return (f for f in makefiles if not pattern.match(Path(f).name))
|
||||||
|
|
||||||
def get_goal_deps(goal="task.mk"):
|
def get_goal_deps(goal="task.mk"):
|
||||||
make = os.getenv("MAKE", "make")
|
make = os.getenv("MAKE", "make")
|
||||||
cmd = [make, "-p", "-n", "-i"]
|
cmd = [make, "-p", "-n", "-i"]
|
||||||
for file in os.getenv("TASK_MAKEFILE_LIST", "").split():
|
for file in get_makefile_list():
|
||||||
cmd.extend(["-f", file])
|
cmd.extend(["-f", file])
|
||||||
database = subprocess.check_output(cmd, universal_newlines=True)
|
database = subprocess.check_output(cmd, universal_newlines=True)
|
||||||
dep_pattern = re.compile(r"^" + goal + ":(.*)?")
|
dep_pattern = re.compile(r"^" + goal + ":(.*)?")
|
||||||
|
|
|
||||||
14
task.mk
14
task.mk
|
|
@ -1,7 +1,7 @@
|
||||||
# }> [github.com/daylinmorgan/task.mk] <{ #
|
# }> [github.com/daylinmorgan/task.mk] <{ #
|
||||||
# Copyright (c) 2022 Daylin Morgan
|
# Copyright (c) 2022 Daylin Morgan
|
||||||
# MIT License
|
# MIT License
|
||||||
TASKMK_VERSION ?= v23.1.1-12-gb0f7493-dev
|
TASKMK_VERSION ?= 23.1.2
|
||||||
# task.mk should be included at the bottom of your Makefile with `-include .task.mk`
|
# task.mk should be included at the bottom of your Makefile with `-include .task.mk`
|
||||||
# See below for the standard configuration options that should be set prior to including this file.
|
# See below for the standard configuration options that should be set prior to including this file.
|
||||||
# You can update your .task.mk with `make _update-task.mk`
|
# You can update your .task.mk with `make _update-task.mk`
|
||||||
|
|
@ -19,10 +19,11 @@ WRAP ?= 100
|
||||||
# python f-string literals
|
# python f-string literals
|
||||||
EPILOG ?=
|
EPILOG ?=
|
||||||
USAGE ?={ansi.header}usage{ansi.end}:\n make <recipe>\n
|
USAGE ?={ansi.header}usage{ansi.end}:\n make <recipe>\n
|
||||||
INHERIT_SHELL ?=
|
PHONIFY ?=
|
||||||
# ---- [python scripts] ---- #
|
# ---- [python scripts] ---- #
|
||||||
define help_py
|
define help_py
|
||||||
from collections import namedtuple
|
from collections import namedtuple
|
||||||
|
from pathlib import Path
|
||||||
import subprocess
|
import subprocess
|
||||||
from textwrap import wrap
|
from textwrap import wrap
|
||||||
$(utils_py)
|
$(utils_py)
|
||||||
|
|
@ -46,10 +47,14 @@ def recipe_help_header(goal):
|
||||||
)
|
)
|
||||||
else:
|
else:
|
||||||
return f" {ansi.style(goal,'goal')}"
|
return f" {ansi.style(goal,'goal')}"
|
||||||
|
def get_makefile_list():
|
||||||
|
pattern = re.compile(r'^\.?task.*?\.mk$$')
|
||||||
|
makefiles = os.getenv("MAKEFILE_LIST", "").split()
|
||||||
|
return (f for f in makefiles if not pattern.match(Path(f).name))
|
||||||
def get_goal_deps(goal="task.mk"):
|
def get_goal_deps(goal="task.mk"):
|
||||||
make = os.getenv("MAKE", "make")
|
make = os.getenv("MAKE", "make")
|
||||||
cmd = [make, "-p", "-n", "-i"]
|
cmd = [make, "-p", "-n", "-i"]
|
||||||
for file in os.getenv("TASK_MAKEFILE_LIST", "").split():
|
for file in get_makefile_list():
|
||||||
cmd.extend(["-f", file])
|
cmd.extend(["-f", file])
|
||||||
database = subprocess.check_output(cmd, universal_newlines=True)
|
database = subprocess.check_output(cmd, universal_newlines=True)
|
||||||
dep_pattern = re.compile(r"^" + goal + ":(.*)?")
|
dep_pattern = re.compile(r"^" + goal + ":(.*)?")
|
||||||
|
|
@ -450,8 +455,7 @@ tprint = $(call py,print_py,$(1))
|
||||||
tprint-verbose= $(call py-verbose,print_py,$(1))
|
tprint-verbose= $(call py-verbose,print_py,$(1))
|
||||||
tconfirm = $(call py,confirm_py,$(1))
|
tconfirm = $(call py,confirm_py,$(1))
|
||||||
.PHONY: h help _help _print-ansi _update-task.mk
|
.PHONY: h help _help _print-ansi _update-task.mk
|
||||||
TASK_MAKEFILE_LIST := $(filter-out .task.cfg.mk .task.mk,$(MAKEFILE_LIST))
|
export MAKEFILE_LIST MAKE
|
||||||
export MAKEFILE_LIST MAKE TASK_MAKEFILE_LIST
|
|
||||||
ifdef PHONIFY
|
ifdef PHONIFY
|
||||||
$(shell MAKEFILE_LIST='$(MAKEFILE_LIST)' $(call py-verbose,phonify_py))
|
$(shell MAKEFILE_LIST='$(MAKEFILE_LIST)' $(call py-verbose,phonify_py))
|
||||||
endif
|
endif
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue