Go Driver

Current version: v0.1.3. Released Jun 13, 2022

The Cloud CMS Go driver allows you to easily connect your Go applications to the Cloud CMS server.

Currently supports the following functionality:

• Connect to and refresh access tokens with the API
• Read platform, branches, repositories, projects, releases
• Read, query, search, create, update, and delete nodes
• Manage node translations, versions, associations, attachments
• Make graphql queries
• And more!

Installation

Install this driver using the go cli:

go get github.com/gitana/cloudcms-go-driver

Connecting to Cloud CMS

To connect to Cloud CMS, use one of the functions cloudcms.ConnectDefault or cloudcms.Connect. ConnectDefault looks for a gitana.json file in your working directory, where as Connect allows you to pass the required authentication settings

The required API key properties for this are:

• clientKey
• clientSecret
• username
• password
• baseURL

You can also provide the flag debug: true in your gitana.json / cloudcms config object to provide additional request logging.

Connection Examples:

            
// Connect to CloudCMS using gitana.json in working directory
session, err := cloudcms.ConnectDefault()
if err != nil {
    fmt.Println(err)
    return
}]

session, err = cloudcms.Connect(&cloudcms.CloudcmsConfig{
    Client_id: "clientId",
	Client_secret: "clientSecret",
	Username: "username",
	Password: "password",
	BaseURL: "baseURL",
})

            
        

Examples

Below are some examples of how you might use the driver:

            
package main

import (
    "github.com/gitana/cloudcms-go-driver"
)

func main() {
    // Connect to CloudCMS using gitana.json in working directory
    session, err := cloudcms.ConnectDefault()
    if err != nil {
        fmt.Println(err)
        return
    }

    var repositoryId string


    // List branches
    branches, _ := session.ListBranches(repositoryId, nil)

    // Read branch
    branchId := "master"
    branch, _ := session.ReadBranch(repositoryId, branchId)

    // Read Node
    node, _ := session.ReadNode(repositoryId, branchId, nodeId)

    // Create Node
    nodeObj := cloudcms.JsonObject{
        "title": "Twelfth Night",
        "description": "An old play",
    }
    nodeId, _ := session.createNode(repositoryId, branchId, nodeObj, nil)

    // Query Nodes
    query := cloudcms.JsonObject{
        "_type": "store:book",
    }
    pagination := cloudcms.JsonObject{
        "limit": 1,
    }
    queriedNodes, _ session.QueryNodes(repositoryId, branchId, query, pagination)

    // Find Nodes
    find := cloudcms.JsonObject{
        "search": "Shakespeare",
        "query": JsonObject{
            "_type": "store:book",
        }
    }
    findNodes, _ := session.FindNodes(repositoryId, branchId, find ,nil)
}