fix: RADICAL config - mock everything, aggressive autodoc

Author: denisneuf

docs/conf.py

@@ -1,9 +1,10 @@
-# Configuration file for Sphinx documentation builder
+# Configuration file for Sphinx - ENFOQUE RADICAL
+# NO intenta importar el módulo, solo mockea TODO
 
 import os
 import sys
 
-# Agregar directorio padre al path
+# Agregar directorio padre al path (por si acaso)
 sys.path.insert(0, os.path.abspath('..'))
 
 # -- Project information -----------------------------------------------------
@@ -16,23 +17,55 @@
 # -- General configuration ---------------------------------------------------
 extensions = [
     'sphinx.ext.autodoc',
-    'sphinx.ext.napoleon',  # Para docstrings estilo Google
+    'sphinx.ext.napoleon',
     'sphinx_rtd_theme',
 ]
 
-# Configuración MINIMAL pero FUNCIONAL
+# MOCKEAR TODO - ENFOQUE RADICAL
+autodoc_mock_imports = [
+    # Dependencias del sistema
+    'requests',
+    'six',
+    'cachetools',
+    'pycryptodome',
+    'pytz',
+    'confuse',
+    'python-dotenv',
+    'pyyaml',
+    
+    # Módulos del paquete - MOCKEAR TODO EL PAQUETE
+    'ad_api',
+    'ad_api.base',
+    'ad_api.api',
+    'ad_api.api.sp',
+    'ad_api.api.sb',
+    'ad_api.api.sd',
+    'ad_api.api.dsp',
+    'ad_api.auth',
+]
+
+# Configuración AGRESIVA de autodoc
 autodoc_default_options = {
     'members': True,
     'undoc-members': True,
+    'private-members': False,
+    'special-members': '__init__',
+    'inherited-members': True,
+    'show-inheritance': True,
     'member-order': 'bysource',
 }
 
-# IMPORTANTE para métodos decorados
+# CRÍTICO: Forzar que funcione incluso con módulos mockeados
 autodoc_inherit_docstrings = True
+autodoc_preserve_defaults = True
+autodoc_typehints = 'none'  # Simplificar
 
-# Configuración de napoleon
+# Napoleon para docstrings estilo Google
 napoleon_google_docstring = True
 napoleon_numpy_docstring = False
+napoleon_include_init_with_doc = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
 
 templates_path = ['_templates']
 exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']