From: Steven Baltakatei Sandoval Date: Thu, 4 Jun 2020 02:06:35 +0000 (+0000) Subject: feature(user) Add legacy user scripts X-Git-Tag: 0.1.0~16^2 X-Git-Url: https://zdv2.bktei.com/gitweb/BK-2020-03.git/commitdiff_plain/1dc4ab4a4faa75f66279389b788a5939cf58ce43?ds=sidebyside;hp=0d22dfcdb7eab1975d56ed36967885707470c828 feature(user) Add legacy user scripts Add the following legacy user scripts: - `bkcc`: A Creative Commons HTML tag generator - `bkcryptomator`: A script to start Cryptomator from an arbitrarily set path. --- diff --git a/user/bkcc b/user/bkcc new file mode 100755 index 0000000..347baaf --- /dev/null +++ b/user/bkcc @@ -0,0 +1,384 @@ +#!/bin/bash + +# Date: 2020-02-08T22:21Z + +# Author: Steven Baltakatei Sandoval + +# License: This bash script, 'bkcc', is licensed under GPLv3 or +# later by Steven Baltakatei Sandoval: +# +# 'bkcc', a Creative Commons HTML tag generator. +# Copyright (C) 2020 Steven Baltakatei Sandoval (baltakatei.com) +# +# This program is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# A copy of the GNU General Public License may be found at +# . +# +# The structure of this script was modeled after the following +# Creative Commons license choosers: +# +# https://creativecommons.org/choose/ +# https://chooser-beta.creativecommons.org/ + +# Description: bkcc - A tool that creates a machine-readable (RDFa +# XML) Creative Commons license tag. The tag is generated using +# information prompted from the user and exported to stdout. + +# Usage: bkcc [ OPTIONS ] + + +#==DEFINITIONS== + +# regular expression for identifying valid URLs (source: http://regexlib.com/REDetails.aspx?regexp_id=1051 ) +regexURL="((http\://|https\://|ftp\://)|(www.))+(([a-zA-Z0-9\.-]+\.[a-zA-Z]{2,4})|([0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}))(/[a-zA-Z0-9%:/-_\?\.'~]*)?" + +# Define 'echoerr' function which outputs text to stderr + # Note: function copied from https://stackoverflow.com/a/2990533 +echoerr() { + echo "$@" 1>&2; +} + +promptAttribute() { + ###echoerr "Note: RECOMMENDED options promote \"Free Cultural Works\" as defined by creativecommons.org" + echoerr "=======================================================" + echoerr "Do you want to require attribution for your work? (y/n)" + echoerr " y) Yes, anyone using my work must give me appropriate credit (RECOMMENDED)." + echoerr " n) No, anyone can use my work even without attribution." + read m + case $m in + y | Y | yes | 1) OPTION_BY="true";; + n | N | no | 2) + echoerr "=======================================================" + echoerr "I hereby waive all copyright and related or neighboring rights together with all" + echoerr "associated claims and causes of action with respect to this work to the extent" + echoerr "possible under law according to" + echoerr "https://creativecommons.org/publicdomain/zero/1.0/ ." + echoerr "" + echoerr "I have read and understood the terms and intended legal effect of CC0, and" + echoerr "hereby voluntarily elect to apply it to this work (y/n):" + read m + case $m in + y | Y | yes | 1) OPTION_BY="false"; + echoerr "DEBUG: OPTION_BY set to $OPTION_BY" + return 1 + ;; + n | N | no | 2) echoerr "No license selected. Exiting."; exit 1;; + *) echoerr "Invalid CC0 release option. Exiting."; exit 1;; + esac ;; + *) echoerr "Invalid attribution requirement option. Exiting."; exit 1;; + esac +} + +promptCommercial() { + echoerr "=======================================================" + echoerr "Do you want to prohibit others commercial use of your work? (y/n)" + echoerr " y) Yes, others cannot use my work for commercial purposes." + echoerr " n) No, others can use my work for commercial purposes (RECOMMENDED)." + read m + case $m in + y | Y | yes | 1) OPTION_NC="true"; echoerr "DEBUG: OPTION_NC set to $OPTION_NC";; + n | N | no | 2) OPTION_NC="false"; echoerr "DEBUG: OPTION_NC set to $OPTION_NC";; + *) echoerr "Invalid commercial use permission option. Exiting."; exit 1;; + esac +} + +promptDerivatives() { + echoerr "=======================================================" + echoerr "Do you want to prohibit others from distributing your work if they remix, transform, or build upon it?" + echoerr " y) Yes, others can use and share my work only as is, without modifications." + echoerr " n) No, others may share modified versions of my work (RECOMMENDED)." + read m + case $m in + y | Y | yes | 1) OPTION_ND="true"; echoerr "DEBUG: OPTION_ND set to $OPTION_ND";; + n | N | no | 2) OPTION_ND="false"; echoerr "DEBUG: OPTION_ND set to $OPTION_ND";; + *) echoerr "Invalid derivative use permission option. Exiting."; exit 1;; + esac +} + +promptShareAlike() { + echoerr "=======================================================" + echoerr "Do you want to prohibit your work under other terms?" + echoerr " y) Yes, anyone who changes your work must share their contributions under the same license as the original. (RECOMMENDED)" + echoerr " n) No, anyone who changes your work can distribute their contributions under a different license." + read m + case $m in + y | Y | yes | 1) OPTION_SA="true"; echoerr "DEBUG: OPTION_SA set to $OPTION_SA";; + n | N | no | 2) OPTION_SA="false"; echoerr "DEBUG: OPTION_SA set to $OPTION_SA";; + *) echoerr "Invalid sharealike requirement option. Exiting."; exit 1;; + esac +} + +promptLicenseDetails() { + # Usage: promptLicenseDetails + # Description: Sets LICENSE_TYPE by questioning user. + + echoerr "DEBUG: Beginning promptLicenseDetails function." + + # Evaluate BY option. + # Ask if author wishes to be attributed. + promptAttribute # set OPTION_BY to true or false. + if [[ $OPTION_BY == "false" ]]; then + LICENSE_TYPE="CC 1.0" + echoerr "DEBUG: LICENSE_TYPE set to $LICENSE_TYPE" + return 1; + fi + + # Evaluate NC option. + # Ask if author permits commercial use of work. + promptCommercial # set OPTION_NC to true or false. + + # Evaluate ND option. + # Ask if author permits derivative use of work. + promptDerivatives # set OPTION_ND to true or false. + + # Evaluate SA option. + # Ask if author requires derivative works to also carry same license as work. + if [[ $OPTION_ND = "true" ]]; then + OPTION_SA="false" # An SA work cannot be made from an ND work. + else + promptShareAlike # set OPTION_SA to true or false. + fi + + # Check for CC BY + if [[ $OPTION_BY == "true" ]] && \ + [[ $OPTION_NC == "false" ]] && \ + [[ $OPTION_ND == "false" ]] && \ + [[ $OPTION_SA == "false" ]] + then + LICENSE_TYPE="CC BY 4.0" + return + fi + + # Check for CC BY-SA + if [[ $OPTION_BY == "true" ]] && \ + [[ $OPTION_NC == "false" ]] && \ + [[ $OPTION_ND == "false" ]] && \ + [[ $OPTION_SA == "true" ]] + then + LICENSE_TYPE="CC BY-SA 4.0" + return + fi + + # Check for CC BY-ND + if [[ $OPTION_BY == "true" ]] && \ + [[ $OPTION_NC == "false" ]] && \ + [[ $OPTION_ND == "true" ]] && \ + [[ $OPTION_SA == "false" ]] + then + LICENSE_TYPE="CC BY-ND 4.0" + return + fi + + # Check for CC BY-NC + if [[ $OPTION_BY == "true" ]] && \ + [[ $OPTION_NC == "true" ]] && \ + [[ $OPTION_ND == "false" ]] && \ + [[ $OPTION_SA == "false" ]] + then + LICENSE_TYPE="CC BY-NC 4.0" + return + fi + + # Check for CC BY-NC-SA + if [[ $OPTION_BY == "true" ]] && \ + [[ $OPTION_NC == "true" ]] && \ + [[ $OPTION_ND == "false" ]] && \ + [[ $OPTION_SA == "true" ]] + then + LICENSE_TYPE="CC BY-NC-SA 4.0" + return + fi + + # Check for CC BY-NC-ND + if [[ $OPTION_BY == "true" ]] && \ + [[ $OPTION_NC == "true" ]] && \ + [[ $OPTION_ND == "true" ]] && \ + [[ $OPTION_SA == "false" ]] + then + LICENSE_TYPE="CC BY-NC-ND 4.0" + return + fi + + # Error message if none of the above if statements returned out of function. + echoerr "ERROR: Invalid license specified or LICENSE_TYPE not set."; exit 1; + +} + +selectLicense() { + # Usage: selectLicense + # Description: Sets LICENSE_TYPE variable according to a set of user prompts. + + # Prompt license type + echoerr "Select license type:" + echoerr " 0) I don't know. Guide me." + echoerr " 1) CC0 1.0 \"CC0 1.0 Universal\"" + echoerr " 2) CC BY 4.0 \"Attribution 4.0 International\"" + echoerr " 3) CC BY-SA 4.0 \"Attribution-ShareAlike 4.0 International\"" + echoerr " 4) CC BY-ND 4.0 \"Attribution-NoDerivatives 4.0 International\"" + echoerr " 5) CC BY-NC 4.0 \"Attribution-NonCommercial 4.0 International\"" + echoerr " 6) CC BY-NC-SA 4.0 \"Attribution-NonCommercial-ShareAlike 4.0 International\"" + echoerr " 7) CC BY-NC-ND 4.0 \"Attribution-NonCommercial-NoDerivatives 4.0 International\"" + read n + case $n in + 0) promptLicenseDetails; return;; # Sets LICENSE_TYPE via many questions to user. + 1) LICENSE_TYPE="CC 1.0";; + 2) LICENSE_TYPE="CC BY 4.0";; + 3) LICENSE_TYPE="CC BY-SA 4.0";; + 4) LICENSE_TYPE="CC BY-ND 4.0";; + 5) LICENSE_TYPE="CC BY-NC 4.0";; + 6) LICENSE_TYPE="CC BY-NC-SA 4.0";; + 7) LICENSE_TYPE="CC BY-NC-ND 4.0";; + *) echoerr "Invalid option selected. Exiting."; exit 1;; + esac + +} + +#==MAIN PROGRAM== +selectLicense # Sets LICENSE_TYPE via simple prompt. + +# Display value of $LICENSE_TYPE +echoerr "=======================================================" +echoerr "$LICENSE_TYPE"" license selected." + +# Prompt metadata +echoerr "=======================================================" +echoerr "Specify metadata (leave blank if not needed):" +read -p " Title of work [title]:" workTitle +read -p " Attribute work to [author]:" workAuthor + +read -p " Attribute work to (ex: author's website) [URL]:" workAuthorURL +if [[ -n $workAuthorURL ]]; then + while [[ ! $workAuthorURL =~ $regexURL ]]; do + echoerr "WARNING: URL may contain error (ex: does not begin with \"https://\"." + echoerr " Preappend \"http://\" to URL? (y/n)" + read m + case $m in + y | Y | yes | 1) workAuthorURL="http://""$workAuthorURL" ;; + n | N | no | 2) read -p " Attribute work to (ex: author's website) [URL]:" workAuthorURL ;; + *) ;; + esac + done +fi + +read -p " Source work from which work was derived (leave blank if original work) [URL]:" workSourceURL +if [[ -n $workSourceURL ]]; then + while [[ ! $workSourceURL =~ $regexURL ]]; do + echoerr "WARNING: URL may contain error (ex: does not begin with \"https://\." + echoerr " Preappend \"http://\" to URL? (y/n)" + read m + case $m in + y | Y | yes | 1) workSourceURL="http://""$workSourceURL" ;; + n | N | no | 2) read -p " Source work from which work was derived (leave blank if original work) [URL]:" workSourceURL ;; + *);; + esac + done +fi + +read -p " Webpage where more additional permissions may be requested (OPTIONAL) [URL]:" morePermissionsURL +if [[ -n $morePermissionsURL ]]; then + while [[ ! $morePermissionsURL =~ $regexURL ]]; do + echoerr "WARNING: URL may contain error (ex: does not begin with \"https://\." + echoerr " Preappend \"http://\" to URL? (y/n)" + read m + case $m in + y | Y | yes | 1) morePermissionsURL="http://""$morePermissionsURL";; + n | N | no | 2) read -p " Webpage where more additional permissions may be requested (OPTIONAL) [URL]:" morePermissionsURL ;; + esac + done +fi + +#===CONSTRUCT RDFA TAG=== +#====RDFA:Handle workTitle, workAuthor, workAuthorURL==== +###echoerr "DEBUG: workTitle is --$workTitle--" +###echoerr "DEBUG: workAuthor is --$workAuthor--" +###echoerr "DEBUG: workAuthorURL is --$workAuthorURL--" +###echoerr "DEBUG: workSourceURL is --$workSourceURL--" +###echoerr "DEBUG: morePermissionsURL is --$morePermissionsURL--" +###echoerr "DEBUG: LICENSE_TYPE is --$LICENSE_TYPE--" + +# Exit early if critical parameters not provided +if [[ -z "$workTitle" ]] || \ + [[ ! -v LICENSE_TYPE ]]; +then + echoerr "ERROR: Problem with workTitle or LICENSE_TYPE." + exit 1; +fi + +# Add workTitle to OUTPUT variable +OUTPUT=$OUTPUT"$workTitle" + +# Add workAuthor and/or workAuthorURL to OUTPUT variable (if applicable) +if [[ -v workAuthor ]]; then + if [[ -v workAuthorURL ]]; then + # workAuthor set, workAuthorURL set + OUTPUT=$OUTPUT" by $workAuthor" + else + #workAuthor set, workAuthorURL not set + OUTPUT=$OUTPUT" by $workAuthor" + fi +fi + +#====RDFA:Handle LICENSE_TYPE==== +# Add selected license to OUTPUT variable + +# Add boilerplate +OUTPUT=$OUTPUT" is licensed under " + +# Add license text +case $LICENSE_TYPE in + "CC 1.0") + OUTPUT=$OUTPUT"CC0 1.0" + ;; + "CC BY 4.0") + OUTPUT=$OUTPUT"CC BY 4.0" + ;; + "CC BY-SA 4.0") + OUTPUT=$OUTPUT"CC BY-SA 4.0" + ;; + "CC BY-ND 4.0") + OUTPUT=$OUTPUT"CC BY-ND 4.0" + ;; + "CC BY-NC 4.0") + OUTPUT=$OUTPUT"CC BY-NC 4.0" + ;; + "CC BY-NC-SA 4.0") + OUTPUT=$OUTPUT"CC BY-NC-SA 4.0" + ;; + "CC BY-NC-ND 4.0") + OUTPUT=$OUTPUT"CC BY-NC-ND 4.0" + ;; + *) echoerr "Error."; exit 1;; +esac +# End sentence. +OUTPUT=$OUTPUT"." + + +#====RDFA:Handle workSourceURL, morePermissionsURL (if applicable)==== +# Add workSourceURL to OUTPUT (if applicable) +if [[ -n "$workSourceURL" ]]; then + OUTPUT=$OUTPUT"
$workTitle is based on a work at $workSourceURL" + # End sentence. + OUTPUT=$OUTPUT"." +fi + +# Add morePermissionsURL to OUTPUT (if applicable) +if [[ -n "$morePermissionsURL" ]]; then + OUTPUT=$OUTPUT"
Permissions beyond the scope of this license may be available at $morePermissionsURL" + #End sentence + OUTPUT=$OUTPUT"." +fi + + + +#====Deliver output==== +# Send OUTPUT to stdout. +echo $OUTPUT diff --git a/user/bkcryptomator b/user/bkcryptomator new file mode 100755 index 0000000..a8583be --- /dev/null +++ b/user/bkcryptomator @@ -0,0 +1 @@ +~/Desktop/cryptomator/cryptomator-1.4.15-x86_64.AppImage