add stdlib.[canonical,expanduser]

require Matlab >= R2020b

python: better test for working

Author: scivision

+stdlib/+fileio/absolute_path.m

@@ -1,15 +1,4 @@
 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.
-%
-%%% Inputs
-% * p: path to make absolute
-%%% Outputs
-% * abspath: absolute path, if determined
 
 arguments
   p string {mustBeScalarOrEmpty}

+stdlib/+fileio/expanduser.m

@@ -1,16 +1,4 @@
 function expanded = expanduser(p)
-%% expanduser(path)
-% expands tilde ~ into user home directory
-%
-% Useful for Matlab functions like h5read() and some Computer Vision toolbox functions
-% that can't handle ~
-%
-%%% Inputs
-% * p: path to expand, if tilde present
-%%% Outputs
-% * expanded: expanded path
-%
-% See also ABSOLUTE_PATH
 
 arguments
   p string

+stdlib/+fileio/extract_zstd.m

@@ -1,9 +1,4 @@
 function extract_zstd(archive, out_dir)
-%% extract_zstd(archive, out_dir)
-% extract a zstd file "archive" to "out_dir"
-% out_dir need not exist yet, but its parent must
-% We do this with CMake to avoid problems with old system tar.
-% For our user audience, CMake is at least as likely to be installed as Zstd.
 
 arguments
   archive (1,1) string {mustBeFile}

+stdlib/+fileio/is_absolute_path.m

@@ -1,17 +1,10 @@
 function isabs = is_absolute_path(apath)
-%% is_absolute_path(apath)
-% true if path is absolute. Path need not yet exist.
-% even if path has inside ".." it's still considered absolute
-% e.g. Python
-%  os.path.isabs("/foo/../bar") == True
 
 arguments
   apath string
 end
 
-import stdlib.fileio.expanduser
-
-apath = expanduser(apath);
+apath = stdlib.fileio.expanduser(apath);
 
 if ispc
   i = strlength(apath) < 3;
@@ -24,4 +17,4 @@
   isabs = startsWith(apath, "/");
 end
 
-end % function
+end

+stdlib/+fileio/is_exe.m

@@ -1,11 +1,4 @@
 function ok = is_exe(file)
-%% is_exe(file)
-% is a file executable, as per its filesystem attributes
-% does not actually try to run the file.
-%%% Inputs
-% * file: filename
-%%% Outputs
-% * ok: boolean logical
 
 arguments
   file string {mustBeScalarOrEmpty}

+stdlib/+fileio/makedir.m

@@ -1,7 +1,5 @@
 function makedir(direc)
-%% makedir(direc)
-% malformed paths can be "created" but are not accessible.
-% This function works around that bug in Matlab mkdir().
+
 arguments
   direc (1,1) string {mustBeNonzeroLengthText}
 end

+stdlib/+fileio/md5sum.m

@@ -24,4 +24,4 @@
 
 assert(strlength(hash)==32, 'md5 hash is 32 characters')
 
-end % function
+end

+stdlib/+fileio/path_tail.m

@@ -1,25 +1,16 @@
 function last = path_tail(apath)
-%% path_tail(apath)
-% get last part of directory path
-% if filename, return filename with suffix
+
 arguments
   apath string {mustBeScalarOrEmpty}
 end
 
-import stdlib.fileio.absolute_path
-
-if isempty(apath)
-  last = string.empty;
-  return
-end
-
 if strlength(apath) == 0
   last = "";
   return
 end
 
-[~, name, ext] = fileparts(absolute_path(apath));
+[~, name, ext] = fileparts(stdlib.fileio.absolute_path(apath));
 
 last = append(name, ext);
 
-end % function
+end

+stdlib/+fileio/posix.m

@@ -1,8 +1,5 @@
 function ppath = posix(file)
-%% posix(file)
-% convert a path or sequence of path components to a Posix path separated
-% with "/" even on Windows.
-% If Windows path also have escaping "\" this breaks
+
 arguments
   file string
 end
@@ -14,4 +11,4 @@
   ppath = strrep(ppath, "\", "/");
 end
 
-end % function
+end