Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

update tool doc generation flow

Rahul Tarak0b1ab1054ce0
diff --git a/.github/workflows/publish_docs.yml b/.github/workflows/publish_docs.yml
index 9b5071f98..d3d4081a6 100644
--- a/.github/workflows/publish_docs.yml
+++ b/.github/workflows/publish_docs.yml
@@ -20,20 +20,12 @@ jobs:
- name: Install dependencies
run: pnpm install
-
- - name: Install git
- run: |
- apt-get update && apt-get install -y git
-
- name: Install Python Dependencies
working-directory: ./fern
run: |
uv sync
uv run composio apps generate-types
- - name: Install Fern
- run: npm install -g fern-api
-
- name: Build documentation with Turbo
working-directory: ./fern
run: pnpm turbo run build
diff --git a/fern/generators/tool_doc_generator/base_docs.py b/fern/generators/tool_doc_generator/base_docs.py
new file mode 100644
index 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.py
index 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 t
from dataclasses import dataclass, field
from 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 logging
logger = 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 application
Returns:
Self reference for method chaining
"""
- self._blocks.append(MDX.as_frontmatter(app_name))
+ self._blocks.append(MDX.as_frontmatter(app_name, category))
return self
def 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 present
if 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 present
if 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 document
Returns:
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("<", "&lt;").replace(">", "&gt;")
-
- 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("<", "&lt;").replace(">", "&gt;")
+
+ 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 variables
load_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 tools
self.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 directory
max_workers: Maximum number of parallel workers (default: CPU count * 5)
+ limit: Limit processing to first N toolkits (for debugging)
"""
# Ensure output directory exists
output_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 list
from threading import Lock
@@ -331,24 +481,24 @@ class ToolDocGenerator:
# Use CPU count as default but cap at 10 to avoid connection pool issues
max_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 True
except 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 processing
with 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 complete
success_count = 0
@@ -358,64 +508,100 @@ class ToolDocGenerator:
# Log final statistics
if 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 tools
self.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 for
output_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 content
content = 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 safely
auth_schemes = None
try:
- auth_schemes = app_model.auth_schemes
+ auth_schemes = toolkit_model.auth_config_details
except 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 section
content.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 / filename
content_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 Auth
Args:
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 name
sorted_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 threads
lint_only: Only lint existing MDX files without generating new ones
no_lint: Skip the linting step when generating documentation
+ limit: Limit processing to first N toolkits (for debugging)
"""
# Configure logging
configure_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.py
index 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 application
Returns:
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"
@staticmethod
diff --git a/fern/generators/tool_doc_generator/pre_commit_tool_doc.py b/fern/generators/tool_doc_generator/pre_commit_tool_doc.py
new file mode 100644
index 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 file
diff --git a/fern/package.json b/fern/package.json
index 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.json
index 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.lock
index 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]]