drive

package
v0.1.8 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 14, 2015 License: Apache-2.0 Imports: 30 Imported by: 0

Documentation

Index

Constants

View Source
const (
	Barely = iota
	AlmostExceeded
	HalfwayExceeded
	Exceeded
	Unknown
)
View Source
const (
	AboutNone = 1 << iota
	AboutQuota
	AboutFileSizes
	AboutFeatures
)
View Source
const (
	SelectSrc = 1 << iota
	SelectDest
)
View Source
const (
	AboutKey      = "about"
	AllKey        = "all"
	CopyKey       = "copy"
	DiffKey       = "diff"
	EmptyTrashKey = "emptytrash"
	FeaturesKey   = "features"
	HelpKey       = "help"
	InitKey       = "init"
	LinkKey       = "Link"
	ListKey       = "list"
	MoveKey       = "move"
	OSLinuxKey    = "linux"
	PullKey       = "pull"
	PushKey       = "push"
	PubKey        = "pub"
	RenameKey     = "rename"
	QuotaKey      = "quota"
	ShareKey      = "share"
	StatKey       = "stat"
	TouchKey      = "touch"
	TrashKey      = "trash"
	UnshareKey    = "unshare"
	UntrashKey    = "untrash"
	UnpubKey      = "unpub"
	VersionKey    = "version"

	ForceKey         = "force"
	QuietKey         = "quiet"
	QuitShortKey     = "q"
	QuitLongKey      = "quit"
	DriveRepoRelPath = "github.com/odeke-em/drive"
)
View Source
const (
	DescAbout          = "print out information about your Google drive"
	DescAll            = "print out the entire help section"
	DescCopy           = "copy remote paths to a destination"
	DescDiff           = "compares local files with their remote equivalent"
	DescEmptyTrash     = "permanently cleans out your trash"
	DescFeatures       = "returns information about the features of your drive"
	DescHelp           = "Get help for a topic"
	DescInit           = "initializes a directory and authenticates user"
	DescList           = "lists the contents of remote path"
	DescMove           = "move files/folders"
	DescQuota          = "prints out information related to your quota space"
	DescPublish        = "publishes a file and prints its publicly available url"
	DescRename         = "renames a file/folder"
	DescPull           = "pulls remote changes from Google Drive"
	DescPush           = "push local changes to Google Drive"
	DescShare          = "share files with specific emails giving the specified users specifies roles and permissions"
	DescStat           = "display information about a file"
	DescTouch          = "updates a remote file's modification time to that currently on the server"
	DescTrash          = "moves files to trash"
	DescUnshare        = "revoke a user's access to a file"
	DescUntrash        = "restores files from trash to their original locations"
	DescUnpublish      = "revokes public access to a file"
	DescVersion        = "prints the version"
	DescAccountTypes   = "\n\t* anyone.\n\t* user.\n\t* domain.\n\t* group"
	DescRoles          = "\n\t* owner.\n\t* reader.\n\t* writer.\n\t* commenter."
	DescIgnoreChecksum = "avoids computation of checksums as a final check." +
		"\nUse cases may include:\n\t* when you are low on bandwidth e.g SSHFS." +
		"\n\t* Are on a low power device"
	DescIgnoreConflict = "turns off the conflict resolution safety"
)
View Source
const (
	CLIOptionIgnoreChecksum = "ignore-checksum"
	CLIOptionIgnoreConflict = "ignore-conflict"
)
View Source
const (
	InTrash = 1 << iota
	Folder
	NonFolder
	Minimal
	Shared
	Owners
	CurrentVersion
)
View Source
const (
	MimeTypeJoiner      = "-"
	RemoteDriveRootPath = "My Drive"
)
View Source
const (
	// Google OAuth 2.0 service URLs
	GoogleOAuth2AuthURL  = "https://accounts.google.com/o/oauth2/auth"
	GoogleOAuth2TokenURL = "https://accounts.google.com/o/oauth2/token"

	// OAuth 2.0 OOB redirect URL for authorization.
	RedirectURL = "urn:ietf:wg:oauth:2.0:oob"

	// OAuth 2.0 full Drive scope used for authorization.
	DriveScope = "https://www.googleapis.com/auth/drive"

	// OAuth 2.0 access type for offline/refresh access.
	AccessType = "offline"

	// Google Drive webpage host
	DriveResourceHostURL = "https://googledrive.com/host/"
)
View Source
const (
	OptNone = 1 << iota
	OptConvert
	OptOCR
	OptUpdateViewedDate
	OptContentAsIndexableText
	OptPinned
	OptNewRevision
)
View Source
const (
	UnknownAccountType = 1 << iota
	Anyone
	User
	Domain
	Group
)
View Source
const (
	UnknownRole = 1 << iota
	Owner
	Reader
	Writer
	Commenter
)
View Source
const (
	NoopOnShare = 1 << iota
	Notify
)
View Source
const (
	OpNone = iota
	OpAdd
	OpDelete
	OpMod
	OpModConflict
)
View Source
const (
	DifferNone    = 0
	DifferDirType = 1 << iota
	DifferMd5Checksum
	DifferModTime
	DifferSize
)
View Source
const (
	DriveFolderMimeType = "application/vnd.google-apps.folder"
)
View Source
const (
	DriveIgnoreSuffix = ".driveignore"
)
View Source
const MaxFileSize = 50 * 1024 * 1024

MaxFileSize is the max number of bytes we can accept for diffing (Arbitrary value)

View Source
const Version = "0.1.7"

Variables

View Source
var (
	UnescapedPathSep = fmt.Sprintf("%c", os.PathSeparator)
	EscapedPathSep   = url.QueryEscape(UnescapedPathSep)
)
View Source
var Aliases = map[string][]string{
	CopyKey: []string{"cp"},
	ListKey: []string{"ls"},
	MoveKey: []string{"mv"},
}
View Source
var BigFileSize = int64(1024 * 1024 * 400)

Arbitrary value. TODO: Get better definition of BigFileSize.

View Source
var BytesPerKB = float64(1024)
View Source
var (
	ErrNoContext = errors.New("not in a drive context")
)
View Source
var ErrPathNotDir = errors.New("not a directory")
View Source
var (
	ErrPathNotExists = errors.New("remote path doesn't exist")
)
View Source
var Ruler = strings.Repeat("*", 4)

Functions

func NonEmptyStrings

func NonEmptyStrings(v []string) (splits []string)

func PrintVersion

func PrintVersion()

func RetrieveRefreshToken

func RetrieveRefreshToken(context *config.Context) (string, error)

func ShowAllDescriptions

func ShowAllDescriptions()

func ShowDescription

func ShowDescription(topic string)

Types

type AccountType

type AccountType int

func (*AccountType) String

func (a *AccountType) String() string

type ByPrecedence

type ByPrecedence []*Change

func (ByPrecedence) Len

func (cl ByPrecedence) Len() int

func (ByPrecedence) Less

func (cl ByPrecedence) Less(i, j int) bool

func (ByPrecedence) Swap

func (cl ByPrecedence) Swap(i, j int)

type Change

type Change struct {
	Dest           *File
	Parent         string
	Path           string
	Src            *File
	Force          bool
	NoClobber      bool
	IgnoreConflict bool
	IgnoreChecksum bool
}

func (*Change) Op

func (c *Change) Op() Operation

func (*Change) Symbol

func (c *Change) Symbol() string

type Commands

type Commands struct {
	// contains filtered or unexported fields
}

func New

func New(context *config.Context, opts *Options) *Commands

func (*Commands) About

func (g *Commands) About(mask int) (err error)

func (*Commands) Copy

func (g *Commands) Copy() error

func (*Commands) Diff

func (g *Commands) Diff() (err error)

func (*Commands) EmptyTrash

func (g *Commands) EmptyTrash() error

func (*Commands) Init

func (g *Commands) Init() (err error)

func (*Commands) List

func (g *Commands) List() (err error)

func (*Commands) ListMatches added in v0.1.7

func (g *Commands) ListMatches() error

func (*Commands) Move

func (g *Commands) Move() (err error)

func (*Commands) Publish

func (c *Commands) Publish() (err error)

func (*Commands) Pull

func (g *Commands) Pull() (err error)

Pull from remote if remote path exists and in a god context. If path is a directory, it recursively pulls from the remote if there are remote changes. It doesn't check if there are remote changes if isForce is set.

func (*Commands) PullMatches added in v0.1.7

func (g *Commands) PullMatches() (err error)

func (*Commands) PullPiped

func (g *Commands) PullPiped() (err error)

func (*Commands) Push

func (g *Commands) Push() (err error)

Pushes to remote if local path exists and in a gd context. If path is a directory, it recursively pushes to the remote if there are local changes. It doesn't check if there are local changes if isForce is set.

func (*Commands) PushPiped

func (g *Commands) PushPiped() (err error)

func (*Commands) QuotaStatus

func (g *Commands) QuotaStatus(query int64) (status int, err error)

func (*Commands) Rename

func (g *Commands) Rename() error

func (*Commands) Share

func (c *Commands) Share() (err error)

func (*Commands) Stat

func (g *Commands) Stat() error

func (*Commands) Touch

func (g *Commands) Touch() (err error)

func (*Commands) TouchByMatch

func (g *Commands) TouchByMatch() (err error)

func (*Commands) Trash

func (g *Commands) Trash() (err error)

func (*Commands) TrashByMatch

func (g *Commands) TrashByMatch() error

func (*Commands) Unpublish

func (c *Commands) Unpublish() error

func (*Commands) Unshare

func (c *Commands) Unshare() (err error)

func (*Commands) Untrash

func (g *Commands) Untrash() (err error)

func (*Commands) UntrashByMatch

func (g *Commands) UntrashByMatch() error

type File

type File struct {
	// AlternateLink opens the file in a relevant Google editor or viewer
	AlternateLink string
	BlobAt        string
	// Copyable decides if the user has allowed for the file to be copied
	Copyable    bool
	ExportLinks map[string]string
	Id          string
	IsDir       bool
	Md5Checksum string
	MimeType    string
	ModTime     time.Time
	Name        string
	Size        int64
	Etag        string
	Shared      bool
	// UserPermission contains the permissions for the authenticated user on this file
	UserPermission *drive.Permission
	// CacheChecksum when set avoids recomputation of checksums
	CacheChecksum bool
	// Monotonically increasing version number for the file
	Version int64
	// The onwers of this file.
	OwnerNames []string
	// Permissions contains the overall permissions for this file
	Permissions []*drive.Permission
}

func DupFile

func DupFile(f *File) *File

func NewLocalFile

func NewLocalFile(absPath string, f os.FileInfo) *File

func NewRemoteFile

func NewRemoteFile(f *drive.File) *File

func (*File) ToIndex

func (f *File) ToIndex() *config.Index

type Operation added in v0.1.8

type Operation int

type Options

type Options struct {
	// Depth is the number of pages/ listing recursion depth
	Depth int
	// Exports contains the formats to export your Google Docs + Sheets to
	// e.g ["csv" "txt"]
	Exports []string
	// Directory to put the exported Google Docs + Sheets, if not
	// provided will export them to the same dir as the source files are.
	ExportsDir string
	// Force once set always converts NoChange into an Addition
	Force bool
	// Hidden discovers hidden paths if set
	Hidden       bool
	IgnoreRegexp *regexp.Regexp
	// IgnoreChecksum when set avoids the step
	// of comparing checksums as a final check.
	IgnoreChecksum bool
	// IgnoreConflict when set turns off the conflict resolution safety.
	IgnoreConflict bool
	// Allows listing of content in trash
	InTrash bool
	Meta    *map[string][]string
	Mount   *config.Mount
	// NoClobber when set prevents overwriting of stale content
	NoClobber bool
	// NoPrompt overwrites any prompt pauses
	NoPrompt bool
	Path     string
	// PageSize determines the number of results returned per API call
	PageSize  int64
	Recursive bool
	// Sources is a of list all paths that are
	// within the scope/path of the current gd context
	Sources []string
	// TypeMask contains the result of setting different type bits e.g
	// Folder to search only for folders etc.
	TypeMask int
	// Piped when set means to infer content to or from stdin
	Piped bool
	// Quiet when set toggles only logging of errors to stderrs as
	// well as reading from stdin in this case stdout is not logged to
	Quiet       bool
	StdoutIsTty bool
}

type Remote

type Remote struct {
	// contains filtered or unexported fields
}

func NewRemoteContext

func NewRemoteContext(context *config.Context) *Remote

func (*Remote) About

func (r *Remote) About() (about *drive.About, err error)

func (*Remote) Download

func (r *Remote) Download(id string, exportURL string) (io.ReadCloser, error)

func (*Remote) EmptyTrash

func (r *Remote) EmptyTrash() error

func (*Remote) FindById

func (r *Remote) FindById(id string) (file *File, err error)

func (*Remote) FindByParentId

func (r *Remote) FindByParentId(parentId string, hidden bool) chan *File

func (*Remote) FindByParentIdTrashed

func (r *Remote) FindByParentIdTrashed(parentId string, hidden bool) chan *File

func (*Remote) FindByPath

func (r *Remote) FindByPath(p string) (file *File, err error)

func (*Remote) FindByPathShared

func (r *Remote) FindByPathShared(p string) (chan *File, error)

func (*Remote) FindByPathTrashed

func (r *Remote) FindByPathTrashed(p string) (file *File, err error)

func (*Remote) FindMatches

func (r *Remote) FindMatches(dirPath string, keywords []string, inTrash bool) (chan *File, error)

func (*Remote) Publish

func (r *Remote) Publish(id string) (string, error)

func (*Remote) Touch

func (r *Remote) Touch(id string) (*File, error)

func (*Remote) Trash

func (r *Remote) Trash(id string) error

func (*Remote) Unpublish

func (r *Remote) Unpublish(id string) error

func (*Remote) Untrash

func (r *Remote) Untrash(id string) error

func (*Remote) UpsertByComparison

func (r *Remote) UpsertByComparison(args *upsertOpt) (f *File, err error)

type Role

type Role int

func (*Role) String

func (r *Role) String() string

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL