terraform/vendor/github.com/go-chef/chef
Donald Guy 36b4b1acb2 vendor: update go-chef, fixes #8382 2016-08-22 18:58:31 -04:00
..
LICENSE
README.md
acl.go
authentication.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
build.sh
client.go
cookbook.go
databag.go
debug.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
doc.go
environment.go
http.go
node.go
principal.go vendor: update go-chef, fixes #8382 2016-08-22 18:58:31 -04:00
reader.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
release.go
role.go
run_list.go
sandbox.go
search.go Vendor all dependencies w/ Godep 2016-01-29 15:08:48 -06:00
wercker.yml vendor: update go-chef, fixes #8382 2016-08-22 18:58:31 -04:00

README.md

Stories in Ready Build Status Coverage Status

Chef Server API Client Library in Golang

This is a Library that you can use to write tools to interact with the chef server.

Install

go get github.com/go-chef/chef

Test

go get -t github.com/go-chef/chef
go test -v github.com/go-chef/chef

SSL

If you run into an SSL verification problem when trying to connect to a ssl server with self signed certs setup your config object with SkipSSL: true

Usage

This example is setting up a basic client that you can use to interact with all the service endpoints (clients, nodes, cookbooks, etc.) More usage examples can be found in the examples directory.

 package main
 
 import (
 	"encoding/json"
 	"fmt"
 	"io/ioutil"
 	"log"
 	"os"
 
 	"github.com/go-chef/chef"
 )
 
 func main() {
 	// read a client key
 	key, err := ioutil.ReadFile("key.pem")
 	if err != nil {
 		fmt.Println("Couldn't read key.pem:", err)
     os.Exit(1)
   }
 
 	// build a client
 	client, err := chef.NewClient(&chef.Config{
 		Name: "foo",
 		Key:  string(key),
 		// goiardi is on port 4545 by default. chef-zero is 8889
 		BaseURL: "http://localhost:4545",
 	})
 	if err != nil {
 		fmt.Println("Issue setting up client:", err)
   }
 
   // List Cookbooks
   cookList, err := client.Cookbooks.List()
   if err != nil {
     fmt.Println("Issue listing cookbooks:", err)
   }
 
   // Print out the list
   fmt.Println(cookList)
 }

CONTRIBUTING

If you feel like contributing, great! Just fork the repo, make your improvements, and submit a pull request. Tests would, of course, be appreciated. Adding tests where there are no tests currently would be even more appreciated. At least, though, try and not break anything worse than it is. Test coverage has improved, but is still an ongoing concern.

AUTHORS

Jesse Nelson @spheromak
AJ Christensen @fujin
Brad Beam @bradbeam
Kraig Amador @bigkraig

Copyright 2013-2014, Jesse Nelson

LICENSE

Like many Chef ecosystem programs, go-chef/chef is licensed under the Apache 2.0 License. See the LICENSE file for details.

Chef is copyright (c) 2008-2014 Chef, Inc. and its various contributors.

Thanks go out to the fine folks of Opscode and the Chef community for all their hard work.