speed up reading MATLAB source

[joeced]

Originally reported by: Mark Mikofski (Bitbucket: bwanamarko, GitHub: Unknown)

---

Currently only modules are cached in sys.modules, but classdefs are not.

The way Documenter imports objects is by importing the module, then walks its namespace calling the getter method for each path. EG: for pkg.mod.cls.attr it would import pkg then use pkg.getter('mod') to get mod, etc. If a class is encountered it is lexed using Pygments.

This means that a class might be lexed multiple times which is time consuming.

1. profile a build to see where bottlenecks are
2. in matlabify, check if modname is in sys.modules before calling MatModule
3. after a class or function is firts parsed, attach it to it's MatModule using setattr() which is already in sys.modules so that it can be called using getattr()
4. in MatModules getter method, check if the class or function is an attr using hasattr(), then don't reparse but just return the already parsed object.

---

• Bitbucket: https://bitbucket.org/bwanamarko/sphinxcontrib-matlabdomain/issue/18

[joeced]

Original comment by Mark Mikofski (Bitbucket: bwanamarko, GitHub: Unknown):

---

fixes #18 speed up reading parsing files

• in matlabify, check first if module is already imported by looking in sys.modules if not then use MatModule()
• issue debug messages to help troubleshoot errors
• add test mode static function dbg and set sphinx_dbg to dbg for test mode, it will still be overloaded by MatlabDocumenter's real sphinx_dbg
• in MatModule getter, if module then return None, so that real_module_name uses self.modname always, and issue debug message, matlab modules are like packages, so no module attr
• check if MatModule has attr using hasattr(self, name), if it does return getattr(self, name), if not then call matlabify to get attr and store attr in MatModule using setattr(self, name, attr), issue debuge messages for both cases

[joeced]

Original comment by Mark Mikofski (Bitbucket: bwanamarko, GitHub: Unknown):

---

fixes #18 speed up reading parsing files

• in matlabify, check first if module is already imported by looking in sys.modules if not then use MatModule()
• issue debug messages to help troubleshoot errors
• add test mode static function dbg and set sphinx_dbg to dbg for test mode, it will still be overloaded by MatlabDocumenter's real sphinx_dbg
• in MatModule getter, if module then return None, so that real_module_name uses self.modname always, and issue debug message, matlab modules are like packages, so no module attr
• check if MatModule has attr using hasattr(self, name), if it does return getattr(self, name), if not then call matlabify to get attr and store attr in MatModule using setattr(self, name, attr), issue debuge messages for both cases