remove unneed arguments for speed

scivision · scivision · commit 2fe2cf53caca · 2025-09-15T13:11:25.000-04:00
diff --git a/+stdlib/+java/file_checksum.m b/+stdlib/+java/file_checksum.m
@@ -29,5 +29,4 @@
 
 fclose(fid);
 
-
 end
diff --git a/+stdlib/+python/is_char_device.m b/+stdlib/+python/is_char_device.m
@@ -1,11 +1,9 @@
 function y = is_char_device(file)
-arguments
-  file (1,1) string
-end
 
 try
   y = py.pathlib.Path(file).is_char_device();
-catch
+catch e
+  pythonException(e)
   y = logical.empty;
 end
 
diff --git a/+stdlib/+sys/file_checksum.m b/+stdlib/+sys/file_checksum.m
@@ -1,9 +1,5 @@
 %% SYS.FILE_CHECKSUM compute checksum of file
 function [hash, cmd] = file_checksum(file, hash_method)
-arguments
-  file (1,1) string
-  hash_method (1,1) string
-end
 
 switch lower(hash_method)
   case {"sha-256", "sha256"}
@@ -27,7 +23,10 @@
 
 [s, m] = system(cmd);
 
-assert(s == 0, "failed to compute SHA256 hash of %s: %s", file, m)
+if s ~= 0
+  hash = '';
+  return
+end
 
 switch lower(hash_method)
   case {"sha-256", "sha256"}
diff --git a/+stdlib/+sys/get_owner.m b/+stdlib/+sys/get_owner.m
@@ -1,7 +1,4 @@
 function [o, cmd] = get_owner(file)
-arguments
-  file (1,1) string
-end
 
 o = '';
 
diff --git a/+stdlib/+sys/hard_link_count.m b/+stdlib/+sys/hard_link_count.m
@@ -3,9 +3,6 @@
 % Powershell is 0, 1, or 2
 
 function [n, cmd] = hard_link_count(file)
-arguments
-  file (1,1) string
-end
 
 n = [];
 
diff --git a/+stdlib/+sys/is_char_device.m b/+stdlib/+sys/is_char_device.m
@@ -1,7 +1,4 @@
 function [ok, cmd] = is_char_device(file)
-arguments
-  file (1,1) string
-end
 
 cmd = '';
 
diff --git a/+stdlib/+sys/is_dev_drive.m b/+stdlib/+sys/is_dev_drive.m
@@ -1,7 +1,4 @@
 function [y, cmd] = is_dev_drive(fpath)
-arguments
-  fpath (1,1) string
-end
 
 y = false;
 cmd = '';
diff --git a/+stdlib/+sys/read_symlink.m b/+stdlib/+sys/read_symlink.m
@@ -1,7 +1,4 @@
 function [r, cmd] = read_symlink(file)
-arguments
-  file (1,1) string
-end
 
 r = string.empty;
 
diff --git a/+stdlib/+sys/samepath.m b/+stdlib/+sys/samepath.m
@@ -1,8 +1,4 @@
 function y = samepath(path1, path2)
-arguments
-  path1 (1,1) string
-  path2 (1,1) string
-end
 
 y = false;
 
diff --git a/+stdlib/+sys/set_modtime.m b/+stdlib/+sys/set_modtime.m
@@ -1,13 +1,11 @@
 function [ok, cmd] = set_modtime(file, dt)
-arguments
-  file (1,1) string
-  dt (1,1) datetime
-end
 
 ok = false;
 
+tiso = string(datetime(dt), "yyyy-MM-dd HH:mm:ss");
+
 if ispc()
-  cmd = sprintf('pwsh -c "(Get-Item ''%s'').LastWriteTime = ''%s''"', file, string(dt, "yyyy-MM-dd HH:mm:ss"));
+  cmd = sprintf('pwsh -c "(Get-Item ''%s'').LastWriteTime = ''%s''"', file, tiso);
 elseif ismac()
   cmd = sprintf('touch -mt %s "%s"', string(dt, "yyyyMMddHHmm"), file);
 else
diff --git a/+stdlib/resolve.m b/+stdlib/resolve.m
@@ -2,19 +2,19 @@
 % resolve path, to cwd if relative
 % effectively canonical(absolute(p))
 %%% Inputs
-% * p: path to make absolute
+% * file: path to make absolute
+% * strict: if true, return empty if path does not exist (default: false)
 %%% Outputs
 % * c: resolved path
 
 % distinct from canonical(), resolve() always returns absolute path
 % non-existant path is made absolute relative to pwd
 
-function r = resolve(p, strict)
-arguments
-  p (1,1) string
-  strict (1,1) logical = false
+function r = resolve(file, strict)
+if nargin < 2
+  strict = false;
 end
 
-r = stdlib.canonical(stdlib.absolute(p), strict);
+r = stdlib.canonical(stdlib.absolute(file), strict);
 
 end
diff --git a/AGENTS.md b/AGENTS.md
@@ -0,0 +1,27 @@
+# Matlab standard library project
+
+## Project Overview
+
+This is a standard library project for Matlab, designed to provide a collection of commonly used functions and utilities to enhance productivity and streamline development in Matlab.
+We generally are not compatible with GNU Octave as the syntax we use is too new to be supported yet by GNU Octave.
+The namespace of the project is "stdlib" as indicated by all the project functions being under directory "+stdlib/"
+
+A primary purpose of this project is to use the external language interfaces provided by Matlab to call functions written in other scripting languages IF the language interface is enabled on the specific computer where Matlab is running.
+The specific languages supported are Python (namespace stdlib.python under +stdlib/+python/), Java (namespace stdlib.java under +stdlib/+java/), Perl (namespace stdlib.perl under +stdlib/+perl/), .NET (namespace stdlib.dotnet under +stdlib/+dotnet/).
+Not every language interface may be available on every system, and the availability of specific language interfaces may depend on the installation and configuration of the Matlab environment.
+To detect if a specific language interface is available, we provide functions stdlib.has_python(), stdlib.has_java(), stdlib.has_perl(), stdlib.has_dotnet(), which return logical true or false. These stdlib.has_*() functions are intended to run very quickly, caching the result using Matlab "persistent" variables as needed to make them efficient to call multiple times.
+
+There is a namespace stdlib.sys defined under +stdlib/+sys/ that provided system() calls using the system shell as a last-restort fallback if no external language interface is available on the end user computer running Matlab.
+The namespace stdlib.native and stdlib.legacy use plain Matlab code, and allow switching between "modern" and "legacy" implementations of functions as needed.
+
+The self-test functions under "test/" directory can be used by Matlab >= R2019b as invoked by "test_main.m" at the top level of the project directory.
+Matlab >= R2022b can alternatively use "buildtool test" to run the self-tests.
+
+## Dev Rules
+
+These rules apply under the namespace "stdlib" (directory +stdlib/) and all its sub-namespaces (subdirectories +stdlib/+*).
+
+- The code syntax must work for Matlab >= R2019b
+- The code must not require any Matlab toolboxes, only base Matlab functionality
+- Prohibited to use Matlab factory function "isMATLABReleaseOlderThan()" as it is slow and not available for Matlab < R2020b. Instead we use stdlib.matlabOlderThan() which is like 200x faster than isMATLABReleaseOlderThan() and works for Matlab >= R2016b
+- When an exception is encountered, we generally desire that the code return an "empty" value of the appropriate type. In certain cases we may throw or rethrow an error.
diff --git a/example/+javafun/parent.m b/example/+javafun/parent.m
@@ -1,7 +1,4 @@
 function par = parent(pth)
-arguments
-  pth (1,1) string
-end
 
 par = java.io.File(pth).getParent();
 if isempty(par)

Original file line number	Diff line number	Diff line change
`@@ -29,5 +29,4 @@`
`29`	`29`
`30`	`30`	`fclose(fid);`
`31`	`31`
`32`		`-`
`33`	`32`	`end`