make stdlib.absolute_path, same as stdlib.canonical

Author: scivision

+stdlib/+test/TestFilePure.m

@@ -59,33 +59,33 @@ function test_is_absolute_path(tc)
 tc.verifyFalse(is_absolute_path("c"))
 end
 
-function test_canonical(tc)
+function test_absolute_path(tc)
 
-import stdlib.canonical
+import stdlib.absolute_path
 
-tc.assumeTrue(usejava("jvm"), "Java required for canonical")
+tc.assumeTrue(usejava("jvm"), "Java required for absolute_path")
 
-tc.verifyEmpty(canonical(string.empty))
-tc.verifyEqual(canonical(""), string(pwd))
+tc.verifyEmpty(absolute_path(string.empty))
+tc.verifyEqual(absolute_path(""), string(pwd))
 
-pabs = canonical('2foo');
-pabs2 = canonical('4foo');
+pabs = absolute_path('2foo');
+pabs2 = absolute_path('4foo');
 tc.verifyFalse(startsWith(pabs, "2"))
 tc.verifyTrue(strncmp(pabs, pabs2, 2))
 
-par1 = canonical("../2foo");
+par1 = absolute_path("../2foo");
 tc.verifyNotEmpty(par1)
 tc.verifyFalse(contains(par1, ".."))
 
-par2 = canonical("../4foo");
+par2 = absolute_path("../4foo");
 tc.verifyTrue(strncmp(par2, pabs2, 2))
 
-pt1 = canonical("bar/../2foo");
+pt1 = absolute_path("bar/../2foo");
 tc.verifyNotEmpty(pt1)
 tc.verifyFalse(contains(pt1, ".."))
 
-va = canonical("2foo");
-vb = canonical("4foo");
+va = absolute_path("2foo");
+vb = absolute_path("4foo");
 tc.verifyFalse(startsWith(va, "2"))
 tc.verifyTrue(strncmp(va, vb, 2))
 

+stdlib/+test/TestWindowsCOM.m

@@ -14,7 +14,7 @@ function test_shortname(tc)
 tc.verifyTrue(endsWith(short, 'notepad.exe'), "Short name should end with 'notepad.exe'")
 tc.verifyTrue(contains(short, "MICROS~1"))
 
-tc.verifyEqual(stdlib.canonical(short), test_file)
+tc.verifyEqual(stdlib.absolute_path(short), test_file)
 
 end
 

+stdlib/absolute_path.m

@@ -0,0 +1,22 @@
+function abspath = absolute_path(p)
+%% absolute_path(p)
+% path need not exist, but absolute path is returned
+%
+% NOTE: some network file systems are not resolvable by Matlab Java
+% subsystem, but are sometimes still valid--so return
+% unmodified path if this occurs.
+%
+% This also resolves Windows short paths to full long paths.
+%
+%%% Inputs
+% * p: path to make absolute
+%%% Outputs
+% * abspath: absolute path, if determined
+
+arguments
+  p string {mustBeScalarOrEmpty}
+end
+
+abspath = stdlib.fileio.absolute_path(p);
+
+end

+stdlib/canonical.m

@@ -1,5 +1,6 @@
 function abspath = canonical(p)
 %% canonical(p)
+% yes this is the same as absolute_path
 % path need not exist, but absolute path is returned
 %
 % NOTE: some network file systems are not resolvable by Matlab Java

+stdlib/expanduser.m

@@ -10,7 +10,7 @@
 %%% Outputs
 % * expanded: expanded path
 %
-% See also CANONICAL
+% See also absolute_path
 
 arguments
   p string