From 9cce861b2ef60cbbccf7c687dd69ec3dc2344417 Mon Sep 17 00:00:00 2001
From: brent saner <brent.saner@gmail.com>
Date: Wed, 28 Jan 2026 09:16:18 -0500
Subject: [PATCH] v1.16.1

FIXED:
* *Some* documentation weirdness on pkg.go dev rendering. It still uses
  the Markdown render by default, and it seems if you use anchor links
  in a bulletpoint list, pandoc just says "lol screw you"...

ADDED:
* tplx/sprigx tpl function `osHostname`
---
 tplx/sprigx/README.adoc     | 182 ++++++++++++++++++++----------------
 tplx/sprigx/funcs_tpl_os.go |  13 +++
 2 files changed, 116 insertions(+), 79 deletions(-)
 create mode 100644 tplx/sprigx/funcs_tpl_os.go

diff --git a/tplx/sprigx/README.adoc b/tplx/sprigx/README.adoc
index 9b2f63b..7d42724 100644
--- a/tplx/sprigx/README.adoc
+++ b/tplx/sprigx/README.adoc
@@ -21,11 +21,22 @@ SprigX are extensions to https://masterminds.github.io/sprig/[the `sprig` librar
 
 They provide functions that offer more enriched use cases and domain-specific data.
 
+[TIP]
+====
+If you are reading this README on the Go Module Directory documentation (https://pkg.go.dev/r00t2.io/goutils/tplx/sprigx)
+or the directory landing page (https://git.r00t2.io/r00t2/go_goutils/src/branch/master/tplx/sprigx), it may not render correctly.
+
+Be sure to view it at properly via https://git.r00t2.io/r00t2/go_goutils/src/branch/master/tplx/sprigx/README.adoc[the AsciiDoc rendering^]
+or by downloading and viewing the https://git.r00t2.io/r00t2/go_goutils/raw/branch/master/tplx/sprigx/README.html[HTML version^].
+====
+
 [id="use"]
 == How do I Use SprigX?
 
+The same way you would `sprig`!
+
 [%collapsible]
-.The same way you would `sprig`!
+.Like this.
 ====
 [source,go]
 ----
@@ -40,21 +51,23 @@ import (
 
 var (
 	txtTpl *txtTplLib.Template = txtTplLib.
-									New("").
-										Funcs(
-											sprigx.TxtFuncMap(),
-										)
+		New("").
+		Funcs(
+			sprigx.TxtFuncMap(),
+		)
 	htmlTpl *htmlTplLib.Template = htmlTplLib.
-									New("").
-										Funcs(
-											sprigx.HtmlFuncMap(),
-										)
+		New("").
+		Funcs(
+			sprigx.HtmlFuncMap(),
+		)
 )
 ----
 ====
 
+They can even be combined/used together.
+
 [%collapsible]
-.They can even be combined/used together.
+.Like this.
 ====
 [source,go]
 ----
@@ -68,23 +81,23 @@ import (
 )
 
 var txtTpl *template.Template = template.
-									New("").
-										Funcs(
-											sprigx.TxtFuncMap(),
-										).
-										Funcs(
-											sprig.TxtFuncMap(),
-										)
+		New("").
+		Funcs(
+			sprigx.TxtFuncMap(),
+		).
+		Funcs(
+			sprig.TxtFuncMap(),
+		)
 // Or:
 /*
 var txtTpl *template.Template = template.
-									New("").
-										Funcs(
-											sprig.TxtFuncMap(),
-										).
-										Funcs(
-											sprigx.TxtFuncMap(),
-										)
+		New("").
+		Funcs(
+			sprig.TxtFuncMap(),
+		).
+		Funcs(
+			sprigx.TxtFuncMap(),
+		)
  */
 ----
 ====
@@ -93,8 +106,42 @@ If a `<template>.FuncMap` is added via `.Funcs()` *after* template parsing, it w
 
 For example, if both `sprig` and `sprigx` provide a function `foo`:
 
+this will use `foo` from `sprigx`
+
 [%collapsible]
-.this will use `foo` from `sprigx`
+.(show)
+====
+[source,go]
+----
+package main
+
+import (
+	"text/template"
+
+	"github.com/Masterminds/sprig/v3"
+	"r00t2.io/goutils/tplx/sprigx"	
+)
+
+const (
+	myTpl string = `{{ "This is an example template string." | foo }}`
+)
+
+var (
+	tpl *template.Template = template.Must(
+					template.
+						New("").
+						Funcs(sprig.TxtFuncMap()).
+						Parse(myTpl),
+				).
+				Funcs(sprigx.TxtFuncMap())
+)
+----
+====
+
+whereas this will use `foo` from `sprig`
+
+[%collapsible]
+.(show)
 ====
 [source,go]
 ----
@@ -113,52 +160,20 @@ const (
 
 var (
 	tpl *template.Template = template.Must(
-								template.
-									New("").
-										Funcs(sprig.TxtFuncMap()).
-										Parse(myTpl),
-									).
-									Funcs(sprigx.TxtFuncMap())
+					template.
+						New("").
+						Funcs(sprigx.TxtFuncMap()).
+						Parse(myTpl),
+					).
+					Funcs(sprig.TxtFuncMap())
 )
 ----
 ====
 
-whereas
+and a function can even be explicitly overridden.
 
 [%collapsible]
-.this will use `foo` from `sprig`
-====
-[source,go]
-----
-package main
-
-import (
-	"text/template"
-
-	"github.com/Masterminds/sprig/v3"
-	"r00t2.io/goutils/tplx/sprigx"
-)
-
-const (
-	myTpl string = `{{ "This is an example template string." | foo }}`
-)
-
-var (
-	tpl *template.Template = template.Must(
-								template.
-									New("").
-										Funcs(sprigx.TxtFuncMap()).
-										Parse(myTpl),
-									).
-									Funcs(sprig.TxtFuncMap())
-)
-----
-====
-
-and a function can even be
-
-[%collapsible]
-.explicitly overridden.
+.(show)
 ====
 This would override a function `foo` and `foo2` in `sprigx` from `foo` and `foo2` from `sprig`, but leave all other `sprig` functions untouched.
 
@@ -180,19 +195,19 @@ const (
 var (
 	overrideFuncs template.FuncMap = sprig.TxtFuncMap()
 	tpl *template.Template = template.Must(
-								template.
-									New("").
-									Funcs(sprigx.TxtFuncMap()).
-									Parse(myTpl),
-								).
-									Funcs(
-										template.FuncMap(
-											map[string]any{
-												"foo": overrideFuncs["foo"],
-												"foo2": overrideFuncs["foo2"],
-											},
-										),
-									)
+					template.
+						New("").
+						Funcs(sprigx.TxtFuncMap()).
+						Parse(myTpl),
+					).
+					Funcs(
+						template.FuncMap(
+							map[string]any{
+								"foo": overrideFuncs["foo"],
+								"foo2": overrideFuncs["foo2"],
+							},
+						),
+					)
 )
 ----
 ====
@@ -201,8 +216,17 @@ var (
 == Functions
 Expect this list to grow over time, and potentially more frequently than the `sprigx` functions.
 
+[id="fn_os"]
+=== Operating System
+
+[id="fn_os_hstnm"]
+==== `osHostname`
+`osHostname` simply wraps and returns the result of calling https://pkg.go.dev/os#Hostname[`os.Hostname`^].
+
+As such, it comes with the same caveats - it's possible for it to error, and it isn't guaranteed to be an FQDN -- it will be precisely/exactly whatever the kernel's hostname is set as.
+
 [id="fn_sys"]
-=== System/OS/Platform
+=== System/Platform/Architecture
 
 [id="fn_sys_arch"]
 ==== `sysArch`
diff --git a/tplx/sprigx/funcs_tpl_os.go b/tplx/sprigx/funcs_tpl_os.go
new file mode 100644
index 0000000..b2979f4
--- /dev/null
+++ b/tplx/sprigx/funcs_tpl_os.go
@@ -0,0 +1,13 @@
+package sprigx
+
+import (
+	"os"
+)
+
+// osHostname returns os.Hostname()
+func osHostname() (out string, err error) {
+
+	out, err = os.Hostname()
+
+	return
+}