feat: new built-in function stringToBase64

Author: fugerit79

CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- new built-in function stringToBase64
+
 ### Changed
 
 - fj-doc-maven-plugin, init, flavour : quarkus-version set to 3.29.2 across all the modules

fj-doc-freemarker/src/main/java/org/fugerit/java/doc/freemarker/config/FreeMarkerConfigStep.java

@@ -153,6 +153,7 @@ public int process(DocProcessContext context, DocProcessData data) throws Except
 			map.put(CleanTextFun.DEFAULT_NAME, new CleanTextFun());
 			map.put(FormatLocalDateTimeFun.DEFAULT_NAME, new FormatLocalDateTimeFun());
 			map.put(Base64ToStringFun.DEFAULT_NAME, new Base64ToStringFun());
+			map.put(StringToBase64Fun.DEFAULT_NAME, new StringToBase64Fun());
 		}
 		return res;
 	}

fj-doc-freemarker/src/main/java/org/fugerit/java/doc/freemarker/fun/StringToBase64Fun.java

@@ -0,0 +1,23 @@
+package org.fugerit.java.doc.freemarker.fun;
+
+import freemarker.template.SimpleScalar;
+import freemarker.template.TemplateMethodModelEx;
+import freemarker.template.TemplateModelException;
+import freemarker.template.TemplateScalarModel;
+
+import java.nio.charset.StandardCharsets;
+import java.util.Base64;
+import java.util.List;
+
+public class StringToBase64Fun implements TemplateMethodModelEx {
+
+	public static final String DEFAULT_NAME = "stringToBase64";
+
+	@Override
+	public Object exec(@SuppressWarnings("rawtypes") List arguments) throws TemplateModelException {
+		FMFunHelper.checkParameterNumber( arguments, 1 );
+		String content = ((TemplateScalarModel)arguments.get( 0 )).getAsString();
+		return new SimpleScalar( Base64.getEncoder().encodeToString( content.getBytes( StandardCharsets.UTF_8 ) ) );
+	}
+	
+}

fj-doc-guide/src/main/docs/asciidoc/chapters/04_1_doc_freemarker_config.adoc

@@ -209,6 +209,16 @@ NOTE: When using *skipfm* no FreeMarker template syntax should be used in the te
 | formats a LocalDate, LocalTime or LocalDateTime
 | (1) - the date/time to format, (2) - the format pattern
 
+| base64ToString
+| org.fugerit.java.doc.freemarker.fun.​Base64ToStringFun
+| converts a base64 to string
+| (1) - base64 to convert to string
+
+| stringToBase64
+| org.fugerit.java.doc.freemarker.fun.​StringToBase64Fun
+| converts a string to base64
+| (1) - the string to convert
+
 |========================================================================================================================================
 
 NOTE: These functions can all be loaded at once with the config step attribute _load-bundled-functions="true"_.