feat(macOS): add support for resolving macOS aliases

.gitignore

@@ -1,5 +1,6 @@
 # ide 
 .vscode/
+.history/
 .idea/
 .fleet/
 

internal/cli/g.go

@@ -21,6 +21,7 @@ import (
 	"github.com/Equationzhao/g/internal/global"
 	"github.com/Equationzhao/g/internal/index"
 	"github.com/Equationzhao/g/internal/item"
+	"github.com/Equationzhao/g/internal/osbased"
 	"github.com/Equationzhao/g/internal/render"
 	"github.com/Equationzhao/g/internal/shell"
 	"github.com/Equationzhao/g/internal/sorter"
@@ -893,8 +894,8 @@ var logic = func(context *cli.Context) error {
 		// dereference
 		if dereference {
 			for i := range infos {
-				if util.IsSymLink(infos[i]) {
-					symlinks, err := filepath.EvalSymlinks(infos[i].FullPath)
+				if util.IsSymLink(infos[i]) || osbased.IsMacOSAlias(infos[i].FullPath) {
+					symlinks, err := util.Evallinks(infos[i].FullPath)
 					if err != nil {
 						continue
 					}

internal/content/name.go

@@ -13,6 +13,7 @@ import (
 	"unicode"
 
 	"github.com/Equationzhao/g/internal/display"
+	"github.com/Equationzhao/g/internal/osbased"
 
 	"github.com/Equationzhao/g/internal/global"
 	"github.com/shirou/gopsutil/v3/disk"
@@ -232,7 +233,7 @@ func (n *Name) Enable(renderer *render.Renderer) ContentOption {
 				classify = "/"
 			}
 			color, underline, bold, italics, faint, blink = style.Color, style.Underline, style.Bold, style.Italics, style.Faint, style.Blink
-		} else if util.IsSymLinkMode(mode) {
+		} else if util.IsSymLinkMode(mode) || osbased.IsMacOSAlias(info.FullPath) {
 			if n.statistics != nil {
 				n.statistics.link.Add(1)
 			}
@@ -247,7 +248,7 @@ func (n *Name) Enable(renderer *render.Renderer) ContentOption {
 			// color + arrow + color-end + color + path + color-end
 			if !n.noDeference {
 				if n.json { // "dereference": "symlinks"
-					symlinks, err := filepath.EvalSymlinks(info.FullPath)
+					symlinks, err := util.Evallinks(info.FullPath)
 					if err != nil {
 						info.Meta.Set("dereference_err", &display.ItemContent{Content: display.StringContent(err.Error())})
 						symlinks = n.checkDereferenceErr(err)
@@ -259,7 +260,7 @@ func (n *Name) Enable(renderer *render.Renderer) ContentOption {
 					checkNameDisplayEffect(arrowStyle, dereference)
 					_, _ = dereference.WriteString(arrowStyle.Icon)
 					_, _ = dereference.WriteString(renderer.Colorend())
-					symlinks, err := filepath.EvalSymlinks(info.FullPath)
+					symlinks, err := util.Evallinks(info.FullPath)
 					var linkStyle theme.Style
 					dereferenceMounts := ""
 					if err != nil {

internal/osbased/filedetail_darwin.go

@@ -2,10 +2,62 @@
 
 package osbased
 
+/*
+#cgo CFLAGS: -mmacosx-version-min=10.9
+#cgo LDFLAGS: -framework CoreFoundation -framework CoreServices
+
+#include <CoreFoundation/CoreFoundation.h>
+#include <CoreServices/CoreServices.h>
+
+#include <stdlib.h>
+#include <string.h>
+#include <limits.h>
+#include <sys/xattr.h>
+
+char *resolveAlias(const char *path) {
+    CFURLRef url = CFURLCreateFromFileSystemRepresentation(NULL, (const UInt8 *)path, strlen(path), false);
+    if (!url) {
+        return NULL;
+    }
+
+    CFErrorRef error = NULL;
+    CFDataRef bookmarkData = CFURLCreateBookmarkDataFromFile(NULL, url, &error);
+    CFRelease(url);
+    if (!bookmarkData) {
+        if (error != NULL) {
+            CFRelease(error);
+        }
+        return NULL;
+    }
+
+    Boolean bookmarkIsStale;
+    CFURLRef resolvedURL = CFURLCreateByResolvingBookmarkData(NULL, bookmarkData, kCFBookmarkResolutionWithoutUIMask, NULL, NULL, &bookmarkIsStale, &error);
+    CFRelease(bookmarkData);
+    if (!resolvedURL) {
+        if (error != NULL) {
+            CFRelease(error);
+        }
+        return NULL;
+    }
+
+    UInt8 buffer[PATH_MAX];
+    Boolean success = CFURLGetFileSystemRepresentation(resolvedURL, true, buffer, PATH_MAX);
+    CFRelease(resolvedURL);
+    if (!success) {
+        return NULL;
+    }
+
+    return strdup((const char*)buffer);
+}
+*/
+import "C"
 import (
+	"fmt"
 	"os"
 	"strconv"
 	"syscall"
+
+	"unsafe"
 )
 
 func Inode(info os.FileInfo) string {
@@ -32,3 +84,38 @@ func BlockSize(info os.FileInfo) int64 {
 
 	return stat.Blocks
 }
+
+func IsMacOSAlias(fullPath string) bool {
+	path := C.CString(fullPath)
+	defer C.free(unsafe.Pointer(path))
+
+	name := C.CString("com.apple.FinderInfo")
+	defer C.free(unsafe.Pointer(name))
+
+	buf := make([]byte, 32)
+	size := C.size_t(len(buf))
+
+	ret, _ := C.getxattr(
+		path,
+		name,
+		unsafe.Pointer(&buf[0]),
+		size,
+		0,
+		0,
+	)
+
+	return ret > 0 && (buf[0]&0x20) != 0
+}
+
+func ResolveAlias(fullPath string) (string, error) {
+	cPath := C.CString(fullPath)
+	defer C.free(unsafe.Pointer(cPath))
+
+	resolved := C.resolveAlias(cPath)
+	if resolved == nil {
+		return "", fmt.Errorf("failed to resolve macOS alias for %s", fullPath)
+	}
+	defer C.free(unsafe.Pointer(resolved))
+
+	return C.GoString(resolved), nil
+}

internal/osbased/filedetail_linux.go

@@ -32,3 +32,13 @@ func BlockSize(info os.FileInfo) int64 {
 
 	return stat.Blocks
 }
+
+// always false on Linux
+func IsMacOSAlias(_ string) bool {
+	return false
+}
+
+// ResolveAlias is a no-op on Linux.
+func ResolveAlias(_ string) (string, error) {
+	return "", nil
+}

internal/osbased/filedetail_windows.go

@@ -77,3 +77,13 @@ func LinkCount(info *item.FileInfo) uint64 {
 func BlockSize(info os.FileInfo) int64 {
 	return 0
 }
+
+// always false on Windows
+func IsMacOSAlias(_ string) bool {
+	return false
+}
+
+// ResolveAlias is a no-op on Windows.
+func ResolveAlias(_ string) (string, error) {
+	return "", nil
+}

internal/util/file.go

@@ -1,6 +1,7 @@
 package util
 
 import (
+	"fmt"
 	"io/fs"
 	"math/rand/v2"
 	"os"
@@ -9,9 +10,28 @@
 
 	"github.com/Equationzhao/g/internal/global"
 	"github.com/Equationzhao/g/internal/item"
+	"github.com/Equationzhao/g/internal/osbased"
 	"github.com/spf13/afero"
 )
 
+func Evallinks(fullPath string) (string, error) {
+	// support symlinks and macOS Alias
+	if osbased.IsMacOSAlias(fullPath) {
+		for {
+			if osbased.IsMacOSAlias(fullPath) {
+				aliasTarget, err := osbased.ResolveAlias(fullPath)
+				if err != nil {
+					return "", fmt.Errorf("alias resolution failed: %w", err)
+				}
+				fullPath = aliasTarget
+			} else {
+				break
+			}
+		}
+	}
+	return filepath.EvalSymlinks(fullPath)
+}
+
 func IsSymLink(file os.FileInfo) bool {
 	return file.Mode()&os.ModeSymlink != 0
 }