Merge pull request #802 from devlights/add-replace-timenow-with-golinkname-directive

Author: devlights

examples/singleapp/replace_timenow_with_golinkname_directive/.gitignore

@@ -0,0 +1 @@
+app

examples/singleapp/replace_timenow_with_golinkname_directive/README.md

@@ -0,0 +1,23 @@
+# これは何？
+
+[go:linknameコンパイラディレクティブ](https://pkg.go.dev/cmd/compile#hdr-Compiler_Directives) を利用して
+
+```time.Now()``` を置き換えるサンプルです。参考情報に上げているサイトの記事がとても勉強になりました。
+
+実行すると以下のようになります。
+
+```sh
+$ task
+task: [build] go build -o app
+task: [default] ./app
+2000-01-01 00:00:00 +0000 UTC
+```
+
+```time.Now()``` の結果を固定日時になるように置き換えているので、どのタイミングでtime.Now()を呼んでも同じ日時となります。
+
+## 参考情報
+
+- https://www.sobyte.net/post/2022-07/go-linkname/
+- https://zenn.dev/sasakiki/articles/a838380540245d
+- https://pkg.go.dev/cmd/compile#hdr-Compiler_Directives
+

examples/singleapp/replace_timenow_with_golinkname_directive/Taskfile.yml

@@ -0,0 +1,18 @@
+# https://taskfile.dev
+
+version: "3"
+
+tasks:
+  default:
+    cmds:
+      - task: build
+      - ./app
+  build:
+    cmds:
+      - go build -o app
+  clean:
+    cmds:
+      - rm -f ./app
+  doc:
+    cmds:
+      - go doc -cmd -u -all .

examples/singleapp/replace_timenow_with_golinkname_directive/main.go

@@ -0,0 +1,47 @@
+package main
+
+import (
+	"log"
+	"time"
+	_ "unsafe"
+)
+
+// fixedNow は、固定の時間を返す time.Now() のモックです。
+//
+// 標準ライブラリの time.Now() を置き換えるために
+// linknameコンパイラディレクティブを付与しています。
+//
+// linknameコンパイラディレクティブを利用するためには
+// unsafeパッケージをインポート（明示的、暗黙的問わず）する必要があります。
+//
+// linknameは、標準ライブラリ内で利用されており、例えば time.Sleep() も
+// 実際のソースコードを見ると以下の宣言となっており、宣言のみで実装がありません。
+//
+// # $(go env GOROOT)/src/time/sleep.go
+//
+//	package time
+//
+//	func Sleep(d Duration)
+//
+// 実体は、runtime.timeSleep() となっています。
+//
+// # $(go env GOROOT)/src/runtime/time.go
+//
+//	package runtime
+//
+//	//go:linkname timeSleep time.Sleep
+//	func timeSleep(ns int64) { ... }
+//
+//go:linkname fixedNow time.Now
+func fixedNow() time.Time {
+	return time.Date(2000, 1, 1, 0, 0, 0, 0, time.Local)
+}
+
+func init() {
+	log.SetFlags(0)
+}
+
+func main() {
+	// linknameコンパイラディレクティブによって time.Now が置き換えられる
+	log.Println(time.Now())
+}