bashup 1.1.0

A (toy) language that compiles to bash.

A (toy) language that compiles to bash.

Just a spoonful of sugar makes the bashisms go down…

#/bin/bash

@fn hi greeting='Hello', target {
    echo "${greeting}, ${target}!"
}

hi --target 'World'

Installation:

$ pip install bashup

Compile and run the above example:

$ bashup -i above_example.bashup -o above_example.sh
$ bash above_example.sh
Hello, World!

Compiled code (above_example.sh):

#/bin/bash

#
# usage: hi [--greeting <GREETING>] --target <TARGET> [ARGS]
#
function hi() {
    local greeting='Hello'
    local target
    local target__set=0
    local args=()
    local i

    for ((i = 1; i < $#; i++)); do
        if [ "${!i}" == "--greeting" ]; then
            ((i++))
            greeting=${!i}
        elif [ "${!i}" == "--target" ]; then
            ((i++))
            target=${!i}
            target__set=1
        else
            args+=("${!i}")
        fi
    done

    if [ ${target__set} -eq 0 ]; then
        echo "[ERROR] The --target parameter must be given."
        return 1
    fi

    __hi "${greeting}" "${target}" "${args[@]}"
}

function __hi() {
    local greeting=${1}
    local target=${2}
    shift 2

    echo "${greeting}, ${target}!"
}

hi --target 'World'

Supported Bash Versions

The generated bash code works with bash 3.1 and above (tested against 3.1 to 4.3).

Nifty Features

Bashup tries its best to match the indentation of its compiled code against your hand-written bash. For example:

@fn hi greeting='Hello', target {
  echo "${greeting}, ${target}!"
}

…compiles to:

#
# usage: hi [--greeting <GREETING>] --target <TARGET> [ARGS]
#
function hi() {
  local greeting='Hello'
  local target
  local target__set=0
  local args=()
  local i

  for ((i = 1; i < $#; i++)); do
    if [ "${!i}" == "--greeting" ]; then
      ((i++))
      greeting=${!i}
      ...

Changelog

1.1.0

• Fixed - Issue #2: “Run generated bash code against multiple versions of bash.”

• Feature - Issue #3: “Allow running of bashup scripts directly.”

• Fixed - Issue #4: “Last positional parameter to @fn may not be passed to generated function.”

1.0.0

• Initial release, supports @fn syntax.