feat: add Directory.emptyOrCreate helper in utils (fs and io)

fs/lib/utils/io/read_write.dart

@@ -6,7 +6,6 @@ import 'dart:typed_data';
 
 import 'package:fs_shim/fs_io.dart' as fs;
 import 'package:fs_shim/utils/read_write.dart' as fs;
-import 'package:fs_shim/utils/src/utils_impl.dart' as fs;
 
 var _useCrLf = Platform.isWindows;
 var _eol = _useCrLf ? '\r\n' : '\n';
@@ -71,6 +70,18 @@ Future<List<String>> readLines(File file, {Encoding encoding = utf8}) =>
     fs.readLines(fs.wrapIoFile(file), encoding: encoding);
 
 /// Ensure the directory is created and empty.
+/// @Deprecated
 Future emptyOrCreateDirectory(Directory dir) {
-  return fs.emptyOrCreateDirectory(fs.wrapIoDirectory(dir));
+  return dir.emptyOrCreate();
+}
+
+/// Empty or create helper
+extension DirectoryEmptyOrCreateExt on Directory {
+  fs.Directory get _fsDir => fs.wrapIoDirectory(this);
+
+  /// Ensure the directory is created and empty.
+  Future<void> emptyOrCreate() async {
+    await _fsDir.delete(recursive: true);
+    await _fsDir.create(recursive: true);
+  }
 }

fs/lib/utils/read_write.dart

@@ -46,3 +46,18 @@ Future<List<String>> readLines(File file, {Encoding encoding = utf8}) async {
   var text = await readString(file, encoding: encoding);
   return LineSplitter.split(text).toList();
 }
+
+/// Empty or create helper
+extension DirectoryEmptyOrCreateExt on Directory {
+  /// Ensure the directory is created and empty.
+  Future<void> emptyOrCreate() async {
+    if (await exists()) {
+      try {
+        await delete(recursive: true);
+      } catch (_) {
+        // ignore
+      }
+    }
+    await create(recursive: true);
+  }
+}

fs/lib/utils/src/utils_impl.dart

@@ -344,11 +344,6 @@ Future<int> copyFileMeta(File src, File dst) async {
   return 0;
 }
 
-Future emptyOrCreateDirectory(Directory dir) async {
-  await dir.delete(recursive: true);
-  await dir.create(recursive: true);
-}
-
 abstract class EntityNode {
   EntityNode? get parent; // can be null
   FileSystem get fs; // cannot be null

fs_test/lib/utils_read_write_test.dart

@@ -43,5 +43,18 @@ void defineTests(FileSystemTestContext ctx) {
       await writeString(file, 'test2');
       expect(await readString(file), 'test2');
     });
+
+    test('Directory.emptyOrCreate', () async {
+      final top = await ctx.prepare();
+      var dir = fs.directory(fs.path.join(top.path, 'dir'));
+      expect(await dir.exists(), isFalse);
+      await dir.emptyOrCreate();
+      expect(await dir.exists(), isTrue);
+      // test 2 level depth
+      dir = fs.directory(fs.path.join(top.path, 'sub', 'dir'));
+      expect(await dir.exists(), isFalse);
+      await dir.emptyOrCreate();
+      expect(await dir.exists(), isTrue);
+    });
   });
 }