resolve: add the flag --pass

the `--pass` flag *passes* the query through if the search fails.
passing the query through simply appends the query to the notes'
absolute path, then appends '.md' and outputs the resulting string
to standard output. the reason for this is wanting to edit a note
despite it not existing. this is a common workflow supported by many
editors, where the user is allowed to open nonexistent files until saved

Author: adam

.readme.md

@@ -0,0 +1,10 @@
+# goals, principles, thoughts
+
+1. the product must gets out of the way.
+2. navigation must be flat, no hierarchy of menus to follow; aids goal 1.
+3. the product doesn't require or expect prior configuration; aids goal 1.
+4. the source code is easily modifiable; solves flexibility issues that maybe imposed by goal 3.
+5. the source code is the configuration; induced from 3 and 4.
+6. variable names are wide, clear and promoted to the top; aids 5.
+7. modules are split on the basis of relevance; serves 5, and 2 in spirit.
+8. use existing solutions when it makes sense.

readme.md

@@ -1,7 +1,7 @@
 A set of simple bash scripts for finding, opening, creating and managing notes. The scripts are simple, they don't assume much. They are meant to be easily integrated into one's preferred environment.
 
 The following —and the source code— are the documentation:
-- `resolve` Takes two arguments: 1) a search query and 2) the directory containing the notes; `resolve` outputs the location of a note matching the query.
+- `resolve` Takes three positional arguments: 1) an optional flag (`-p` or `--pass`), 2) a search query and 3) the directory containing the notes; `resolve` outputs the absolute location of the note matching the query. if the `--pass` flag is present and no notes are found, the search query is appended to the notes' location then passed to stdout. the purpose of this is being able to resolve nonexitent files.
 - `edit`: Takes two arguments: 1) an editor command and 2) the file path for a note. It inserts the file name at the top of the note before opening it. If the line changes, it renames the file accordingly. This allows the note's name to serve as the title. this streamlines editing
 - `select_with_*` are scripts starting with `select_with_`. They allow selecting a note in various ways, using different menu programs, runners, launchers, etc.. The output is a file path to the selected note
 - `select_random` outputs a random note given a notes directory

resolve

@@ -4,29 +4,41 @@
 # Finding the target of a link is no more than finding the match of an exact
 # search by file name. If no matches are found, the script fails
 # The script takes a search query, a location to search within
+# and optional flag
 
 set -eu
 
+flag_pass_is_present=0;
+
+if [[ "$1" == "-p" ]] || [[ "$1" == "--pass" ]];
+then
+  flag_pass_is_present=1;
+  shift;
+fi
+
 if (($# != 2)); then
-  echo "Usage: $0 <search query> <notes directory>"
+  echo "Usage: $0 [-p|--pass] <search query> <notes directory>"
   echo "Example: $0 'Foundations of Mathematics' ~/notes"
   exit 1
 fi
 
-SEARCH_QUERY="$1"
-NOTES_PATH="$(realpath "$2")"
+search_query="$1"
+notes_path="$(realpath "$2")"
 
 FIND_COMMAND=(
   fd
-  --search-path "$NOTES_PATH"
+  --search-path "$notes_path"
   --type file
-  --and "$SEARCH_QUERY.md"
+  --and "$search_query.md"
 )
 
 search_result="$("${FIND_COMMAND[@]}" | head -1)"
 
-if [[ -z "$search_result" ]]; then
-  exit 1
-else
+if [[ -n "$search_result" ]]; then
   printf '%s' "$search_result"
+elif [[ $flag_pass_is_present == 1 ]]; then
+  printf '%s/%s.md' "$notes_path" "$search_query"
+else
+  echo "No results found" >&2
+  exit 1
 fi

select_random.sh renamed to select_random

@@ -19,7 +19,6 @@ FIND_COMMAND_ZERO_TERMINATED=(fd
   --glob '*.md'
   --print0)
 
-echo "$NOTES_DIRECTORY"
 declare -a search_results
 readarray -d '' search_results < <("${FIND_COMMAND_ZERO_TERMINATED[@]}")