Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
update tool doc generation flow
Rahul Tarak0b1ab1054ce0
diff --git a/.github/workflows/publish_docs.yml b/.github/workflows/publish_docs.ymlindex 9b5071f98..d3d4081a6 100644--- a/.github/workflows/publish_docs.yml+++ b/.github/workflows/publish_docs.yml@@ -20,20 +20,12 @@ jobs:- name: Install dependenciesrun: pnpm install-- - name: Install git- run: |- apt-get update && apt-get install -y git-- name: Install Python Dependenciesworking-directory: ./fernrun: |uv syncuv run composio apps generate-types- - name: Install Fern- run: npm install -g fern-api-- name: Build documentation with Turboworking-directory: ./fernrun: pnpm turbo run builddiff --git a/fern/generators/tool_doc_generator/base_docs.py b/fern/generators/tool_doc_generator/base_docs.pynew file mode 100644index 000000000..03373192c--- /dev/null+++ b/fern/generators/tool_doc_generator/base_docs.py@@ -0,0 +1,11 @@+base_layout = [+ {+ "section": "Tool",+ "contents": [+ {+ "page": "Introduction",+ "path": "tools/introduction.mdx"+ }+ ]+ }+]diff --git a/fern/generators/tool_doc_generator/main.py b/fern/generators/tool_doc_generator/main.pyindex 0626cc36d..0741a2339 100644--- a/fern/generators/tool_doc_generator/main.py+++ b/fern/generators/tool_doc_generator/main.py@@ -18,6 +18,39 @@ import typing as tfrom dataclasses import dataclass, fieldfrom pathlib import Path+# Disable telemetry to avoid background network requests+os.environ["COMPOSIO_TELEMETRY_DISABLED"] = "true"+os.environ["COMPOSIO_DISABLE_TELEMETRY"] = "true"+os.environ["TELEMETRY_DISABLED"] = "true"++# Import MDX linting functionality+from composio import Composio+from composio.client.types import (+ Tool,+ toolkit_list_response,+ toolkit_retrieve_response,+)+from dotenv import load_dotenv+from inflection import titleize+from generators.tool_doc_generator.mdx_formatter import MDX+from generators.tool_doc_generator.base_docs import base_layout++# Import from the same directory+++IMPORTANT_TOOL_SLUGS = [+ "twitter",+ "gmail",+ "github",+ "notion",+ "googlesheets",+ "shopify",+ "stripe",+]++++try:from ruamel.yaml import YAML@@ -32,21 +65,39 @@ except ImportError:"ruamel.yaml not found, falling back to standard yaml. Install with: uv pip install ruamel.yaml")-# Import MDX linting functionality-from composio.client.collections import Actions, AppAuthScheme, ActionModel-from composio_openai import App, ComposioToolSet-from dotenv import load_dotenv-from inflection import titleize-# Import from the same directory-sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))-from mdx_formatter import MDX# Configure logginglogger = logging.getLogger(__name__)+class TelemetryFilter(logging.Filter):+ """Filter out telemetry-related log messages"""++ def filter(self, record):+ # Filter out telemetry-related messages+ message = record.getMessage()+ telemetry_keywords = [+ "telemetry.composio.dev",+ "telemetry",+ "TELEMETRY",+ "metrics/invocations",+ "errors"+ ]++ # Also filter by logger name+ if "telemetry" in record.name.lower():+ return False++ # Filter by message content+ for keyword in telemetry_keywords:+ if keyword in message:+ return False++ return True++def sanitize_html(text: str) -> str:"""Sanitize HTML content by removing HTML tags and decoding HTML entities.@@ -114,17 +165,18 @@ class DocumentContent:_blocks: list[str] = field(default_factory=list)- def add_frontmatter(self, app_name: str) -> "DocumentContent":+ def add_frontmatter(self, app_name: str, category: t.Optional[str] = None) -> "DocumentContent":"""Add frontmatter section to the document.Args:app_name: The name of the application+ category: The category of the applicationReturns:Self reference for method chaining"""- self._blocks.append(MDX.as_frontmatter(app_name))+ self._blocks.append(MDX.as_frontmatter(app_name, category))return selfdef add_overview_section(@@ -132,7 +184,7 @@ class DocumentContent:app_name: str,app_id: str,description: str,- auth_schemes: t.Optional[t.List[AppAuthScheme]] = None,+ auth_schemes: t.Optional[t.List[toolkit_retrieve_response.AuthConfigDetail]] = None,tags: t.Optional[list] = None,) -> "DocumentContent":"""@@ -159,26 +211,7 @@ class DocumentContent:# Authentication schemes if presentif auth_schemes:- self._blocks.append("### Authentication Details")- for scheme in auth_schemes:- field_block = []- for field in scheme.fields:- # Apply sanitization to auth field properties too- safe_name = field.name.replace('"', '\\"')- safe_type = str(field.type).replace('"', '\\"')- safe_default = str(field.default).replace('"', '\\"') if field.default else ""-- field_block.append(- MDX.as_param(- name=safe_name,- required=field.required,- typ=safe_type,- default=safe_default,- )- )- self._blocks.append(- MDX.as_accordion(title=scheme.auth_mode, content="\n".join(field_block))- )+ self._add_auth_schemes(auth_schemes)# Tags if presentif tags:@@ -188,12 +221,83 @@ class DocumentContent:return self- def add_actions(self, actions: t.List[ActionModel]) -> "DocumentContent":+ def _add_auth_schemes(self, auth_schemes: t.List[toolkit_retrieve_response.AuthConfigDetail]) -> None:+ """Add authentication schemes section."""+ self._blocks.append("### Authentication Details")++ for scheme in auth_schemes:+ fields = self._extract_auth_fields(scheme)+ if fields:+ auth_type = self._get_auth_type(scheme)+ self._blocks.append(MDX.as_accordion(auth_type, "\n".join(fields)))++ def _extract_auth_fields(self, scheme: toolkit_retrieve_response.AuthConfigDetail) -> t.List[str]:+ """Extract authentication fields from scheme."""+ fields = []++ if hasattr(scheme, 'fields') and scheme.fields:+ for field in scheme.fields:+ if isinstance(field, tuple) and len(field) == 2:+ fields.extend(self._process_tuple_field(field))+ elif hasattr(field, 'name'):+ fields.append(self._create_param_from_field(field))++ return fields++ def _process_tuple_field(self, field: tuple) -> t.List[str]:+ """Process tuple-style authentication field."""+ fields = []+ _, field_config = field++ for field_list, required in [(getattr(field_config, 'required', []), True),+ (getattr(field_config, 'optional', []), False)]:+ for f in field_list:+ if hasattr(f, 'name'):+ fields.append(self._create_param_from_field(f, required))++ return fields++ def _create_param_from_field(self, field: toolkit_retrieve_response.AuthConfigDetail, required: t.Optional[bool] = None) -> str:+ """Create parameter string from field object."""+ return MDX.as_param(+ name=str(field.name).replace('"', '\\"'),+ required=required if required is not None else getattr(field, 'required', False),+ typ=str(getattr(field, 'type', '')).replace('"', '\\"'),+ default=str(getattr(field, 'default', '')).replace('"', '\\"') if getattr(field, 'default', None) else "",+ doc=str(getattr(field, 'description', '')).replace('"', '\\"')+ )++ def _get_auth_type(self, scheme: toolkit_retrieve_response.AuthConfigDetail) -> str:+ """Get authentication type from scheme."""+ auth_type = (+ getattr(scheme, 'mode', None) or+ getattr(scheme, 'type', None) or+ getattr(scheme, 'auth_type', None) or+ getattr(scheme, 'auth_mode', None) or+ 'Authentication'+ )++ auth_type_mapping = {+ 'oauth2': 'OAuth2',+ 'OAUTH2': 'OAuth2',+ 'api_key': 'API Key',+ 'API_KEY': 'API Key',+ 'bearer_token': 'Bearer Token',+ 'BEARER_TOKEN': 'Bearer Token',+ 'basic': 'Basic Auth',+ 'BASIC': 'Basic Auth',+ 'no_auth': 'No Authentication',+ 'NO_AUTH': 'No Authentication'+ }++ return auth_type_mapping.get(auth_type, auth_type.replace('_', ' ').title())++ def add_actions(self, actions: t.List[Tool]) -> "DocumentContent":"""Add actions section to the document.Args:- actions: List of action models to document+ actions: List of tool models to documentReturns:Self reference for method chaining@@ -202,75 +306,116 @@ class DocumentContent:if not any("## Actions" in block for block in self._blocks):self._blocks.append("## Actions")- all_action_content = []-- for action in actions:- action_content = []- params = action.parameters- response = action.response+ action_contents = []- # Description with encoding fixes and sanitization- action_content.append(- # sanitize_html(action.description.replace("<<", "(").replace(">>", ")"))- MDX.as_code_block(action.description, "text")- )-- # Process parameters with enhanced sanitization to avoid MDX parsing issues- action_params = []- for k, v in params.properties.items():- # Get the basic sanitized description- doc = sanitize_html(v.get("description", ""))- param_content = MDX.as_param(- name=k,- typ=str(v.get("type", "")),- doc=doc,- default=v.get("default", ""),- required=k in params.required if params.required else False,- )- action_params.append(param_content)-- # Process responses with the same enhanced sanitization- action_responses = []- for k, v in response.properties.items():- # Get the basic sanitized description- doc = sanitize_html(v.get("description", ""))- action_response = MDX.as_param(name=k, typ=str(v.get("type", "")), doc=doc)- action_responses.append(action_response)-- # Add sections to action content- action_content.append("\n**Action Parameters**\n")- action_content.append("\n".join(action_params))-- action_content.append("\n**Action Response**\n")- action_content.append("\n".join(action_responses))-- # Create accordion for this action, sanitizing the title- safe_action_name = action.name-- # Check for operator patterns in the action name (<4mb type issues)- if "<" in safe_action_name or ">" in safe_action_name:- # Handle comparison operators that cause MDX parsing issues- safe_action_name = re.sub(r"<(\d+)", r"less than \1", safe_action_name)- safe_action_name = re.sub(r">(\d+)", r"greater than \1", safe_action_name)- safe_action_name = re.sub(r"<=(\d+)", r"less than or equal to \1", safe_action_name)- safe_action_name = re.sub(- r">=(\d+)", r"greater than or equal to \1", safe_action_name- )-- # Handle remaining < and > characters- safe_action_name = safe_action_name.replace("<", "<").replace(">", ">")-- all_action_content.append(MDX.as_accordion(safe_action_name, "\n".join(action_content)))+ logger.info(f"Processing {len(actions)} actions for documentation")+ for i, tool in enumerate(actions):+ content = self._process_tool(tool)+ if content:+ action_contents.append(content)# Only wrap in accordion group if there are actions- if all_action_content:- self._blocks.append(MDX.as_accordion_group("\n".join(all_action_content)))+ if action_contents:+ self._blocks.append(MDX.as_accordion_group("\n".join(action_contents)))else:+ logger.info(f"No action content generated for {len(actions)} tools")self._blocks.append("""This app has actions coming soon! Feel free to raise a request for it in our [GitHub Issues](https://github.com/ComposioHQ/composio/issues).You can also create [custom actions](/tool-calling/customizing-tools#extending-composio-toolkits) for the app using Composio Auth.""")return self+ def _process_tool(self, tool: Tool) -> t.Optional[str]:+ """Process a single tool and return accordion content."""+ tool_data = self._extract_tool_data(tool)+ if not tool_data['name']:+ return None++ content = [MDX.as_code_block(tool_data['description'], "text")]++ # Add parameters+ content.append("\n**Action Parameters**\n")+ content.append("\n".join(self._process_parameters(tool_data['params'])))++ # Add responses+ content.append("\n**Action Response**\n")+ content.append("\n".join(self._process_parameters(tool_data['response'])))++ safe_name = self._sanitize_action_name(tool_data['name'])+ return MDX.as_accordion(safe_name, "\n".join(content))++ def _extract_tool_data(self, tool: Tool) -> t.Dict[str, t.Any]:+ """Extract data from tool object or dict."""+ if isinstance(tool, dict):+ if 'function' in tool:+ func = tool['function']+ return {+ 'name': func.get('name', ''),+ 'description': func.get('description', ''),+ 'params': func.get('parameters', {}),+ 'response': tool.get('output_parameters', {}) or func.get('output_parameters', {})+ }+ else:+ return {+ 'name': tool.get('name', tool.get('slug', '')),+ 'description': tool.get('description', ''),+ 'params': tool.get('input_parameters', {}),+ 'response': tool.get('output_parameters', {})+ }+ else:+ return {+ 'name': getattr(tool, 'name', getattr(tool, 'slug', '')),+ 'description': getattr(tool, 'description', ''),+ 'params': getattr(tool, 'input_parameters', {}) or {},+ 'response': getattr(tool, 'output_parameters', {}) or {}+ }++ def _process_parameters(self, params: t.Any) -> t.List[str]:+ """Process parameters from various formats."""+ if not params or not isinstance(params, dict):+ return []++ param_list = []++ if 'properties' in params:+ properties = params.get('properties', {})+ required = params.get('required', [])++ for name, schema in properties.items():+ param_list.append(MDX.as_param(+ name=name,+ typ=str(schema.get("type", "")),+ doc=sanitize_html(schema.get("description", "")),+ default=schema.get("default", ""),+ required=name in required+ ))+ else:+ for name, schema in params.items():+ if isinstance(schema, dict):+ param_list.append(MDX.as_param(+ name=name,+ typ=str(schema.get("type", "")),+ doc=sanitize_html(schema.get("description", "")),+ default=schema.get("default", ""),+ required=schema.get("required", False)+ ))++ return param_list++ def _sanitize_action_name(self, name: str) -> str:+ """Sanitize action name for MDX."""+ if "<" in name or ">" in name:+ replacements = [+ (r"<(\d+)", r"less than \1"),+ (r">(\d+)", r"greater than \1"),+ (r"<=(\d+)", r"less than or equal to \1"),+ (r">=(\d+)", r"greater than or equal to \1")+ ]+ for pattern, replacement in replacements:+ name = re.sub(pattern, replacement, name)+ name = name.replace("<", "<").replace(">", ">")++ return name+def __str__(self) -> str:"""Convert document content to string."""return "\n\n".join(self._blocks)@@ -289,34 +434,39 @@ class ToolDocGenerator:Args:include_local: Whether to include local development tools- skip_lint: Whether to skip the linting step"""# Load environment variablesload_dotenv()- # Initialize toolset- self.toolset = ComposioToolSet()+ # Initialize composio client+ self.composio = Composio()self.include_local = include_local- self.actions_obj = Actions(self.toolset.client)# For tracking generated toolsself.generated_tools = []self.problematic_actions = []- def generate_docs(self, output_path: Path, max_workers: int | None = None) -> None:+ def generate_docs(self, output_path: Path, max_workers: int | None = None, limit: int | None = None) -> None:"""Generate documentation for all apps in parallel.Args:output_path: Path to output directorymax_workers: Maximum number of parallel workers (default: CPU count * 5)+ limit: Limit processing to first N toolkits (for debugging)"""# Ensure output directory existsoutput_path.mkdir(parents=True, exist_ok=True)# Get all apps- apps = self.toolset.get_apps(include_local=self.include_local)- logger.info(f"Starting documentation generation for {len(apps)} apps")+ toolkits = self.composio.toolkits.get()++ # Apply limit if specified+ if limit is not None:+ toolkits = toolkits[:limit]+ logger.info(f"Limited to first {limit} toolkits")++ logger.info(f"Starting documentation generation for {len(toolkits)} toolkits")# Track failures with a synchronized listfrom threading import Lock@@ -331,24 +481,24 @@ class ToolDocGenerator:# Use CPU count as default but cap at 10 to avoid connection pool issuesmax_workers = min(10, multiprocessing.cpu_count())- def process_app(app):- """Process a single app with proper exception handling"""+ def process_app(toolkit):+ """Process a single toolkit with proper exception handling"""try:- self._generate_app_doc(app, output_path)- logger.info(f"✅ Generated docs for {app.name}")+ self._generate_app_doc(toolkit, output_path)+ logger.info(f"✅ Generated docs for {toolkit.name}")return Trueexcept Exception as e:with failed_apps_lock:- failed_apps.append((app.name, str(e)))- logger.error(f"❌ Failed to generate docs for {app.name}: {e}")+ failed_apps.append((toolkit.name, str(e)))+ logger.error(f"❌ Failed to generate docs for {toolkit.name}: {e}")if logger.isEnabledFor(logging.DEBUG):- logger.debug(traceback.format_exc())+ logger.info(traceback.format_exc())return False# Use ThreadPoolExecutor for parallel processingwith concurrent.futures.ThreadPoolExecutor(max_workers=max_workers) as executor:# Submit all app processing tasks- future_to_app = {executor.submit(process_app, app): app for app in apps}+ future_to_app = {executor.submit(process_app, toolkit): toolkit for toolkit in toolkits}# Collect results as they completesuccess_count = 0@@ -358,64 +508,100 @@ class ToolDocGenerator:# Log final statisticsif failed_apps:- logger.warning("\nFailed to generate docs for the following apps:")+ logger.warning("\nFailed to generate docs for the following toolkits:")for app_name, error in failed_apps:logger.warning(f"- {app_name}: {error}")- logger.warning(f"\nTotal failed apps: {len(failed_apps)}/{len(apps)}")+ logger.warning(f"\nTotal failed toolkits: {len(failed_apps)}/{len(toolkits)}")else:- logger.info(f"\nSuccessfully generated docs for all {len(apps)} apps!")+ logger.info(f"\nSuccessfully generated docs for all {len(toolkits)} toolkits!")- logger.info(f"Generated {success_count} app docs in parallel using {max_workers} workers")+ logger.info(f"Generated {success_count} toolkit docs in parallel using {max_workers} workers")# Update docs.yml with the generated toolsself.update_docs_yml(output_path.parent / "docs.yml")- def _generate_app_doc(self, app: App, output_path: Path) -> None:+ def _generate_app_doc(self, toolkit: toolkit_list_response.Item, output_path: Path) -> None:"""- Generate documentation for a single app.+ Generate documentation for a single toolkit.Args:- app: The app to generate documentation for+ toolkit: The toolkit to generate documentation foroutput_path: Output directory path"""- # Get app model and actions- app_model = self.toolset.get_app(app.name)- actions = self.actions_obj._get_actions(apps=[app.name], allow_all=True)+ # Get toolkit model and tools+ toolkit_model = self.composio.toolkits.get(slug=toolkit.slug)+ tools = self.composio.tools.get_raw_composio_tools(toolkits=[toolkit.slug])+ logger.info(f"Toolkit tools: {toolkit}")+++ logger.info(f"Retrieved {len(tools)} tools for {toolkit.name}")+ if tools:+ logger.debug(f"First tool type: {type(tools[0])}")+ if hasattr(tools[0], '__dict__'):+ logger.debug(f"First tool attributes: {list(tools[0].__dict__.keys())}")+ elif isinstance(tools[0], dict):+ logger.debug(f"First tool dict keys: {list(tools[0].keys())}")+ logger.debug(f"Sample tool: {str(tools[0])[:200]}...")# Create contentcontent = DocumentContent()+ # Extract category from toolkit meta+ category = None+ if hasattr(toolkit_model, 'meta') and hasattr(toolkit_model.meta, 'categories') and toolkit_model.meta.categories:+ # Use the first category if multiple exist+ category = toolkit_model.meta.categories[0].get('name') if isinstance(toolkit_model.meta.categories[0], dict) else getattr(toolkit_model.meta.categories[0], 'name', None)+# Add frontmatter- content.add_frontmatter(titleize(app.name))+ content.add_frontmatter(titleize(toolkit.name), category)# Handle auth schemes safelyauth_schemes = Nonetry:- auth_schemes = app_model.auth_schemes+ auth_schemes = toolkit_model.auth_config_detailsexcept Exception as e:- logger.debug(f"Could not process auth schemes for {app.name}: {e}")+ logger.info(f"Could not process auth schemes for {toolkit.name}: {e}")# Continue without auth schemes- # Sanitize the app description++ no_auth = "NO_AUTH" in (toolkit.auth_schemes or [])++ logger.info(f"No auth: {no_auth}")++# Add overview sectioncontent.add_overview_section(- app_name=app.name,- app_id=app.key, # type: ignore- description=app.description, # type: ignore+ app_name=toolkit.name,+ app_id=toolkit.slug,+ description=toolkit.meta.description,auth_schemes=auth_schemes,)# Filter out problematic actions- filtered_actions = [- action for action in actions- if action.name not in self.problematic_actions- ]+ filtered_tools = []+ for tool in tools:+ # Extract tool slug for filtering+ if isinstance(tool, dict):+ if 'function' in tool:+ tool_slug = tool['function'].get('name', '')+ else:+ tool_slug = tool.get('slug', '')+ else:+ tool_slug = getattr(tool, 'slug', '')++ if tool_slug not in self.problematic_actions:+ filtered_tools.append(tool)+ else:+ logger.info(f"Filtered out problematic tool: {tool_slug}")++ logger.info(f"After filtering: {len(filtered_tools)} tools remaining out of {len(tools)}")+# Add actions section (only the filtered ones)- content.add_actions(filtered_actions)+ content.add_actions(filtered_tools)# Write to file- filename = f"{app.name.lower()}.mdx"+ filename = f"{toolkit.slug.lower()}.mdx"output_file = output_path / filenamecontent_str = str(content)@@ -425,101 +611,117 @@ class ToolDocGenerator:with threading.Lock():self.generated_tools.append({- "name": app.name.lower(),- "display_name": titleize(app.name),+ "name": toolkit.slug.lower(),+ "display_name": titleize(toolkit.name.lower()),"path": f"tools/{filename}",+ "category": category,+ "tool_count": len(tools),+ "no_auth": no_auth,})def update_docs_yml(self, docs_yml_path: Path) -> None:"""- Update the docs.yml file with the generated tools.+ Update the docs.yml file with the generated tools, grouped by section:+ - Important+ - Categories (each key becomes a section)+ - Proxy Apps+ - No AuthArgs:docs_yml_path: Path to the docs.yml file"""+ import yaml # Use PyYAML for writing+logger.info(f"Updating docs.yml with {len(self.generated_tools)} tools")try:# Sort tools alphabetically by namesorted_tools = sorted(self.generated_tools, key=lambda x: x["name"])- # Create page entries for generated tools- tools_contents = []+ # Prepare sections+ important_tools = []+ proxy_apps = []+ no_auth_tools = []+ categories: dict[str, list] = {}++for tool in sorted_tools:- tools_contents.append({"page": tool["display_name"], "path": tool["path"]})-- if USE_RUAMEL:- # Use ruamel.yaml to preserve comments and formatting- yaml = YAML()- yaml.preserve_quotes = True- yaml.indent(mapping=2, sequence=4, offset=2)-- # Read the current docs.yml- with open(docs_yml_path, "r") as f:- docs_data = yaml.load(f)-- # Find the "tools" tab section in the navigation structure- for tab_section in docs_data.get("navigation", []):- if tab_section.get("tab") == "tools":- # Find the tools section- for section in tab_section.get("layout", []):- if section.get("section") == "Tools":- # Preserve the Introduction entry if it exists- existing_contents = section.get("contents", [])- intro_entries = [- item for item in existing_contents- if item.get("page") == "Introduction"- ]-- # Add introduction entries first, then the generated tools- final_contents = intro_entries + tools_contents-- # Update the section contents- section["contents"] = final_contents- break- break-- # Write the updated YAML back to the file- with open(docs_yml_path, "w") as f:- yaml.dump(docs_data, f)- else:- # Fallback to standard yaml- # Read the current docs.yml- with open(docs_yml_path, "r") as f:- docs_data = yaml_module.safe_load(f)-- # Find the "tools" tab section in the navigation structure- for tab_section in docs_data.get("navigation", []):- if tab_section.get("tab") == "tools":- # Find the tools section- for section in tab_section.get("layout", []):- if section.get("section") == "Tools":- # Preserve the Introduction entry if it exists- existing_contents = section.get("contents", [])- intro_entries = [- item for item in existing_contents- if item.get("page") == "Introduction"- ]-- # Add introduction entries first, then the generated tools- final_contents = intro_entries + tools_contents-- # Update the section contents- section["contents"] = final_contents- break- break+ entry = {"page": tool["display_name"], "slug": "tools/" + tool["name"], "path": tool["path"]}+ name = tool["name"]+ category = tool.get("category", "").strip()++ if name in IMPORTANT_TOOL_SLUGS:+ important_tools.append(entry)+ elif tool.get("tool_count") == 0:+ proxy_apps.append(entry)+ elif tool.get("no_auth"):+ no_auth_tools.append(entry)+ elif category:+ lower_category = category.lower()+ if lower_category not in categories:+ categories[lower_category] = []+ categories[lower_category].append(entry)++ # Read the current docs.yml+ with open(docs_yml_path, "r") as f:+ docs_data = yaml.safe_load(f)++ logger.info(f"Important tools: {important_tools}")+ logger.info(f"Proxy apps: {proxy_apps}")+ logger.info(f"No auth tools: {no_auth_tools}")++ # Sort categories by number of elements (descending), then by name+ sorted_categories = sorted(+ categories.items(),+ key=lambda item: (-len(item[1]), item[0])+ )- # Write the updated YAML back to the file- with open(docs_yml_path, "w") as f:- yaml_module.dump(docs_data, f, default_flow_style=False, sort_keys=False)+ logger.info(f"Category keys: {list(categories.keys())}")+ logger.info(f"Sorted categories keys: {[cat for cat, _ in sorted_categories]}")+++ # Find the "tools" tab section in the navigation structure+ for tab_section in docs_data.get("navigation", []):+ if tab_section.get("tab") == "tools":+ logger.info(f"Tab section: {tab_section}")+ new_layout = []++ # Always add the Tool section with Introduction first+ new_layout.append(base_layout)++ # Add Important section if present+ if important_tools:+ new_layout.append({"section": "Important", "contents": important_tools})+++ # Add each category as its own section+ for cat, tools_list in sorted_categories:+ if tools_list:+ new_layout.append({"section": titleize(cat), "contents": tools_list})++ # Add Proxy Apps section if present+ if proxy_apps:+ new_layout.append({"section": "Proxy Apps", "contents": proxy_apps})++ # Add No Auth section if present+ if no_auth_tools:+ new_layout.append({"section": "No Auth", "contents": no_auth_tools})++ logger.info("new_layout: %s", new_layout)+ tab_section["layout"] = new_layout+ break++ # Write the updated YAML back to the file+ with open(docs_yml_path, "w") as f:+ yaml.dump(docs_data, f, default_flow_style=False, sort_keys=False)logger.info(f"✅ Updated docs.yml with {len(self.generated_tools)} tools")except Exception as e:logger.error(f"Failed to update docs.yml: {e}")if logger.isEnabledFor(logging.DEBUG):- logger.debug(traceback.format_exc())+ logger.info(traceback.format_exc())def configure_logging(log_level: str) -> None:@@ -538,6 +740,14 @@ def configure_logging(log_level: str) -> None:format="%(asctime)s - %(levelname)s - %(message)s",datefmt="%Y-%m-%d %H:%M:%S",)++ # Add telemetry filter to root logger to filter out telemetry requests+ telemetry_filter = TelemetryFilter()+ logging.getLogger().addFilter(telemetry_filter)++ # Also add filter to specific loggers that might handle HTTP requests+ for logger_name in ["httpx", "urllib3", "requests"]:+ logging.getLogger(logger_name).addFilter(telemetry_filter)def cli_main() -> int:@@ -586,6 +796,13 @@ def cli_main() -> int:help="Skip the linting step when generating documentation",default=False,)+ parser.add_argument(+ "--limit",+ "-l",+ type=int,+ help="Limit processing to first N toolkits (for debugging)",+ default=None,+ )args = parser.parse_args()@@ -599,13 +816,15 @@ def cli_main() -> int:generator = ToolDocGenerator(include_local=args.include_local)# Generate docs with specified number of workers- generator.generate_docs(output_path, max_workers=args.workers)+ generator.generate_docs(output_path, max_workers=args.workers, limit=args.limit)- return 0+ # Force exit immediately without waiting for background telemetry+ logger.info("Documentation generation complete. Exiting immediately.")+ os._exit(0)except Exception as e:logger.error(f"Error generating documentation: {e}")if logger.isEnabledFor(logging.DEBUG):- logger.debug(traceback.format_exc())+ logger.info(traceback.format_exc())return 1@@ -616,7 +835,8 @@ def generate_tool_docs(log_level="info",workers=None,lint_only=False,- no_lint=False+ no_lint=False,+ limit=None):"""Generate tool documentation@@ -629,6 +849,7 @@ def generate_tool_docs(workers: Number of parallel worker threadslint_only: Only lint existing MDX files without generating new onesno_lint: Skip the linting step when generating documentation+ limit: Limit processing to first N toolkits (for debugging)"""# Configure loggingconfigure_logging(log_level)@@ -637,9 +858,11 @@ def generate_tool_docs(generator = ToolDocGenerator(include_local=include_local)# Generate docs with specified number of workers- generator.generate_docs(output_dir, max_workers=workers)+ generator.generate_docs(output_dir, max_workers=workers, limit=limit)- return 0+ # Force exit immediately without waiting for background telemetry+ logger.info("Documentation generation complete. Exiting immediately.")+ os._exit(0)if __name__ == "__main__":diff --git a/fern/generators/tool_doc_generator/mdx_formatter.py b/fern/generators/tool_doc_generator/mdx_formatter.pyindex 76c78e189..da84c307f 100644--- a/fern/generators/tool_doc_generator/mdx_formatter.py+++ b/fern/generators/tool_doc_generator/mdx_formatter.py@@ -18,12 +18,13 @@ class MDX:"""@staticmethod- def as_frontmatter(app_name: str | None = None) -> str:+ def as_frontmatter(app_name: str | None = None, category: str | None = None) -> str:"""Generate MDX frontmatter.Args:app_name: The name of the application+ category: The category of the applicationReturns:Formatted MDX frontmatter string@@ -31,6 +32,8 @@ class MDX:frontmatter = f'title: "{app_name}"'if app_name is not None:frontmatter += f'\nsubtitle: "Learn how to use {app_name} with Composio"'+ if category is not None:+ frontmatter += f'\ncategory: "{category}"'return "---\n" + frontmatter + "\n---\n"@staticmethoddiff --git a/fern/generators/tool_doc_generator/pre_commit_tool_doc.py b/fern/generators/tool_doc_generator/pre_commit_tool_doc.pynew file mode 100644index 000000000..69458c68d--- /dev/null+++ b/fern/generators/tool_doc_generator/pre_commit_tool_doc.py@@ -0,0 +1,111 @@+#!/usr/bin/env python+"""+Minimal docs.yml updater for pre-commit hooks.++This script provides a minimal version that just sets the base layout+for the tools section in docs.yml.+"""++import argparse+import logging+import sys+from pathlib import Path++import yaml++from generators.tool_doc_generator.base_docs import base_layout++logger = logging.getLogger(__name__)+++def update_docs_yml_minimal(docs_yml_path: Path) -> None:+ """+ Minimal update of docs.yml file with just the base layout.++ Args:+ docs_yml_path: Path to the docs.yml file+ """+ logger.info("Updating docs.yml with minimal base layout")++ try:+ # Read the current docs.yml+ with open(docs_yml_path, "r") as f:+ docs_data = yaml.safe_load(f)++ # Find the "tools" tab section in the navigation structure+ for tab_section in docs_data.get("navigation", []):+ if tab_section.get("tab") == "tools":+ logger.info("Found tools tab section, setting base layout")+ tab_section["layout"] = base_layout+ break+ else:+ logger.warning("No tools tab section found in docs.yml")+ return++ # Write the updated YAML back to the file+ with open(docs_yml_path, "w") as f:+ yaml.dump(docs_data, f, default_flow_style=False, sort_keys=False)++ logger.info("✅ Updated docs.yml with base layout")++ except Exception as e:+ logger.error(f"Failed to update docs.yml: {e}")+ raise+++def configure_logging(log_level: str = "info") -> None:+ """Configure logging settings."""+ numeric_level = getattr(logging, log_level.upper(), None)+ if not isinstance(numeric_level, int):+ raise ValueError(f"Invalid log level: {log_level}")++ logging.basicConfig(+ level=numeric_level,+ format="%(asctime)s - %(levelname)s - %(message)s",+ datefmt="%Y-%m-%d %H:%M:%S",+ )+++def main() -> int:+ """Command-line entry point for minimal docs.yml update."""+ parser = argparse.ArgumentParser(+ description="Minimal docs.yml updater for pre-commit hooks"+ )+ parser.add_argument(+ "--docs-yml",+ type=str,+ help="Path to docs.yml file (default: ./docs.yml)",+ default="./docs.yml",+ )+ parser.add_argument(+ "--log-level",+ choices=["debug", "info", "warning", "error", "critical"],+ default="info",+ help="Set logging level",+ )++ args = parser.parse_args()++ try:+ # Configure logging+ configure_logging(args.log_level)++ # Convert path to absolute path+ docs_yml_path = Path(args.docs_yml).resolve()++ if not docs_yml_path.exists():+ logger.error(f"docs.yml file not found: {docs_yml_path}")+ return 1++ # Update docs.yml with minimal layout+ update_docs_yml_minimal(docs_yml_path)++ return 0++ except Exception as e:+ logger.error(f"Error updating docs.yml: {e}")+ return 1+++if __name__ == "__main__":+ sys.exit(main())\ No newline at end of filediff --git a/fern/package.json b/fern/package.jsonindex f285385c0..bf2f6567a 100644--- a/fern/package.json+++ b/fern/package.json@@ -9,8 +9,7 @@"clean": "rm -rf ./dist && rm -rf ./node_modules && rm -rf ./docs/snippets/dist","compile": "npx tailwindcss -i ./assets/input.css -o ./dist/output.css","tools:generate": "uv run generators/tool_doc_generator/main.py --workers 10",- "tools:comment": "uv run python scripts/manage-tool-docs.py comment",- "tools:uncomment": "uv run python scripts/manage-tool-docs.py uncomment",+ "tools:generate:dev": "uv run generators/tool_doc_generator/main.py --workers 10 --limit ${LIMIT:-5}","sdkdocs": "pnpm run sdkdocs:ts && pnpm run sdkdocs:python","sdkdocs:ts": "pnpm exec typedoc","sdkdocs:python": "uv run python generators/python-sdk/generate_docs.py",diff --git a/fern/turbo.json b/fern/turbo.jsonindex 2896baef3..ed81781f4 100644--- a/fern/turbo.json+++ b/fern/turbo.json@@ -3,13 +3,13 @@"extends": ["//"],"tasks": {"build": {- "dependsOn": ["api:pull", "add-og", "snippets:build", "tools:generate", "tools:uncomment", "sdkdocs"],+ "dependsOn": ["api:pull", "add-og", "snippets:build", "tools:generate", "sdkdocs"],"outputs": ["pages/*.mdx", "tools/*.mdx", "pages/**"],"cache": true},"dev": {- "dependsOn": ["api:pull", "sdkdocs", "tools:comment", "snippets:build"],+ "dependsOn": ["api:pull", "sdkdocs", "tools:generate:dev", "snippets:build"],"persistent": true,"cache": false},@@ -44,17 +44,10 @@"cache": true,"env": ["COMPOSIO_API_KEY"]},-- "tools:comment": {- "outputs": ["docs.yml"],- "inputs": ["scripts/manage-tool-docs.py", "docs.yml"],- "cache": true- },-- "tools:uncomment": {- "outputs": ["docs.yml"],- "inputs": ["scripts/manage-tool-docs.py", "docs.yml"],- "cache": true+ "tools:generate:dev": {+ "cache": false,+ "inputs": ["generators/tool_doc_generator/**/*.py"],+ "env": ["COMPOSIO_API_KEY", "LIMIT"]},"sdkdocs": {diff --git a/uv.lock b/uv.lockindex bf2541705..fc69c4c18 100644--- a/uv.lock+++ b/uv.lock@@ -2440,43 +2440,32 @@ wheels = [[[package]]name = "pillow"-version = "11.2.1"-source = { registry = "https://pypi.org/simple" }-sdist = { url = "https://files.pythonhosted.org/packages/af/cb/bb5c01fcd2a69335b86c22142b2bccfc3464087efb7fd382eee5ffc7fdf7/pillow-11.2.1.tar.gz", hash = "sha256:a64dd61998416367b7ef979b73d3a85853ba9bec4c2925f74e588879a58716b6", size = 47026707 }-wheels = [- { url = "https://files.pythonhosted.org/packages/c7/40/052610b15a1b8961f52537cc8326ca6a881408bc2bdad0d852edeb6ed33b/pillow-11.2.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:78afba22027b4accef10dbd5eed84425930ba41b3ea0a86fa8d20baaf19d807f", size = 3190185 },- { url = "https://files.pythonhosted.org/packages/e5/7e/b86dbd35a5f938632093dc40d1682874c33dcfe832558fc80ca56bfcb774/pillow-11.2.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:78092232a4ab376a35d68c4e6d5e00dfd73454bd12b230420025fbe178ee3b0b", size = 3030306 },- { url = "https://files.pythonhosted.org/packages/a4/5c/467a161f9ed53e5eab51a42923c33051bf8d1a2af4626ac04f5166e58e0c/pillow-11.2.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:25a5f306095c6780c52e6bbb6109624b95c5b18e40aab1c3041da3e9e0cd3e2d", size = 4416121 },- { url = "https://files.pythonhosted.org/packages/62/73/972b7742e38ae0e2ac76ab137ca6005dcf877480da0d9d61d93b613065b4/pillow-11.2.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0c7b29dbd4281923a2bfe562acb734cee96bbb129e96e6972d315ed9f232bef4", size = 4501707 },- { url = "https://files.pythonhosted.org/packages/e4/3a/427e4cb0b9e177efbc1a84798ed20498c4f233abde003c06d2650a6d60cb/pillow-11.2.1-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:3e645b020f3209a0181a418bffe7b4a93171eef6c4ef6cc20980b30bebf17b7d", size = 4522921 },- { url = "https://files.pythonhosted.org/packages/fe/7c/d8b1330458e4d2f3f45d9508796d7caf0c0d3764c00c823d10f6f1a3b76d/pillow-11.2.1-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:b2dbea1012ccb784a65349f57bbc93730b96e85b42e9bf7b01ef40443db720b4", size = 4612523 },- { url = "https://files.pythonhosted.org/packages/b3/2f/65738384e0b1acf451de5a573d8153fe84103772d139e1e0bdf1596be2ea/pillow-11.2.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:da3104c57bbd72948d75f6a9389e6727d2ab6333c3617f0a89d72d4940aa0443", size = 4587836 },- { url = "https://files.pythonhosted.org/packages/6a/c5/e795c9f2ddf3debb2dedd0df889f2fe4b053308bb59a3cc02a0cd144d641/pillow-11.2.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:598174aef4589af795f66f9caab87ba4ff860ce08cd5bb447c6fc553ffee603c", size = 4669390 },- { url = "https://files.pythonhosted.org/packages/96/ae/ca0099a3995976a9fce2f423166f7bff9b12244afdc7520f6ed38911539a/pillow-11.2.1-cp312-cp312-win32.whl", hash = "sha256:1d535df14716e7f8776b9e7fee118576d65572b4aad3ed639be9e4fa88a1cad3", size = 2332309 },- { url = "https://files.pythonhosted.org/packages/7c/18/24bff2ad716257fc03da964c5e8f05d9790a779a8895d6566e493ccf0189/pillow-11.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:14e33b28bf17c7a38eede290f77db7c664e4eb01f7869e37fa98a5aa95978941", size = 2676768 },- { url = "https://files.pythonhosted.org/packages/da/bb/e8d656c9543276517ee40184aaa39dcb41e683bca121022f9323ae11b39d/pillow-11.2.1-cp312-cp312-win_arm64.whl", hash = "sha256:21e1470ac9e5739ff880c211fc3af01e3ae505859392bf65458c224d0bf283eb", size = 2415087 },- { url = "https://files.pythonhosted.org/packages/36/9c/447528ee3776e7ab8897fe33697a7ff3f0475bb490c5ac1456a03dc57956/pillow-11.2.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:fdec757fea0b793056419bca3e9932eb2b0ceec90ef4813ea4c1e072c389eb28", size = 3190098 },- { url = "https://files.pythonhosted.org/packages/b5/09/29d5cd052f7566a63e5b506fac9c60526e9ecc553825551333e1e18a4858/pillow-11.2.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:b0e130705d568e2f43a17bcbe74d90958e8a16263868a12c3e0d9c8162690830", size = 3030166 },- { url = "https://files.pythonhosted.org/packages/71/5d/446ee132ad35e7600652133f9c2840b4799bbd8e4adba881284860da0a36/pillow-11.2.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7bdb5e09068332578214cadd9c05e3d64d99e0e87591be22a324bdbc18925be0", size = 4408674 },- { url = "https://files.pythonhosted.org/packages/69/5f/cbe509c0ddf91cc3a03bbacf40e5c2339c4912d16458fcb797bb47bcb269/pillow-11.2.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d189ba1bebfbc0c0e529159631ec72bb9e9bc041f01ec6d3233d6d82eb823bc1", size = 4496005 },- { url = "https://files.pythonhosted.org/packages/f9/b3/dd4338d8fb8a5f312021f2977fb8198a1184893f9b00b02b75d565c33b51/pillow-11.2.1-cp313-cp313-manylinux_2_28_aarch64.whl", hash = "sha256:191955c55d8a712fab8934a42bfefbf99dd0b5875078240943f913bb66d46d9f", size = 4518707 },- { url = "https://files.pythonhosted.org/packages/13/eb/2552ecebc0b887f539111c2cd241f538b8ff5891b8903dfe672e997529be/pillow-11.2.1-cp313-cp313-manylinux_2_28_x86_64.whl", hash = "sha256:ad275964d52e2243430472fc5d2c2334b4fc3ff9c16cb0a19254e25efa03a155", size = 4610008 },- { url = "https://files.pythonhosted.org/packages/72/d1/924ce51bea494cb6e7959522d69d7b1c7e74f6821d84c63c3dc430cbbf3b/pillow-11.2.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:750f96efe0597382660d8b53e90dd1dd44568a8edb51cb7f9d5d918b80d4de14", size = 4585420 },- { url = "https://files.pythonhosted.org/packages/43/ab/8f81312d255d713b99ca37479a4cb4b0f48195e530cdc1611990eb8fd04b/pillow-11.2.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:fe15238d3798788d00716637b3d4e7bb6bde18b26e5d08335a96e88564a36b6b", size = 4667655 },- { url = "https://files.pythonhosted.org/packages/94/86/8f2e9d2dc3d308dfd137a07fe1cc478df0a23d42a6c4093b087e738e4827/pillow-11.2.1-cp313-cp313-win32.whl", hash = "sha256:3fe735ced9a607fee4f481423a9c36701a39719252a9bb251679635f99d0f7d2", size = 2332329 },- { url = "https://files.pythonhosted.org/packages/6d/ec/1179083b8d6067a613e4d595359b5fdea65d0a3b7ad623fee906e1b3c4d2/pillow-11.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:74ee3d7ecb3f3c05459ba95eed5efa28d6092d751ce9bf20e3e253a4e497e691", size = 2676388 },- { url = "https://files.pythonhosted.org/packages/23/f1/2fc1e1e294de897df39fa8622d829b8828ddad938b0eaea256d65b84dd72/pillow-11.2.1-cp313-cp313-win_arm64.whl", hash = "sha256:5119225c622403afb4b44bad4c1ca6c1f98eed79db8d3bc6e4e160fc6339d66c", size = 2414950 },- { url = "https://files.pythonhosted.org/packages/c4/3e/c328c48b3f0ead7bab765a84b4977acb29f101d10e4ef57a5e3400447c03/pillow-11.2.1-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:8ce2e8411c7aaef53e6bb29fe98f28cd4fbd9a1d9be2eeea434331aac0536b22", size = 3192759 },- { url = "https://files.pythonhosted.org/packages/18/0e/1c68532d833fc8b9f404d3a642991441d9058eccd5606eab31617f29b6d4/pillow-11.2.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:9ee66787e095127116d91dea2143db65c7bb1e232f617aa5957c0d9d2a3f23a7", size = 3033284 },- { url = "https://files.pythonhosted.org/packages/b7/cb/6faf3fb1e7705fd2db74e070f3bf6f88693601b0ed8e81049a8266de4754/pillow-11.2.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9622e3b6c1d8b551b6e6f21873bdcc55762b4b2126633014cea1803368a9aa16", size = 4445826 },- { url = "https://files.pythonhosted.org/packages/07/94/8be03d50b70ca47fb434a358919d6a8d6580f282bbb7af7e4aa40103461d/pillow-11.2.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:63b5dff3a68f371ea06025a1a6966c9a1e1ee452fc8020c2cd0ea41b83e9037b", size = 4527329 },- { url = "https://files.pythonhosted.org/packages/fd/a4/bfe78777076dc405e3bd2080bc32da5ab3945b5a25dc5d8acaa9de64a162/pillow-11.2.1-cp313-cp313t-manylinux_2_28_aarch64.whl", hash = "sha256:31df6e2d3d8fc99f993fd253e97fae451a8db2e7207acf97859732273e108406", size = 4549049 },- { url = "https://files.pythonhosted.org/packages/65/4d/eaf9068dc687c24979e977ce5677e253624bd8b616b286f543f0c1b91662/pillow-11.2.1-cp313-cp313t-manylinux_2_28_x86_64.whl", hash = "sha256:062b7a42d672c45a70fa1f8b43d1d38ff76b63421cbbe7f88146b39e8a558d91", size = 4635408 },- { url = "https://files.pythonhosted.org/packages/1d/26/0fd443365d9c63bc79feb219f97d935cd4b93af28353cba78d8e77b61719/pillow-11.2.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:4eb92eca2711ef8be42fd3f67533765d9fd043b8c80db204f16c8ea62ee1a751", size = 4614863 },- { url = "https://files.pythonhosted.org/packages/49/65/dca4d2506be482c2c6641cacdba5c602bc76d8ceb618fd37de855653a419/pillow-11.2.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:f91ebf30830a48c825590aede79376cb40f110b387c17ee9bd59932c961044f9", size = 4692938 },- { url = "https://files.pythonhosted.org/packages/b3/92/1ca0c3f09233bd7decf8f7105a1c4e3162fb9142128c74adad0fb361b7eb/pillow-11.2.1-cp313-cp313t-win32.whl", hash = "sha256:e0b55f27f584ed623221cfe995c912c61606be8513bfa0e07d2c674b4516d9dd", size = 2335774 },- { url = "https://files.pythonhosted.org/packages/a5/ac/77525347cb43b83ae905ffe257bbe2cc6fd23acb9796639a1f56aa59d191/pillow-11.2.1-cp313-cp313t-win_amd64.whl", hash = "sha256:36d6b82164c39ce5482f649b437382c0fb2395eabc1e2b1702a6deb8ad647d6e", size = 2681895 },- { url = "https://files.pythonhosted.org/packages/67/32/32dc030cfa91ca0fc52baebbba2e009bb001122a1daa8b6a79ad830b38d3/pillow-11.2.1-cp313-cp313t-win_arm64.whl", hash = "sha256:225c832a13326e34f212d2072982bb1adb210e0cc0b153e688743018c94a2681", size = 2417234 },+version = "10.4.0"+source = { registry = "https://pypi.org/simple" }+sdist = { url = "https://files.pythonhosted.org/packages/cd/74/ad3d526f3bf7b6d3f408b73fde271ec69dfac8b81341a318ce825f2b3812/pillow-10.4.0.tar.gz", hash = "sha256:166c1cd4d24309b30d61f79f4a9114b7b2313d7450912277855ff5dfd7cd4a06", size = 46555059 }+wheels = [+ { url = "https://files.pythonhosted.org/packages/05/cb/0353013dc30c02a8be34eb91d25e4e4cf594b59e5a55ea1128fde1e5f8ea/pillow-10.4.0-cp312-cp312-macosx_10_10_x86_64.whl", hash = "sha256:673655af3eadf4df6b5457033f086e90299fdd7a47983a13827acf7459c15d94", size = 3509350 },+ { url = "https://files.pythonhosted.org/packages/e7/cf/5c558a0f247e0bf9cec92bff9b46ae6474dd736f6d906315e60e4075f737/pillow-10.4.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:866b6942a92f56300012f5fbac71f2d610312ee65e22f1aa2609e491284e5597", size = 3374980 },+ { url = "https://files.pythonhosted.org/packages/84/48/6e394b86369a4eb68b8a1382c78dc092245af517385c086c5094e3b34428/pillow-10.4.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:29dbdc4207642ea6aad70fbde1a9338753d33fb23ed6956e706936706f52dd80", size = 4343799 },+ { url = "https://files.pythonhosted.org/packages/3b/f3/a8c6c11fa84b59b9df0cd5694492da8c039a24cd159f0f6918690105c3be/pillow-10.4.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bf2342ac639c4cf38799a44950bbc2dfcb685f052b9e262f446482afaf4bffca", size = 4459973 },+ { url = "https://files.pythonhosted.org/packages/7d/1b/c14b4197b80150fb64453585247e6fb2e1d93761fa0fa9cf63b102fde822/pillow-10.4.0-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:f5b92f4d70791b4a67157321c4e8225d60b119c5cc9aee8ecf153aace4aad4ef", size = 4370054 },+ { url = "https://files.pythonhosted.org/packages/55/77/40daddf677897a923d5d33329acd52a2144d54a9644f2a5422c028c6bf2d/pillow-10.4.0-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:86dcb5a1eb778d8b25659d5e4341269e8590ad6b4e8b44d9f4b07f8d136c414a", size = 4539484 },+ { url = "https://files.pythonhosted.org/packages/40/54/90de3e4256b1207300fb2b1d7168dd912a2fb4b2401e439ba23c2b2cabde/pillow-10.4.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:780c072c2e11c9b2c7ca37f9a2ee8ba66f44367ac3e5c7832afcfe5104fd6d1b", size = 4477375 },+ { url = "https://files.pythonhosted.org/packages/13/24/1bfba52f44193860918ff7c93d03d95e3f8748ca1de3ceaf11157a14cf16/pillow-10.4.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:37fb69d905be665f68f28a8bba3c6d3223c8efe1edf14cc4cfa06c241f8c81d9", size = 4608773 },+ { url = "https://files.pythonhosted.org/packages/55/04/5e6de6e6120451ec0c24516c41dbaf80cce1b6451f96561235ef2429da2e/pillow-10.4.0-cp312-cp312-win32.whl", hash = "sha256:7dfecdbad5c301d7b5bde160150b4db4c659cee2b69589705b6f8a0c509d9f42", size = 2235690 },+ { url = "https://files.pythonhosted.org/packages/74/0a/d4ce3c44bca8635bd29a2eab5aa181b654a734a29b263ca8efe013beea98/pillow-10.4.0-cp312-cp312-win_amd64.whl", hash = "sha256:1d846aea995ad352d4bdcc847535bd56e0fd88d36829d2c90be880ef1ee4668a", size = 2554951 },+ { url = "https://files.pythonhosted.org/packages/b5/ca/184349ee40f2e92439be9b3502ae6cfc43ac4b50bc4fc6b3de7957563894/pillow-10.4.0-cp312-cp312-win_arm64.whl", hash = "sha256:e553cad5179a66ba15bb18b353a19020e73a7921296a7979c4a2b7f6a5cd57f9", size = 2243427 },+ { url = "https://files.pythonhosted.org/packages/c3/00/706cebe7c2c12a6318aabe5d354836f54adff7156fd9e1bd6c89f4ba0e98/pillow-10.4.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:8bc1a764ed8c957a2e9cacf97c8b2b053b70307cf2996aafd70e91a082e70df3", size = 3525685 },+ { url = "https://files.pythonhosted.org/packages/cf/76/f658cbfa49405e5ecbfb9ba42d07074ad9792031267e782d409fd8fe7c69/pillow-10.4.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:6209bb41dc692ddfee4942517c19ee81b86c864b626dbfca272ec0f7cff5d9fb", size = 3374883 },+ { url = "https://files.pythonhosted.org/packages/46/2b/99c28c4379a85e65378211971c0b430d9c7234b1ec4d59b2668f6299e011/pillow-10.4.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:bee197b30783295d2eb680b311af15a20a8b24024a19c3a26431ff83eb8d1f70", size = 4339837 },+ { url = "https://files.pythonhosted.org/packages/f1/74/b1ec314f624c0c43711fdf0d8076f82d9d802afd58f1d62c2a86878e8615/pillow-10.4.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1ef61f5dd14c300786318482456481463b9d6b91ebe5ef12f405afbba77ed0be", size = 4455562 },+ { url = "https://files.pythonhosted.org/packages/4a/2a/4b04157cb7b9c74372fa867096a1607e6fedad93a44deeff553ccd307868/pillow-10.4.0-cp313-cp313-manylinux_2_28_aarch64.whl", hash = "sha256:297e388da6e248c98bc4a02e018966af0c5f92dfacf5a5ca22fa01cb3179bca0", size = 4366761 },+ { url = "https://files.pythonhosted.org/packages/ac/7b/8f1d815c1a6a268fe90481232c98dd0e5fa8c75e341a75f060037bd5ceae/pillow-10.4.0-cp313-cp313-manylinux_2_28_x86_64.whl", hash = "sha256:e4db64794ccdf6cb83a59d73405f63adbe2a1887012e308828596100a0b2f6cc", size = 4536767 },+ { url = "https://files.pythonhosted.org/packages/e5/77/05fa64d1f45d12c22c314e7b97398ffb28ef2813a485465017b7978b3ce7/pillow-10.4.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:bd2880a07482090a3bcb01f4265f1936a903d70bc740bfcb1fd4e8a2ffe5cf5a", size = 4477989 },+ { url = "https://files.pythonhosted.org/packages/12/63/b0397cfc2caae05c3fb2f4ed1b4fc4fc878f0243510a7a6034ca59726494/pillow-10.4.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:4b35b21b819ac1dbd1233317adeecd63495f6babf21b7b2512d244ff6c6ce309", size = 4610255 },+ { url = "https://files.pythonhosted.org/packages/7b/f9/cfaa5082ca9bc4a6de66ffe1c12c2d90bf09c309a5f52b27759a596900e7/pillow-10.4.0-cp313-cp313-win32.whl", hash = "sha256:551d3fd6e9dc15e4c1eb6fc4ba2b39c0c7933fa113b220057a34f4bb3268a060", size = 2235603 },+ { url = "https://files.pythonhosted.org/packages/01/6a/30ff0eef6e0c0e71e55ded56a38d4859bf9d3634a94a88743897b5f96936/pillow-10.4.0-cp313-cp313-win_amd64.whl", hash = "sha256:030abdbe43ee02e0de642aee345efa443740aa4d828bfe8e2eb11922ea6a21ea", size = 2554972 },+ { url = "https://files.pythonhosted.org/packages/48/2c/2e0a52890f269435eee38b21c8218e102c621fe8d8df8b9dd06fabf879ba/pillow-10.4.0-cp313-cp313-win_arm64.whl", hash = "sha256:5b001114dd152cfd6b23befeb28d7aee43553e2402c9f159807bf55f33af8a8d", size = 2243375 },][[package]]