https://github.com/ncw/dropbox
Go (golang) client library for the Dropbox core and Datastore API with support for uploading and downloading encrypted files.
https://github.com/ncw/dropbox
Last synced: over 1 year ago
JSON representation
Go (golang) client library for the Dropbox core and Datastore API with support for uploading and downloading encrypted files.
- Host: GitHub
- URL: https://github.com/ncw/dropbox
- Owner: ncw
- License: bsd-2-clause
- Created: 2014-07-13T09:25:00.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2017-05-22T19:35:23.000Z (about 9 years ago)
- Last Synced: 2024-06-19T06:49:21.741Z (about 2 years ago)
- Language: Go
- Homepage:
- Size: 65.4 KB
- Stars: 10
- Watchers: 6
- Forks: 26
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
dropbox
=======
Go client library for the Dropbox core and Datastore API with support for uploading and downloading encrypted files.
Support of the Datastore API should be considered as a beta version.
Prerequisite
------------
To use this library, you must have a valid client ID (app key) and client secret (app secret) provided by Dropbox.
To register a new client application, please visit https://www.dropbox.com/developers/apps/create
Installation
------------
This library depends on the oauth2 package, it can be installed with the go get command:
$ go get golang.org/x/oauth2
This package can be installed with the go get command:
$ go get github.com/stacktic/dropbox
Examples
--------
This simple 4-step example will show you how to create a folder:
package main
import (
"dropbox"
"fmt"
)
func main() {
var err error
var db *dropbox.Dropbox
var clientid, clientsecret string
var token string
clientid = "xxxxx"
clientsecret = "yyyyy"
token = "zzzz"
// 1. Create a new dropbox object.
db = dropbox.NewDropbox()
// 2. Provide your clientid and clientsecret (see prerequisite).
db.SetAppInfo(clientid, clientsecret)
// 3. Provide the user token.
db.SetAccessToken(token)
// 4. Send your commands.
// In this example, you will create a new folder named "demo".
folder := "demo"
if _, err = db.CreateFolder(folder); err != nil {
fmt.Printf("Error creating folder %s: %s\n", folder, err)
} else {
fmt.Printf("Folder %s successfully created\n", folder)
}
}
If you do not know the user token, you can replace step 3 by a call to the Auth method:
// This method will ask the user to visit an URL and paste the generated code.
if err = db.Auth(); err != nil {
fmt.Println(err)
return
}
// You can now retrieve the token if you want.
token = db.AccessToken()
If you want a more complete example, please check the following project: https://github.com/stacktic/dbox.
Documentation
-------------
API documentation can be found here: http://godoc.org/github.com/stacktic/dropbox.