mirror of
https://github.com/kemko/nomad.git
synced 2026-01-07 19:05:42 +03:00
15fb4c990a
This PR switches the Nomad repository from using govendor to Go modules for managing dependencies. Aspects of the Nomad workflow remain pretty much the same. The usual Makefile targets should continue to work as they always did. The API submodule simply defers to the parent Nomad version on the repository, keeping the semantics of API versioning that currently exists.
66 lines
1.7 KiB
Markdown
66 lines
1.7 KiB
Markdown
# hashstructure [](https://godoc.org/github.com/mitchellh/hashstructure)
|
|
|
|
hashstructure is a Go library for creating a unique hash value
|
|
for arbitrary values in Go.
|
|
|
|
This can be used to key values in a hash (for use in a map, set, etc.)
|
|
that are complex. The most common use case is comparing two values without
|
|
sending data across the network, caching values locally (de-dup), and so on.
|
|
|
|
## Features
|
|
|
|
* Hash any arbitrary Go value, including complex types.
|
|
|
|
* Tag a struct field to ignore it and not affect the hash value.
|
|
|
|
* Tag a slice type struct field to treat it as a set where ordering
|
|
doesn't affect the hash code but the field itself is still taken into
|
|
account to create the hash value.
|
|
|
|
* Optionally specify a custom hash function to optimize for speed, collision
|
|
avoidance for your data set, etc.
|
|
|
|
* Optionally hash the output of `.String()` on structs that implement fmt.Stringer,
|
|
allowing effective hashing of time.Time
|
|
|
|
## Installation
|
|
|
|
Standard `go get`:
|
|
|
|
```
|
|
$ go get github.com/mitchellh/hashstructure
|
|
```
|
|
|
|
## Usage & Example
|
|
|
|
For usage and examples see the [Godoc](http://godoc.org/github.com/mitchellh/hashstructure).
|
|
|
|
A quick code example is shown below:
|
|
|
|
```go
|
|
type ComplexStruct struct {
|
|
Name string
|
|
Age uint
|
|
Metadata map[string]interface{}
|
|
}
|
|
|
|
v := ComplexStruct{
|
|
Name: "mitchellh",
|
|
Age: 64,
|
|
Metadata: map[string]interface{}{
|
|
"car": true,
|
|
"location": "California",
|
|
"siblings": []string{"Bob", "John"},
|
|
},
|
|
}
|
|
|
|
hash, err := hashstructure.Hash(v, nil)
|
|
if err != nil {
|
|
panic(err)
|
|
}
|
|
|
|
fmt.Printf("%d", hash)
|
|
// Output:
|
|
// 2307517237273902113
|
|
```
|