aboutsummaryrefslogtreecommitdiffstats
path: root/vendor/github.com/mitchellh/mapstructure/README.md
diff options
context:
space:
mode:
authorMichael Muré <batolettre@gmail.com>2018-09-26 15:55:14 +0200
committerMichael Muré <batolettre@gmail.com>2018-09-26 16:26:50 +0200
commitf969370901f9f6d3c71c0391c74ac933d683e784 (patch)
tree9230635ac72092f753edc06312d9319c2759f88e /vendor/github.com/mitchellh/mapstructure/README.md
parent879e147e2be0b6216a00f8141e71647a0be5b566 (diff)
downloadgit-bug-f969370901f9f6d3c71c0391c74ac933d683e784.tar.gz
graphql: add a general test for the handler/resolvers
Diffstat (limited to 'vendor/github.com/mitchellh/mapstructure/README.md')
-rw-r--r--vendor/github.com/mitchellh/mapstructure/README.md46
1 files changed, 46 insertions, 0 deletions
diff --git a/vendor/github.com/mitchellh/mapstructure/README.md b/vendor/github.com/mitchellh/mapstructure/README.md
new file mode 100644
index 00000000..0018dc7d
--- /dev/null
+++ b/vendor/github.com/mitchellh/mapstructure/README.md
@@ -0,0 +1,46 @@
+# mapstructure [![Godoc](https://godoc.org/github.com/mitchellh/mapstructure?status.svg)](https://godoc.org/github.com/mitchellh/mapstructure)
+
+mapstructure is a Go library for decoding generic map values to structures
+and vice versa, while providing helpful error handling.
+
+This library is most useful when decoding values from some data stream (JSON,
+Gob, etc.) where you don't _quite_ know the structure of the underlying data
+until you read a part of it. You can therefore read a `map[string]interface{}`
+and use this library to decode it into the proper underlying native Go
+structure.
+
+## Installation
+
+Standard `go get`:
+
+```
+$ go get github.com/mitchellh/mapstructure
+```
+
+## Usage & Example
+
+For usage and examples see the [Godoc](http://godoc.org/github.com/mitchellh/mapstructure).
+
+The `Decode` function has examples associated with it there.
+
+## But Why?!
+
+Go offers fantastic standard libraries for decoding formats such as JSON.
+The standard method is to have a struct pre-created, and populate that struct
+from the bytes of the encoded format. This is great, but the problem is if
+you have configuration or an encoding that changes slightly depending on
+specific fields. For example, consider this JSON:
+
+```json
+{
+ "type": "person",
+ "name": "Mitchell"
+}
+```
+
+Perhaps we can't populate a specific structure without first reading
+the "type" field from the JSON. We could always do two passes over the
+decoding of the JSON (reading the "type" first, and the rest later).
+However, it is much simpler to just decode this into a `map[string]interface{}`
+structure, read the "type" key, then use something like this library
+to decode it into the proper structure.