bake/README

--- README

A tool to run embedded scripts.

Bootstrap with ./shake bake.l
then compile further with ./bake,
install by running ./install.sh

---

bake [-chln] [-s <n>] <FILENAME> [ARGS...]; version 20240928

Bake is a simple tool meant  to execute embedded shell commands within
any file.   It executes with /bin/sh  the command after a  "@BAKE " to
the end of the line (a UNIX newline: '\n') or to the first instance of
@STOP.

It expands some macros,
  @FILENAME @FILE @NAME - filename
  @SHORT                - filename without suffix (abc.x.txt \-> abc.x)
  @SHORT:N              - removes N suffixes, so (a.b.c 2 -> a)
  @ARGS                 - other arguments to the program
  @ARGS:N               - Provides the Nth argument, starting from 0
  @ARGS:N+              - All arguments at and after Nth
  @RECURS               - the full path name to the executable
  @LINE                 - line number at the selected @BAKE

All  macros  can be  exempted  by  prefixing  them with  a  backslash,
which'll be subtracted in the  expansion. commands may be spanned over
several lines with a leading backslash.

-h --help	| Help message
-n --dry-run	| don't execute or remove anything
-c --color	| disables color
-l --list	| lists available Bake blocks
-s --select <n>	| selects Nth Bake block
-x --expunge	| Removes the file specified in the expunge block

It roots the shell execution in the directory of the given file.

Licensed under the public domain.

--- Potential Issues

Whitespace interstring is pruned, which may lead to an issue where you may echo ' ' or require more than one space, please don't do this. If you absolutely need this remove the 'BEGIN PADDING;' statement from the <FOUND>{space} rule. You may also wish to solve the issue with adding a conditional to ' (excluding expunge) and " to wind and not observe the other rules via another group that matches the identity of <OVERLOOK>(.|\n){ ECHO; } & <OVERLOOK>('|"){ BEGIN FOUND; ECHO; }, modify other rules in <FOUND> accordingly.

---

Shake

Bake was inspired by the  Bash-based Shake utility (formerly eMake, he
liked my suggestion  for a name).  It is  included under authorization
of  its creator.   The  original version  of Shake  may  be found  at:
<http://bis64wqhh3louusbd45iyj76kmn4rzw5ysawyan5bkxwyzihj67c5lid.onion/anon/shake>

Bake  includes a  modified Shake,  both  after installation  and as  a
bootstrapper.  The modified version includes all features of Bake with
the  exceptions  of   multi-line  commands.   It  is   not  a  general
replacement for Bake.

Changelog

Bake was created on 2023/09/13, and complete as of 2024/03/02.

2024-09-27

Lex. As adviced  by the original creator, I learned  and implemented a
Bake with lex. It's fully featured, and has new stuff.