How to structure Python library and path in the same way as MATLAB

Well, the python package is probably the best way to solve your problem. You can read more here. Python packages have no need to be built and not always are created for sharing, so do not worry.

Assume you had this file structure:

Documents/
  startup.py
  PythonFunctions/
    FirstFunc.py
    SecondFunc.py

Then you can add file __init__.py in your PythonFunctions directory with next content:

__all__ = ['FirstFunc', 'SecondFunc']

Init file must be updated if you change filenames, so maybe it isn't best solution for you. Now, the directory looks like:

Documents/
  startup.py
  PythonFunctions/
    __init__.py
    FirstFunc.py
    SecondFunc.py

And it's all - PythonFunctions now is a package. You can import all files by one import statement and use them:

from PythonFunctions import *

result_one = FirstFunc.function_name(some_data)
result_two = SecondFunc.function_name(some_other_data)

And if your startup.py is somewhere else, you can update path before importing as next:

sys.path.append('C:\Users\AG5\Documents')

More detailed explanations can be found here

There is no need to write all your matlab functions within one file. You can also keep (kind of) your desired folder structure of your library. However, you should write all functions in the deepest subfolder into one *.py file.

Suppose your MATLAB library is in the folder space_engineering and is set up like this:

space_engineering\
    subfolder1\
        functiongroup1\
            printfoo.m
            printbar.m
    subfolder2\
        ...
    subfolder3\
        ...
    ...

After doing addpath(genpath('\your_path\space_engineering')) all functions in subfolders subfolder* and functiongroup* are available in the global namespace like this

>> printfoo    % function printfoo does only do fprintf('foo')
foo

I understand this is an behaviour your want to preserve in your migrated python library. And there is a way to do so. Your new python library would be structured like this:

space_engineering\
    __init__.py
    subfolder1\
        __init__.py
        functiongroup1.py
        functiongroup2.py
    subfolder2\
        __init__.py
        ...
    subfolder3\
        __init__.py
        ...
    ...

As you can see the deepest subfolder layers functiongroup* of the MATLAB structure is replaced now by functiongroup*.py files, so called modules. The only compromise you have to allow for is that functions printfoo() and printbar() are now defined in this .py modules instead of having individual .py files.

# content of functiongroup1.py
def printfoo():
    print(foo)

def printbar():
    print(bar)

To allow for doing the same function calling as in MATLAB you have to make the function names printfoo and printbar available in the global namespace by adjusting the __init__.py files of each subfolder

# content of space_enginieering\subfolder1\__init__.py
from .functiongroup1 import *
from .functiongroup2 import *

as well as the __init__.py of the main folder

# content of space_engineering\__init__.py
from .subfolder1 import *
from .subfolder2 import *
from .subfolder3 import *

The from .functiongroup1 import * statement loads all names from module functiongroup1 into the namespace of subfolder1. Successively from .subfolder1 import * will forward them to the global namespace.

Like this you can do in an python console (or in any script) e.g.:

>>> sys.path.append('\your_path\space_engineering')
>>> from space_engineering import *
>>> printfoo()
foo

This way you can use your new python library in the same way as you former used the MATLAB library.

HOWEVER: The usage of from xyz import * statement is not recommend in python (see here why, it is similar to why not using eval in MATLAB) and some Pythonistas may complain recommending this. But for your special case, where you insist on creating a python library with MATLAB like comfort, it is a proper solution.