initial

modules/module_list.py

@@ -0,0 +1,152 @@
+"""
+Module for listing available Python modules and objects.
+"""
+import pydoc
+import inspect
+import sys
+from typing import List, Dict, Any
+
+
+class ModuleList:
+    """
+    Provides lists of available Python modules and objects for documentation.
+    """
+    
+    @staticmethod
+    def get_standard_modules() -> List[Dict[str, Any]]:
+        """
+        Get list of standard library modules.
+        
+        Returns:
+            List of dictionaries with module information
+        """
+        modules = []
+        stdlib_paths = [p for p in sys.path if 'site-packages' not in p]
+        
+        # Common standard library modules
+        common_modules = [
+            'os', 'sys', 'json', 'datetime', 'collections', 'itertools',
+            'functools', 'operator', 'string', 're', 'math', 'random',
+            'statistics', 'decimal', 'fractions', 'array', 'bisect',
+            'heapq', 'copy', 'pickle', 'sqlite3', 'hashlib', 'hmac',
+            'secrets', 'uuid', 'pathlib', 'shutil', 'glob', 'fnmatch',
+            'linecache', 'tempfile', 'fileinput', 'csv', 'configparser',
+            'netrc', 'xdrlib', 'plistlib', 'codecs', 'unicodedata',
+            'stringprep', 'readline', 'rlcompleter', 'struct', 'codecs',
+            'types', 'copyreg', 'pprint', 'reprlib', 'enum', 'numbers',
+            'collections.abc', 'io', 'argparse', 'getopt', 'logging',
+            'getpass', 'curses', 'platform', 'errno', 'ctypes', 'threading',
+            'multiprocessing', 'concurrent', 'subprocess', 'sched', 'queue',
+            'select', 'selectors', 'asyncio', 'socket', 'ssl', 'email',
+            'html', 'http', 'urllib', 'xml', 'webbrowser', 'cgi', 'cgitb',
+            'wsgiref', 'urllib', 'xmlrpc', 'ipaddress', 'audioop', 'aifc',
+            'sunau', 'wave', 'chunk', 'colorsys', 'imghdr', 'sndhdr',
+            'ossaudiodev', 'gettext', 'locale', 'calendar', 'cmd', 'shlex',
+            'tkinter', 'turtle', 'pydoc', 'doctest', 'unittest', 'test',
+            'lib2to3', 'typing', 'dataclasses', 'contextlib', 'abc',
+            'atexit', 'traceback', 'future', 'gc', 'inspect', 'site',
+            'fpectl', 'distutils', 'ensurepip', 'venv', 'zipapp', 'faulthandler',
+            'pdb', 'profile', 'pstats', 'timeit', 'trace', 'tracemalloc',
+            'warnings', 'contextvars', 'dataclasses', 'weakref', 'types',
+            'copy', 'pprint', 'reprlib', 'enum', 'numbers', 'collections.abc'
+        ]
+        
+        for mod_name in common_modules:
+            try:
+                if mod_name in sys.modules:
+                    mod = sys.modules[mod_name]
+                else:
+                    mod = __import__(mod_name)
+                
+                if inspect.ismodule(mod):
+                    modules.append({
+                        'name': mod_name,
+                        'type': 'module',
+                        'doc': inspect.getdoc(mod) or ''
+                    })
+            except (ImportError, AttributeError):
+                continue
+        
+        return sorted(modules, key=lambda x: x['name'])
+    
+    @staticmethod
+    def get_builtin_objects() -> List[Dict[str, Any]]:
+        """
+        Get list of builtin objects (types, functions, etc.).
+        
+        Returns:
+            List of dictionaries with builtin object information
+        """
+        objects = []
+        builtins_module = __import__('builtins')
+        
+        for name in dir(builtins_module):
+            if not name.startswith('_'):
+                try:
+                    obj = getattr(builtins_module, name)
+                    obj_type = 'function' if inspect.isbuiltin(obj) or inspect.isfunction(obj) else 'type'
+                    objects.append({
+                        'name': name,
+                        'type': obj_type,
+                        'full_name': f'builtins.{name}',
+                        'doc': ''
+                    })
+                except Exception:
+                    continue
+        
+        return sorted(objects, key=lambda x: x['name'])
+    
+    @staticmethod
+    def get_module_contents(module_name: str) -> List[Dict[str, Any]]:
+        """
+        Get list of objects in a module.
+        
+        Args:
+            module_name: Name of the module
+        
+        Returns:
+            List of dictionaries with object information
+        """
+        objects = []
+        try:
+            if module_name in sys.modules:
+                mod = sys.modules[module_name]
+            else:
+                mod = __import__(module_name)
+            
+            if not inspect.ismodule(mod):
+                return objects
+            
+            for name in dir(mod):
+                if name.startswith('_'):
+                    continue
+                
+                try:
+                    obj = getattr(mod, name)
+                    obj_type = 'unknown'
+                    if inspect.ismodule(obj):
+                        obj_type = 'module'
+                    elif inspect.isclass(obj):
+                        obj_type = 'class'
+                    elif inspect.isfunction(obj) or inspect.ismethod(obj):
+                        obj_type = 'function'
+                    elif inspect.isbuiltin(obj):
+                        obj_type = 'function'
+                    else:
+                        obj_type = 'object'
+                    
+                    full_name = f"{module_name}.{name}"
+                    objects.append({
+                        'name': name,
+                        'type': obj_type,
+                        'full_name': full_name,
+                        'doc': ''
+                    })
+                except Exception:
+                    continue
+            
+        except Exception as e:
+            print(f"Error getting module contents for {module_name}: {e}")
+        
+        return sorted(objects, key=lambda x: x['name'])
+