#!/usr/bin/env bash
# Setup script for finngineering/apxutil on Linux, from https://gitmanual.com/finngineering/apxutil
# Read it before you run it: the commands come from the repo's own README and files.
# Run: bash setup.sh
set -eo pipefail
trap 'echo "Setup stopped at the step above. Steps and fixes: https://gitmanual.com/finngineering/apxutil" >&2' ERR
step() { printf '\n\033[1m==> %s\033[0m\n' "$1"; }
have() { command -v "$1" >/dev/null 2>&1; }
# Installers put programs here; make them usable right away.
export PATH="$HOME/.local/share/mise/shims:$HOME/.cargo/bin:$HOME/.local/bin:$HOME/.deno/bin:$HOME/.bun/bin:$PATH"
# nvm is a shell function, so load it into this script when it's installed.
export NVM_DIR="${NVM_DIR:-$HOME/.nvm}"
load_nvm() { [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"; }
have_nvm() { load_nvm >/dev/null 2>&1; type nvm >/dev/null 2>&1; }

step '1/3 Clone the repository'
[ -d 'apxutil' ] || git clone https://github.com/finngineering/apxutil.git
cd 'apxutil'

step '2/3 Install the required tools'
# Python 3
have python3 || sudo apt install -y python3 python3-pip

step '3/3 Follow the README: Usage'
# In the maintainers' order. Do the README instructions above first — they cover steps outside the terminal.
python apxutil.py -h
usage: apxutil.py [-h] [-f filaname-apx] [-F filaname-sta] [-e dir] [-E dir] [-a manifestpath] [-A manifestpath] [-d]
[-x] [-B] [-r]
Tool to manipulate Schneider Electric .sta and .apx files
options:
-h, --help            show this help message and exit
-f, --apxfile filaname-apx
.apx file to read or write
-F, --stafile filaname-sta
.sta file to read or write
-e, --extract-apx dir
extract contents of the Station.apx file
-E, --extract-sta dir
extract contents of the .sta file
-a, --assemble-apx manifestpath
create Station.apx file based on apx_manifest.ini
-A, --assemble-sta manifestpath
create a .sta file from files in sta_manifest.ini
-d, --decompress      decompress Station.apx sections that are compressed
-x, --hexdump         print hexdump of Station.apx with header information
-B, --include-apd     include Station.apd when creating .sta archive
-r, --restart-offsets
restart offsets at 0 for each section in hexdump print (useful for diffing)
python apxutil.py -F archive.sta -E extracted
python apxutil.py -f extracted/BinAppli/Station.apx -e contents -d
python apxutil.py -f extracted/BinAppli/Station.apx -a contents
python apxutil.py -F modified-archive.sta -A extracted
python apxutil.py -F modified-archive.sta -x

echo 'Set up finngineering/apxutil.'
echo 'Manual: https://gitmanual.com/finngineering/apxutil'