Function TestArrayDefinitionsBug

tools/goctl/api/swagger/swagger_test.go:28–87

(t *testing.T)

}

func TestArrayDefinitionsBug(t *testing.T) {
	// Test case for the bug where array of structs with useDefinitions
	// generates incorrect swagger JSON structure

	// Context with useDefinitions enabled
	ctx := Context{
		UseDefinitions: true,
	}

	// Create a test struct containing an array of structs
	testStruct := spec.DefineStruct{
		RawName: "TestStruct",
		Members: []spec.Member{
			{
				Name: "ArrayField",
				Type: spec.ArrayType{
					Value: spec.DefineStruct{
						RawName: "ItemStruct",
						Members: []spec.Member{
							{
								Name: "ItemName",
								Type: spec.PrimitiveType{RawName: "string"},
								Tag:  `json:"itemName"`,
							},
						},
					},
				},
				Tag: `json:"arrayField"`,
			},
		},
	}

	// Get properties from the struct
	properties, _ := propertiesFromType(ctx, testStruct)

	// Check that we have the array field
	assert.Contains(t, properties, "arrayField")
	arrayField := properties["arrayField"]

	// Verify the array field has correct structure
	assert.Equal(t, "array", arrayField.Type[0])
	
	// Check that we have items
	assert.NotNil(t, arrayField.Items, "Array should have items defined")
	assert.NotNil(t, arrayField.Items.Schema, "Array items should have schema")

	// The FIX: $ref should be inside items, not at schema level
	hasRef := arrayField.Ref.String() != ""
	assert.False(t, hasRef, "Schema level should NOT have $ref")
	
	// The $ref should be in the items
	hasItemsRef := arrayField.Items.Schema.Ref.String() != ""
	assert.True(t, hasItemsRef, "Items should have $ref")
	assert.Equal(t, "#/definitions/ItemStruct", arrayField.Items.Schema.Ref.String())

	// Verify there are no other properties in the items when using $ref
	assert.Nil(t, arrayField.Items.Schema.Properties, "Items with $ref should not have properties")
	assert.Empty(t, arrayField.Items.Schema.Required, "Items with $ref should not have required")