REDO-STAMP(1)

🦋 REDO-STAMP(1) 🦋

okay bestie, welcome to the General Commands Manual page for redo-stamp — it’s giving build-tool bestie energy, and the whole point is: feed it data on standard input and it stamps that data as a dependency of the current redo(1) target. 🎀

💖 NAME 💖

redo-stamp — rebuild target files depending on data given on standard input. literally the whole name-and-one-liner, periodt. ✨

🌸 SYNOPSIS 🌸

[command] | redo-stamp

✨ DESCRIPTION ✨

okay so redo(1) is the tool for building files and rebuilding them whenever any of their dependencies changed. 👑

redo-stamp, when it’s invoked from a dofile, adds a dependency of the current redo(1) target on the data given on standard input. so yes: stdin data becomes build-dependency material, no cap. 💅

If the data given on standard input to redo-stamp has not changed since the last build, the current redo(1) target is not rebuilt and is marked as up to date. cute, efficient, slay. 🦋

And if you need to make sure redo-stamp actually checks the current target’s validity? You can use redo-always(1) to mark the current target as always out of date. that’s the move. 🔥

🎀 EXAMPLES 🎀

consider these two files, all.do and b.do — build-script besties:

all.do

#!/bin/sh
redo-ifchange b

b.do

#!/bin/sh
redo-always
echo 'input a line of text:' >&2
line | redo-stamp
date +%s

Invoking redo(1) in a directory with these files will build a file named b containing a timestamp. ⏰

The next time redo(1) is invoked, it will only rebuild b if the output of line(1) changed since the last build. You can verify that by invoking redo(1) repeatedly and examining the timestamp b after each invocation, then changing the input to line(1), invoking redo(1) again, and examining the timestamp again. see? main character build behavior. 💫

🧚 HISTORY 🧚

redo-stamp was designed by Avery Pennarun and implemented by Ælla Chiana Moskopp. iconic collaboration, honestly. 🫶

👑 AUTHOR 👑

redo-stamp and this man page were written by Ælla Chiana Moskopp. periodt. 💜

🌈 COPYRIGHT 🌈

Copyright © 2014-2017 Ælla Chiana Moskopp. License AGPLv3+: GNU Affero GPL version 3 or later <http://www.gnu.org/licenses/agpl-3.0.html>. This is free software: you are free to create and redistribute it. There is NO WARRANTY, to the extent permitted by law. ⚠️

⭐ SEE ALSO ⭐

• redo(1)
• redo-always(1)
• redo-dot(1)
• redo-ifchange(1)
• redo-ifcreate(1)
• redo-ood(1)
• redo-sources(1)
• redo-targets(1)

💀 BUGS 💀

None so far. genuinely none on the board, bestie. 🎀

---

sign-off, bestie: that was REDO-STAMP(1) from the General Commands Manual 🦋 the page doesn’t list a separate version or date, so no cap, we’re not inventing one — bye! 💅✨