universal-mcp 0.1.13rc3__py3-none-any.whl → 0.1.13rc14__py3-none-any.whl

universal_mcp/utils/readme.py

@@ -0,0 +1,92 @@
+import importlib
+from pathlib import Path
+
+from jinja2 import Environment, FileSystemLoader, TemplateError, select_autoescape
+from loguru import logger
+
+
+def _import_class(module_path: str, class_name: str):
+    """
+    Helper to import a class by name from a module.
+    Raises ModuleNotFoundError if module or class does not exist.
+    """
+    try:
+        spec = importlib.util.spec_from_file_location("temp_module", module_path)
+        module = importlib.util.module_from_spec(spec)
+        spec.loader.exec_module(module)
+    except ModuleNotFoundError as e:
+        logger.debug(f"Import failed for module '{module_path}': {e}")
+        raise
+    try:
+        return getattr(module, class_name)
+    except AttributeError as e:
+        logger.error(f"Class '{class_name}' not found in module '{module_path}'")
+        raise ModuleNotFoundError(
+            f"Class '{class_name}' not found in module '{module_path}'"
+        ) from e
+
+
+def generate_readme(app: Path, class_name: str) -> Path:
+    """Generate README.md with API documentation.
+
+    Args:
+        app_dir: Directory where the README will be generated
+        folder_name: Name of the application folder
+        tools: List of Function objects from the OpenAPI schema
+
+    Returns:
+        Path to the generated README file
+
+    Raises:
+        FileNotFoundError: If the template directory doesn't exist
+        TemplateError: If there's an error rendering the template
+        IOError: If there's an error writing the README file
+    """
+
+    # Import the app
+    app_instance = _import_class(app, class_name)(integration=None)
+    # List tools by calling list_tools()
+    tools = app_instance.list_tools()
+    # Format tools into (name, description) tuples
+    formatted_tools = []
+    for tool in tools:
+        name = tool.__name__
+        description = tool.__doc__.strip().split("\n")[0]
+        formatted_tools.append((name, description))
+    # Render the template
+    # Set up Jinja2 environment
+    template_dir = Path(__file__).parent.parent / "templates"
+    if not template_dir.exists():
+        logger.error(f"Template directory not found: {template_dir}")
+        raise FileNotFoundError(f"Template directory not found: {template_dir}")
+
+    try:
+        env = Environment(
+            loader=FileSystemLoader(template_dir), autoescape=select_autoescape()
+        )
+        template = env.get_template("README.md.j2")
+    except Exception as e:
+        logger.error(f"Error loading template: {e}")
+        raise TemplateError(f"Error loading template: {e}") from e
+    # Write the README file
+    try:
+        readme_content = template.render(name=class_name, tools=formatted_tools)
+    except Exception as e:
+        logger.error(f"Error rendering template: {e}")
+        raise TemplateError(f"Error rendering template: {e}") from e
+
+    # Write the README file
+    app_dir = app.parent
+    readme_file = app_dir / "README.md"
+
+    # Write the README file
+    readme_file = app_dir / "README.md"
+    try:
+        with open(readme_file, "w") as f:
+            f.write(readme_content)
+        logger.info(f"Documentation generated at: {readme_file}")
+    except Exception as e:
+        logger.error(f"Error writing README file: {e}")
+        raise OSError(f"Error writing README file: {e}") from e
+
+    return readme_file

{universal_mcp-0.1.13rc3.dist-info → universal_mcp-0.1.13rc14.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: universal-mcp
-Version: 0.1.13rc3
+Version: 0.1.13rc14
 Summary: Universal MCP acts as a middle ware for your API applications. It can store your credentials, authorize, enable disable apps on the fly and much more.
 Author-email: Manoj Bajaj <manojbajaj95@gmail.com>
 License: MIT
@@ -18,60 +18,9 @@ Requires-Dist: pydantic>=2.11.1
 Requires-Dist: pyyaml>=6.0.2
 Requires-Dist: rich>=14.0.0
 Requires-Dist: typer>=0.15.2
-Provides-Extra: all
-Requires-Dist: langchain-mcp-adapters>=0.0.3; extra == 'all'
-Requires-Dist: langchain-openai>=0.3.12; extra == 'all'
-Requires-Dist: langgraph-checkpoint-sqlite>=2.0.6; extra == 'all'
-Requires-Dist: langgraph>=0.3.24; extra == 'all'
-Requires-Dist: litellm>=1.30.7; extra == 'all'
-Requires-Dist: pyright>=1.1.398; extra == 'all'
-Requires-Dist: pytest-asyncio>=0.26.0; extra == 'all'
-Requires-Dist: pytest>=8.3.5; extra == 'all'
-Requires-Dist: python-dotenv>=1.0.1; extra == 'all'
-Requires-Dist: ruff>=0.11.4; extra == 'all'
-Requires-Dist: streamlit>=1.44.1; extra == 'all'
-Requires-Dist: watchdog>=6.0.0; extra == 'all'
-Provides-Extra: applications
-Requires-Dist: universal-mcp-ahrefs; extra == 'applications'
-Requires-Dist: universal-mcp-cal-com-v2; extra == 'applications'
-Requires-Dist: universal-mcp-calendly; extra == 'applications'
-Requires-Dist: universal-mcp-clickup; extra == 'applications'
-Requires-Dist: universal-mcp-coda; extra == 'applications'
-Requires-Dist: universal-mcp-crustdata; extra == 'applications'
-Requires-Dist: universal-mcp-e2b; extra == 'applications'
-Requires-Dist: universal-mcp-elevenlabs; extra == 'applications'
-Requires-Dist: universal-mcp-falai; extra == 'applications'
-Requires-Dist: universal-mcp-figma; extra == 'applications'
-Requires-Dist: universal-mcp-firecrawl; extra == 'applications'
-Requires-Dist: universal-mcp-github; extra == 'applications'
-Requires-Dist: universal-mcp-gong; extra == 'applications'
-Requires-Dist: universal-mcp-google-calendar; extra == 'applications'
-Requires-Dist: universal-mcp-google-docs; extra == 'applications'
-Requires-Dist: universal-mcp-google-drive; extra == 'applications'
-Requires-Dist: universal-mcp-google-mail; extra == 'applications'
-Requires-Dist: universal-mcp-google-sheet; extra == 'applications'
-Requires-Dist: universal-mcp-hashnode; extra == 'applications'
-Requires-Dist: universal-mcp-heygen; extra == 'applications'
-Requires-Dist: universal-mcp-mailchimp; extra == 'applications'
-Requires-Dist: universal-mcp-markitdown; extra == 'applications'
-Requires-Dist: universal-mcp-neon; extra == 'applications'
-Requires-Dist: universal-mcp-notion; extra == 'applications'
-Requires-Dist: universal-mcp-perplexity; extra == 'applications'
-Requires-Dist: universal-mcp-reddit; extra == 'applications'
-Requires-Dist: universal-mcp-replicate; extra == 'applications'
-Requires-Dist: universal-mcp-resend; extra == 'applications'
-Requires-Dist: universal-mcp-retell; extra == 'applications'
-Requires-Dist: universal-mcp-rocketlane; extra == 'applications'
-Requires-Dist: universal-mcp-serpapi; extra == 'applications'
-Requires-Dist: universal-mcp-shortcut; extra == 'applications'
-Requires-Dist: universal-mcp-spotify; extra == 'applications'
-Requires-Dist: universal-mcp-supabase; extra == 'applications'
-Requires-Dist: universal-mcp-tavily; extra == 'applications'
-Requires-Dist: universal-mcp-wrike; extra == 'applications'
-Requires-Dist: universal-mcp-youtube; extra == 'applications'
-Requires-Dist: universal-mcp-zenquotes; extra == 'applications'
 Provides-Extra: dev
 Requires-Dist: litellm>=1.30.7; extra == 'dev'
+Requires-Dist: pre-commit>=4.2.0; extra == 'dev'
 Requires-Dist: pyright>=1.1.398; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.26.0; extra == 'dev'
 Requires-Dist: pytest>=8.3.5; extra == 'dev'

{universal_mcp-0.1.13rc3.dist-info → universal_mcp-0.1.13rc14.dist-info}/RECORD

@@ -1,38 +1,39 @@
 universal_mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 universal_mcp/analytics.py,sha256=aGCg0Okpcy06W70qCA9I8_ySOiCgAtzJAIWAdhBsOeA,2212
-universal_mcp/cli.py,sha256=kJwUvIG3RJQ62wiZaf8qgO_N7Gnrye7kH5BBOCDXeaQ,8212
+universal_mcp/cli.py,sha256=aQioMc0ZpE5uL9h_qrk_eS514H0woQOsTsjEzL6Khto,8552
 universal_mcp/config.py,sha256=sJaPI4q51CDPPG0z32rMJiE7a64eaa9nxbjJgYnaFA4,838
 universal_mcp/exceptions.py,sha256=WApedvzArNujD0gZfUofYBxjQo97ZDJLqDibtLWZoRk,373
 universal_mcp/logger.py,sha256=D947u1roUf6WqlcEsPpvmWDqGc8L41qF3MO1suK5O1Q,308
 universal_mcp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-universal_mcp/applications/__init__.py,sha256=7rghGqPTKDqpzjYo7JshagaAEyU8CcLaQ07TjwM4TTU,2808
+universal_mcp/applications/__init__.py,sha256=ZjV0P55Ej0vjIQ_bCSNatWTX-VphDJ6OGePWBu3bu3U,3196
 universal_mcp/applications/application.py,sha256=0eC9D4HHRwIGpuFusaCxTZ0u64U68VbBpRSxjxGB5y8,8152
 universal_mcp/integrations/README.md,sha256=lTAPXO2nivcBe1q7JT6PRa6v9Ns_ZersQMIdw-nmwEA,996
-universal_mcp/integrations/__init__.py,sha256=fx0dn79M1YhCwxtDy5QKrqtez2fbowhfJtQeWCLm1wU,922
+universal_mcp/integrations/__init__.py,sha256=tg6Yk59AEhwPsrTp0hZQ3NBfmJuYGu2sNCOXuph-h9k,922
 universal_mcp/integrations/integration.py,sha256=genBiaWuzCs-XCf3UD1j8PQYyGU3GiVO4uupSdJRHnA,12601
 universal_mcp/servers/README.md,sha256=ytFlgp8-LO0oogMrHkMOp8SvFTwgsKgv7XhBVZGNTbM,2284
 universal_mcp/servers/__init__.py,sha256=dDtvvMzbWskABlobTZHztrWMb3hbzgidza3BmEmIAD8,474
-universal_mcp/servers/server.py,sha256=j_WreQSSed-e_QFFffsuQxhr7XDexiR5Cls50qkdX-g,9439
+universal_mcp/servers/server.py,sha256=0oJQQUiwPdG2q79tzsVv3WPMV5YIFbF14PRvBF-SxMQ,9395
 universal_mcp/stores/README.md,sha256=jrPh_ow4ESH4BDGaSafilhOVaN8oQ9IFlFW-j5Z5hLA,2465
 universal_mcp/stores/__init__.py,sha256=quvuwhZnpiSLuojf0NfmBx2xpaCulv3fbKtKaSCEmuM,603
-universal_mcp/stores/store.py,sha256=eaS2S2V0pg-9qj5gUup0de7RY1lW8GglA-isJdeg6l8,6898
+universal_mcp/stores/store.py,sha256=lYaFd-9YKC404BPeqzNw_Xm3ziQjksZyvQtaW1yd9FM,6900
 universal_mcp/templates/README.md.j2,sha256=gNry-IrGUdumhgWyHFVxOKgXf_MR4RFK6SI6jF3Tuns,2564
 universal_mcp/templates/api_client.py.j2,sha256=972Im7LNUAq3yZTfwDcgivnb-b8u6_JLKWXwoIwXXXQ,908
 universal_mcp/tools/README.md,sha256=RuxliOFqV1ZEyeBdj3m8UKfkxAsfrxXh-b6V4ZGAk8I,2468
 universal_mcp/tools/__init__.py,sha256=hVL-elJLwD_K87Gpw_s2_o43sQRPyRNOnxlzt0_Pfn8,72
 universal_mcp/tools/adapters.py,sha256=2HvpyFiI0zg9dp0XshnG7t6KrVqFHM7hgtmgY1bsHN0,927
 universal_mcp/tools/func_metadata.py,sha256=f_5LdDNsOu1DpXvDUeZYiJswVmwGZz6IMPtpJJ5B2-Y,7975
-universal_mcp/tools/tools.py,sha256=Q1MoYSjKCBnQNv-lFWwbXzrYrVaVp-69bzLLOE5GyrE,12919
+universal_mcp/tools/tools.py,sha256=9YzFbX0YHdz7RrVyKKBx-eyFEnYD4HPoUVtSAftgdk4,12889
 universal_mcp/utils/__init__.py,sha256=8wi4PGWu-SrFjNJ8U7fr2iFJ1ktqlDmSKj1xYd7KSDc,41
-universal_mcp/utils/agentr.py,sha256=RkKDbOu5M2q-_3jSQcTqI1vQdTCsidJri5QufzyUD20,3410
-universal_mcp/utils/api_generator.py,sha256=bs7BTuEKWz9FNb49BofsLP29BHL3B0PRCtBaKLXoR0A,7949
-universal_mcp/utils/docgen.py,sha256=yGBcBIr7dz3mNMGrCb_-JFsDf-ShmCKWWiPpuEj2SIU,21878
+universal_mcp/utils/agentr.py,sha256=3sobve7Odk8pIAZm3RHTX4Rc21rkBClcXQgXXslbSUA,3490
+universal_mcp/utils/api_generator.py,sha256=x3LkJm3tXgl2qVQq-ZQW86w7IqbErEdFTfwBP3aOwyI,4763
+universal_mcp/utils/docgen.py,sha256=zPmZ-b-fK6xk-dwHEx2hwShN-iquPD_O15CGuPwlj2k,21870
 universal_mcp/utils/docstring_parser.py,sha256=j7aE-LLnBOPTJI0qXayf0NlYappzxICv5E_hUPNmAlc,11459
 universal_mcp/utils/dump_app_tools.py,sha256=9bQePJ4ZKzGtcIYrBgLxbKDOZmL7ajIAHhXljT_AlyA,2041
 universal_mcp/utils/installation.py,sha256=H6woSY5AljEy_m5KgiAlHtNfe8eygOu4ZXNs5Q4H_y4,10307
-universal_mcp/utils/openapi.py,sha256=Mojlihskv0xO0RGGhvjjFjVMBJEoRIcE1a2h_Tt9Ir0,15998
+universal_mcp/utils/openapi.py,sha256=GhUdSefVOrOFMw15ZAIaEma-XKu6ptHv65ds0g7ntBo,24924
+universal_mcp/utils/readme.py,sha256=Q4E3RidWVg0ngYBGZCKcoA4eX6wlkCpvU-clU0E7Q20,3305
 universal_mcp/utils/singleton.py,sha256=kolHnbS9yd5C7z-tzaUAD16GgI-thqJXysNi3sZM4No,733
-universal_mcp-0.1.13rc3.dist-info/METADATA,sha256=goT3MkIrlpp_BRyvRONlf-SNrE4k_mX_tChpl4Bep1o,12805
-universal_mcp-0.1.13rc3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-universal_mcp-0.1.13rc3.dist-info/entry_points.txt,sha256=QlBrVKmA2jIM0q-C-3TQMNJTTWOsOFQvgedBq2rZTS8,56
-universal_mcp-0.1.13rc3.dist-info/RECORD,,
+universal_mcp-0.1.13rc14.dist-info/METADATA,sha256=2lpAZEt7uenPEs6meQ9c4kE65jno2gcWcIVZCHuxbxk,9804
+universal_mcp-0.1.13rc14.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+universal_mcp-0.1.13rc14.dist-info/entry_points.txt,sha256=QlBrVKmA2jIM0q-C-3TQMNJTTWOsOFQvgedBq2rZTS8,56
+universal_mcp-0.1.13rc14.dist-info/RECORD,,