initial commits

2024-02-14 15:58:51 -08:00 · 2024-02-14 15:58:51 -08:00 · b6bf3ab0c2
parent 141be61623
commit b6bf3ab0c2
2 changed files with 117 additions and 0 deletions
--- a/appendframeposturl.go
+++ b/appendframeposturl.go
@ -0,0 +1,21 @@
+package frameproto
+
+// AppendFramePostURL will append the HTML <meta/> element for the Frame-Protocol's (i.e., Farcaster Frame's) "fc:frame:post_url" name-value pair.
+//
+// For example, this call:
+//
+//	var p []byte
+//	
+//	// ...
+//	
+//	var url string = "https://example.com/my/post/path.php"
+//	
+//	p = frameproto.AppendFramePostURL(p, url)
+//
+// Would append this HTML <meta/> element:
+//
+//	<meta property="fc:frame:post_url" content="https://example.com/my/post/path.php" />
+func AppendFramePostURL(p []byte, url string) []byte {
+	const property string = MetaPropertyFramePostURL
+	return appendMetaPropertyContent(p, property, url)
+}
--- a/appendframeposturl_test.go
+++ b/appendframeposturl_test.go
@ -0,0 +1,96 @@
+package frameproto
+
+import (
+	"testing"
+)
+
+func TestAppendFramePostURL(t *testing.T) {
+
+	tests := []struct{
+		Version string
+		Expected string
+	}{
+		{
+			Version:                                              "",
+			Expected: `<meta property="fc:frame:post_url" content="" />`+"\n",
+		},
+
+
+
+		{
+			Version:                                              "something",
+			Expected: `<meta property="fc:frame:post_url" content="something" />`+"\n",
+		},
+
+
+
+		{
+			Version:                                              "Hello world! 🙂",
+			Expected: `<meta property="fc:frame:post_url" content="Hello world! 🙂" />`+"\n",
+		},
+
+
+
+		{
+			Version:                                              "https://example.com/path/to/post/to.php",
+			Expected: `<meta property="fc:frame:post_url" content="https://example.com/path/to/post/to.php" />`+"\n",
+		},
+
+
+
+		{
+			Version:                                              "x-proto:apple/banana/cherry",
+			Expected: `<meta property="fc:frame:post_url" content="x-proto:apple/banana/cherry" />`+"\n",
+		},
+	}
+
+	for testNumber, test := range tests {
+
+		{
+			var buffer [256]byte
+			var p []byte = buffer[0:0]
+
+			p = AppendFramePostURL(p, test.Version)
+
+			expected := test.Expected
+			actual   := string(p)
+
+			if expected != actual {
+				t.Errorf("For test #%d, the actual written meta-tag is not what was expected.", testNumber)
+				t.Logf("EXPECTED: %s", expected)
+				t.Logf("ACTUAL:   %s", actual)
+				t.Logf("EXPECTED: %q", expected)
+				t.Logf("ACTUAL:   %q", actual)
+				t.Logf("LABEL: %q", test.Version)
+				continue
+			}
+		}
+
+		{
+			const top    string = "<html>\n<head>\n"
+			const bottom string = "</head>\n<body>\n</body>\n</html>\n"
+
+			var buffer [256]byte
+			var p []byte = buffer[0:0]
+
+			p = append(p, top...)
+
+			p = AppendFramePostURL(p, test.Version)
+
+			p = append(p, bottom...)
+
+			expected := top + test.Expected + bottom
+			actual   := string(p)
+
+			if expected != actual {
+				t.Errorf("For test #%d, the actual written meta-tag is not what was expected.", testNumber)
+				t.Logf("EXPECTED: %s", expected)
+				t.Logf("ACTUAL:   %s", actual)
+				t.Logf("EXPECTED: %q", expected)
+				t.Logf("ACTUAL:   %q", actual)
+				t.Logf("LABEL: %q", test.Version)
+				continue
+			}
+		}
+	}
+}