Add basic example

Author: Piszmog

README.md

@@ -53,6 +53,7 @@ configurations
     1. Call `LocalEnv()`. Set the environment variable `CONFIG_SERVER_URLS`. It is a comma separated list of all the
        base URLs
     2. Call `Local(baseUrls ...string)`. Provide the array of base URLs of Config Servers.
+* If the config server is protected with basic auth, call `Basic` with the username and password.
 * For running in Cloud Foundry, ensure a Config Server is bounded to the application. `VCAP_SERVICES` will be provided
   as an environment variables with the credentials to access the Config Server
 * For connecting to a Config Server via OAuth2 and not deployed to Cloud Foundry, an OAuth2 Client can be created
@@ -80,6 +81,8 @@ func main() {
 	configClient, err := cloudconfigclient.New(cloudconfigclient.LocalEnv(&http.Client{}))
 	// Or
 	configClient, err = cloudconfigclient.New(cloudconfigclient.Local(&http.Client{}, "http://localhost:8888"))
+	// or to create a Client for a Spring Config Server using Basic Authentication
+	configClient, err = cloudconfigclient.New(cloudconfigclient.Basic(&http.Client{}, "username", "password" "http://localhost:8888"))
 	// or to create a Client for a Spring Config Server in Cloud Foundry
 	configClient, err = cloudconfigclient.New(cloudconfigclient.DefaultCFService())
 	// or to create a Client for a Spring Config Server with OAuth2

examples/basic/main.go

@@ -0,0 +1,62 @@
+package main
+
+import (
+	"fmt"
+	"log"
+	"net/http"
+	"strings"
+
+	"github.com/Piszmog/cloudconfigclient/v2"
+)
+
+func main() {
+	// ensure you have the Config Server running locally...
+	client, err := cloudconfigclient.New(cloudconfigclient.Basic(&http.Client{}, "username", "password", "http://localhost:8888"))
+	if err != nil {
+		log.Fatalln(err)
+	}
+
+	// load a config file
+	configuration, err := client.GetConfiguration("test-app", "local")
+	if err != nil {
+		log.Fatalln(err)
+	}
+	// we can either unmarshal into a struct
+	var configData configStruct
+	if err = configuration.Unmarshal(&configData); err != nil {
+		log.Fatalln("failed to find cloud property file")
+	}
+
+	// or manually access the values
+	localProp, err := configuration.GetPropertySource("application-local.yml")
+	if err != nil {
+		log.Fatalln("failed to find local property file")
+	}
+	fmt.Printf("local property file: %+v\n", localProp)
+	// handle all config properties
+	configuration.HandlePropertySources(func(propertySource cloudconfigclient.PropertySource) {
+		if strings.HasSuffix(propertySource.Name, "test-app.properties") {
+			// TODO save off values
+		}
+	})
+
+	// load a specific file (e.g. json/txt)
+	var f map[string]string
+	// if 'fooDir' has been added to 'searchPaths' in SCS v3.x, then pass "" (blank) for directory
+	if err = client.GetFile("fooDir", "bar.json", &f); err != nil {
+		log.Fatalln(err)
+	}
+	fmt.Printf("file from default branch: %+v\n", f)
+
+	// load a specific file (e.g. json/txt)
+	var b map[string]string
+	// if 'fooDir' has been added to 'searchPaths' in SCS v3.x, then pass "" (blank) for directory
+	if err = client.GetFileFromBranch("develop", "fooDir", "bar.json", &b); err != nil {
+		log.Fatalln(err)
+	}
+	fmt.Printf("file from specific branch: %+v\n", b)
+}
+
+type configStruct struct {
+	Field1 string `json:"field1"`
+}

examples/cloudfoundry/main.go

@@ -11,7 +11,6 @@ import (
 func main() {
 	// ensure you have set the environment variable 'VCAP_SERVICES' that contains the information to connect to the
 	// Config Server
-
 	client, err := cloudconfigclient.New(cloudconfigclient.DefaultCFService())
 	if err != nil {
 		log.Fatalln(err)

examples/local/main.go

@@ -11,7 +11,6 @@ import (
 
 func main() {
 	// ensure you have the Config Server running locally...
-
 	client, err := cloudconfigclient.New(cloudconfigclient.Local(&http.Client{}, "http://localhost:8888"))
 	if err != nil {
 		log.Fatalln(err)

examples/oauth/main.go

@@ -10,7 +10,6 @@ import (
 
 func main() {
 	// ensure you have the Config Server running locally (or in the cloud) and configured for OAuth2
-
 	client, err := cloudconfigclient.New(cloudconfigclient.OAuth2("config server uri", "client id",
 		"client secret", "access token uri"))
 	if err != nil {