Compare commits
No commits in common. "fa026b7edafd0ffb907ea7f7baf2b3a9619af04c" and "e59538a3bdcfd53ef3e84f346b94102281ec1891" have entirely different histories.
fa026b7eda
...
e59538a3bd
1
slides/makefiles/examples/.gitignore
vendored
1
slides/makefiles/examples/.gitignore
vendored
@ -1 +0,0 @@
|
|||||||
*
|
|
||||||
@ -1,8 +0,0 @@
|
|||||||
CHECKER = command -v
|
|
||||||
.PHONY: check
|
|
||||||
check:
|
|
||||||
$(CHECKER) fortune >/dev/null
|
|
||||||
$(CHECKER) cowsay >/dev/null
|
|
||||||
|
|
||||||
file: | check
|
|
||||||
fortune | cowsay > $@
|
|
||||||
@ -1,18 +0,0 @@
|
|||||||
IMAGES = $(wildcard jpgs/*)
|
|
||||||
COL = $(patsubst jpgs/%,collection/%,$(IMAGES))
|
|
||||||
|
|
||||||
.PHONY: help
|
|
||||||
help:
|
|
||||||
$(info try 'show' or 'output')
|
|
||||||
.PHONY: show
|
|
||||||
show:
|
|
||||||
$(info IMAGES is $(IMAGES))
|
|
||||||
$(info Col is $(COL))
|
|
||||||
|
|
||||||
.PHONY: output
|
|
||||||
output: $(COL)
|
|
||||||
|
|
||||||
collection/%.jpg: jpgs/%.jpg
|
|
||||||
mkdir -p $(@D)
|
|
||||||
cp $< $@
|
|
||||||
|
|
||||||
@ -1,15 +0,0 @@
|
|||||||
CP = ln -f
|
|
||||||
|
|
||||||
output: pngs/ldap.png
|
|
||||||
|
|
||||||
jpgs/ldap.jpg: ../../ldap/ldap.jpg
|
|
||||||
mkdir -p $(dir $@)
|
|
||||||
$(CP) $< $@
|
|
||||||
|
|
||||||
pngs/%.png: jpgs/%.jpg
|
|
||||||
mkdir -p $(dir $@)
|
|
||||||
$(info making $(@F) in $(@D))
|
|
||||||
magick $< $@
|
|
||||||
|
|
||||||
clean:
|
|
||||||
$(RM) -r pngs jpgs
|
|
||||||
@ -1,10 +0,0 @@
|
|||||||
include /etc/os-release
|
|
||||||
DAY != date +%d
|
|
||||||
MESSAGE != fortune -s
|
|
||||||
|
|
||||||
motd_$(DAY):
|
|
||||||
$(info Hello $(USER))
|
|
||||||
$(info Placing message:)
|
|
||||||
echo "Welcome to $(NAME)" > $@
|
|
||||||
echo $(MESSAGE) >> $@
|
|
||||||
|
|
||||||
@ -10,4 +10,149 @@ colortheme:
|
|||||||
- orchid
|
- orchid
|
||||||
---
|
---
|
||||||
|
|
||||||
(presentation in presentation.md)
|
# Intro
|
||||||
|
|
||||||
|
The fundamental problem:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git submodule update --init soundscape
|
||||||
|
cargo build --release
|
||||||
|
install -pm755 target/release/tap /usr/local/bin/
|
||||||
|
```
|
||||||
|
|
||||||
|
You can't type this after every test.
|
||||||
|
|
||||||
|
***
|
||||||
|
|
||||||
|
## First Solution
|
||||||
|
|
||||||
|
```bash
|
||||||
|
#!/bin/sh
|
||||||
|
git submodule update --init soundscape
|
||||||
|
cargo build --release
|
||||||
|
install -pm755 target/release/tap /usr/local/bin/
|
||||||
|
```
|
||||||
|
|
||||||
|
At this point, every test takes 10 minutes.
|
||||||
|
|
||||||
|
## Second Solution
|
||||||
|
|
||||||
|
```bash
|
||||||
|
#!/bin/sh
|
||||||
|
[ -f soundscape/.git ] || git submodule update --init soundscape
|
||||||
|
[ -f target/release/tap ] || cargo build --release
|
||||||
|
[ -f target/release/tap ] || \
|
||||||
|
install -pm755 target/release/tap /usr/local/bin/
|
||||||
|
```
|
||||||
|
|
||||||
|
***
|
||||||
|
|
||||||
|
# Makefile Solutions
|
||||||
|
|
||||||
|
- input, process, output.
|
||||||
|
- automatic idempotence
|
||||||
|
|
||||||
|
```bash
|
||||||
|
INSTALL_DIR = /usr/local/bin
|
||||||
|
|
||||||
|
soundscape/.git:
|
||||||
|
git submodule update --init soundscape
|
||||||
|
|
||||||
|
/usr/local/bin/tap: target/release/tap
|
||||||
|
install -pm755 target/release/tap $(INSTALL_DIR)
|
||||||
|
|
||||||
|
target/release/tap: src soundscape/.git
|
||||||
|
cargo build --release
|
||||||
|
```
|
||||||
|
|
||||||
|
***
|
||||||
|
|
||||||
|
# Basic
|
||||||
|
|
||||||
|
- *Gotcha*: directories
|
||||||
|
- This, that, and these
|
||||||
|
|
||||||
|
***
|
||||||
|
|
||||||
|
## Repetition, Repetition, Repetition
|
||||||
|
|
||||||
|
```make
|
||||||
|
.PHONY: output
|
||||||
|
output: release/index.html
|
||||||
|
|
||||||
|
release/: backups.zip
|
||||||
|
mkdir $@
|
||||||
|
|
||||||
|
release/index.html: index.html release/
|
||||||
|
cp $< $@
|
||||||
|
|
||||||
|
index.html: backups.zip
|
||||||
|
unzip $<
|
||||||
|
```
|
||||||
|
|
||||||
|
***
|
||||||
|
|
||||||
|
# Variables
|
||||||
|
|
||||||
|
- From your shell.
|
||||||
|
- New variables.
|
||||||
|
- Filenames as variables.
|
||||||
|
- *Gotcha*: no shell variables, only make!
|
||||||
|
|
||||||
|
## Equality
|
||||||
|
|
||||||
|
- Variables with '=', never ':='.
|
||||||
|
- *Gotcha*: one shell per line.
|
||||||
|
- Variables as shell output.
|
||||||
|
|
||||||
|
|
||||||
|
***
|
||||||
|
|
||||||
|
|
||||||
|
# Phonies, and the Problems with Lies
|
||||||
|
|
||||||
|
- clean (common)
|
||||||
|
- check (excellent)
|
||||||
|
|
||||||
|
***
|
||||||
|
|
||||||
|
|
||||||
|
## Non-Compiling Checks
|
||||||
|
|
||||||
|
- `make` -n
|
||||||
|
- *Gotcha*: shell output variables.
|
||||||
|
|
||||||
|
***
|
||||||
|
|
||||||
|
|
||||||
|
# The Fourth Sigil: `%`
|
||||||
|
|
||||||
|
- Standard rules, e.g. ImageMagick, copying, et c.
|
||||||
|
- *Gotcha*: intermediaries are deleted.
|
||||||
|
|
||||||
|
***
|
||||||
|
|
||||||
|
# Bling: make2graph
|
||||||
|
|
||||||
|
- *Gotcha*: completely outdated.
|
||||||
|
|
||||||
|
***
|
||||||
|
|
||||||
|
# Inclusivity
|
||||||
|
|
||||||
|
- `include dir/Makefile`
|
||||||
|
- *Gotcha*: directory has not changed
|
||||||
|
- `$(MAKEFILE_LIST)`
|
||||||
|
|
||||||
|
|
||||||
|
# Special Commands
|
||||||
|
|
||||||
|
- dir
|
||||||
|
- `DIR = test -d $(dir $@) || mkdir $(dir $@)`
|
||||||
|
- patsubst
|
||||||
|
- Wildcards (or not?)
|
||||||
|
|
||||||
|
# Maintanance
|
||||||
|
|
||||||
|
- backups
|
||||||
|
- saving files
|
||||||
|
|||||||
@ -1,314 +0,0 @@
|
|||||||
# Intro
|
|
||||||
|
|
||||||
The fundamental problem:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git submodule update --init soundscape
|
|
||||||
cargo build --release
|
|
||||||
install -pm755 target/release/tap /usr/local/bin/
|
|
||||||
```
|
|
||||||
|
|
||||||
*But you can't type this for run.*
|
|
||||||
|
|
||||||
***
|
|
||||||
|
|
||||||
## First Solution
|
|
||||||
|
|
||||||
```bash
|
|
||||||
#!/bin/sh
|
|
||||||
git submodule update --init soundscape
|
|
||||||
cargo build --release
|
|
||||||
install -pm755 target/release/tap /usr/local/bin/
|
|
||||||
```
|
|
||||||
|
|
||||||
At this point, every test takes 10 minutes.
|
|
||||||
|
|
||||||
## Second Solution
|
|
||||||
|
|
||||||
```bash
|
|
||||||
#!/bin/sh
|
|
||||||
[ -f soundscape/.git ] || git submodule update --init soundscape
|
|
||||||
[ -f target/release/tap ] || cargo build --release
|
|
||||||
[ -f target/release/tap ] || \
|
|
||||||
install -pm755 target/release/tap /usr/local/bin/
|
|
||||||
```
|
|
||||||
|
|
||||||
***
|
|
||||||
|
|
||||||
# Makefile Solutions
|
|
||||||
|
|
||||||
- input, process, output.
|
|
||||||
- automatic idempotence
|
|
||||||
|
|
||||||
```bash
|
|
||||||
INSTALL_DIR = /usr/local/bin
|
|
||||||
|
|
||||||
soundscape/.git:
|
|
||||||
git submodule update --init soundscape
|
|
||||||
|
|
||||||
/usr/local/bin/tap: target/release/tap
|
|
||||||
install -pm755 target/release/tap $(INSTALL_DIR)
|
|
||||||
|
|
||||||
target/release/tap: src soundscape/.git
|
|
||||||
cargo build --release
|
|
||||||
```
|
|
||||||
|
|
||||||
***
|
|
||||||
|
|
||||||
# The Three Sigils
|
|
||||||
|
|
||||||
Readable, but slow:
|
|
||||||
|
|
||||||
```make fort_1
|
|
||||||
forts/big_fort.txt: forts/short.txt forts/long.txt
|
|
||||||
cat forts/short.txt forts/long.txt > forts/big_fort.txt
|
|
||||||
|
|
||||||
forts/:
|
|
||||||
mkdir forts
|
|
||||||
|
|
||||||
forts/short.txt: forts/
|
|
||||||
fortune -s > forts/short.txt
|
|
||||||
|
|
||||||
forts/long.txt: forts/
|
|
||||||
fortune -l > forts/long.txt
|
|
||||||
```
|
|
||||||
|
|
||||||
***
|
|
||||||
|
|
||||||
| Make this | From That | From These |
|
|
||||||
|:---------:|:---------:|:----------:|
|
|
||||||
| `$@` | `$<` | `$^` |
|
|
||||||
|
|
||||||
|
|
||||||
```make fort_2
|
|
||||||
forts/big_fort.txt: forts/short.txt forts/long.txt
|
|
||||||
cat $^ > $@
|
|
||||||
|
|
||||||
forts/: README.md
|
|
||||||
mkdir $@
|
|
||||||
forts/short.txt: forts/
|
|
||||||
fortune -s > $@
|
|
||||||
forts/long.txt: forts/
|
|
||||||
fortune -l > $@
|
|
||||||
```
|
|
||||||
|
|
||||||
***
|
|
||||||
|
|
||||||
# Gotcha: Directories
|
|
||||||
|
|
||||||
|
|
||||||
```make fort_2
|
|
||||||
forts/big_fort.txt: forts/short.txt forts/long.txt
|
|
||||||
cat $^ > $@
|
|
||||||
|
|
||||||
forts/: README.md
|
|
||||||
mkdir $@
|
|
||||||
forts/short.txt: forts/
|
|
||||||
fortune -s > $@
|
|
||||||
forts/long.txt: forts/
|
|
||||||
fortune -l > $@
|
|
||||||
|
|
||||||
README.md:
|
|
||||||
echo "Find the fortunes in the fort dir" > $@
|
|
||||||
```
|
|
||||||
|
|
||||||
***
|
|
||||||
|
|
||||||
# Variables
|
|
||||||
|
|
||||||
```make vars
|
|
||||||
include /etc/os-release
|
|
||||||
DAY != date +%d
|
|
||||||
MESSAGE != fortune -s
|
|
||||||
|
|
||||||
motd_$(DAY):
|
|
||||||
$(info Placing message:)
|
|
||||||
echo "Welcome to $(NAME)" > $@
|
|
||||||
echo $(MESSAGE) >> $@
|
|
||||||
```
|
|
||||||
|
|
||||||
### Gotcha: Hanging Quotes
|
|
||||||
|
|
||||||
> echo "Welcome to "Arch Linux""
|
|
||||||
|
|
||||||
***
|
|
||||||
|
|
||||||
## Add New Variables
|
|
||||||
|
|
||||||
```make
|
|
||||||
make -f vars -e MESSAGE="Red alert, all hands on deck!"
|
|
||||||
```
|
|
||||||
|
|
||||||
### Gotcha: Quote, or Risk Escape
|
|
||||||
|
|
||||||
```make
|
|
||||||
make -f vars -e MESSAGE="<h1> HTML Headers </h1>"
|
|
||||||
```
|
|
||||||
|
|
||||||
***
|
|
||||||
|
|
||||||
# Gotcha: Variables from Shell
|
|
||||||
|
|
||||||
This works:
|
|
||||||
|
|
||||||
```make
|
|
||||||
file:
|
|
||||||
$(info Hello $(USER))
|
|
||||||
```
|
|
||||||
|
|
||||||
...but not this:
|
|
||||||
|
|
||||||
```make
|
|
||||||
file:
|
|
||||||
user=bob
|
|
||||||
echo $user
|
|
||||||
```
|
|
||||||
|
|
||||||
Nor this:
|
|
||||||
|
|
||||||
```make
|
|
||||||
numbers:
|
|
||||||
for x in 1 2 3 4 5; do
|
|
||||||
echo $x
|
|
||||||
done > $@
|
|
||||||
```
|
|
||||||
|
|
||||||
Nor this:
|
|
||||||
|
|
||||||
```make
|
|
||||||
numbers:
|
|
||||||
for x in 1 2 3 4 5; do echo $x ; done > $@
|
|
||||||
```
|
|
||||||
|
|
||||||
***
|
|
||||||
|
|
||||||
### Ugly Fixes are Ugly
|
|
||||||
|
|
||||||
This works, but don't.
|
|
||||||
|
|
||||||
```make
|
|
||||||
file:
|
|
||||||
for x in 1 2 ;\
|
|
||||||
do echo $$x ;\
|
|
||||||
done > $@
|
|
||||||
```
|
|
||||||
|
|
||||||
***
|
|
||||||
|
|
||||||
|
|
||||||
# Phonies, and the Problems with Lies
|
|
||||||
|
|
||||||
## Clean
|
|
||||||
|
|
||||||
|
|
||||||
```make
|
|
||||||
.PHONY: clean
|
|
||||||
clean:
|
|
||||||
git clean -fdX
|
|
||||||
```
|
|
||||||
|
|
||||||
## Gotcha: Recompiling without Changes
|
|
||||||
|
|
||||||
```make
|
|
||||||
CHECKER = command -v
|
|
||||||
.PHONY: check
|
|
||||||
check:
|
|
||||||
$(CHECKER) fortune >/dev/null
|
|
||||||
$(CHECKER) cowsay >/dev/null
|
|
||||||
|
|
||||||
file: check # Needs a '|'
|
|
||||||
fortune | cowsay > $@
|
|
||||||
```
|
|
||||||
|
|
||||||
***
|
|
||||||
|
|
||||||
|
|
||||||
## Non-Compiling Checks
|
|
||||||
|
|
||||||
- `make` -n
|
|
||||||
- *Gotcha*: shell output variables.
|
|
||||||
|
|
||||||
***
|
|
||||||
|
|
||||||
|
|
||||||
# The Fourth Sigil: `%`
|
|
||||||
|
|
||||||
Create standardized rules with `%`.
|
|
||||||
|
|
||||||
|
|
||||||
```make rules
|
|
||||||
CP = ln -f
|
|
||||||
|
|
||||||
output: pngs/ldap.png
|
|
||||||
|
|
||||||
jpgs/ldap.jpg: ../../ldap/ldap.jpg
|
|
||||||
mkdir -p $(dir $@)
|
|
||||||
$(CP) $< $@
|
|
||||||
|
|
||||||
pngs/%.png: jpgs/%.jpg
|
|
||||||
mkdir -p $(dir $@)
|
|
||||||
$(info making $(@F) in $(@D))
|
|
||||||
magick $< $@
|
|
||||||
```
|
|
||||||
|
|
||||||
***
|
|
||||||
|
|
||||||
# Bling: makefile2graph
|
|
||||||
|
|
||||||
```graph
|
|
||||||
|
|
||||||
┌────────────────┐ ┌────────────────────┐
|
|
||||||
│ forts/long.txt │ ◀── │ forts/ │
|
|
||||||
└────────────────┘ └────────────────────┘
|
|
||||||
│ │
|
|
||||||
│ │
|
|
||||||
│ ▼
|
|
||||||
│ ┌────────────────────┐
|
|
||||||
│ │ forts/short.txt │
|
|
||||||
│ └────────────────────┘
|
|
||||||
│ │
|
|
||||||
│ │
|
|
||||||
│ ▼
|
|
||||||
│ ┌────────────────────┐
|
|
||||||
└──────────────────▶ │ forts/big_fort.txt │
|
|
||||||
└────────────────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
### Gotcha: The Binary is Called `make2graph`
|
|
||||||
|
|
||||||
- Works with GUI tools maybe, IDK, I don't use Windows.
|
|
||||||
- Some systems can use `graph-easy`, but it's outdated.
|
|
||||||
|
|
||||||
***
|
|
||||||
|
|
||||||
# Patsubst and Wildcards
|
|
||||||
|
|
||||||
|
|
||||||
```make pats
|
|
||||||
IMAGES = $(wildcard jpgs/*)
|
|
||||||
COL = $(patsubst jpgs/%,collection/%,$(IMAGES))
|
|
||||||
|
|
||||||
.PHONY: show
|
|
||||||
show:
|
|
||||||
$(info IMAGES is $(IMAGES))
|
|
||||||
$(info Col is $(COL))
|
|
||||||
|
|
||||||
.PHONY: output
|
|
||||||
output: $(COL)
|
|
||||||
|
|
||||||
collection/%.jpg: jpgs/%.jpg
|
|
||||||
mkdir -p $(@D)
|
|
||||||
cp $< $@
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
***
|
|
||||||
|
|
||||||
# Use Cases
|
|
||||||
|
|
||||||
- Backups
|
|
||||||
- Making Websites
|
|
||||||
* `git clone https://gitlab.com/bindrpg/blag`
|
|
||||||
- `NOT installations`
|
|
||||||
- ...but maybe installations?
|
|
||||||
- Setting
|
|
||||||
Loading…
Reference in New Issue
Block a user