Merge pull request #367 from devlights/devlights/add-embed-package-examples-366

add embed package examples (#366)

Author: devlights

internal/examples/basic/embeds/README.md

@@ -0,0 +1,11 @@
+# サンプルリスト
+
+このディレクトリには以下のサンプルがあります。
+
+|file|example name|note|
+|----|------------|----|
+|embed\_string.go|embed\_string|iota の基本的な使い方のサンプルです.|
+|embed\_bytes.go|embed\_bytes|embed パッケージの機能を確認するサンプルです (バイト列として値を取得)|
+|embed\_fs\_singlefile.go|embed\_fs\_singlefile|embed パッケージの機能を確認するサンプルです (embed.FSとして単独ファイルを操作)|
+|embed\_fs\_multifiles.go|embed\_fs\_multifiles|embed パッケージの機能を確認するサンプルです (embed.FSとして複数ファイルを操作)|
+|embed\_fs\_filter.go|embed\_fs\_filter|embed パッケージの機能を確認するサンプルです (埋め込むファイルをフィルタリング)|

internal/examples/basic/embeds/data/dotnet.txt

@@ -0,0 +1 @@
+dotnet

internal/examples/basic/embeds/data/go.txt

@@ -0,0 +1 @@
+golang

internal/examples/basic/embeds/data/golang.txt

@@ -0,0 +1 @@
+golang

internal/examples/basic/embeds/data/python.txt

@@ -0,0 +1 @@
+python

internal/examples/basic/embeds/doc.go

@@ -0,0 +1,4 @@
+/*
+Package embeds -- embed パッケージについてのサンプルが配置されているパッケージです。
+*/
+package embeds

internal/examples/basic/embeds/embed_bytes.go

@@ -0,0 +1,22 @@
+package embeds
+
+import (
+	_ "embed"
+	"encoding/hex"
+	"os"
+)
+
+//go:embed helloworld.txt
+var b []byte
+
+// EmbedBytes は、embed パッケージの機能を確認するサンプルです (バイト列として値を取得)
+func EmbedBytes() error {
+	dumper := hex.Dumper(os.Stdout)
+	defer dumper.Close()
+
+	if _, err := dumper.Write(b); err != nil {
+		return err
+	}
+
+	return nil
+}

internal/examples/basic/embeds/embed_fs_filter.go

@@ -0,0 +1,42 @@
+package embeds
+
+import (
+	"embed"
+	"fmt"
+	"io/fs"
+
+	"github.com/devlights/gomy/output"
+)
+
+//go:embed data/go*.txt
+var filteredContent embed.FS // 埋め込むファイルをフィルタリングしている
+
+// EmbedFsFilter は、embed パッケージの機能を確認するサンプルです (埋め込むファイルをフィルタリング)
+func EmbedFsFilter() error {
+	var (
+		entries []fs.DirEntry
+		buf     []byte
+		err     error
+	)
+
+	entries, err = filteredContent.ReadDir("data")
+	if err != nil {
+		return err
+	}
+
+	for _, entry := range entries {
+		var (
+			name = entry.Name()
+			path = fmt.Sprintf("data/%s", name)
+		)
+
+		buf, err = content.ReadFile(path)
+		if err != nil {
+			return err
+		}
+
+		output.Stdoutl(fmt.Sprintf("[%s]", name), string(buf))
+	}
+
+	return nil
+}

internal/examples/basic/embeds/embed_fs_multifiles.go

@@ -0,0 +1,59 @@
+package embeds
+
+import (
+	"embed"
+	"fmt"
+
+	"github.com/devlights/gomy/output"
+)
+
+//go:embed data
+//go:embed helloworld.txt
+var content embed.FS
+
+// EmbedFsMultifiles は、embed パッケージの機能を確認するサンプルです (embed.FSとして複数ファイルを操作)
+func EmbedFsMultifiles() error {
+	var (
+		buf []byte
+		err error
+	)
+
+	//
+	// 埋め込まれたファイルの操作
+	//
+	buf, err = content.ReadFile("helloworld.txt")
+	if err != nil {
+		return err
+	}
+
+	output.Stdoutl("[helloworld.txt]", string(buf))
+	output.StdoutHr()
+
+	//
+	// 埋め込まれたディレクトリの操作
+	//
+	entries, err := content.ReadDir("data")
+	if err != nil {
+		return err
+	}
+
+	for _, entry := range entries {
+		if entry.IsDir() {
+			continue
+		}
+
+		var (
+			name = entry.Name()
+			path = fmt.Sprintf("data/%s", name)
+		)
+
+		buf, err = content.ReadFile(path)
+		if err != nil {
+			return err
+		}
+
+		output.Stdoutl(fmt.Sprintf("[%s]", name), string(buf))
+	}
+
+	return nil
+}

internal/examples/basic/embeds/embed_fs_singlefile.go

@@ -0,0 +1,27 @@
+package embeds
+
+import (
+	"embed"
+	"encoding/hex"
+	"os"
+)
+
+//go:embed helloworld.txt
+var f embed.FS
+
+// EmbedFsSingleFile は、embed パッケージの機能を確認するサンプルです (embed.FSとして単独ファイルを操作)
+func EmbedFsSingleFile() error {
+	b, err := f.ReadFile("helloworld.txt")
+	if err != nil {
+		return err
+	}
+
+	dumper := hex.Dumper(os.Stdout)
+	defer dumper.Close()
+
+	if _, err := dumper.Write(b); err != nil {
+		return err
+	}
+
+	return nil
+}