fstest

Documentation

Overview

Package fstest provides utilities for testing the Fs

Index

• Variables
• func CheckItems(t *testing.T, f fs.Fs, items ...Item)
• func CheckListing(t *testing.T, f fs.Fs, items []Item)
• func CheckListingWithPrecision(t *testing.T, f fs.Fs, items []Item, expectedDirs []string, ...)
• func CheckTimeEqualWithPrecision(t0, t1 time.Time, precision time.Duration) (time.Duration, bool)
• func LocalRemote() (path string, err error)
• func RandomRemote(remoteName string, subdir bool) (fs.Fs, string, func(), error)
• func RandomRemoteName(remoteName string) (string, string, error)
• func RandomString(n int) string
• func TestMkdir(t *testing.T, remote fs.Fs)
• func TestPurge(t *testing.T, remote fs.Fs)
• func TestRmdir(t *testing.T, remote fs.Fs)
• func Time(timeString string) time.Time
• type Item
  • func NewItem(Path, Content string, modTime time.Time) Item
  • func (i *Item) Check(t *testing.T, obj fs.Object, precision time.Duration)
  • func (i *Item) CheckHashes(t *testing.T, obj fs.Object)
  • func (i *Item) CheckModTime(t *testing.T, obj fs.Object, modTime time.Time, precision time.Duration)
• type Items
  • func NewItems(items []Item) *Items
  • func (is *Items) Done(t *testing.T)
  • func (is *Items) Find(t *testing.T, obj fs.Object, precision time.Duration)

Variables

var (
	// MatchTestRemote matches the remote names used for testing
	MatchTestRemote = regexp.MustCompile(`^rclone-test-[abcdefghijklmnopqrstuvwxyz0123456789]{24}$`)
	// ListRetries is the number of times to retry a listing to overcome eventual consistency
	ListRetries = flag.Int("list-retries", 6, "Number or times to retry listing")
)

Functions

func CheckItems

func CheckItems(t *testing.T, f fs.Fs, items ...Item)

CheckItems checks the fs to see if it has only the items passed in using a precision of fs.Config.ModifyWindow

func CheckListing

func CheckListing(t *testing.T, f fs.Fs, items []Item)

CheckListing checks the fs to see if it has the expected contents

func CheckListingWithPrecision

func CheckListingWithPrecision(t *testing.T, f fs.Fs, items []Item, expectedDirs []string, precision time.Duration)

CheckListingWithPrecision checks the fs to see if it has the expected contents with the given precision.

If expectedDirs is non nil then we check those too. Note that no directories returned is also OK as some remotes don't return directories.

func CheckTimeEqualWithPrecision

func CheckTimeEqualWithPrecision(t0, t1 time.Time, precision time.Duration) (time.Duration, bool)

CheckTimeEqualWithPrecision checks the times are equal within the precision, returns the delta and a flag

func LocalRemote

func LocalRemote() (path string, err error)

LocalRemote creates a temporary directory name for local remotes

func RandomRemote

func RandomRemote(remoteName string, subdir bool) (fs.Fs, string, func(), error)

RandomRemote makes a random bucket or subdirectory on the remote

Call the finalise function returned to Purge the fs at the end (and the parent if necessary)

Returns the remote, its url, a finaliser and an error

func RandomRemoteName

func RandomRemoteName(remoteName string) (string, string, error)

RandomRemoteName makes a random bucket or subdirectory name

Returns a random remote name plus the leaf name

func RandomString

func RandomString(n int) string

RandomString create a random string for test purposes

func TestMkdir

func TestMkdir(t *testing.T, remote fs.Fs)

TestMkdir tests Mkdir works

func TestPurge

func TestPurge(t *testing.T, remote fs.Fs)

TestPurge tests Purge works

func TestRmdir

func TestRmdir(t *testing.T, remote fs.Fs)

TestRmdir tests Rmdir works

func Time

func Time(timeString string) time.Time

Time parses a time string or logs a fatal error

Types

type Item

type Item struct {
	Path    string
	Hashes  map[fs.HashType]string
	ModTime time.Time
	Size    int64
	WinPath string
}

Item represents an item for checking

func NewItem

func NewItem(Path, Content string, modTime time.Time) Item

NewItem creates an item from a string content

func (*Item) Check

func (i *Item) Check(t *testing.T, obj fs.Object, precision time.Duration)

Check checks all the attributes of the object are correct

func (*Item) CheckHashes

func (i *Item) CheckHashes(t *testing.T, obj fs.Object)

CheckHashes checks all the hashes the object supports are correct

func (*Item) CheckModTime

func (i *Item) CheckModTime(t *testing.T, obj fs.Object, modTime time.Time, precision time.Duration)

CheckModTime checks the mod time to the given precision

type Items

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

Items represents all items for checking

func NewItems

func NewItems(items []Item) *Items

NewItems makes an Items

func (*Items) Done

func (is *Items) Done(t *testing.T)

Done checks all finished

func (*Items) Find

func (is *Items) Find(t *testing.T, obj fs.Object, precision time.Duration)

Find checks off an item