fs: Document that Purger returns error on empty directory, test and fix

fstest/fstest.go

@@ -161,9 +161,12 @@ func RandomRemote(remoteName string, subdir bool) (fs.Fs, func()) {
 	}
 
 	finalise := func() {
-		TestPurge(remote)
+		_ = fs.Purge(remote) // ignore error
 		if parentRemote != nil {
-			TestPurge(parentRemote)
+			err = fs.Purge(parentRemote) // ignore error
+			if err != nil {
+				log.Printf("Failed to purge %v: %v", parentRemote, err)
+			}
 		}
 		// Delete directory if we made one above
 		if rmdir != "" {

fstest/fstests/fstests.go

@@ -322,7 +322,10 @@ func TestObjectRemove(t *testing.T) {
 func TestObjectPurge(t *testing.T) {
 	skipIfNotOk(t)
 	fstest.TestPurge(remote)
-	fstest.TestPurge(remote)
+	err := fs.Purge(remote)
+	if err == nil {
+		t.Fatal("Expecting error after on second purge")
+	}
 }
 
 func TestFinalise(t *testing.T) {