matlabengine 25.2.2__tar.gz → 26.1.12__tar.gz

{matlabengine-25.2.2 → matlabengine-26.1.12}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: matlabengine
-Version: 25.2.2
+Version: 26.1.12
 Summary: A module to call MATLAB from Python
 Home-page: https://github.com/mathworks/matlab-engine-for-python/
 Author: MathWorks
@@ -9,16 +9,27 @@ Project-URL: Documentation, https://www.mathworks.com/help/matlab/matlab-engine-
 Project-URL: Source, https://github.com/mathworks/matlab-engine-for-python
 Project-URL: Tracker, https://github.com/mathworks/matlab-engine-for-python/issues
 Keywords: MATLAB,MATLAB Engine for Python
-Platform: UNKNOWN
 Classifier: Natural Language :: English
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.9, <3.13
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.9, <3.14
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-python
+Dynamic: summary
 
 # MATLAB Engine API for Python
 
@@ -28,11 +39,11 @@ The MATLAB&reg; Engine API for Python&reg; provides a package to integrate MATLA
 ## Requirements
 ### Required MathWorks Products
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
-* MATLAB release R2025b
+* MATLAB release R2026a
 
 ### Required 3rd Party Products
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
-* Python 3.9, 3.10, 3.11, or 3.12
+* Python 3.9, 3.10, 3.11, 3.12, or 3.13
     * Supported Python versions by MATLAB release can be found [here](https://www.mathworks.com/support/requirements/python-compatibility.html).
 
 ---
@@ -43,7 +54,7 @@ The MATLAB&reg; Engine API for Python&reg; provides a package to integrate MATLA
 MATLAB Engine API for Python can be installed directly from the Python Package Index.
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
 ```bash
-$ python -m pip install matlabengine==25.2.2
+$ python -m pip install matlabengine==26.1.12
 ```
 
 
@@ -51,7 +62,7 @@ $ python -m pip install matlabengine==25.2.2
 ### Linux&reg; 
 Prior to installation, check the default install location of MATLAB by calling ```matlabroot``` in a MATLAB Command Window. By default, Linux installs MATLAB at:<br>
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
-```/usr/local/MATLAB/R2025b```
+```/usr/local/MATLAB/R2026a```
 
 When MATLAB is not installed in the default location, the bin/*architecture* directory within the MATLAB root directory must be added to the environment variable LD_LIBRARY_PATH. The path can be added to the environment variable within the shell startup configuration file (for example, .bashrc for bash shell or .tcshrc for tcsh).
 
@@ -68,14 +79,14 @@ setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:<matlabroot>/bin/glnxa64
 MATLAB Engine API for Python can be installed directly from the Python Package Index.
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
 ```bash
-$ python -m pip install matlabengine==25.2.2
+$ python -m pip install matlabengine==26.1.12
 ```
 
 ### macOS
 Prior to installation, check the default install location of MATLAB by calling ```matlabroot``` in a MATLAB Command Window. By default, macOS installs MATLAB at:<br>
 
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
-```/Applications/MATLAB_R2025b.app```
+```/Applications/MATLAB_R2026a.app```
 
 When MATLAB is not installed in the default location, the bin/*architecture* directory within the MATLAB root directory must be added to the environment variable DYLD_LIBRARY_PATH. The path can be added to the environment variable within the shell startup configuration file (for example, .bashrc for bash shell or .tcshrc for tcsh).
 
@@ -92,7 +103,7 @@ setenv DYLD_LIBRARY_PATH ${DYLD_LIBRARY_PATH}:<matlabroot>/bin/maci64
 MATLAB Engine API for Python can be installed directly from the Python Package Index.
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
 ```bash
-$ python -m pip install matlabengine==25.2.2
+$ python -m pip install matlabengine==26.1.12
 ```
 
 ---
@@ -160,5 +171,3 @@ Linux&reg; is the registered trademark of Linus Torvalds in the U.S. and other c
 Mac OS is a trademark of Apple Inc., registered in the U.S. and other countries.
 
 "Python" and the Python logos are trademarks or registered trademarks of the Python Software Foundation, used by MathWorks with permission from the Foundation.
-
-

{matlabengine-25.2.2 → matlabengine-26.1.12}/README.md

@@ -6,11 +6,11 @@ The MATLAB® Engine API for Python® provides a package to integrate MATLA
 ## Requirements
 ### Required MathWorks Products
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
-* MATLAB release R2025b
+* MATLAB release R2026a
 
 ### Required 3rd Party Products
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
-* Python 3.9, 3.10, 3.11, or 3.12
+* Python 3.9, 3.10, 3.11, 3.12, or 3.13
     * Supported Python versions by MATLAB release can be found [here](https://www.mathworks.com/support/requirements/python-compatibility.html).
 
 ---
@@ -21,7 +21,7 @@ The MATLAB&reg; Engine API for Python&reg; provides a package to integrate MATLA
 MATLAB Engine API for Python can be installed directly from the Python Package Index.
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
 ```bash
-$ python -m pip install matlabengine==25.2.2
+$ python -m pip install matlabengine==26.1.12
 ```
 
 
@@ -29,7 +29,7 @@ $ python -m pip install matlabengine==25.2.2
 ### Linux&reg; 
 Prior to installation, check the default install location of MATLAB by calling ```matlabroot``` in a MATLAB Command Window. By default, Linux installs MATLAB at:<br>
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
-```/usr/local/MATLAB/R2025b```
+```/usr/local/MATLAB/R2026a```
 
 When MATLAB is not installed in the default location, the bin/*architecture* directory within the MATLAB root directory must be added to the environment variable LD_LIBRARY_PATH. The path can be added to the environment variable within the shell startup configuration file (for example, .bashrc for bash shell or .tcshrc for tcsh).
 
@@ -46,14 +46,14 @@ setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:<matlabroot>/bin/glnxa64
 MATLAB Engine API for Python can be installed directly from the Python Package Index.
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
 ```bash
-$ python -m pip install matlabengine==25.2.2
+$ python -m pip install matlabengine==26.1.12
 ```
 
 ### macOS
 Prior to installation, check the default install location of MATLAB by calling ```matlabroot``` in a MATLAB Command Window. By default, macOS installs MATLAB at:<br>
 
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
-```/Applications/MATLAB_R2025b.app```
+```/Applications/MATLAB_R2026a.app```
 
 When MATLAB is not installed in the default location, the bin/*architecture* directory within the MATLAB root directory must be added to the environment variable DYLD_LIBRARY_PATH. The path can be added to the environment variable within the shell startup configuration file (for example, .bashrc for bash shell or .tcshrc for tcsh).
 
@@ -70,7 +70,7 @@ setenv DYLD_LIBRARY_PATH ${DYLD_LIBRARY_PATH}:<matlabroot>/bin/maci64
 MATLAB Engine API for Python can be installed directly from the Python Package Index.
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
 ```bash
-$ python -m pip install matlabengine==25.2.2
+$ python -m pip install matlabengine==26.1.12
 ```
 
 ---

{matlabengine-25.2.2 → matlabengine-26.1.12}/setup.py

@@ -1,4 +1,4 @@
-# Copyright 2024 Mathworks, Inc.
+# Copyright 2024-2026 Mathworks, Inc.
 
 from setuptools import setup, find_packages
 from setuptools.command.build_py import build_py 
@@ -21,13 +21,13 @@ class _MatlabFinder(build_py):
     }
     
     # MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string)
-    MATLAB_REL = 'R2025b'
+    MATLAB_REL = 'R2026a'
 
     # MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string)
-    MATLAB_VER = '25.2.2'
+    MATLAB_VER = '26.1.12'
 
     # MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string)
-    SUPPORTED_PYTHON_VERSIONS = set(['3.9', '3.10', '3.11', '3.12'])
+    SUPPORTED_PYTHON_VERSIONS = set(['3.9', '3.10', '3.11', '3.12', '3.13'])
 
     # MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string)
     VER_TO_REL = {
@@ -41,7 +41,8 @@ class _MatlabFinder(build_py):
         "24.1": "R2024a",
         "24.2": "R2024b",
         "25.1": "R2025a",
-        "25.2": "R2025b"
+        "25.2": "R2025b",
+        "26.1": "R2026a"
     }
 
     DEFAULT_INSTALLS = {
@@ -104,6 +105,8 @@ class _MatlabFinder(build_py):
                 self.arch = 'maci64'
         else:
             raise RuntimeError(self.unsupported_platform.format(platform=self.platform))
+        
+        self._print_if_verbose(f'{self.platform=}; {self.path_env_var_name=}; {self.arch=}')
     
     def set_python_version(self):
         """
@@ -114,12 +117,16 @@ class _MatlabFinder(build_py):
 
         if self.python_ver not in self.SUPPORTED_PYTHON_VERSIONS:
             raise RuntimeError(self.unsupported_python.format(python=self.python_ver, supported=str(self.SUPPORTED_PYTHON_VERSIONS)))
+            
+        self._print_if_verbose(f'{self.python_ver=}')
 
     def unix_default_install_exists(self):
         """
         Determines whether MATLAB is installed in default UNIX location.
         """
         path = self.DEFAULT_INSTALLS[self.platform]
+        self._print_if_verbose(f'From unix_default_install_exists: {self.platform=}; {path=}')
+        self._print_if_verbose(f'{os.path.exists(path)=}')
         if not os.path.exists(path):
             return False
         
@@ -127,6 +134,8 @@ class _MatlabFinder(build_py):
             # On Mac, we need to further verify that there is a 'bin/maci64' subdir if the Python is maci64
             # or a 'bin/maca64' subdir if the Python is maca64.
             path_to_bin = os.path.join(path, 'bin', self.arch)
+            self._print_if_verbose(f'From unix_default_install_exists: {path_to_bin=}')
+            self._print_if_verbose(f'{os.path.exists(path_to_bin)=}')
             if os.path.exists(path_to_bin):
                 # The path exists, and we don't need to do anything further.
                 return True
@@ -143,6 +152,7 @@ class _MatlabFinder(build_py):
                 # location that has the wrong arch. The user can choose whether to change the
                 # Python interpreter or the MATLAB installation so that the arch will match.
                 self.found_matlab_with_wrong_arch_in_default_install = path
+                self._print_if_verbose(f'{self.found_matlab_with_wrong_arch_in_default_install}')
                 return False
                 
         return True
@@ -156,6 +166,7 @@ class _MatlabFinder(build_py):
         if self.path_env_var_name in os.environ:
             path_string = os.environ[self.path_env_var_name]
             path_dirs.extend(path_string.split(os.pathsep))
+        self._print_if_verbose(f'{path_dirs=}')
         
         if not path_dirs:
             raise RuntimeError(self.install_or_set_path.format(
@@ -284,6 +295,7 @@ class _MatlabFinder(build_py):
             raise RuntimeError(f"{self.invalid_version_from_matlab_ver.format(ver=matlab_ver)}")
         eng_major_minor = self._get_engine_ver_major_minor(self.MATLAB_VER)
         matlab_ver_major_minor = (matlab_ver_match.group(1), matlab_ver_match.group(2))
+        self._print_if_verbose(f'{matlab_ver_major_minor=}; {eng_major_minor=}')
         return (matlab_ver_major_minor == eng_major_minor)
     
     def verify_matlab_release(self, root):
@@ -305,6 +317,7 @@ class _MatlabFinder(build_py):
             elif child.tag == 'version':
                 major, minor = self._get_engine_ver_major_minor(child.text)
                 self.found_matlab_version = f'{major}.{minor}'
+        self._print_if_verbose(f'{matlab_release=}; {self.MATLAB_REL=}')
         return matlab_release == self.MATLAB_REL
 
     def search_path_for_directory_unix(self, arch, path_dirs):
@@ -373,6 +386,7 @@ class _MatlabFinder(build_py):
             root_file.write(bin_arch + '\n')
             root_file.write(engine_arch + '\n')
             root_file.write(extern_bin)
+        self._print_if_verbose(f'{file_location=}; {bin_arch=}; {engine_arch=}; {extern_bin=}')
 
     def run(self):
         """
@@ -419,7 +433,7 @@ if __name__ == '__main__':
     setup(
         name="matlabengine",
         # MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string)
-        version="25.2.2",
+        version="26.1.12",
         description='A module to call MATLAB from Python',
         author='MathWorks',
         license="LICENSE.txt, located in this repository",
@@ -447,8 +461,9 @@ if __name__ == '__main__':
             "Programming Language :: Python :: 3.9",
             "Programming Language :: Python :: 3.10",
             "Programming Language :: Python :: 3.11",
-            "Programming Language :: Python :: 3.12"
+            "Programming Language :: Python :: 3.12",
+            "Programming Language :: Python :: 3.13"
         ],
         # MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string)
-        python_requires=">=3.9, <3.13"
+        python_requires=">=3.9, <3.14"
     )

matlabengine-26.1.12/src/matlab/__init__.py

@@ -0,0 +1,263 @@
+# Copyright 2021-2025 MathWorks, Inc.
+"""
+Array interface between Python and MATLAB
+
+This package defines classes and exceptions that create and manage
+multidimensional arrays in Python that are passed between Python and MATLAB.
+
+Modules
+-------
+    * mcpyarray - type-specific multidimensional array classes for working
+    with MATLAB, implemented in C++
+"""
+
+import os
+import platform
+import sys
+import warnings
+from pkgutil import extend_path
+__path__ = extend_path(__path__, '__name__')
+
+_package_folder = os.path.dirname(os.path.realpath(__file__))
+sys.path.append(_package_folder)
+
+# This code allows us to put the proper extern/bin/<arch> directory on the Python path 
+# to avoid a situation in which some shared libraries are loaded from a MATLAB while
+# others are loaded from a runtime. The first directory on the path that contains
+# the string "bin/<arch>" (with the proper directory separator)
+# will be checked. If it is "extern/bin/<arch>", it will be used as the
+# extern/bin/<arch> directory. Otherwise, we'll go up two directories and down
+# to extern/bin/<arch>.
+class _MiniPathInitializer(object):
+    PLATFORM_DICT = {'Windows': 'PATH', 'Linux': 'LD_LIBRARY_PATH', 'Darwin': 'DYLD_LIBRARY_PATH'}
+
+    def __init__(self):
+        self.arch = ''
+        self.extern_bin_dir = ''
+        self.path_var = ''
+        self.system = ''
+            
+    def get_platform_info(self):
+        """Ask Python for the platform and architecture."""
+        # This will return 'Windows', 'Linux', or 'Darwin' (for Mac).
+        self.system = platform.system() 
+        if not self.system in _MiniPathInitializer.PLATFORM_DICT:
+            raise RuntimeError('{0} is not a supported platform.'.format(self.system))
+        else:
+            # path_var is the OS-dependent name of the path variable ('PATH', 'LD_LIBRARY_PATH', "DYLD_LIBRARY_PATH')
+            self.path_var = _MiniPathInitializer.PLATFORM_DICT[self.system]
+
+        if self.system == 'Windows':
+            self.arch = 'win64'
+        elif self.system == 'Linux':
+            self.arch = 'glnxa64'
+        elif self.system == 'Darwin':
+            # determine ARM or Intel Mac machine
+            if platform.mac_ver()[-1] == 'arm64':
+                self.arch = 'maca64'
+            else:
+                self.arch = 'maci64'
+        else:
+            raise RuntimeError('Operating system {0} is not supported.'.format(self.system))
+
+    def get_extern_bin_from_path_element_ending_with_runtime_arch(self, dir_found):
+        extern_bin_dir = ''
+        path_components = dir_found.split(os.sep)
+        
+        if path_components[-1]:
+            last_path_component = path_components[-1]
+            possible_extern = -3
+        else:
+            # The directory name ended with a slash, so the last item in the list was an empty string. Go back one more.
+            last_path_component = path_components[-2]
+            possible_extern = -4
+
+        if last_path_component != self.arch:
+            output_str = ''.join(('To call deployed MATLAB code on a {0} machine, you must run a {0} version of Python, ',
+                'and your {1} variable must contain an element pointing to "<MR>{2}runtime{2}{0}", ',
+                'where "<MR>" indicates a MATLAB or MATLAB Runtime root. ',
+                'Instead, the value found was as follows: {3}'))
+            raise RuntimeError(output_str.format(self.arch, self.path_var, os.sep, dir_found))
+
+        if (len(path_components) + possible_extern) >= 0 and path_components[possible_extern] == 'extern':
+            extern_bin_dir = dir_found
+        else:
+            mroot = os.path.dirname(os.path.dirname(os.path.normpath(dir_found)))
+            extern_bin_dir = os.path.join(mroot, 'extern', 'bin', self.arch)
+            
+        return extern_bin_dir
+
+    def get_extern_bin_from_py_sys_path(self):
+        #Retrieve Python sys.path as a single string, and search for the substring "extern/bin/<arch>" (with
+        #the proper directory separator). If it's already present, assume it's the one we want.
+        substr_to_find = os.path.join('extern', 'bin', self.arch)
+        for item in sys.path:
+            if item.find(substr_to_find) != -1:
+                return item
+        return ''
+        
+    def put_extern_bin_on_py_sys_path(self):
+        """ 
+        Look through the system path for the first directory ending with "runtime/<arch>" or
+        "bin/<arch>" (with/without trailing slash). Use this to construct a new path ending 
+        with "extern/bin/<arch>".
+        """
+
+        path_elements = []
+        path_elements_orig = ''
+        if self.path_var in os.environ:
+            path_elements_orig = os.environ[self.path_var]
+            # On Windows, some elements of the path may use forward slashes while others use backslashes. 
+            # Make them all backslashes.
+            if self.system == 'Windows':
+                path_elements_orig = path_elements_orig.replace('/', '\\')
+            path_elements = path_elements_orig.split(os.pathsep)
+        if not path_elements:
+            if self.system == 'Darwin':
+                raise RuntimeError('On the Mac, you must run mwpython rather than python ' + 
+                    'to start a session or script that imports your package. ' +
+                    'For more details, execute "mwpython -help" or see the package documentation.')
+            else:
+                raise RuntimeError('On {0}, you must set the environment variable "{1}" to a non-empty string. {2}'.format(
+                    self.system, self.path_var, 
+                    'For more details, see the package documentation.'))
+
+        dir_to_search = os.path.join('runtime', self.arch)
+        trailing_substrings_to_find = [dir_to_search, dir_to_search + os.sep]
+
+        # First, look for a path ending with "runtime/<arch>". If found, use it
+        # to find a path ending with "extern/bin/<arch>".
+        extern_bin_dir = ''
+        for elem in path_elements:
+            for trailing_substring in trailing_substrings_to_find:
+                if elem.endswith(trailing_substring):
+                    extern_bin_dir = self.get_extern_bin_from_path_element_ending_with_runtime_arch(elem)
+                    if extern_bin_dir:
+                        break
+
+        if not extern_bin_dir:
+            # Look for a path ending with "extern/bin/<arch>".
+            dir_to_search = os.path.join('extern', 'bin', self.arch)
+            trailing_substrings_to_find = [dir_to_search, dir_to_search + os.sep]
+
+            extern_bin_dir = ''
+            for elem in path_elements:
+                for trailing_substring in trailing_substrings_to_find:
+                    if elem.endswith(trailing_substring):
+                        extern_bin_dir = elem
+                        if extern_bin_dir:
+                            break
+            
+        if not extern_bin_dir:
+            format_str = 'Could not find an appropriate directory in {0} from which to read binaries. Details::\n{1}'
+            raise RuntimeError(format_str.format(self.path_var, path_elements_orig))
+        
+        if not os.path.isdir(extern_bin_dir):
+            raise RuntimeError('Could not find the directory {0}'.format(extern_bin_dir))
+        self.extern_bin_dir = extern_bin_dir
+        sys.path.insert(0, self.extern_bin_dir)
+
+def get_python_version():
+    # UPDATE_IF_PYTHON_VERSION_ADDED_OR_REMOVED : search for this string in codebase 
+    # when support for a Python version must be added or removed
+    _supported_versions = ['3_9', '3_10', '3_11', '3_12', '3_13']
+    _ver = sys.version_info
+    _version = '{0}_{1}'.format(_ver[0], _ver[1])  
+    newer_than_supported = _ver[1] > 12  
+
+    _PYTHONVERSION = None
+
+    if _version in _supported_versions:
+        _PYTHONVERSION = _version
+    elif newer_than_supported:
+        warnings.warn('Python versions 3.9, 3.10, 3.11, 3.12, and 3.13 are supported, but your version of Python is %s' % _version)
+        _PYTHONVERSION = _version  
+    else:
+        raise EnvironmentError("Python %s is not supported." % _version)
+
+    return _PYTHONVERSION
+
+def get_arch_filename():
+    _module_folder = os.path.dirname(os.path.realpath(__file__))
+    _arch_filename = os.path.join(_module_folder, 'engine', '_arch.txt')
+    return _arch_filename
+
+def add_dll_dir_on_win(arch, dir_to_add):
+    if arch == 'win64':
+        if not dir_to_add:
+            raise RuntimeError('Cannot add empty DLL directory')
+        os.add_dll_directory(dir_to_add)
+        
+        # For the case of Windows, we also need to add the bin/win64 folder to the PATH
+        if 'PATH' in os.environ:
+            _env = os.environ['PATH']
+            os.environ['PATH'] = dir_to_add + os.pathsep + _env
+        else:
+            os.environ['PATH'] = dir_to_add
+    
+def get_dirs_from_arch_file_without_import():
+    _PYTHONVERSION = get_python_version()
+    _arch_filename = get_arch_filename()
+    firstExceptionMessage = ''
+    if not os.path.isfile(_arch_filename):
+        return False
+
+    try:
+        _arch_file = open(_arch_filename,'r')
+        _lines = _arch_file.readlines()
+        [_arch, _bin_dir,_engine_dir, _extern_bin_dir] = [x.rstrip() for x in _lines if x.rstrip() != ""]
+        _arch_file.close()
+        sys.path.insert(0,_engine_dir)
+        sys.path.insert(0,_extern_bin_dir)
+        add_dll_dir_on_win(_arch, _bin_dir)
+    except Exception as exc:
+        firstExceptionMessage = 'Please contact MathWorks Technical Support for assistance:\nDetails: {}'.format(
+            exc)
+                
+    if firstExceptionMessage:
+        return False
+    else:    
+        return True
+
+def subdir_exists(folder_name, subfolder_name):
+    return os.path.exists(os.path.join(folder_name, subfolder_name))
+
+
+_mpi = _MiniPathInitializer()
+_mpi.get_platform_info()
+extern_bin_dir = ''
+if subdir_exists(_package_folder, 'engine'):
+    success = get_dirs_from_arch_file_without_import()
+    if not success:
+        # Use the location of this file (already stored in _package_folder) to construct _bin_dir, _engine_dir, and _extern_bin_dir, 
+        # so that they are added to the Python sys.path and the OS path environment variable as necessary.
+            
+        #Use _package_folder <matlabroot>\extern\engines\python\dist\matlab to derive <matlabroot>\bin\win64
+        #<matlabroot>\extern\engines\python\dist\matlab\..\..\..\..\..\bin\win64
+        _bin_dir = os.path.join(_package_folder, '..', '..', '..', '..' ,'..', 'bin', _mpi.arch) 
+
+        if os.path.exists(_bin_dir):
+            add_dll_dir_on_win(_mpi.arch, _bin_dir)
+                
+            #Use _package_folder <matlabroot>\extern\engines\python\dist\matlab to derive <matlabroot>\extern\engines\python\dist\matlab\engine\win64
+            _engine_dir = os.path.join(_package_folder, 'engine', _mpi.arch)
+            sys.path.insert(0,_engine_dir)
+    
+            #Use _bin_dir <matlabroot>\bin\win64 to derive <matlabroot>\extern\bin\win64
+            _extern_bin_dir = os.path.join(_bin_dir, '..', '..', 'extern', 'bin', _mpi.arch)
+            sys.path.insert(0,_extern_bin_dir)
+        else:
+            raise RuntimeError('unable to read {}'.format(get_arch_filename()))
+else:
+    extern_bin_dir = _mpi.get_extern_bin_from_py_sys_path()
+    if not extern_bin_dir:
+        _mpi.put_extern_bin_on_py_sys_path()
+        extern_bin_dir = _mpi.extern_bin_dir
+
+    bin_dir = extern_bin_dir.replace('extern' + os.sep + 'bin', 'bin')
+    add_dll_dir_on_win(_mpi.arch, bin_dir)
+        
+        
+from matlabmultidimarrayforpython import double, single, uint8, int8, uint16, \
+    int16, uint32, int32, uint64, int64, logical, ShapeError, SizeError
+

{matlabengine-25.2.2 → matlabengine-26.1.12}/src/matlab/engine/__init__.py

@@ -1,4 +1,4 @@
-#Copyright 2014-2024 MathWorks, Inc.
+#Copyright 2014-2025 MathWorks, Inc.
 
 """
 The MATLAB Engine enables you to call any MATLAB statement either synchronously
@@ -30,10 +30,10 @@ import warnings
 # UPDATE_IF_PYTHON_VERSION_ADDED_OR_REMOVED : search for this string in codebase 
 # when support for a Python version must be added or removed
 
-_supported_versions = ['3_9', '3_10', '3_11', '3_12']
+_supported_versions = ['3_9', '3_10', '3_11', '3_12', '3_13']
 _ver = sys.version_info
 _version = '{0}_{1}'.format(_ver[0], _ver[1])
-_newer_than_supported = _ver[1] > 12
+_newer_than_supported = _ver[1] > 13
 
 _PYTHONVERSION = None
 
@@ -41,12 +41,12 @@ if _version in _supported_versions:
     _PYTHONVERSION = _version
 elif _newer_than_supported:
     warnings.warn('MATLAB Engine for Python supports Python version'
-                    ' 3.9, 3.10, 3.11, and 3.12, but your version of Python '
+                    ' 3.9, 3.10, 3.11, 3.12, and 3.13, but your version of Python '
                     'is %s' % _version)
-    _PYTHONVERSION = _version  
+    _PYTHONVERSION = _version
 else:
     raise EnvironmentError('MATLAB Engine for Python supports Python version'
-                        ' 3.9, 3.10, 3.11, and 3.12, but your version of Python '
+                        ' 3.9, 3.10, 3.11, 3.12, and 3.13, but your version of Python '
                         'is %s' % _version)
 
 

{matlabengine-25.2.2 → matlabengine-26.1.12}/src/matlab/engine/matlabengine.py

@@ -1,4 +1,4 @@
-#Copyright 2014-2017 MathWorks, Inc.
+#Copyright 2014-2025 MathWorks, Inc.
 
 """
 MatlabEngine: The class name of MATLAB Engine.  You can call MATLAB software as
@@ -126,11 +126,15 @@ class MatlabWorkSpace(object):
        
         _method=MatlabFunc(self._engine(), "assignin")
         return  _method("base", attr, value, nargout=0)
-        
+
+    def __str__(self):
+        return self.__repr__()
+
     def __repr__(self):
-        _method = MatlabFunc(self._engine(), "whos")
-        _method(nargout=0)
-        return ""
+        # 'evalc' evaluates a MATLAB expression, redirecting stdout to a variable. 
+        # Here, we use it to redirect the stdout of 'whos' to a string.
+        _evalcMethodHandle = MatlabFunc(self._engine(), "evalc")
+        return _evalcMethodHandle('whos')
 
     def __setattr__(self, kw, value):
         raise AttributeError(pythonengine.getMessage('AttrCannotBeAddedToMWS'))

{matlabengine-25.2.2 → matlabengine-26.1.12}/src/matlabengine.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: matlabengine
-Version: 25.2.2
+Version: 26.1.12
 Summary: A module to call MATLAB from Python
 Home-page: https://github.com/mathworks/matlab-engine-for-python/
 Author: MathWorks
@@ -9,16 +9,27 @@ Project-URL: Documentation, https://www.mathworks.com/help/matlab/matlab-engine-
 Project-URL: Source, https://github.com/mathworks/matlab-engine-for-python
 Project-URL: Tracker, https://github.com/mathworks/matlab-engine-for-python/issues
 Keywords: MATLAB,MATLAB Engine for Python
-Platform: UNKNOWN
 Classifier: Natural Language :: English
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.9, <3.13
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.9, <3.14
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-python
+Dynamic: summary
 
 # MATLAB Engine API for Python
 
@@ -28,11 +39,11 @@ The MATLAB&reg; Engine API for Python&reg; provides a package to integrate MATLA
 ## Requirements
 ### Required MathWorks Products
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
-* MATLAB release R2025b
+* MATLAB release R2026a
 
 ### Required 3rd Party Products
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
-* Python 3.9, 3.10, 3.11, or 3.12
+* Python 3.9, 3.10, 3.11, 3.12, or 3.13
     * Supported Python versions by MATLAB release can be found [here](https://www.mathworks.com/support/requirements/python-compatibility.html).
 
 ---
@@ -43,7 +54,7 @@ The MATLAB&reg; Engine API for Python&reg; provides a package to integrate MATLA
 MATLAB Engine API for Python can be installed directly from the Python Package Index.
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
 ```bash
-$ python -m pip install matlabengine==25.2.2
+$ python -m pip install matlabengine==26.1.12
 ```
 
 
@@ -51,7 +62,7 @@ $ python -m pip install matlabengine==25.2.2
 ### Linux&reg; 
 Prior to installation, check the default install location of MATLAB by calling ```matlabroot``` in a MATLAB Command Window. By default, Linux installs MATLAB at:<br>
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
-```/usr/local/MATLAB/R2025b```
+```/usr/local/MATLAB/R2026a```
 
 When MATLAB is not installed in the default location, the bin/*architecture* directory within the MATLAB root directory must be added to the environment variable LD_LIBRARY_PATH. The path can be added to the environment variable within the shell startup configuration file (for example, .bashrc for bash shell or .tcshrc for tcsh).
 
@@ -68,14 +79,14 @@ setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:<matlabroot>/bin/glnxa64
 MATLAB Engine API for Python can be installed directly from the Python Package Index.
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
 ```bash
-$ python -m pip install matlabengine==25.2.2
+$ python -m pip install matlabengine==26.1.12
 ```
 
 ### macOS
 Prior to installation, check the default install location of MATLAB by calling ```matlabroot``` in a MATLAB Command Window. By default, macOS installs MATLAB at:<br>
 
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
-```/Applications/MATLAB_R2025b.app```
+```/Applications/MATLAB_R2026a.app```
 
 When MATLAB is not installed in the default location, the bin/*architecture* directory within the MATLAB root directory must be added to the environment variable DYLD_LIBRARY_PATH. The path can be added to the environment variable within the shell startup configuration file (for example, .bashrc for bash shell or .tcshrc for tcsh).
 
@@ -92,7 +103,7 @@ setenv DYLD_LIBRARY_PATH ${DYLD_LIBRARY_PATH}:<matlabroot>/bin/maci64
 MATLAB Engine API for Python can be installed directly from the Python Package Index.
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
 ```bash
-$ python -m pip install matlabengine==25.2.2
+$ python -m pip install matlabengine==26.1.12
 ```
 
 ---
@@ -160,5 +171,3 @@ Linux&reg; is the registered trademark of Linus Torvalds in the U.S. and other c
 Mac OS is a trademark of Apple Inc., registered in the U.S. and other countries.
 
 "Python" and the Python logos are trademarks or registered trademarks of the Python Software Foundation, used by MathWorks with permission from the Foundation.
-
-

matlabengine-25.2.2/src/matlab/__init__.py

@@ -1,49 +0,0 @@
-# Copyright 2024 MathWorks, Inc.
-
-import os
-import platform
-import sys
-import pkgutil
-
-__path__ = pkgutil.extend_path(__path__, __name__)
-package_folder = os.path.dirname(os.path.realpath(__file__))
-sys.path.append(package_folder)
-
-def add_dirs_to_path(bin_dir, engine_dir, extern_dir):
-        """
-        Adds MATLAB engine and extern/bin directories to sys.path.
-        """
-        path = 'PATH'
-
-        if not os.path.isdir(engine_dir):
-            raise RuntimeError("Could not find directory: {0}".format(engine_dir))
-        
-        if not os.path.isdir(extern_dir):
-            raise RuntimeError("Could not find directory: {0}".format(extern_dir))
-        
-        if platform.system() == 'Windows':
-            if not os.path.isdir(bin_dir):
-                raise RuntimeError("Could not find directory: {0}".format(bin_dir))
-            if path in os.environ:
-                paths = os.environ[path]
-                os.environ[path] = bin_dir + os.pathsep + paths
-            else:
-                os.environ[path] = bin_dir
-            if sys.version_info.major >= 3 and sys.version_info.minor >= 8:
-                os.add_dll_directory(bin_dir)
-
-        sys.path.insert(0, engine_dir)
-        sys.path.insert(0, extern_dir)
-
-arch_file = os.path.join(package_folder, 'engine', '_arch.txt')
-if not os.path.isfile(arch_file):
-    raise RuntimeError("The MATLAB Engine for Python install is corrupted. Please try to re-install.")
-
-with open(arch_file, 'r') as root:
-    [arch, bin_folder, engine_folder, extern_bin] = [line.strip() for line in root.readlines()]
-
-
-add_dirs_to_path(bin_folder, engine_folder, extern_bin)
-
-from matlabmultidimarrayforpython import double, single, uint8, int8, uint16, \
-    int16, uint32, int32, uint64, int64, logical, ShapeError, SizeError