restore Matlab 'arguments' syntax for reliability

Author: scivision

+stdlib/auto_chunk_size.m

@@ -7,12 +7,9 @@
 % * dims: proposed dataset dimensions (like size())
 
 function csize = auto_chunk_size(dims)
-% arguments
-%   dims (1,:) {mustBeInteger,mustBePositive}
-% end
-
-assert(isvector(dims), 'dims must be a vector')
-mustBePositive(dims)
+arguments
+  dims (1,:) {mustBeInteger,mustBePositive}
+end
 
 CHUNK_BASE = 16000;  % Multiplier by which chunks are adjusted
 CHUNK_MIN = 8000;    % lower limit: 8 kbyte

+stdlib/canonical.m

@@ -14,13 +14,12 @@
 % https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html#getCanonicalPath()
 
 function c = canonical(p, expand_tilde, use_java)
-% arguments
-%   p (1,1) string
-%   expand_tilde (1,1) logical = true
-%   use_java (1,1) logical = false
-% end
-if nargin < 2, expand_tilde = true; end
-if nargin < 3, use_java = false; end
+arguments
+  p (1,1) string
+  expand_tilde (1,1) logical = true
+  use_java (1,1) logical = false
+end
+
 
 if expand_tilde
   c = stdlib.expanduser(p, use_java);
@@ -61,6 +60,6 @@
 
 end
 
-%!assert(canonical(""), "")
-%!assert(canonical("~"), homedir())
-%!assert(canonical("a/b/.."), "a")
+%!assert(canonical("", 1, 0), "")
+%!assert(canonical("~", 1, 0), homedir())
+%!assert(canonical("a/b/..", 1, 0), "a")

+stdlib/checkRAM.m

@@ -6,10 +6,10 @@
 % certainly CAN'T create an array without digging deep into swap or worse.
 
 function [OK,newSizeBytes,freebytes] = checkRAM(newSize, myclass)
-% arguments
-%   newSize (1,:) {mustBeNumeric}
-%   myclass (1,1) string
-% end
+arguments
+  newSize (1,:) {mustBeNumeric}
+  myclass (1,1) string
+end
 
 % get available RAM
 freebytes = stdlib.ram_free();

+stdlib/create_symlink.m

@@ -9,10 +9,10 @@
 % Ref: https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/Files.html#createSymbolicLink(java.nio.file.Path,java.nio.file.Path,java.nio.file.attribute.FileAttribute...)
 
 function ok = create_symlink(target, link)
-% arguments
-%   target (1,1) string
-%   link (1,1) string
-% end
+arguments
+  target (1,1) string
+  link (1,1) string
+end
 
 if stdlib.isoctave()
 

+stdlib/diskfree.m

@@ -6,9 +6,9 @@
 % Ref: https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html#getUsableSpace()
 
 function f = diskfree(d)
-% arguments
-%   d (1,1) string
-% end
+arguments
+  d (1,1) string
+end
 
 if stdlib.isoctave()
   o = javaObject("java.io.File", d);

+stdlib/drop_slash.m

@@ -1,9 +1,9 @@
 %% DROP_SLASH drop repeated and trailing slash
 
 function d = drop_slash(p)
-% arguments
-%   p (1,1) string
-% end
+arguments
+  p (1,1) string
+end
 
 s = stdlib.posix(p);
 

+stdlib/exists.m

@@ -11,11 +11,10 @@
 %
 
 function ok = exists(p, use_java)
-% arguments
-%   p (1,1) string
-%   use_java (1,1) logical = false
-% end
-if nargin < 2, use_java = false; end
+arguments
+  p (1,1) string
+  use_java (1,1) logical = false
+end
 
 if stdlib.isoctave()
   ok = javaObject("java.io.File", p).exists();

+stdlib/expanduser.m

@@ -8,11 +8,10 @@
 % * e: expanded path
 
 function e = expanduser(p, use_java)
-% arguments
-%   p (1,1) string
-%   use_java (1,1) logical = false
-% end
-if nargin < 2, use_java = false; end
+arguments
+  p (1,1) string
+  use_java (1,1) logical = false
+end
 
 e = stdlib.drop_slash(p);
 
@@ -30,26 +29,28 @@
 
 home = stdlib.homedir(use_java);
 
-if ~isempty(home)
-  d = home;
-  if L < 2
-    e = d;
-    return
-  end
-
-  if ischar(e)
-    e = strcat(d, '/', e(3:end));
-  else
-    e = d + "/" + extractAfter(e, 2);
-  end
+if stdlib.len(home) == 0
+  return
+end
+
+d = home;
+if L < 2
+  e = d;
+  return
+end
+
+if ischar(e)
+  e = strcat(d, '/', e(3:end));
+else
+  e = d + "/" + extractAfter(e, 2);
 end
 
 end
 
 
-%!assert(expanduser(''), '')
-%!assert(expanduser("~"), homedir())
-%!assert(expanduser("~/"), homedir())
-%!assert(expanduser("~user"), "~user")
-%!assert(expanduser("~user/"), "~user")
-%!assert(expanduser("~///c"), strcat(homedir(), "/c"))
+%!assert(expanduser('', 0), '')
+%!assert(expanduser("~", 0), homedir())
+%!assert(expanduser("~/", 0), homedir())
+%!assert(expanduser("~user", 0), "~user")
+%!assert(expanduser("~user/", 0), "~user")
+%!assert(expanduser("~///c", 0), strcat(homedir(), "/c"))

+stdlib/file_checksum.m

@@ -10,10 +10,10 @@
 % 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, method)
-% arguments
-%   file (1,1) string {mustBeFile}
-%   method (1,1) string
-% end
+arguments
+  file (1,1) string {mustBeFile}
+  method (1,1) string
+end
 
 if strcmp(method, "sha256") || strcmp(method, "SHA256")
   method = "SHA-256";

+stdlib/file_size.m

@@ -1,11 +1,10 @@
 % FILE_SIZE size in bytes of file
 
 function s = file_size(p, use_java)
-% arguments
-%   p (1,1) string {mustBeFile}
-%   use_java (1,1) logical = false
-% end
-if nargin < 2, use_java = false; end
+arguments
+  p (1,1) string {mustBeFile}
+  use_java (1,1) logical = false
+end
 
 if stdlib.isoctave()
   s = javaObject("java.io.File", p).length();