Merge branch '12737-update-rails-wb'
[arvados.git] / doc / sdk / go / index.html.textile.liquid
index 0e26369b388825e57f77076ef2efd060c5a29e39..75e01d96073f13b226ee15431dbf36cc486c16ac 100644 (file)
@@ -2,64 +2,22 @@
 layout: default
 navsection: sdk
 navmenu: Go
-title: "Go SDK"
-
+title: "Installation"
 ...
+{% comment %}
+Copyright (C) The Arvados Authors. All rights reserved.
 
-The Go ("Golang":http://golang.org) SDK provides a generic set of wrappers so you can make API calls easily.
-
-h3. Installation
-
-You don't need to install anything. Just import the client like this. The go tools will fetch the relevant code and dependencies for you.
-
-<notextile>
-<pre><code class="userinput">import (
-       "git.curoverse.com/arvados.git/sdk/go/keepclient"
-       "git.curoverse.com/arvados.git/sdk/go/arvadosclient"
-)
-</code></pre>
-</notextile>
-
-h3. Examples
+SPDX-License-Identifier: CC-BY-SA-3.0
+{% endcomment %}
 
-Import the module. (We import the log module here too, so we can use it in the subsequent examples.)
-
-<notextile>
-<pre><code class="userinput">import (
-       "git.curoverse.com/arvados.git/sdk/go/keepclient"
-       "git.curoverse.com/arvados.git/sdk/go/arvadosclient"
-       "log"
-)
-</code></pre>
-</notextile>
-
-Set up an API client user agent:
-
-<notextile>
-<pre><code class="userinput">  arv, err := arvadosclient.MakeArvadosClient()
-       if err != nil {
-               log.Fatalf("Error setting up arvados client %s", err.Error())
-       }
-</code></pre>
-</notextile>
-
-Get the User object for the current user:
+The Go ("Golang":http://golang.org) SDK provides a generic set of wrappers so you can make API calls easily.
 
-<notextile>
-<pre><code class="userinput">  type user struct {
-               Uuid         string `json:"uuid"`
-               FullName     int    `json:"full_name"`
-       }
+See "Arvados GoDoc":https://godoc.org/git.curoverse.com/arvados.git/sdk/go for detailed documentation.
 
-       var u user
-       err := arv.Call("GET", "users", "", "current", nil, &u)
+h3. Installation
 
-       if err != nil {
-               return err
-       }
+Use @go get git.curoverse.com/arvados.git/sdk/go/arvadosclient@.  The go tools will fetch the relevant code and dependencies for you.
 
-       log.Printf("Logged in as %s (uuid %s)", user.Uuid, user.FullName)
-</code></pre>
-</notextile>
+<notextile>{% code 'example_sdk_go_imports' as go %}</notextile>
 
-A few more usage examples can be found in the services/keepproxy and sdk/go/keepclient directories in the arvados source tree.
+If you need pre-release client code, you can use the latest version from the repo by following "these instructions.":https://dev.arvados.org/projects/arvados/wiki/Go#Using-Go-with-Arvados