wip: vfs: use specialized stat interface when available rather than

listing

Signed-off-by: Anagh Kumar Baranwal <6824881+darthShadow@users.noreply.github.com>

Author: darthShadow

backend/drive/drive.go

@@ -3798,16 +3798,16 @@ Use the --interactive/-i or --dry-run flag to see what would be moved beforehand
 Usage:
 
     rclone backend query drive: query
-    
-The query syntax is documented at [Google Drive Search query terms and 
+
+The query syntax is documented at [Google Drive Search query terms and
 operators](https://developers.google.com/drive/api/guides/ref-search-terms).
 
 For example:
 
 	rclone backend query drive: "'0ABc9DEFGHIJKLMNop0QRatUVW3X' in parents and name contains 'foo'"
 
 If the query contains literal ' or \ characters, these need to be escaped with
-\ characters. "'" becomes "\'" and "\" becomes "\\\", for example to match a 
+\ characters. "'" becomes "\'" and "\" becomes "\\\", for example to match a
 file named "foo ' \.txt":
 
 	rclone backend query drive: "name = 'foo \' \\\.txt'"

backend/local/local.go

@@ -1123,6 +1123,13 @@ func (f *Fs) Command(ctx context.Context, name string, arg []string, opt map[str
 	}
 }
 
+// Stat returns the DirEntry for the given name
+//
+// It should return fs.ErrorNotImplemented if it can't return a DirEntry
+func (f *Fs) Stat(ctx context.Context, dir string, leaf string) (fs.DirEntry, error) {
+	return nil, fs.ErrorNotImplemented
+}
+
 // ------------------------------------------------------------
 
 // Fs returns the parent Fs
@@ -1768,6 +1775,7 @@ var (
 	_ fs.OpenWriterAter  = &Fs{}
 	_ fs.DirSetModTimer  = &Fs{}
 	_ fs.MkdirMetadataer = &Fs{}
+	_ fs.Stater          = &Fs{}
 	_ fs.Object          = &Object{}
 	_ fs.Metadataer      = &Object{}
 	_ fs.SetMetadataer   = &Object{}

backend/onedrive/onedrive.go

@@ -356,7 +356,7 @@ block download of the file.
 
 In this case you will see a message like this
 
-    server reports this file is infected with a virus - use --onedrive-av-override to download anyway: Infected (name of virus): 403 Forbidden: 
+    server reports this file is infected with a virus - use --onedrive-av-override to download anyway: Infected (name of virus): 403 Forbidden:
 
 If you are 100% sure you want to download this file anyway then use
 the --onedrive-av-override flag, or av_override = true in the config
@@ -2988,13 +2988,13 @@ var (
 	_ fs.ListRer         = (*Fs)(nil)
 	_ fs.Shutdowner      = (*Fs)(nil)
 	_ fs.Object          = (*Object)(nil)
-	_ fs.MimeTyper       = &Object{}
-	_ fs.IDer            = &Object{}
+	_ fs.MimeTyper       = (*Object)(nil)
+	_ fs.IDer            = (*Object)(nil)
 	_ fs.Metadataer      = (*Object)(nil)
 	_ fs.Metadataer      = (*Directory)(nil)
 	_ fs.SetModTimer     = (*Directory)(nil)
 	_ fs.SetMetadataer   = (*Directory)(nil)
-	_ fs.MimeTyper       = &Directory{}
+	_ fs.MimeTyper       = (*Directory)(nil)
 	_ fs.DirSetModTimer  = (*Fs)(nil)
 	_ fs.MkdirMetadataer = (*Fs)(nil)
 )

backend/union/union.go

@@ -911,6 +911,13 @@ func (f *Fs) CleanUp(ctx context.Context) error {
 	return errs.Err()
 }
 
+// Stat returns the DirEntry for the given name
+//
+// It should return fs.ErrorNotImplemented if it can't return a DirEntry
+func (f *Fs) Stat(ctx context.Context, dir string, leaf string) (fs.DirEntry, error) {
+	return nil, fs.ErrorNotImplemented
+}
+
 // NewFs constructs an Fs from the path.
 //
 // The returned Fs is the actual Fs, referenced by remote in the config
@@ -1093,4 +1100,5 @@ var (
 	_ fs.ListRer         = (*Fs)(nil)
 	_ fs.Shutdowner      = (*Fs)(nil)
 	_ fs.CleanUpper      = (*Fs)(nil)
+	_ fs.Stater          = (*Fs)(nil)
 )

fs/types.go

@@ -218,6 +218,14 @@ type Fder interface {
 	Fd(ctx context.Context, flags int) (uintptr, error)
 }
 
+// Stater is an optional interface for Directory
+type Stater interface {
+	// Stat returns the DirEntry for the given leaf
+	//
+	// It should return fs.ErrorNotImplemented if it can't return a DirEntry
+	Stat(ctx context.Context, dir string, leaf string) (DirEntry, error)
+}
+
 // SetModTimer is an optional interface for Directory.
 //
 // Object implements this as part of its requires set of interfaces.