add support for embed.FS

_examples/file-server/embedding-files-into-app-bindata/assets/css/main.css

@@ -0,0 +1,5 @@
+html {
+	font-family: sans-serif;
+	-webkit-text-size-adjust: 100%;
+	-ms-text-size-adjust: 100%
+}

_examples/file-server/embedding-files-into-app-bindata/assets/js/main.js

@@ -0,0 +1 @@
+console.log("example");

_examples/file-server/embedding-files-into-app-bindata/main.go

@@ -0,0 +1,44 @@
+package main
+
+import (
+	"github.com/kataras/iris/v12"
+)
+
+// Follow these steps first:
+// $ go install github.com/go-bindata/go-bindata/v3/go-bindata@latest
+// $ go-bindata -prefix "assets" -fs ./assets/...
+// $ go run .
+// "physical" files are not used, you can delete the "assets" folder and run the example.
+//
+// See `file-server/embedding-gzipped-files-into-app-bindata` and
+// 'file-server/embedding-files-into-app` examples as well.
+func newApp() *iris.Application {
+	app := iris.New()
+	app.Logger().SetLevel("debug")
+
+	app.HandleDir("/static", AssetFile())
+
+	/*
+		Or if you need to cache them inside the memory (requires the assets folder
+		to be located near the executable program):
+		app.HandleDir("/static", iris.Dir("./assets"), iris.DirOptions{
+			IndexName: "index.html",
+			Cache: iris.DirCacheOptions{
+				Enable:          true,
+				Encodings:       []string{"gzip"},
+				CompressIgnore:  iris.MatchImagesAssets,
+				CompressMinSize: 30 * iris.B,
+			},
+		})
+	*/
+	return app
+}
+
+func main() {
+	app := newApp()
+
+	// http://localhost:8080/static/css/main.css
+	// http://localhost:8080/static/js/main.js
+	// http://localhost:8080/static/favicon.ico
+	app.Listen(":8080")
+}

_examples/file-server/embedding-files-into-app-bindata/main_test.go

@@ -0,0 +1,94 @@
+package main
+
+import (
+	"os"
+	"path/filepath"
+	"runtime"
+	"strings"
+	"testing"
+
+	"github.com/kataras/iris/v12/httptest"
+)
+
+type resource string
+
+// content types that are used in the ./assets,
+// we could use the detectContentType that iris do but it's better
+// to do it manually so we can test if that returns the correct result on embedding files.
+func (r resource) contentType() string {
+	switch filepath.Ext(r.String()) {
+	case ".js":
+		return "text/javascript"
+	case ".css":
+		return "text/css"
+	case ".ico":
+		return "image/x-icon"
+	case ".html":
+		return "text/html"
+	default:
+		return "text/plain"
+	}
+}
+
+func (r resource) String() string {
+	return string(r)
+}
+
+func (r resource) strip(strip string) string {
+	s := r.String()
+	return strings.TrimPrefix(s, strip)
+}
+
+func (r resource) loadFromBase(dir string) string {
+	filename := r.strip("/static")
+
+	fullpath := filepath.Join(dir, filename)
+
+	b, err := os.ReadFile(fullpath)
+	if err != nil {
+		panic(fullpath + " failed with error: " + err.Error())
+	}
+
+	result := string(b)
+
+	if runtime.GOOS != "windows" {
+		result = strings.ReplaceAll(result, "\n", "\r\n")
+		result = strings.ReplaceAll(result, "\r\r", "")
+	}
+	return result
+}
+
+var urls = []resource{
+	"/static/css/main.css",
+	"/static/js/main.js",
+	"/static/favicon.ico",
+}
+
+// if bindata's values matches with the assets/... contents
+// and secondly if the HandleDir had successfully registered
+// the routes and gave the correct response.
+func TestEmbeddingFilesIntoApp(t *testing.T) {
+	app := newApp()
+	e := httptest.New(t, app)
+
+	route := app.GetRouteReadOnly("GET/static/{file:path}")
+	if route == nil {
+		t.Fatalf("expected a route to serve embedded files")
+	}
+
+	if runtime.GOOS != "windows" {
+		// remove the embedded static favicon for !windows,
+		// it should be built for unix-specific in order to be work
+		urls = urls[0 : len(urls)-1]
+	}
+
+	for _, u := range urls {
+		url := u.String()
+		contents := u.loadFromBase("./assets")
+
+		e.GET(url).Expect().
+			Status(httptest.StatusOK).
+			ContentType(u.contentType()).
+			Body().Equal(contents)
+	}
+}