optional return backend where used

Author: scivision

+stdlib/canonical.m

@@ -9,6 +9,7 @@
 %%% Inputs
 % * p: path to make canonical
 % * strict: if true, only return canonical path if it exists. If false, return normalized path if path does not exist.
+% * backend: backend to use
 %%% Outputs
 % * c: canonical path, if determined
 % * b: backend used

+stdlib/create_symlink.m

@@ -1,19 +1,20 @@
 %% CREATE_SYMLINK create symbolic link
 %
-%%% Inputs
+%% Inputs
 % * target: path to link to
 % * link: path to create link at
-%%% Outputs
+%% Outputs
 % * ok: true if successful
+% * b: backend used
 
-function ok = create_symlink(target, link, backend)
+function [ok, b] = create_symlink(target, link, backend)
 arguments
   target {mustBeTextScalar}
   link {mustBeTextScalar}
   backend (1,:) string = ["native", "dotnet", "python", "sys"]
 end
 
-fun = hbackend(backend, "create_symlink", 'R2024b');
+[fun, b] = hbackend(backend, "create_symlink", 'R2024b');
 
 ok = fun(target, link);
 

+stdlib/device.m

@@ -1,12 +1,19 @@
 %% DEVICE filesystem device index of path
+%
+%% Inputs
+% * file: path to file
+%% Outputs
+% * i: device index
+% * b: backend used
 
-function i = device(file, backend)
+function [i, b] = device(file, backend)
 arguments
   file {mustBeTextScalar}
   backend (1,:) string = ["java", "python", "sys"]
 end
 
-fun = hbackend(backend, "device");
+[fun, b] = hbackend(backend, "device");
+
 i = fun(file);
 
 end

+stdlib/disk_available.m

@@ -2,15 +2,21 @@
 %
 % example:  stdlib.disk_available('/')
 %
+%% Inputs
+% * filepath: path to check
+%% Outputs
+% * f: free disk space (bytes)
+% * b: backend used
+%
 % Ref: https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html#getUsableSpace()
 
-function f = disk_available(filepath, backend)
+function [f, b] = disk_available(filepath, backend)
 arguments
   filepath {mustBeTextScalar}
   backend (1,:) string = ["java", "dotnet", "python", "sys"]
 end
 
-fun = hbackend(backend, "disk_available");
+[fun, b] = hbackend(backend, "disk_available");
 
 f = fun(filepath);
 

+stdlib/disk_capacity.m

@@ -1,14 +1,20 @@
 %% DISK_CAPACITY disk total capacity (bytes)
 %
 % example:  stdlib.disk_capacity('/')
+%
+%% Inputs
+% * filepath: path to check
+%% Outputs
+% * f: total disk capacity (bytes)
+% * b: backend used
 
-function f = disk_capacity(filepath, backend)
+function [f, b] = disk_capacity(filepath, backend)
 arguments
   filepath {mustBeTextScalar}
   backend (1,:) string = ["java", "dotnet", "python", "sys"]
 end
 
-fun = hbackend(backend, "disk_capacity");
+[fun, b] = hbackend(backend, "disk_capacity");
 
 f = fun(filepath);
 

+stdlib/file_checksum.m

@@ -7,17 +7,18 @@
 % * method:  "MD5", "SHA-1", "SHA-256", etc.
 %%% Outputs
 % * hash: string hash
+% * b: backend used
 %
 % Ref: https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/security/MessageDigest.html#getInstance(java.lang.String)
 
-function hash = file_checksum(file, hash_method, backend)
+function [hash, b] = file_checksum(file, hash_method, backend)
 arguments
   file {mustBeTextScalar}
   hash_method {mustBeTextScalar}
   backend (1,:)  string = ["java", "dotnet", "sys"]
 end
 
-fun = hbackend(backend, "file_checksum");
+[fun, b] = hbackend(backend, "file_checksum");
 
 hash = fun(file, hash_method);
 

+stdlib/filesystem_type.m

@@ -1,14 +1,20 @@
 %% FILESYSTEM_TYPE tell type of filesystem
 %
 % example outputs: NTFS, ext4, apfs, ...
+%
+%% Inputs
+% * file: path to check
+%% Outputs
+% * t: filesystem type
+% * b: backend used
 
-function t = filesystem_type(file, backend)
+function [t, b] = filesystem_type(file, backend)
 arguments
   file {mustBeTextScalar}
   backend (1,:) string = ["java", "dotnet", "python", "sys"]
 end
 
-fun = hbackend(backend, "filesystem_type");
+[fun, b] = hbackend(backend, "filesystem_type");
 
 t = fun(file);
 

+stdlib/get_owner.m

@@ -4,14 +4,15 @@
 % * p: path to examine
 %%% Outputs
 % * n: owner, or empty if path does not exist
+% * b: backend used
 
-function n = get_owner(file, backend)
+function [n, b] = get_owner(file, backend)
 arguments
   file {mustBeTextScalar}
   backend (1,:) string = ["java", "dotnet", "python", "sys"]
 end
 
-fun = hbackend(backend, "get_owner");
+[fun, b] = hbackend(backend, "get_owner");
 
 n = fun(file);
 

+stdlib/get_permissions.m

@@ -1,14 +1,20 @@
 %% GET_PERMISSIONS permissions of file or directory
 %
 % output is char like 'rwxrwxr--'
+%
+%% Inputs
+% * file: path to check
+%% Outputs
+% * p: permissions string
+% * b: backend used
 
-function p = get_permissions(file, backend)
+function [p, b] = get_permissions(file, backend)
 arguments
   file {mustBeTextScalar}
   backend (1,:) string = ["native", "legacy"]
 end
 
-fun = hbackend(backend, "get_permissions", 'R2025a');
+[fun, b] = hbackend(backend, "get_permissions", 'R2025a');
 
 p = fun(file);
 

+stdlib/get_shell.m

@@ -1,6 +1,10 @@
 %% GET_SHELL full path to currently running shell
+%
+%% Outputs
+% * s: full path to currently running shell
+% * b: backend used
 
-function s = get_shell()
+function [s, b] = get_shell()
 
 if ispc()
 % https://stackoverflow.com/a/61469226
@@ -10,6 +14,8 @@
   cmd = 'lsof -p "$$" | grep -m 1 txt | xargs -n 1 | tail -n +9';
 end
 
+b = "sys";
+
 [r, msg] = system(cmd);
 
 if r == 0