stdlib.python namespace

scivision · scivision · commit ea3303d0f48d · 2025-07-24T18:28:04.000-04:00
Though intended for internal use, this facilitates testing and sharing
diff --git a/+stdlib/+python/create_symlink.m b/+stdlib/+python/create_symlink.m
@@ -1,4 +1,4 @@
-function ok = py_create_symlink(target, link)
+function ok = create_symlink(target, link)
 
 try
   py.os.symlink(target, link);
diff --git a/+stdlib/+python/device.m b/+stdlib/+python/device.m
@@ -1,4 +1,4 @@
-function i = py_device(p)
+function i = device(p)
 
 i = uint64(int64(py.os.stat(p).st_dev));
 % int64 first is for Matlab <= R2022a
diff --git a/+stdlib/+python/disk_available.m b/+stdlib/+python/disk_available.m
@@ -1,4 +1,4 @@
-function f = py_disk_available(d)
+function f = disk_available(d)
 
 di = py.shutil.disk_usage(d);
 
diff --git a/+stdlib/+python/disk_capacity.m b/+stdlib/+python/disk_capacity.m
@@ -1,4 +1,4 @@
-function f = py_disk_capacity(d)
+function f = disk_capacity(d)
 
 di = py.shutil.disk_usage(d);
 
diff --git a/+stdlib/+python/get_hostname.m b/+stdlib/+python/get_hostname.m
@@ -1,4 +1,4 @@
-function n = py_hostname()
+function n = get_hostname()
 
 n = py.socket.gethostname();
 
diff --git a/+stdlib/+python/get_owner.m b/+stdlib/+python/get_owner.m
@@ -1,4 +1,4 @@
-function n = py_get_owner(p)
+function n = get_owner(p)
 
 n = string(py.str(py.pathlib.Path(p).owner()));
 
diff --git a/+stdlib/+python/hard_link_count.m b/+stdlib/+python/hard_link_count.m
@@ -1,4 +1,4 @@
-function c = py_hard_link_count(p)
+function c = hard_link_count(p)
 
 c = double(py.os.stat(p).st_nlink);
 
diff --git a/+stdlib/+python/is_admin.m b/+stdlib/+python/is_admin.m
@@ -1,4 +1,4 @@
-function y = py_is_admin()
+function y = is_admin()
 
 if isunix()
   y = py.os.getuid() == 0;
diff --git a/+stdlib/+python/is_symlink.m b/+stdlib/+python/is_symlink.m
@@ -1,4 +1,4 @@
-function y = py_is_symlink(p)
+function y = is_symlink(p)
 
 y = py.pathlib.Path(p).is_symlink();
 
diff --git a/+stdlib/+python/ram_free.m b/+stdlib/+python/ram_free.m
@@ -1,4 +1,4 @@
-function n = py_ram_free()
+function n = ram_free()
 
 try
   vm = py.psutil.virtual_memory();
diff --git a/+stdlib/+python/read_symlink.m b/+stdlib/+python/read_symlink.m
@@ -1,4 +1,4 @@
-function r = py_read_symlink(p)
+function r = read_symlink(p)
 
 % https://docs.python.org/3/library/pathlib.html#pathlib.Path.readlink
 r = string(py.os.readlink(p));
diff --git a/+stdlib/+python/set_modtime.m b/+stdlib/+python/set_modtime.m
@@ -1,4 +1,4 @@
-function ok = py_set_modtime(p, utc)
+function ok = set_modtime(p, utc)
 
 try
   s = py.os.stat(p);
diff --git a/+stdlib/+python/version.m b/+stdlib/+python/version.m
@@ -1,4 +1,4 @@
-function v = pvt_get_python_version()
+function v = version()
 
 % Matlab < R2022a has a bug in the JIT compiler that breaks try-catch
 % for any py.* command. We use a separate private function to workaround that.
diff --git a/+stdlib/create_symlink.m b/+stdlib/create_symlink.m
@@ -29,7 +29,7 @@
       if strempty(target) || strempty(link), return, end
 
       if stdlib.has_python()
-        ok = py_create_symlink(target, link);
+        ok = stdlib.python.create_symlink(target, link);
       elseif stdlib.dotnet_api() >= 6
         ok = dotnet_create_symlink(target, link);
       else
diff --git a/+stdlib/device.m b/+stdlib/device.m
@@ -8,7 +8,7 @@
 i = [];
 
 if stdlib.has_python()
-  i = py_device(p);
+  i = stdlib.python.device(p);
 elseif ispc() && stdlib.has_dotnet()
   i = device_dotnet(p);
 elseif stdlib.isoctave()
diff --git a/+stdlib/disk_available.m b/+stdlib/disk_available.m
@@ -18,7 +18,7 @@
 elseif stdlib.has_java()
   f = javaObject("java.io.File", d).getUsableSpace();
 elseif stdlib.has_python()
-  f = py_disk_available(d);
+  f = stdlib.python.disk_available(d);
 end
 
 f = uint64(f);
diff --git a/+stdlib/disk_capacity.m b/+stdlib/disk_capacity.m
@@ -16,7 +16,7 @@
 elseif stdlib.has_java()
   f = javaObject("java.io.File", d).getTotalSpace();
 elseif stdlib.has_python()
-  f = py_disk_capacity(d);
+  f = stdlib.python.disk_capacity(d);
 end
 
 f = uint64(f);
diff --git a/+stdlib/get_owner.m b/+stdlib/get_owner.m
@@ -12,7 +12,7 @@
 
 
 if ~ispc() && stdlib.has_python()
-  n = py_get_owner(p);
+  n = stdlib.python.get_owner(p);
 elseif stdlib.has_java()
 % https://docs.oracle.com/en/java/javase/22/docs/api/java.base/java/nio/file/Files.html#getOwner(java.nio.file.Path,java.nio.file.LinkOption...)
 % https://docs.oracle.com/en/java/javase/22/docs/api/java.base/java/nio/file/LinkOption.html
diff --git a/+stdlib/hard_link_count.m b/+stdlib/hard_link_count.m
@@ -13,7 +13,7 @@
 c = [];
 
 if stdlib.has_python()
-  c = py_hard_link_count(p);
+  c = stdlib.python.hard_link_count(p);
 elseif stdlib.isoctave()
   [s, err] = stat(p);
   if err == 0
diff --git a/+stdlib/hostname.m b/+stdlib/hostname.m
@@ -13,7 +13,7 @@
 elseif stdlib.has_java()
   n = javaMethod("getLocalHost", "java.net.InetAddress").getHostName();
 elseif stdlib.has_python()
-  n = py_hostname();
+  n = stdlib.python.get_hostname();
 elseif stdlib.isoctave()
   n = gethostname();
 end
diff --git a/+stdlib/is_admin.m b/+stdlib/is_admin.m
@@ -4,7 +4,7 @@
 
 
 if (isunix() || ~isMATLABReleaseOlderThan('R2024a')) && stdlib.has_python()
-  y = py_is_admin();
+  y = stdlib.python.is_admin();
 elseif stdlib.isoctave()
   y = getuid() == 0;
 elseif ispc() && stdlib.has_dotnet()
diff --git a/+stdlib/is_symlink.m b/+stdlib/is_symlink.m
@@ -15,7 +15,7 @@
       elseif stdlib.has_java()
         ok = java.nio.file.Files.isSymbolicLink(javaPathObject(stdlib.absolute(p)));
       elseif stdlib.has_python()
-        ok = py_is_symlink(p);
+        ok = stdlib.python.is_symlink(p);
       elseif isunix()
         ok = system(sprintf('test -L %s', p)) == 0;
       elseif ispc()
diff --git a/+stdlib/python_version.m b/+stdlib/python_version.m
@@ -34,7 +34,7 @@
 % we use a separate function because the JIT compiler in Matlab < R2022a
 % breaks try-catch for any py.* command
 
-v = pvt_get_python_version();
+v = stdlib.python.version();
 
 % cache the result
 if ~isempty(v)
diff --git a/+stdlib/ram_free.m b/+stdlib/ram_free.m
@@ -25,7 +25,7 @@
 if stdlib.has_java()
   bytes = ram_free_java();
 elseif stdlib.has_python()
-  bytes = py_ram_free();
+  bytes = stdlib.python.ram_free();
 end
 
 if bytes <= 0
diff --git a/+stdlib/read_symlink.m b/+stdlib/read_symlink.m
@@ -28,7 +28,7 @@
         % https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/Files.html#readSymbolicLink(java.nio.file.Path)
         r = java.nio.file.Files.readSymbolicLink(javaPathObject(r)).string;
       elseif stdlib.has_python()
-        r = py_read_symlink(p);
+        r = stdlib.python.read_symlink(p);
       elseif isunix()
         [s, m] = system(sprintf('readlink -fn %s', p));
         if s == 0, r = string(m); end
diff --git a/+stdlib/set_modtime.m b/+stdlib/set_modtime.m
@@ -21,7 +21,7 @@
 if stdlib.has_java()
   ok = javaObject("java.io.File", p).setLastModified(int64(utc) * 1000);
 elseif stdlib.has_python()
-  ok = py_set_modtime(p, utc);
+  ok = stdlib.python.set_modtime(p, utc);
 end
 
 end

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-function ok = py_create_symlink(target, link)`
	`1`	`+function ok = create_symlink(target, link)`
`2`	`2`
`3`	`3`	`try`
`4`	`4`	`py.os.symlink(target, link);`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-function i = py_device(p)`
	`1`	`+function i = device(p)`
`2`	`2`
`3`	`3`	`i = uint64(int64(py.os.stat(p).st_dev));`
`4`	`4`	`% int64 first is for Matlab <= R2022a`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-function f = py_disk_available(d)`
	`1`	`+function f = disk_available(d)`
`2`	`2`
`3`	`3`	`di = py.shutil.disk_usage(d);`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-function f = py_disk_capacity(d)`
	`1`	`+function f = disk_capacity(d)`
`2`	`2`
`3`	`3`	`di = py.shutil.disk_usage(d);`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-function n = py_hostname()`
	`1`	`+function n = get_hostname()`
`2`	`2`
`3`	`3`	`n = py.socket.gethostname();`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-function n = py_get_owner(p)`
	`1`	`+function n = get_owner(p)`
`2`	`2`
`3`	`3`	`n = string(py.str(py.pathlib.Path(p).owner()));`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-function c = py_hard_link_count(p)`
	`1`	`+function c = hard_link_count(p)`
`2`	`2`
`3`	`3`	`c = double(py.os.stat(p).st_nlink);`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-function y = py_is_admin()`
	`1`	`+function y = is_admin()`
`2`	`2`
`3`	`3`	`if isunix()`
`4`	`4`	`y = py.os.getuid() == 0;`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-function y = py_is_symlink(p)`
	`1`	`+function y = is_symlink(p)`
`2`	`2`
`3`	`3`	`y = py.pathlib.Path(p).is_symlink();`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-function n = py_ram_free()`
	`1`	`+function n = ram_free()`
`2`	`2`
`3`	`3`	`try`
`4`	`4`	`vm = py.psutil.virtual_memory();`