Posix metadata

.github/workflows/io_file.yml

@@ -38,7 +38,13 @@ jobs:
       fail-fast: false
       matrix:
         sdk: [stable, dev]
-        os: [ubuntu-latest, windows-latest, macos-latest]
+        os:
+          - ubuntu-20.04
+          - ubuntu-latest
+          - windows-2019
+          - windows-latest
+          - macos-13
+          - macos-latest
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683

pkgs/io_file/lib/src/vm_posix_file_system.dart

@@ -60,6 +60,33 @@ int _tempFailureRetry(int Function() f) {
   return result;
 }
 
+final class PosixMetadata {
+  @override
+  final bool isDirectory;
+
+  @override
+  final bool isFile;
+
+  @override
+  final bool isLink;
+
+  @override
+  final int size;
+
+  @override
+  final bool isHidden;
+
+  PosixMetadata({
+    this.isDirectory = false,
+    this.isFile = false,
+    this.isLink = false,
+
+    this.size = 0,
+
+    this.isHidden = false,
+  });
+}
+
 /// The POSIX `read` function.
 ///
 /// See https://pubs.opengroup.org/onlinepubs/9699919799/functions/read.html
@@ -150,4 +177,33 @@ base class PosixFileSystem extends FileSystem {
     }
     return buffer.asTypedList(length, finalizer: ffi.calloc.nativeFree);
   }
+
+  PosixMetadata metadata(String path) {
+    final stat = stdlibc.stat(path);
+    if (stat == null) {
+      final errno = stdlibc.errno;
+      throw _getError(errno, 'stat failed', path);
+    }
+
+    final bool isHidden;
+    if (io.Platform.isIOS || io.Platform.isMacOS) {
+      final flags = stat.st_flags!;
+      isHidden = flags & stdlibc.UF_HIDDEN != 0;
+    } else {
+      isHidden = false;
+    }
+
+    final isDirectory = stat.st_mode & stdlibc.S_IFDIR != 0;
+    final isLink = stat.st_mode & stdlibc.S_IFLNK != 0;
+    final isFile = !(isDirectory || isLink);
+
+    // st_birthtimespec;
+    return PosixMetadata(
+      isDirectory: isDirectory,
+      isFile: isFile,
+      isLink: isLink,
+      size: stat.st_size,
+      isHidden: isHidden,
+    );
+  }
 }

pkgs/io_file/test/metadata_apple_test.dart

@@ -0,0 +1,51 @@
+// Copyright (c) 2025, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+@TestOn('ios || mac-os')
+library;
+
+import 'dart:ffi';
+import 'dart:io';
+
+import 'package:ffi/ffi.dart';
+import 'package:io_file/src/vm_posix_file_system.dart';
+import 'package:stdlibc/stdlibc.dart' as stdlibc;
+import 'package:test/test.dart';
+
+import 'test_utils.dart';
+
+@Native<Int Function(Pointer<Utf8>, Uint32)>(isLeaf: false)
+external int chflags(Pointer<Utf8> buf, int count);
+
+void main() {
+  final posixFileSystem = PosixFileSystem();
+
+  group('windows metadata', () {
+    late String tmp;
+
+    setUp(() => tmp = createTemp('metadata'));
+
+    tearDown(() => deleteTemp(tmp));
+
+    group('isHidden', () {
+      test('false', () {
+        final path = '$tmp/file';
+        File(path).writeAsStringSync('Hello World');
+
+        final data = posixFileSystem.metadata(path);
+        expect(data.isHidden, isFalse);
+      });
+      test('false', () {
+        final path = '$tmp/file';
+        File(path).writeAsStringSync('Hello World');
+        using((arena) {
+          chflags(path.toNativeUtf8(), stdlibc.UF_HIDDEN);
+        });
+
+        final data = posixFileSystem.metadata(path);
+        expect(data.isHidden, isTrue);
+      });
+    });
+  });
+}