R4d is a text oriented macro prosessor aims to be an alternative to m4 macro processor.
R4d's foreach behaviour has changes, you can use previous logic by disable default features.
Because crates.io's readme is tied to version. There might be undocumented readme changes. Please use github for latest information.
Raw texts ```text $define(author=Simon Creek)
title : $title()
My name is $author() and I made r4d to make macros can be used within various forms of texts. This article was written in $date() $time().
$ifdef(test, This should be only printed when I'm testing not in release)$dnl()
This is some important table automatically formatted according to environment variable.
$regcsv(addr,$include(addr.csv))$dnl()
$static( queried, $query( SELECT id,firstname,address FROM addr where firstname = John ) )$dnl()
% Comments are disabled by default for better compatibility % TABLEFORM == github $table($env(TABLEFORM),$queried())
$wrap(40,$lipsum(15))
Evaluation : $prec($eval( $num(0.1second) + $num(0.2sekunde)),2) Evaluation : $evalk( 1 + 2 ) ``` Processed texts
title : R4d demo
My name is Simon Creek and I made r4d to make macros can be used within various forms of texts. This article was written in 2022-01-18 16:38:07.
This is some important table automatically formatted according to environment variable.
|id|first_name|address| |-|-|-| |1|John|111-2222| |2|John|222-3333|
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore.
Evaluation : 0.30 Evaluation : 1 + 2 = 3 ```
I recommend using cargo install until I prepare a proper CD
pipeline.
e.g.
```bash
cargo install r4d --features binary --locked
cargo install r4d --features binary,color --locked
cargo install r4d --features basic --locked
```
Binary ```
rad input_file.txt
printf '...text...' | rad -o out_file.txt ```
Library ```rust use rad::RadError; use rad::Processor;
let processor = Processor::new() .writetofile(Some(PathBuf::from("cache.txt")))?;
processor.fromfile(Path::new("input.txt"))?; processor.printresult()?; ```
From 2.0, following breaking changes have been applied.
R4d aims to be a modern alternative to m4 processor, which means
Setvar data races vulnerability is known issue at the time but for current state, it doesn't affect r4d since r4d doesn't utillize multi threading in processing. Every time,date call and env_set calls are sequential and doensn't overlap.