Merge pull request #85 from rahul1995/go-image-upload

Add Go image upload example

Author: colbyfayock

examples/go-image-upload/.env.sample

@@ -0,0 +1 @@
+CLOUDINARY_URL=cloudinary://<API_KEY>:<API_SECRET>@<CLOUD_NAME>

examples/go-image-upload/README.md

@@ -0,0 +1,45 @@
+# Uploading Images to Cloudinary with the Go SDK
+
+## 🧰 Uploading with the SDK in a Go project
+
+To use the SDK in a Go project, first configure a new instance of Cloudinary:
+
+```
+cld, err := cloudinary.New() // CLOUDINARY_URL environment variable should already be set
+OR
+cld, err := NewFromParams(cloud_name, api_key, api_secret)
+```
+
+Then, customize upload behaviour by configuring UploadParams
+
+```
+// can be left empty if default behaviour is needed
+uploadParams := uploader.UploadParams{
+    UseFilename:              api.Bool(true),
+    UseFilenameAsDisplayName: api.Bool(true),
+    UniqueFilename:           api.Bool(false),
+}
+```
+
+Finally, run the upload method, passing in your image source:
+
+```
+filePath := "./path/to/image.jpg" // Can be a remote URL or base64 DataURI as well
+res, err := cld.Upload.Upload(context.Background(), filepath, uploadParams)
+```
+
+## 🚀 Get Started with This Example
+
+* Create an environment variable file `.env` and inside add:
+```
+CLOUDINARY_URL="cloudinary://<API_KEY>:<API_SECRET>@<CLOUD_NAME>"
+```
+
+
+* Run the Go script from project directory, i.e. inside the `examples/go-image-upload` directory:
+
+```
+go run .
+```
+
+The script will run in your terminal and you'll see the URL results logged.

examples/go-image-upload/go.mod

@@ -0,0 +1,11 @@
+module image_upload
+
+go 1.21.2
+
+require (
+	github.com/cloudinary/cloudinary-go/v2 v2.5.1 // indirect
+	github.com/creasty/defaults v1.5.1 // indirect
+	github.com/google/uuid v1.2.0 // indirect
+	github.com/gorilla/schema v1.2.0 // indirect
+	github.com/joho/godotenv v1.5.1 // indirect
+)

examples/go-image-upload/go.sum

@@ -0,0 +1,19 @@
+github.com/cloudinary/cloudinary-go/v2 v2.5.1 h1:RZKSfrmYHwXVTKAnjr2dibzpu7ox2QLtoSF/xVznLvM=
+github.com/cloudinary/cloudinary-go/v2 v2.5.1/go.mod h1:jtSxa6xbzvu4IwChRJVDcXwVXrTRczhbvq3Z1VSoFdk=
+github.com/creasty/defaults v1.5.1 h1:j8WexcS3d/t4ZmllX4GEkl4wIB/trOr035ajcLHCISM=
+github.com/creasty/defaults v1.5.1/go.mod h1:FPZ+Y0WNrbqOVw+c6av63eyHUAl6pMHZwqLPvXUZGfY=
+github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/go-test/deep v1.0.7/go.mod h1:QV8Hv/iy04NyLBxAdO9njL0iVPN1S4d/A3NVv1V36o8=
+github.com/google/uuid v1.1.2/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/google/uuid v1.2.0 h1:qJYtXnJRWmpe7m/3XlyhrsLrEURqHRM2kxzoxXqyUDs=
+github.com/google/uuid v1.2.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/gorilla/schema v1.2.0 h1:YufUaxZYCKGFuAq3c96BOhjgd5nmXiOY9NGzF247Tsc=
+github.com/gorilla/schema v1.2.0/go.mod h1:kgLaKoK1FELgZqMAVxx/5cbj0kT+57qxUrAlIO2eleU=
+github.com/heimdalr/dag v1.0.1/go.mod h1:t+ZkR+sjKL4xhlE1B9rwpvwfo+x+2R0363efS+Oghns=
+github.com/joho/godotenv v1.5.1 h1:7eLL/+HRGLY0ldzfGMeQkb7vMd0as4CfYvUVzLqw0N0=
+github.com/joho/godotenv v1.5.1/go.mod h1:f4LDr5Voq0i2e/R5DDNOoa2zzDfwtkZa6DnEwAbqwq4=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
+github.com/stretchr/testify v1.6.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

examples/go-image-upload/images/aldebaran-s-uXchDIKs4qI-unsplash.jpg

@@ -0,0 +1,58 @@
+package main
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+
+	"github.com/cloudinary/cloudinary-go/v2"
+	"github.com/cloudinary/cloudinary-go/v2/api"
+	"github.com/cloudinary/cloudinary-go/v2/api/uploader"
+
+	"github.com/joho/godotenv"
+)
+
+func main() {
+	if err := godotenv.Load(); err != nil {
+		fmt.Println("Error loading .env file")
+		return
+	}
+
+	cld, err := cloudinary.New()
+	if err != nil {
+		fmt.Println("Error in creating Cloudinary instance", err)
+		return
+	}
+
+	filePaths := []string{
+		"./images/aldebaran-s-uXchDIKs4qI-unsplash.jpg",
+		"./images/brian-mcgowan-I0fDR8xtApA-unsplash.jpg",
+		"./images/spacex-OHOU-5UVIYQ-unsplash.jpg",
+		"./images/spacex-VBNb52J8Trk-unsplash.jpg",
+		"./images/stellan-johansson-1PP0Fc-KSd4-unsplash.jpg",
+		"https://images.unsplash.com/photo-1451187863213-d1bcbaae3fa3?ixlib=rb-4.0.3&ixid=MnwxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8&auto=format&fit=crop&w=880&q=80",
+	}
+
+	for _, filepath := range filePaths {
+		uploadParams := uploader.UploadParams{
+			UseFilename:              api.Bool(true),
+			UseFilenameAsDisplayName: api.Bool(true),
+			UniqueFilename:           api.Bool(false),
+		}
+
+		res, err := cld.Upload.Upload(context.Background(), filepath, uploadParams)
+
+		if err != nil {
+			fmt.Println("failed to upload file", err)
+			continue
+		}
+		fmt.Println("Successfully uploaded", filepath)
+
+		jsonRes, err := json.MarshalIndent(res, "", "  ")
+		if err != nil {
+			fmt.Println("Could not format result in JSON")
+			fmt.Println("Upload result -", res)
+		}
+		fmt.Println("Upload result -", string(jsonRes))
+	}
+}