github/penpot-mcp
1
0
Fork 0
mirror of https://github.com/penpot/penpot-mcp.git synced 2026-04-25 11:18:37 +00:00
Code Issues Packages Projects Releases Wiki Activity

Switch to URL doc.plugins.penpot.app, fix decoding/charset errors

Browse Source
This commit is contained in:
Dominik Jain 2026-01-30 14:35:11 +01:00
parent 0715697cac
commit b2fca8efb8
1 changed files with 12 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
python-scripts/prepare_api_docs.py
View File

@ -15,6 +15,9 @@ from sensai.util import logging
log = logging.getLogger(__name__) log = logging.getLogger(__name__)
API_DOCS_URL = "https://doc.plugins.penpot.app"
class PenpotAPIContentMarkdownConverter(MarkdownConverter): class PenpotAPIContentMarkdownConverter(MarkdownConverter):
""" """
Markdown converter for Penpot API docs, specifically for the .col-content element Markdown converter for Penpot API docs, specifically for the .col-content element
@ -99,6 +102,10 @@ class TypeInfo:
if referencing_types: if referencing_types:
self.overview += "\n\nReferenced by: " + ", ".join(sorted(referencing_types)) self.overview += "\n\nReferenced by: " + ", ".join(sorted(referencing_types))
def __repr__(self) -> str:
num_members = {k: len(v) for k, v in self.members.items()}
return f"TypeInfo(overview_length={len(self.overview)}, num_members={num_members})"
class YamlConverter: class YamlConverter:
"""Converts dictionaries to YAML with all strings in block literal style""" """Converts dictionaries to YAML with all strings in block literal style"""
@ -133,7 +140,7 @@ class YamlConverter:
class PenpotAPIDocsProcessor: class PenpotAPIDocsProcessor:
def __init__(self): def __init__(self):
self.md_converter = PenpotAPIContentMarkdownConverter() self.md_converter = PenpotAPIContentMarkdownConverter()
self.base_url = "https://penpot-plugins-api-doc.pages.dev" self.base_url = API_DOCS_URL
self.types: dict[str, TypeInfo] = {} self.types: dict[str, TypeInfo] = {}
self.type_referenced_by: dict[str, set[str]] = collections.defaultdict(set) self.type_referenced_by: dict[str, set[str]] = collections.defaultdict(set)
@ -153,6 +160,7 @@ class PenpotAPIDocsProcessor:
type_name = href.split("/")[-1].replace(".html", "") type_name = href.split("/")[-1].replace(".html", "")
log.info("Processing page: %s", type_name) log.info("Processing page: %s", type_name)
type_info = self.process_page(href, type_name) type_info = self.process_page(href, type_name)
print(f"Adding '{type_name}' with {type_info}")
self.types[type_name] = type_info self.types[type_name] = type_info
# add type reference information # add type reference information
@ -166,11 +174,11 @@ class PenpotAPIDocsProcessor:
data_dict = {k: dataclasses.asdict(v) for k, v in self.types.items()} data_dict = {k: dataclasses.asdict(v) for k, v in self.types.items()}
YamlConverter().to_file(data_dict, yaml_path) YamlConverter().to_file(data_dict, yaml_path)
def _fetch(self, rel_url: str) -> str: def _fetch(self, rel_url: str) -> bytes:
response = requests.get(f"{self.base_url}/{rel_url}") response = requests.get(f"{self.base_url}/{rel_url}")
if response.status_code != 200: if response.status_code != 200:
raise Exception(f"Failed to retrieve page: {response.status_code}") raise Exception(f"Failed to retrieve page: {response.status_code}")
html_content = response.text html_content = response.content
return html_content return html_content
def _html_to_markdown(self, html_content: str) -> str: def _html_to_markdown(self, html_content: str) -> str:
@ -255,5 +263,5 @@ def debug_type_conversion(rel_url: str):
if __name__ == '__main__': if __name__ == '__main__':
# debug_type_conversion("interfaces/ShapeBase") # debug_type_conversion("interfaces/LayoutChildProperties")
logging.run_main(main) logging.run_main(main)