initial commit

Author: nathanejohnson

.gitignore

@@ -0,0 +1 @@
+vendor

.travis.yml

@@ -0,0 +1,28 @@
+language: go
+sudo: false
+dist: trusty
+go:
+  - 1.x
+  - 1.9.x
+  - 1.8.x
+  - master
+
+env:
+  DEP_VER=0.4.1
+  CONSUL_VER=1.0.7
+  PATH=$HOME/bin:$PATH
+  
+install:
+  - dep ensure
+
+before_install:
+  - wget "https://releases.hashicorp.com/consul/${CONSUL_VER}/consul_${CONSUL_VER}_linux_amd64.zip"
+  - mkdir -p $HOME/bin
+  - unzip -d $HOME/bin consul_${CONSUL_VER}_linux_amd64.zip
+  - wget "https://github.com/golang/dep/releases/download/v$DEP_VER/dep-linux-amd64"
+  - cp dep-linux-amd64 $HOME/bin/dep
+  - chmod 755 $HOME/bin/*
+
+script:
+  - go test
+  - go install

Gopkg.lock

@@ -0,0 +1,38 @@
+# Gopkg.toml example
+#
+# Refer to https://github.com/golang/dep/blob/master/docs/Gopkg.toml.md
+# for detailed Gopkg.toml documentation.
+#
+# required = ["github.com/user/thing/cmd/thing"]
+# ignored = ["github.com/user/project/pkgX", "bitbucket.org/user/project/pkgA/pkgY"]
+#
+# [[constraint]]
+#   name = "github.com/user/project"
+#   version = "1.0.0"
+#
+# [[constraint]]
+#   name = "github.com/user/project2"
+#   branch = "dev"
+#   source = "github.com/myfork/project2"
+#
+# [[override]]
+#   name = "github.com/x/y"
+#   version = "2.4.0"
+#
+# [prune]
+#   non-go = false
+#   go-tests = true
+#   unused-packages = true
+
+
+[[constraint]]
+  name = "github.com/hashicorp/consul"
+  version = "1.0.7"
+
+[[constraint]]
+  name = "github.com/stretchr/testify"
+  version = "1.2.1"
+
+[prune]
+  go-tests = true
+  unused-packages = true

Gopkg.toml

@@ -0,0 +1,55 @@
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Go Report Card](https://goreportcard.com/badge/github.com/myENA/consul-decoder)](https://goreportcard.com/report/github.com/myENA/consul-decoder)
+[![GoDoc](https://godoc.org/github.com/myENA/consul-decoder?status.svg)](https://godoc.org/github.com/myENA/consul-decoder)
+[![Build Status](https://travis-ci.org/myENA/consul-decoder.svg?branch=master)](https://travis-ci.org/myENA/consul-decoder)
+
+
+Package decoder - this unmarshals or decodes values from a consul KV store into a struct. The following types are supported:
+
+* Integer (int/int8/int16/int32/int64)
+* Unsigned (uint/uint8/uint16/uint32/uint64)
+* Float (float64/float32)
+* time.Duration
+* net.IP
+* net.IPMask
+* struct - nested struct by default implies a consul folder with the same name.
+         if the tag modifier "json" is encountered, then the value of in the KV
+         is unmarshaled as json using json.Unmarshal
+
+* slice - the type can be most of the supported types, except another slice.
+* map - the key must be a string, the value can be anything but another map.         
+
+Struct tags
+By default, the decoder packages looks for the struct tag "decoder". However, this can be overridden inside the Decoder struct as shown below. For the purposes of examples, we'll stick with the default "decoder" tag.
+
+
+```go
+
+    struct Foo {
+
+     // populate the value from key "whatever" into FooField1
+     FooField1 string `decoder:"whatever"`
+
+     // skip populating FooField2, "-" signals skip
+     FooField2 string `decoder:"-"`
+
+     // this looks for a folder named FooField3
+     // and maps keys inside to the keys / values of the map.  string
+     // is the only valid key type, though the map value can be most any
+     // of the other types supported by this package.  Notable exception
+     // map, as nested maps are not allowed.  You can, however, have a
+     // map[string]SomeStruct.
+     FooField3 map[string]string
+
+     // this looks for a folder named FooField4 (case insensitive)
+     // this is similar to the map example above, but it ignores the keys
+     // inside and maps the values in-order into the slice.  nested slices
+     // are not allowed, i.e., [][]string.
+     FooField4 []string
+
+     // this interprets the value of foofield5 as json data and
+     // will send it to json.Unmarshal from encoding/json package.
+     FooField5 *SomeStruct `decoder:"foofield5,json"`
+
+}
+```