convert_api.sh

#!/bin/bash

API_RST=./api.rst
API_MD_DIR=.

function usage {
  echo "usage: convert_api.sh [-a /path/to/api.rst] [-p /path/to/api.md/directory]"
  echo "       If -a is omitted, assume './api.rst'"
  echo "       If -p is omitted, assume './'"
}

while getopts ":a:p:" opt; do
  case ${opt} in
    a )
      API_RST=$OPTARG
      ;;
    p )
      API_MD_DIR=$OPTARG
      ;;
    \? )
      usage
      exit
      ;;
    : )
      echo "Invalid option: $OPTARG requires an argument" 1>&2
      usage
      exit 1
      ;;
  esac
done

if [[ ! -r $API_RST ]] ; then
  echo "$API_RST is not readable."
  exit 2
fi

if [[ ! -r $API_MD_DIR/api.md ]] ; then
  echo "$API_MD_DIR doesn't contain api.md"
  exit 3
fi


(
  set -x
  cd $API_MD_DIR
  printf "Title: API | MAAS\ntable_of_contents: True\n\n" > api.md; cat $API_RST | sed -n '/========/,$p' | sed -E '/\.\. raw:: html|^::/!s/:/:\n / 2' | sed '/^::/!s/^:\([a-z0-9 _{}]*\):/MDSTARTDEF\1MDENDDEF/g' | sed 's/_{/MDCURLYFIX/g' | pandoc --from=rst --to=markdown+backtick_code_blocks+pipe_tables+definition_lists+compact_definition_lists --column=78 --atx-headers | sed 's/MDSTARTDEF/- `/1' | sed 's/MDENDDEF/`:/g' | sed 's/MDCURLYFIX/_{/g'| sed 's/: / /g'| sed 's/\\_/_/g'| sed 's/#### /##### /g'| sed 's/^ / /g'  | sed 's/\[Power types\]()/[Power types](#power-types)/' | sed 's/------------------------------------------------------------------------------/\ /g' >> api.md
  set +x
  echo "Conversion completed. See $API_MD_DIR/api.md."
)