feat(base): add nmea2gpx converter

Add nmea2gpx helper that converts .log files to .gpx with gpsbabel and logs each conversion.

Update README function anchors and bump BASE_VERSION.

Author: rdavid

README.adoc

@@ -108,28 +108,29 @@ The public functions are, in alphabetical order:
 {url-base}#L503[`map_del`],
 {url-base}#L523[`map_get`],
 {url-base}#L545[`map_put`],
-{url-base}#L557[`pdf2jpg`],
-{url-base}#L562[`pdf2png`],
-{url-base}#L581[`prettytable`],
-{url-base}#L607[`prettyuptime`],
-{url-base}#L630[`realdir`],
-{url-base}#L639[`realpath`],
-{url-base}#L652[`semver`],
-{url-base}#L670[`should_continue`],
-{url-base}#L726[`timestamp`],
-{url-base}#L746[`tolog`],
-{url-base}#L752[`tologe`],
-{url-base}#L759[`tolower`],
-{url-base}#L777[`totsout`],
-{url-base}#L783[`tsout`],
-{url-base}#L791[`url_exists`],
-{url-base}#L815[`user_exists`],
-{url-base}#L831[`validate_cmd`],
-{url-base}#L838[`validate_var`],
-{url-base}#L845[`var_exists`],
-{url-base}#L879[`ver_ge`],
-{url-base}#L887[`vid2aud`],
-{url-base}#L901[`ytda`].
+{url-base}#L557[`nmea2gpx`],
+{url-base}#L573[`pdf2jpg`],
+{url-base}#L578[`pdf2png`],
+{url-base}#L597[`prettytable`],
+{url-base}#L623[`prettyuptime`],
+{url-base}#L646[`realdir`],
+{url-base}#L655[`realpath`],
+{url-base}#L668[`semver`],
+{url-base}#L686[`should_continue`],
+{url-base}#L742[`timestamp`],
+{url-base}#L762[`tolog`],
+{url-base}#L768[`tologe`],
+{url-base}#L775[`tolower`],
+{url-base}#L793[`totsout`],
+{url-base}#L799[`tsout`],
+{url-base}#L807[`url_exists`],
+{url-base}#L831[`user_exists`],
+{url-base}#L847[`validate_cmd`],
+{url-base}#L854[`validate_var`],
+{url-base}#L861[`var_exists`],
+{url-base}#L895[`ver_ge`],
+{url-base}#L903[`vid2aud`],
+{url-base}#L917[`ytda`].
 
 Global variables have the `BASE_` prefix and can be used by clients.
 Clients should place temporary files under `$BASE_WIP`.
@@ -204,7 +205,7 @@ eval "$(
 log I\'m using the shellbase.
 ----
 
-{url-base}#L581[`prettytable`] example:
+{url-base}#L597[`prettytable`] example:
 
 [,sh]
 ----

lib/base.sh

@@ -16,10 +16,10 @@
 # cmd_exists, cya, die, dng2jpg, echo, ellipsize, file_exists,
 # handle_pipefails, heic2jpg, gitlog, grbt, inside, isempty, isfunc, isnumber,
 # isreadable, isroot, issolid, iswritable, log, loge, logw, map_del, map_get,
-# map_put, pdf2jpg, pdf2png, prettytable, prettyuptime, realdir, realpath,
-# semver, should_continue, timestamp, tolog, tologe, tolower, totsout, tsout,
-# url_exists, user_exists, validate_cmd, validate_var, var_exists, ver_ge,
-# vid2aud, ytda.
+# map_put, nmea2gpx, pdf2jpg, pdf2png, prettytable, prettyuptime, realdir,
+# realpath, semver, should_continue, timestamp, tolog, tologe, tolower,
+# totsout, tsout, url_exists, user_exists, validate_cmd, validate_var,
+# var_exists, ver_ge, vid2aud, ytda.
 #
 # Global variables have BASE_ prefix and clients could use them. Clients should
 # place temporary files under $BASE_WIP. All functions started with base_
@@ -47,7 +47,7 @@ BASE_RC_CON_NO=14
 BASE_RC_CON_TO=13
 BASE_RC_DIE_NO=10
 BASE_SHOULD_CON=false
-BASE_VERSION=0.9.20260328
+BASE_VERSION=0.9.20260402
 
 # Removes any file besides mp3, m4a, flac in the current directory.
 # Removes empty directories.
@@ -553,6 +553,22 @@ map_put() {
 	printf %s "$val" >"$dir/$nme/$key"
 }
 
+# Converts all .log files in the current directory to .gpx files.
+nmea2gpx() {
+	local fle
+	cmd_exists gpsbabel || return $?
+	for fle in ./*.log; do
+		# Skip unmatched glob literals and broken paths.
+		[ -e "$fle" ] || [ -L "$fle" ] || continue
+		log "Converting $fle to ${fle%.log}.gpx."
+		gpsbabel \
+			--input nmea \
+			--file "$fle" \
+			--output gpx \
+			--outfile "${fle%.log}.gpx" || return $?
+	done
+}
+
 # Converts all PDF files in current directory to JPEG files.
 pdf2jpg() {
 	base_pdf2img -jpeg