3 # bash-notes © 2023 by danix is licensed under CC BY-NC 4.0.
4 # To view a copy of this license, visit http://creativecommons.org/licenses/by-nc/4.0/
6 # to debug the script run it like:
7 # DEBUG=true notes.sh ...
8 # and check /tmp/debug_bash-notes.log
9 if [[ $DEBUG == true
]]; then
10 exec 5> /tmp
/debug_bash-notes.log
17 BASENAME
=$
( basename "$0" )
21 DBVERSION
=${VERSION}_
${NOW}
26 EDITOR
=${EDITOR:-/usr/bin/vim}
27 TERMINAL
=${TERMINAL:-/usr/bin/alacritty}
28 # add options for your terminal. Remember to add the last option to execute
29 # your editor program, otherwise the script will fail.
30 # see example in the addnote function
31 TERM_OPTS
="--class notes --title notes -e "
32 # Setting PAGER here overrides whatever is set in your default shell
33 # comment this option to use your default pager if set in your shell.
34 PAGER
=${PAGER:-/usr/bin/more}
36 # set this to true to have output in plain text
37 # or use the -p option on the command line before every other option
39 # base directory for program files
40 BASEDIR
=${BASEDIR:-~/.local/share/bash-notes}
41 # notes database in json format
43 # directory containing the actual notes
44 NOTESDIR
=${BASEDIR}/notes
46 } # end set_defaults, do not change this line.
50 # Do not edit below this point
51 RCFILE
=${RCFILE:-~/.config/bash-notes.rc}
54 if [ ! -x "$JQ" ]; then
55 echo "jq not found in your PATH"
56 echo "install jq to continue"
60 # IMPORT USER DEFINED OPTIONS IF ANY
61 if [[ -f $RCFILE ]]; then
62 # shellcheck disable=SC1090
66 # We prevent the program from running more than one instance:
67 PIDFILE
=/var
/tmp
/$
(basename "$0" .sh
).pid
69 # Make sure the PID file is removed when we kill the process
70 trap 'rm -f $PIDFILE; exit 1' TERM INT
72 if [[ -r $PIDFILE ]]; then
73 # PIDFILE exists, so I guess there's already an instance running
74 # let's kill it and run again
75 # shellcheck disable=SC2046,SC2086
76 kill -s 15 $
(cat $PIDFILE) > /dev
/null
2>&1
77 # should already be deleted by trap, but just to be sure
82 echo $PID > "$PIDFILE"
84 # Export config to file
85 function export_config
() {
86 if [ -r ${RCFILE} ]; then
87 echo "Backing up current '${RCFILE}'...."
88 mv -f ${RCFILE} ${RCFILE}.$
(date +%Y
%m
%d_
%H
%M
)
90 echo "Writing '${RCFILE}'...."
91 sed -n '/^set_defaults() {/,/^} # end set_defaults, do not change this line./p' $0 \
92 |
grep -v set_defaults \
93 |
sed -e 's/^\([^=]*\)=\${\1:-\([^}]*\)}/\1=\2/' \
95 if [ -r ${RCFILE} ]; then
96 echo "Taking no further action."
99 echo "Could not write '${RCFILE}'...!"
104 # we should expand on this function to add a sample note and explain a little bit
105 # how the program works.
106 function firstrun
() {
107 [ -f $RCFILE ] && RC
=$RCFILE || RC
="none"
110 echo "${BASENAME} configuration:
112 base directory: ${BASEDIR}/
113 notes archive: ${NOTESDIR}/
114 notes database: ${DB}
116 text editor: ${EDITOR}
117 terminal: ${TERMINAL}
121 echo "Now I'll create the needed files and directories."
122 read -r -p "Do you wish to continue? (y/N) " ANSWER
126 cat << __EOL__ > ${DB}
129 "version": "${VERSION}",
130 "dbversion": "${DBVERSION}"
135 echo; echo "All done, you can now write your first note."
138 echo "No changes made. Exiting"
144 # check for notes dir existance and create it in case it doesn't exists
145 if [[ ! -d $NOTESDIR ]]; then
146 # we don't have a directory. FIRST RUN?
149 # check if input is a number, returns false or the number itself
150 function check_noteID
() {
162 function helptext
() {
164 echo " $0 [PARAMS] ..."
166 echo "${BASENAME} parameters are:"
167 echo -e " -h | --help\t\t\t: This help text"
168 echo -e " -p | --plain\t\t\t: Output is in plain text"
169 echo -e "\t\t\t\t (without this option the output is formatted)"
170 echo -e "\t\t\t\t (this option must precede all others)"
171 echo -e " -l | --list\t\t\t: List existing notes"
172 echo -e " -a | --add=[\"<title>\"]\t: Add new note"
173 echo -e " -e | --edit=[<note>]\t\t: Edit note"
174 echo -e " -d | --delete=[<note> | all] : Delete single note or all notes at once"
175 echo -e " -s | --show=[<note>]\t\t: Display note using your favourite PAGER"
176 echo -e " -r | --restore=[<dir>]\t: Restore a previous backup from dir"
177 echo -e " -v | --version\t\t: Print version"
178 echo -e " --userconf\t\t\t: Export User config file"
179 echo -e " --backup [<dest>]\t\t: Backup your data in your destination folder"
183 function configtext
() {
185 ${BASENAME} configuration is:
187 base directory: ${BASEDIR}/
188 notes archive: ${NOTESDIR}/
189 notes database: ${DB}
191 debug file: /tmp/debug_bash-note.log
193 text editor: ${EDITOR}
194 terminal: ${TERMINAL}
202 # remove eventually existing temp DB file
203 if [[ -f $TMPDB ]]; then
208 echo "adding new note - \"$NOTETITLE\""
209 # shellcheck disable=SC2086
210 LASTID
=$
($JQ '.notes[-1].id // 0 | tonumber' $DB)
211 # [ "" == $LASTID ] && LASTID=0
212 NOTEID
=$
(( LASTID
+ 1 ))
213 # shellcheck disable=SC2086
214 touch ${NOTESDIR}/${NOW}
215 # shellcheck disable=SC2016
216 $JQ --arg i
"$NOTEID" --arg t
"$NOTETITLE" --arg f
"$NOW" '.notes += [{"id": $i, "title": $t, "file": $f}]' "$DB" > $TMPDB
217 # shellcheck disable=SC2086
219 # example for alacritty:
220 # alacritty --class notes --title notes -e /usr/bin/vim ...
221 # shellcheck disable=SC2086,SC2091
222 $
(${TERMINAL} ${TERM_OPTS} ${EDITOR} ${NOTESDIR}/${NOW})
224 function backup_data
() {
226 echo "backing up data in $BACKUPDIR"
229 if [ -d $BACKUPDIR ]; then
230 if [ $
(/bin
/ls -A $BACKUPDIR) ]; then
231 echo "$BACKUPDIR is not empty. Cannot continue"
234 echo "$BACKUPDIR is ok. Continuing!"
237 # BACKUPDIR doesn't exists
238 echo "$BACKUPDIR doesn't exists"
239 read -r -p "Do you want me to create it for you? (y/N) " ANSWER
245 echo "No changes made. Exiting"
250 # ok, we have a backup directory
251 if [ -r $RCFILE ]; then
252 BCKUP_COMM
=$
(rsync
-avz --progress ${RCFILE}* ${BASEDIR}/* ${BACKUPDIR})
254 BCKUP_COMM
=$
(rsync
-avz --progress ${BASEDIR}/* ${BACKUPDIR})
257 if [ "$BCKUP_COMM" ]; then
258 echo -e "All files backed up."
259 echo -e "BACKUP directory:\t$BACKUPDIR"
260 tree
$BACKUPDIR |
$PAGER
261 echo; echo "BACKUP COMPLETED"
265 function backup_restore
() {
267 echo "restoring backup from $BACKUPDIR"
268 echo "This will overwrite all your notes and configurations with the backup."
269 read -r -p "Do you want to continue? (y/N) " ANSWER
273 BACKUPRC
=$
(basename $RCFILE)
274 if [ -r ${BACKUPDIR}/${BACKUPRC} ]; then
275 if [ -r ${RCFILE} ]; then
276 echo "Backing up current '${RCFILE}'...."
277 mv -f ${RCFILE} ${RCFILE}.$
(date +%Y
%m
%d_
%H
%M
)
279 cp --verbose ${BACKUPDIR}/${BACKUPRC} $RCFILE
281 # restoring notes directory
282 if [ -d $BACKUPDIR/notes
]; then
283 if [ $
(/bin
/ls -A $NOTESDIR) ]; then
284 rm --verbose $NOTESDIR/*
286 cp -r --verbose $BACKUPDIR/notes
$BASEDIR
289 BACKUPDB
=$
(basename $DB)
290 if [ -f ${BACKUPDIR}/${BACKUPDB} ]; then
291 if [ -r ${DB} ]; then
292 echo "Backing up current '${DB}'...."
293 mv -f ${DB} ${DB}.$
(date +%Y
%m
%d_
%H
%M
)
295 cp --verbose ${BACKUPDIR}/${BACKUPDB} $DB
299 echo "No changes made. Exiting"
305 function editnote
() {
307 # shellcheck disable=SC2155
308 local OK
=$
(check_noteID
"$NOTE")
310 echo "invalid note \"$NOTE\""
311 echo "Use the note ID that you can fetch after listing your notes"
315 # shellcheck disable=SC2016,SC2086
316 TITLE
=$
($JQ --arg i
$OK '.notes[] | select(.id == $i) | .title' $DB)
317 # shellcheck disable=SC2016,SC2086
318 FILE
=$
($JQ -r --arg i
$OK '.notes[] | select(.id == $i) | .file' $DB)
319 if [ "$TITLE" ]; then
320 echo "editing note $TITLE"
321 # shellcheck disable=SC2086,SC2091
322 $
(${TERMINAL} ${TERM_OPTS} ${EDITOR} ${NOTESDIR}/${FILE})
324 echo "note not found"
328 function listnotes
() {
329 # [ $PLAIN == true ] && echo "output is plain text" || echo "output is colored"
330 if [[ $
(ls -A "$NOTESDIR") ]]; then
331 if [ $PLAIN == false
]; then
332 echo "listing all notes"
335 [ $PLAIN == false
] && echo "[ID] [TITLE] [CREATED]"
336 for i
in "${NOTESDIR}"/*; do
337 # shellcheck disable=SC2155
338 local fname
=$
(basename $i)
339 DATE
=$
(date -d @
${fname} +"%d/%m/%Y %R %z%Z")
340 # shellcheck disable=SC2016,SC2086
341 TITLE
=$
($JQ -r --arg z $
(basename $i) '.notes[] | select(.file == $z) | .title' $DB)
342 # shellcheck disable=SC2016,SC2086
343 ID
=$
($JQ -r --arg z $
(basename $i) '.notes[] | select(.file == $z) | .id' $DB)
344 [ $PLAIN == false
] && echo "[${ID}] ${TITLE} ${DATE}" || echo "${ID} - ${TITLE} - ${DATE}"
347 echo "no notes yet. You can add your first one with: ${BASENAME} -a \"your note title\""
351 # remove eventually existing temp DB file
352 if [[ -f $TMPDB ]]; then
357 if [ "all" == "$NOTE" ]; then
358 echo "You're going to delete all notes."
359 read -r -p "Do you wish to continue? (y/N) " ANSWER
362 # shellcheck disable=SC2086
363 $JQ 'del(.notes[])' $DB > $TMPDB
364 # shellcheck disable=SC2086
366 # shellcheck disable=SC2086
368 echo "Deleted all notes"
371 echo "Aborting, no notes were deleted."
376 # shellcheck disable=SC2155
377 local OK
=$
(check_noteID
"$NOTE")
379 echo "invalid note \"$NOTE\""
380 echo "Use the note ID that you can fetch after listing your notes"
384 # shellcheck disable=SC2016,SC2086
385 TITLE
=$
($JQ --arg i
$OK '.notes[] | select(.id == $i) | .title' $DB)
386 # shellcheck disable=SC2016,SC2086
387 FILE
=$
($JQ -r --arg i
$OK '.notes[] | select(.id == $i) | .file' $DB)
388 if [ "$TITLE" ]; then
389 # shellcheck disable=SC2016,SC2086
390 $JQ -r --arg i
$OK 'del(.notes[] | select(.id == $i))' $DB > $TMPDB
391 # shellcheck disable=SC2086
394 echo "Deleted note $TITLE"
396 echo "note not found"
401 function shownote
() {
404 # shellcheck disable=SC2155
405 local OK
=$
(check_noteID
"$NOTE")
407 echo "invalid note \"$NOTE\""
408 echo "Use the note ID that you can fetch after listing your notes"
412 FILE
=$
($JQ -r --arg i
$OK '.notes[] | select(.id == $i) | .file' $DB)
415 $PAGER ${NOTESDIR}/${FILE}
418 # shellcheck disable=SC2006
419 GOPT
=$
(getopt
-o hvplr
::a
::e
::d
::s
:: --long help,version
,list
,plain
,userconf
,restore
::,backup
::,add
::,edit
::,delete
::,show
:: -n 'bash-notes' -- "$@")
421 # shellcheck disable=SC2181
422 if [ $?
!= 0 ] ; then helptext
>&2 ; exit 1 ; fi
424 # Note the quotes around `$GOPT': they are essential!
435 echo $BASENAME v
${VERSION}
449 read -r -p "Title: " TITLE
462 read -r -p "Note ID: " NOTE
475 read -r -p "Note ID: " NOTE
488 read -r -p "Note ID: " NOTE
501 read -r -p "Backup Dir: " RDIR
513 # shellcheck disable=SC2317
514 echo "config exported to \"$RCFILE\""
515 # shellcheck disable=SC2317
521 read -r -p "Backup Dir: " BDIR