ROOTPLOIT
Server: LiteSpeed
System: Linux in-mum-web1878.main-hosting.eu 5.14.0-570.21.1.el9_6.x86_64 #1 SMP PREEMPT_DYNAMIC Wed Jun 11 07:22:35 EDT 2025 x86_64
User: u435929562 (435929562)
PHP: 7.4.33
Disabled: system, exec, shell_exec, passthru, mysql_list_dbs, ini_alter, dl, symlink, link, chgrp, leak, popen, apache_child_terminate, virtual, mb_send_mail
Upload Files
File: //opt/go/pkg/mod/github.com/aws/[email protected]/private/model/api/docstring_test.go
//go:build go1.8 && codegen
// +build go1.8,codegen

package api

import (
	"testing"
)

func TestDocstring(t *testing.T) {
	cases := map[string]struct {
		In     string
		Expect string
	}{
		"non HTML": {
			In:     "Testing 1 2 3",
			Expect: "// Testing 1 2 3",
		},
		"link": {
			In:     `<a href="https://example.com">a link</a>`,
			Expect: "// a link (https://example.com)",
		},
		"link with space": {
			In:     `<a href=" https://example.com">a link</a>`,
			Expect: "// a link (https://example.com)",
		},
		"list HTML 01": {
			In:     "<ul><li>Testing 1 2 3</li> <li>FooBar</li></ul>",
			Expect: "//    * Testing 1 2 3\n// \n//    * FooBar",
		},
		"list HTML 02": {
			In:     "<ul> <li>Testing 1 2 3</li> <li>FooBar</li> </ul>",
			Expect: "//    * Testing 1 2 3\n// \n//    * FooBar",
		},
		"list HTML leading spaces": {
			In:     " <ul> <li>Testing 1 2 3</li> <li>FooBar</li> </ul>",
			Expect: "//    * Testing 1 2 3\n// \n//    * FooBar",
		},
		"list HTML paragraph": {
			In:     "<ul> <li> <p>Testing 1 2 3</p> </li><li> <p>FooBar</p></li></ul>",
			Expect: "//    * Testing 1 2 3\n// \n//    * FooBar",
		},
		"inline code HTML": {
			In:     "<ul> <li><code>Testing</code>: 1 2 3</li> <li>FooBar</li> </ul>",
			Expect: "//    * Testing: 1 2 3\n// \n//    * FooBar",
		},
		"complex list paragraph": {
			In:     "<ul> <li><p><code>FOO</code> Bar</p></li><li><p><code>Xyz</code> ABC</p></li></ul>",
			Expect: "//    * FOO Bar\n// \n//    * Xyz ABC",
		},
		"inline code in paragraph": {
			In:     "<p><code>Testing</code>: 1 2 3</p>",
			Expect: "// Testing: 1 2 3",
		},
		"root pre": {
			In:     "<pre><code>Testing</code></pre>",
			Expect: "//    Testing",
		},
		"paragraph": {
			In:     "<p>Testing 1 2 3</p>",
			Expect: "// Testing 1 2 3",
		},
		"wrap lines": {
			In:     "<span data-target-type=\"operation\" data-service=\"secretsmanager\" data-target=\"CreateSecret\">CreateSecret</span> <span data-target-type=\"structure\" data-service=\"secretsmanager\" data-target=\"SecretListEntry\">SecretListEntry</span> <span data-target-type=\"structure\" data-service=\"secretsmanager\" data-target=\"CreateSecret$SecretName\">SecretName</span> <span data-target-type=\"structure\" data-service=\"secretsmanager\" data-target=\"SecretListEntry$KmsKeyId\">KmsKeyId</span>",
			Expect: "// CreateSecret SecretListEntry SecretName KmsKeyId",
		},
		"links with spaces": {
			In:     "<p> Deletes the replication configuration from the bucket. For information about replication configuration, see <a href=\" https://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html\">Cross-Region Replication (CRR)</a> in the <i>Amazon S3 Developer Guide</i>. </p>",
			Expect: "// Deletes the replication configuration from the bucket. For information about\n// replication configuration, see Cross-Region Replication (CRR) (https://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html)\n// in the Amazon S3 Developer Guide.",
		},
		"unexpected closing tag": {
			In:     "<p>Some cool text</p></p>",
			Expect: "// Some cool text",
		},
	}

	for name, c := range cases {
		t.Run(name, func(t *testing.T) {
			actual := docstring(c.In)
			if e, a := c.Expect, actual; e != a {
				t.Errorf("expect %q, got %q", e, a)
			}
		})
	}
}

func TestApiDocumentation_missingShapes(t *testing.T) {
	docs := apiDocumentation{
		Service: "some service documentation",
		Operations: map[string]string{
			"OperationOne": "some operation documentation",
			"OperationTwo": "some more operation documentation",
		},
		Shapes: map[string]shapeDocumentation{
			"ShapeOne": {
				Base: "some shape documentation",
			},
			"ShapeTwo": {
				Base: "some more shape documentation",
				Refs: map[string]string{
					"ShapeOne$shapeTwo": "shape ref document",
				},
			},
		},
	}

	api := API{
		Operations: map[string]*Operation{
			"OperationOne": {},
		},
		Shapes: map[string]*Shape{
			"ShapeOne": {
				Type:       "structure",
				MemberRefs: map[string]*ShapeRef{},
			},
		},
	}

	if err := docs.setup(&api); err != nil {
		t.Fatalf("expect no error, got %v", err)
	}

	if _, ok := api.Operations["OperationTwo"]; ok {
		t.Errorf("expect operation shape to not be added from document model")
	}

	if _, ok := api.Shapes["ShapeTwo"]; ok {
		t.Errorf("expect shape to not be added from document model")
	}

	if _, ok := api.Shapes["ShapeOne"].MemberRefs["shapeTwo"]; ok {
		t.Errorf("expect shape to not be added from document model")
	}
}