12573: Update documentation describing interpretation of priority

[arvados.git] / doc / sdk / go / example.html.textile.liquid

diff --git a/doc/sdk/go/example.html.textile.liquid b/doc/sdk/go/example.html.textile.liquid
index 903d367733e89cec7447ec7cf91e0412c0d9e214..a5a109b85b8673676919b9c5e9497761e27919aa 100644 (file)
--- a/doc/sdk/go/example.html.textile.liquid
+++ b/doc/sdk/go/example.html.textile.liquid
@@ -2,34 +2,80 @@
 layout: default
 navsection: sdk
 navmenu: Python
-title: Python SDK examples
+title: Examples
 ...
+{% comment %}
+Copyright (C) The Arvados Authors. All rights reserved.
+
+SPDX-License-Identifier: CC-BY-SA-3.0
+{% endcomment %}
+
+See "Arvados GoDoc":https://godoc.org/git.curoverse.com/arvados.git/sdk/go for detailed documentation.
+
+In these examples, the site prefix is @aaaaa@.
+
+h2.  Initialize SDK
+
+{% codeblock as go %}
+import (
+  "git.curoverse.com/arvados.git/sdk/go/arvados"
+  "git.curoverse.com/arvados.git/sdk/go/arvadosclient"
+}
+
+func main() {
+  arv, err := arvadosclient.MakeArvadosClient()
+  if err != nil {
+    log.Fatalf("Error setting up arvados client %s", err.Error())
+  }
+}
+{% endcodeblock %}
 
 h2. create
 
-<pre>
+{% codeblock as go %}
   var collection arvados.Collection
-  err := api.Create("collection", Dict{"collection": Dict{"name": "create example"}}, &collection)
-</pre>
+  err := api.Create("collections", Dict{"collection": Dict{"name": "create example"}}, &collection)
+{% endcodeblock %}
 
 h2. delete
 
-<pre>
+{% codeblock as go %}
   var collection arvados.Collection
-  err := api.Delete("collection", "", Dict{"collection": Dict{"name": "create example"}}, &collection)
-</pre>
+  err := api.Delete("collections", "aaaaa-4zz18-ccccccccccccccc", Dict{}, &collection)
+{% endcodeblock %}
 
 h2. get
 
-<pre>
-</pre>
+{% codeblock as go %}
+  var collection arvados.Collection
+  err := api.Get("collections", "aaaaa-4zz18-ccccccccccccccc", Dict{}, &collection)
+{% endcodeblock %}
 
 h2. list
 
-<pre>
-</pre>
+{% codeblock as go %}
+  var collection arvados.Collection
+  err := api.List("collections", Dict{}, &collection)
+{% endcodeblock %}
 
 h2. update
 
-<pre>
-</pre>
+{% codeblock as go %}
+  var collection arvados.Collection
+  err := api.Update("collections", "aaaaa-4zz18-ccccccccccccccc", Dict{"collection": Dict{"name": "update example"}}, &collection)
+{% endcodeblock %}
+
+h2. Get current user
+
+{% codeblock as go %}
+  var user arvados.User
+  err := api.Get("users", "current", Dict{}, &user)
+{% endcodeblock %}
+
+h2. Example program
+
+You can save this source as a .go file and run it:
+
+<notextile>{% code 'example_sdk_go' as go %}</notextile>
+
+A few more usage examples can be found in the "services/keepproxy":https://dev.arvados.org/projects/arvados/repository/revisions/master/show/services/keepproxy and "sdk/go/keepclient":https://dev.arvados.org/projects/arvados/repository/revisions/master/show/sdk/go/keepclient directories in the arvados source tree.