cloudinary.go

package cloudinary

import (
	"github.com/cloudinary/cloudinary-go/v2/api/admin"
	"github.com/cloudinary/cloudinary-go/v2/api/admin/search"
	"github.com/cloudinary/cloudinary-go/v2/api/uploader"
	"github.com/cloudinary/cloudinary-go/v2/asset"
	"github.com/cloudinary/cloudinary-go/v2/config"
	"github.com/cloudinary/cloudinary-go/v2/logger"
)

// Cloudinary main struct
type Cloudinary struct {
	Config config.Configuration
	Admin  admin.API
	Upload uploader.API
	Logger *logger.Logger
}

// New returns a new Cloudinary instance from environment variable.
func New() (*Cloudinary, error) {
	c, err := config.New()
	if err != nil {
		return nil, err
	}

	return NewFromConfiguration(*c)
}

// NewFromURL returns a new Cloudinary instance from a cloudinary url.
func NewFromURL(cloudinaryURL string) (*Cloudinary, error) {
	c, err := config.NewFromURL(cloudinaryURL)
	if err != nil {
		return nil, err
	}
	return NewFromConfiguration(*c)
}

// NewFromParams returns a new Cloudinary instance from the provided parameters.
func NewFromParams(cloud string, key string, secret string) (*Cloudinary, error) {
	c, err := config.NewFromParams(cloud, key, secret)
	if err != nil {
		return nil, err
	}
	return NewFromConfiguration(*c)
}

// NewFromOAuthToken returns a new Cloudinary instance from the provided cloud name and OAuth token.
func NewFromOAuthToken(cloud string, oAuthToken string) (*Cloudinary, error) {
	c, err := config.NewFromOAuthToken(cloud, oAuthToken)
	if err != nil {
		return nil, err
	}
	return NewFromConfiguration(*c)
}

// NewFromConfiguration returns a new Cloudinary instance from the provided configuration.
func NewFromConfiguration(configuration config.Configuration) (*Cloudinary, error) {
	log := logger.New()

	return &Cloudinary{
		Config: configuration,
		Admin: admin.API{
			Config: configuration,
			Logger: log,
		},
		Upload: uploader.API{
			Config: configuration,
			Logger: log,
		},
		Logger: log,
	}, nil
}

// Image creates a new asset.Image instance.
func (c Cloudinary) Image(publicID string) (*asset.Asset, error) {
	return asset.Image(publicID, &c.Config)
}

// Video creates a new asset.Video instance.
func (c Cloudinary) Video(publicID string) (*asset.Asset, error) {
	return asset.Video(publicID, &c.Config)
}

// File creates a new asset.File instance.
func (c Cloudinary) File(publicID string) (*asset.Asset, error) {
	return asset.File(publicID, &c.Config)
}

// Media creates a new asset.Media instance.
func (c Cloudinary) Media(publicID string) (*asset.Asset, error) {
	return asset.Media(publicID, &c.Config)
}

// SearchURL creates a new asset.SearchURL instance.
func (c Cloudinary) SearchURL(query search.Query) (*asset.SearchURLAsset, error) {
	return asset.SearchURL(query, &c.Config)
}