gen-examples.sh

# Converts the examples in the `examples` directory into documentation in the
# `examples` module (`src/examples/*.rs`)

set -euxo pipefail

main() {
    local examples=(
        hello
        itm
        leds
        blinky
        roulette
        serial
        serial-echo
        l3gd20
        lsm303dlhc
        log-sensors
        madgwick
    )

    rm -rf src/examples

    mkdir src/examples

    cat >src/examples/mod.rs <<'EOF'
//! Examples in order of increasing complexity
// Auto-generated. Do not modify.
EOF

    local i=0 out=
    for ex in ${examples[@]}; do
        name=_$(printf "%02d" $i)_${ex//-/_}
        out=src/examples/${name}.rs

        echo "pub mod $name;" >> src/examples/mod.rs

        grep '//!' examples/$ex.rs > $out
        echo '//!' >> $out
        echo '//! ```' >> $out
        grep -v '//!' examples/$ex.rs | (
            IFS=''

            while read line; do
                echo "//! $line" >> $out;
            done
        )
        echo '//! ```' >> $out
        echo '// Auto-generated. Do not modify.' >> $out


        chmod -x $out

        i=$(( i + 1 ))
    done

    chmod -x src/examples/mod.rs
}

main