feat: implement base functionality (#1)

Author: jrschumacher

.gitignore

@@ -0,0 +1,3 @@
+# tests
+coverage.out
+coverage.html

.trunk/.gitignore

@@ -0,0 +1,9 @@
+*out
+*logs
+*actions
+*notifications
+*tools
+plugins
+user_trunk.yaml
+user.yaml
+tmp

.trunk/configs/.markdownlint.yaml

@@ -0,0 +1,2 @@
+# Prettier friendly markdownlint config (all formatting rules disabled)
+extends: markdownlint/style/prettier

.trunk/configs/.yamllint.yaml

@@ -0,0 +1,7 @@
+rules:
+  quoted-strings:
+    required: only-when-needed
+    extra-allowed: ["{|}"]
+  key-duplicates: {}
+  octal-values:
+    forbid-implicit-octal: true

.trunk/configs/svgo.config.js

@@ -0,0 +1,14 @@
+module.exports = {
+  plugins: [
+    {
+      name: "preset-default",
+      params: {
+        overrides: {
+          removeViewBox: false, // https://github.com/svg/svgo/issues/1128
+          sortAttrs: true,
+          removeOffCanvasPaths: true,
+        },
+      },
+    },
+  ],
+};

.trunk/trunk.yaml

@@ -0,0 +1,40 @@
+# This file controls the behavior of Trunk: https://docs.trunk.io/cli
+# To learn more about the format of this file, see https://docs.trunk.io/reference/trunk-yaml
+version: 0.1
+cli:
+  version: 1.22.2
+# Trunk provides extensibility via plugins. (https://docs.trunk.io/plugins)
+plugins:
+  sources:
+    - id: trunk
+      ref: v1.6.1
+      uri: https://github.com/trunk-io/plugins
+# Many linters and tools depend on runtimes - configure them here. (https://docs.trunk.io/runtimes)
+runtimes:
+  enabled:
+    - go@1.21.0
+# This is the section where you manage your linters. (https://docs.trunk.io/check/configuration)
+lint:
+  ignore:
+    - linters: [ALL]
+      paths: 
+        - examples/**
+  enabled:
+    - checkov@3.2.219
+    - git-diff-check
+    - gofmt@1.20.4
+    - golangci-lint@1.59.1
+    - markdownlint@0.41.0
+    - osv-scanner@1.8.3
+    - prettier@3.3.3
+    - svgo@3.3.2
+    - trivy@0.54.1
+    - trufflehog@3.81.7
+    - yamllint@1.35.1
+actions:
+  disabled:
+    - trunk-announce
+    - trunk-check-pre-push
+    - trunk-fmt-pre-commit
+  enabled:
+    - trunk-upgrade-available

.vscode/launch.json

@@ -0,0 +1,15 @@
+{
+  // Use IntelliSense to learn about possible attributes.
+  // Hover to view descriptions of existing attributes.
+  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Launch Package",
+      "type": "go",
+      "request": "launch",
+      "mode": "auto",
+      "program": "${fileDirname}"
+    }
+  ]
+}

README.md

@@ -1,7 +1,18 @@
-# Go Vite Env
+# Go SPA Serve
+
+Go SPA Serve is a simple package that serves static files specifically focused on serving single page applications (SPA).
+Generally, this can be used to instead of the stdlib `http.FileServer`, but the main use case is to serve a SPA with a
+single entry point (e.g. `index.html`) and let the client-side router handle the rest.
+
+In addition to serving static files, this package also provides a way to load environment variables from a Go struct at
+runtime by injecting them into the head tag of the served HTML file.
+
+## Problem
 
 Vite is a fantastic build tool, but it doesn't support loading environment variables at runtime.
 This becomes quite a problem when you build a single image for multiple environments or need to
 build images for on-premises deployments where you can't bake in the environment variables.
 
-This package provides a way to load environment variables from a Go struct at runtime.
+## Code Coverage
+
+[![codecov](https://codecov.io/gh/jrschumacher/go-spaserve/graph/badge.svg?token=W99WAK10IX)](https://codecov.io/gh/jrschumacher/go-spaserve)

codecov.yaml

@@ -0,0 +1,8 @@
+coverage:
+  status:
+    project:
+      default:
+        # basic
+        target: auto #default
+        threshold: 5
+        base: auto

copyFilesys.go

@@ -0,0 +1,60 @@
+package spaserve
+
+import (
+	"errors"
+	"io"
+	"io/fs"
+
+	"github.com/psanford/memfs"
+)
+
+// OnHookFunc is a function that can be used to modify the data of a file before it is written to the memfs.
+// The function should return the modified data and an error if one occurred.
+type OnHookFunc func(path string, data []byte) ([]byte, error)
+
+func CopyFileSys(filesys fs.FS, onHook OnHookFunc) (*memfs.FS, error) {
+	mfs := memfs.New()
+	err := fs.WalkDir(filesys, ".", func(path string, d fs.DirEntry, err error) error {
+		if err != nil {
+			return errors.Join(ErrUnexpectedWalkError, err)
+		}
+
+		// create dir and continue
+		if d.IsDir() {
+			if err := mfs.MkdirAll(path, 0o755); err != nil {
+				return errors.Join(ErrCouldNotMakeDir, err)
+			}
+			return nil
+		}
+
+		// open file
+		f, err := filesys.Open(path)
+		if err != nil {
+			return errors.Join(ErrCouldNotOpenFile, err)
+		}
+		defer f.Close()
+
+		// read file
+		data, err := io.ReadAll(f)
+		if err != nil {
+			return errors.Join(ErrCouldNotReadFile, err)
+		}
+
+		// run onHook
+		if onHook != nil {
+			data, err = onHook(path, data)
+			if err != nil {
+				return err
+			}
+		}
+
+		// write file to memfs
+		if err := mfs.WriteFile(path, data, fs.ModeAppend); err != nil {
+			return errors.Join(ErrCouldNotWriteFile, err)
+		}
+
+		return nil
+	})
+
+	return mfs, err
+}