init commit

README.md

@@ -0,0 +1,64 @@
+# oxpasta
+
+A minimal shell script for interacting with a [rustypaste](https://github.com/orhun/rustypaste) server
+
+## Brief
+
+As someone who needed quick access to only a handful of features, [rpaste](https://github.com/orhun/rustypaste-cli) was overkill. As such, this shell only provides shortcuts for 3 features: upload, oneshot (-o), and url shortening (-s).
+
+## Help
+
+``` zsh
+Usage: oxpasta [OPTION] FILE
+
+Options:
+  [none]             {file}   Upload a file
+  -o, --oneshot      {file}   Upload a file as a oneshot link
+  -s, --shorten-url  {url}    Shorten a given URL
+  -h, --help                  Display this help message
+
+Description:
+  minimal rustypaste cli script
+
+Requires:
+  export OXP_SERVER="https://example.com"
+
+Examples:
+  oxpasta /path/to/file
+    | Uploads the file located at /path/to/file
+  oxpasta -o /path/to/file
+    | Uploads the oneshot URL https://example.com
+  oxpasta -s https://example.com/long/url
+    | Shortens the URL to https://<server>/<some-text>
+```
+
+## Setup
+
+1. save `oxpasta.sh` file
+
+
+1. symlink `oxpasta`
+    ``` zsh
+    sudo ln -s /path/to/oxpasta.sh /usr/local/bin/oxpasta
+    ```
+
+1. set server url
+    ``` zsh
+    echo 'export OXP_SERVER="https://<rustypaste-server-url>"' >> ~/.bashrc
+    source ~/.bashrc
+    ```
+
+## Example
+
+``` zsh
+$ git clone https://github.com/rskntroot/oxpasta.git
+$ echo $PATH | grep -o '/usr/local/sbin'
+$ sudo ln -s /home/${USER}/workspace/oxpasta/oxpasta.sh /usr/local/bin/oxpasta
+$
+$ sha256sum oxpasta/oxpasta.sh > file && cat file
+8fb227774b7f24c22b1437303af7bcd222b4bd058563576102f87c351595deb0  workspace/oxpasta/oxpasta.sh
+$ oxpasta file
+https://paste.rskio.com/unsolicitous-fredricka.txt
+$ curl https://paste.rskio.com/unsolicitous-fredricka.txt
+8fb227774b7f24c22b1437303af7bcd222b4bd058563576102f87c351595deb0  workspace/oxpasta/oxpasta.sh
+```

oxpasta.sh

@@ -0,0 +1,116 @@
+#!/bin/sh
+
+# Exit codes
+EXIT_OK=0
+EXIT_GENERIC=1
+EXIT_ARG_MISSING=64
+EXIT_INVALID_OPTION=65
+EXIT_INVALID_URL=69
+EXIT_DEP_MISSING=71
+EXIT_FILE_ERROR=74
+EXIT_ENV_MISSING=78
+
+# Display help message
+show_help() {
+  cat <<EOF
+Usage: oxpasta [OPTION] FILE
+
+Options:
+  [none]             {file}   Upload a file
+  -o, --oneshot      {file}   Upload a file as a oneshot link
+  -s, --shorten-url  {url}    Shorten a given URL
+  -h, --help                  Display this help message
+
+Description:
+  minimal rustypaste cli script
+
+Requires:
+  export OXP_SERVER="https://example.com"
+
+Examples:
+  oxpasta /path/to/file
+    | Uploads the file located at /path/to/file
+  oxpasta -o /path/to/file
+    | Uploads the oneshot URL https://example.com
+  oxpasta -s https://example.com/long/url
+    | Shortens the URL to https://<server>/<some-text>
+EOF
+}
+
+# check for curl command
+
+if ! type curl >/dev/null 2>&1; then
+  echo "Error: 'curl' is not installed or not in PATH." >&2
+  show_help
+  exit ${EXIT_DEP_MISSING}
+fi
+
+# check for OXP_SERVER env var
+
+if [ -z "${OXP_SERVER}" ]; then
+  echo "Error: OXP_SERVER environment variable is not set." >&2
+  exit ${EXIT_ENV_MISSING}
+fi
+
+# functions
+
+oneshot_upload() {
+  file="$1"
+  if [ -z "${file}" ]; then
+      echo "Error: You must provide a file for --oneshot." >&2
+    exit ${EXIT_ARG_MISSING}
+  fi
+  curl -fsS -F "oneshot=@${file}" "${OXP_SERVER}"
+}
+
+shorten_url() {
+  long_url="$1"
+  if [ -z "${long_url}" ]; then
+    echo "Error: You must provide a URL for --shorten-url." >&2
+    exit ${EXIT_ARG_MISSING}
+  fi
+  if ! curl -fsS -I --location "${long_url}" >/dev/null 2>&1; then
+    echo "Error: URL appears to be invalid or not accessible." >&2
+    exit ${EXIT_INVALID_URL}
+  fi
+  curl -fsS -F "url=${long_url}" "${OXP_SERVER}"
+}
+
+file_upload() {
+  file="$1"
+  if [ -z "${file}" ]; then
+    echo "Error: No file provided for upload." >&2
+    exit ${EXIT_ARG_MISSING}
+  elif [ ! -f "${file}" ]; then
+    echo "Error: File '${file}' not found." >&2
+    exit ${EXIT_FILE_ERROR}
+  fi
+  curl -fsS -F "file=@${file}" "${OXP_SERVER}"
+}
+
+# argument dispatch
+
+case "$1" in
+  -h|--help)
+    show_help
+    ;;
+  -o|--oneshot)
+    shift
+    oneshot_upload "$1"
+    ;;
+  -s|--shorten-url)
+    shift
+    shorten_url "$1"
+    ;;
+  -*)
+    echo "Unknown option: $1" >&2
+    exit ${EXIT_INVALID_OPTION}
+    ;;
+  *)
+    file_upload "$1"
+    ;;
+esac
+
+exit ${EXIT_OK}
+
+#`lost`25my