github.com/richardmarshall/terraform@v0.9.5-0.20170429023105-15704cc6ee35/helper/schema/set.go (about) 1 package schema 2 3 import ( 4 "bytes" 5 "fmt" 6 "reflect" 7 "sort" 8 "strconv" 9 "sync" 10 11 "github.com/hashicorp/terraform/helper/hashcode" 12 ) 13 14 // HashString hashes strings. If you want a Set of strings, this is the 15 // SchemaSetFunc you want. 16 func HashString(v interface{}) int { 17 return hashcode.String(v.(string)) 18 } 19 20 // HashResource hashes complex structures that are described using 21 // a *Resource. This is the default set implementation used when a set's 22 // element type is a full resource. 23 func HashResource(resource *Resource) SchemaSetFunc { 24 return func(v interface{}) int { 25 var buf bytes.Buffer 26 SerializeResourceForHash(&buf, v, resource) 27 return hashcode.String(buf.String()) 28 } 29 } 30 31 // HashSchema hashes values that are described using a *Schema. This is the 32 // default set implementation used when a set's element type is a single 33 // schema. 34 func HashSchema(schema *Schema) SchemaSetFunc { 35 return func(v interface{}) int { 36 var buf bytes.Buffer 37 SerializeValueForHash(&buf, v, schema) 38 return hashcode.String(buf.String()) 39 } 40 } 41 42 // Set is a set data structure that is returned for elements of type 43 // TypeSet. 44 type Set struct { 45 F SchemaSetFunc 46 47 m map[string]interface{} 48 once sync.Once 49 } 50 51 // NewSet is a convenience method for creating a new set with the given 52 // items. 53 func NewSet(f SchemaSetFunc, items []interface{}) *Set { 54 s := &Set{F: f} 55 for _, i := range items { 56 s.Add(i) 57 } 58 59 return s 60 } 61 62 // CopySet returns a copy of another set. 63 func CopySet(otherSet *Set) *Set { 64 return NewSet(otherSet.F, otherSet.List()) 65 } 66 67 // Add adds an item to the set if it isn't already in the set. 68 func (s *Set) Add(item interface{}) { 69 s.add(item, false) 70 } 71 72 // Remove removes an item if it's already in the set. Idempotent. 73 func (s *Set) Remove(item interface{}) { 74 s.remove(item) 75 } 76 77 // Contains checks if the set has the given item. 78 func (s *Set) Contains(item interface{}) bool { 79 _, ok := s.m[s.hash(item)] 80 return ok 81 } 82 83 // Len returns the amount of items in the set. 84 func (s *Set) Len() int { 85 return len(s.m) 86 } 87 88 // List returns the elements of this set in slice format. 89 // 90 // The order of the returned elements is deterministic. Given the same 91 // set, the order of this will always be the same. 92 func (s *Set) List() []interface{} { 93 result := make([]interface{}, len(s.m)) 94 for i, k := range s.listCode() { 95 result[i] = s.m[k] 96 } 97 98 return result 99 } 100 101 // Difference performs a set difference of the two sets, returning 102 // a new third set that has only the elements unique to this set. 103 func (s *Set) Difference(other *Set) *Set { 104 result := &Set{F: s.F} 105 result.once.Do(result.init) 106 107 for k, v := range s.m { 108 if _, ok := other.m[k]; !ok { 109 result.m[k] = v 110 } 111 } 112 113 return result 114 } 115 116 // Intersection performs the set intersection of the two sets 117 // and returns a new third set. 118 func (s *Set) Intersection(other *Set) *Set { 119 result := &Set{F: s.F} 120 result.once.Do(result.init) 121 122 for k, v := range s.m { 123 if _, ok := other.m[k]; ok { 124 result.m[k] = v 125 } 126 } 127 128 return result 129 } 130 131 // Union performs the set union of the two sets and returns a new third 132 // set. 133 func (s *Set) Union(other *Set) *Set { 134 result := &Set{F: s.F} 135 result.once.Do(result.init) 136 137 for k, v := range s.m { 138 result.m[k] = v 139 } 140 for k, v := range other.m { 141 result.m[k] = v 142 } 143 144 return result 145 } 146 147 func (s *Set) Equal(raw interface{}) bool { 148 other, ok := raw.(*Set) 149 if !ok { 150 return false 151 } 152 153 return reflect.DeepEqual(s.m, other.m) 154 } 155 156 func (s *Set) GoString() string { 157 return fmt.Sprintf("*Set(%#v)", s.m) 158 } 159 160 func (s *Set) init() { 161 s.m = make(map[string]interface{}) 162 } 163 164 func (s *Set) add(item interface{}, computed bool) string { 165 s.once.Do(s.init) 166 167 code := s.hash(item) 168 if computed { 169 code = "~" + code 170 } 171 172 if _, ok := s.m[code]; !ok { 173 s.m[code] = item 174 } 175 176 return code 177 } 178 179 func (s *Set) hash(item interface{}) string { 180 code := s.F(item) 181 // Always return a nonnegative hashcode. 182 if code < 0 { 183 code = -code 184 } 185 return strconv.Itoa(code) 186 } 187 188 func (s *Set) remove(item interface{}) string { 189 s.once.Do(s.init) 190 191 code := s.hash(item) 192 delete(s.m, code) 193 194 return code 195 } 196 197 func (s *Set) index(item interface{}) int { 198 return sort.SearchStrings(s.listCode(), s.hash(item)) 199 } 200 201 func (s *Set) listCode() []string { 202 // Sort the hash codes so the order of the list is deterministic 203 keys := make([]string, 0, len(s.m)) 204 for k := range s.m { 205 keys = append(keys, k) 206 } 207 sort.Sort(sort.StringSlice(keys)) 208 return keys 209 }