jsonpointer/options_test.go at 9cc920f483228f2706915b60a49a9e010be6d880 · fredbi/jsonpointer · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
// SPDX-FileCopyrightText: Copyright (c) 2015-2025 go-swagger maintainers
// SPDX-License-Identifier: Apache-2.0

package jsonpointer

import (
	"reflect"
	"sync"
	"testing"

	"github.com/go-openapi/testify/v2/assert"
	"github.com/go-openapi/testify/v2/require"
)

// stubNameProvider is a NameProvider that maps JSON names to Go field names
// via a fixed dictionary. It lets tests observe which provider was used by
// the resolver without relying on the default reflection-based behavior.
type stubNameProvider struct {
	mu       sync.Mutex
	mapping  map[string]string
	lookups  []string
	forTypes []string
}

func (s *stubNameProvider) GetGoName(_ any, name string) (string, bool) {
	s.record(name, false)
	goName, ok := s.mapping[name]
	return goName, ok
}

func (s *stubNameProvider) GetGoNameForType(_ reflect.Type, name string) (string, bool) {
	s.record(name, true)
	goName, ok := s.mapping[name]
	return goName, ok
}

func (s *stubNameProvider) record(name string, forType bool) {
	s.mu.Lock()
	defer s.mu.Unlock()

	if forType {
		s.forTypes = append(s.forTypes, name)
		return
	}
	s.lookups = append(s.lookups, name)
}

type optionStruct struct {
	// intentional: the JSON name "renamed" is deliberately not a valid
	// struct tag so that only a custom provider can resolve it.
	Field string
}

func TestWithNameProvider_overridesDefault(t *testing.T) {
	t.Parallel()

	stub := &stubNameProvider{mapping: map[string]string{"renamed": "Field"}}

	doc := optionStruct{Field: "hello"}
	p, err := New("/renamed")
	require.NoError(t, err)

	v, _, err := p.Get(doc, WithNameProvider(stub))
	require.NoError(t, err)
	assert.Equal(t, "hello", v)

	stub.mu.Lock()
	defer stub.mu.Unlock()
	assert.Contains(t, stub.forTypes, "renamed", "custom provider must be consulted")
}

func TestWithNameProvider_setRoutesThroughProvider(t *testing.T) {
	t.Parallel()

	stub := &stubNameProvider{mapping: map[string]string{"renamed": "Field"}}

	doc := &optionStruct{Field: "before"}
	p, err := New("/renamed")
	require.NoError(t, err)

	_, err = p.Set(doc, "after", WithNameProvider(stub))
	require.NoError(t, err)
	assert.Equal(t, "after", doc.Field)
}

func TestSetDefaultNameProvider_roundTrip(t *testing.T) {
	// Not Parallel: mutates package state.
	original := DefaultNameProvider()
	t.Cleanup(func() { SetDefaultNameProvider(original) })

	stub := &stubNameProvider{mapping: map[string]string{"renamed": "Field"}}
	SetDefaultNameProvider(stub)

	assert.Same(t, stub, DefaultNameProvider())

	doc := optionStruct{Field: "hello"}
	p, err := New("/renamed")
	require.NoError(t, err)

	v, _, err := p.Get(doc)
	require.NoError(t, err)
	assert.Equal(t, "hello", v)
}

func TestSetDefaultNameProvider_nilIgnored(t *testing.T) {
	// Not Parallel: mutates package state.
	original := DefaultNameProvider()
	t.Cleanup(func() { SetDefaultNameProvider(original) })

	SetDefaultNameProvider(nil)
	assert.Same(t, original, DefaultNameProvider(), "nil must be a no-op")
}

func TestDefaultNameProvider_reachesGetForToken(t *testing.T) {
	// Not Parallel: mutates package state.
	original := DefaultNameProvider()
	t.Cleanup(func() { SetDefaultNameProvider(original) })

	stub := &stubNameProvider{mapping: map[string]string{"renamed": "Field"}}
	SetDefaultNameProvider(stub)

	doc := optionStruct{Field: "hello"}
	v, _, err := GetForToken(doc, "renamed")
	require.NoError(t, err)
	assert.Equal(t, "hello", v)
}