PyPI - arcade-google - Versions diffs - 0.1.6__py3-none-any.whl → 2.0.0__py3-none-any.whl - Mend

arcade-google 0.1.6py3-none-any.whl → 2.0.0py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (24) hide show

arcade_google/constants.py +24 -0
arcade_google/critics.py +41 -0
arcade_google/doc_to_html.py +99 -0
arcade_google/doc_to_markdown.py +64 -0
arcade_google/enums.py +0 -0
arcade_google/exceptions.py +70 -0
arcade_google/models.py +654 -0
arcade_google/tools/__init__.py +96 -1
arcade_google/tools/calendar.py +236 -32
arcade_google/tools/contacts.py +96 -0
arcade_google/tools/docs.py +24 -14
arcade_google/tools/drive.py +256 -48
arcade_google/tools/file_picker.py +54 -0
arcade_google/tools/gmail.py +336 -116
arcade_google/tools/sheets.py +144 -0
arcade_google/utils.py +1564 -0
arcade_google-2.0.0.dist-info/METADATA +27 -0
arcade_google-2.0.0.dist-info/RECORD +21 -0
{arcade_google-0.1.6.dist-info → arcade_google-2.0.0.dist-info}/WHEEL +1 -1
arcade_google-2.0.0.dist-info/licenses/LICENSE +21 -0
arcade_google/tools/models.py +0 -296
arcade_google/tools/utils.py +0 -282
arcade_google-0.1.6.dist-info/METADATA +0 -20
arcade_google-0.1.6.dist-info/RECORD +0 -11

arcade_google/constants.py ADDED Viewed

@@ -0,0 +1,24 @@
+import os
+from arcade_google.models import GmailReplyToWhom
+# The default reply in Gmail is to only the sender. Since Gmail also offers the possibility of
+# changing the default to 'reply to all', we support both options through an env variable.
+# https://support.google.com/mail/answer/6585?hl=en&sjid=15399867888091633568-SA#null
+try:
+    GMAIL_DEFAULT_REPLY_TO = GmailReplyToWhom(
+        # Values accepted are defined in the arcade_google.tools.models.GmailReplyToWhom Enum
+        os.getenv("ARCADE_GMAIL_DEFAULT_REPLY_TO", GmailReplyToWhom.ONLY_THE_SENDER.value).lower()
+    )
+except ValueError as e:
+    raise ValueError(
+        "Invalid value for ARCADE_GMAIL_DEFAULT_REPLY_TO: "
+        f"'{os.getenv('ARCADE_GMAIL_DEFAULT_REPLY_TO')}'. Expected one of "
+        f"{list(GmailReplyToWhom.__members__.keys())}"
+    ) from e
+DEFAULT_SEARCH_CONTACTS_LIMIT = 30
+DEFAULT_SHEET_ROW_COUNT = 1000
+DEFAULT_SHEET_COLUMN_COUNT = 26

arcade_google/critics.py ADDED Viewed

@@ -0,0 +1,41 @@
+from collections.abc import Collection
+from typing import Any
+from arcade_evals import DatetimeCritic
+class DatetimeOrNoneCritic(DatetimeCritic):
+    """
+    A critic that evaluates the closeness of datetime values within a specified tolerance or whether
+    it's a None value.
+    Attributes:
+        tolerance: Acceptable timedelta between expected and actual datetimes.
+        max_difference: Maximum timedelta for a partial score.
+    """
+    def evaluate(self, expected: Any, actual: Any) -> dict[str, Any]:
+        if actual is None:
+            return {"match": True, "score": self.weight}
+        return super().evaluate(expected, actual)
+class AnyDatetimeCritic(DatetimeCritic):
+    """
+    A critic that evaluates the closeness of datetime values within a list of expected values.
+    """
+    def evaluate(self, expected: Any, actual: Any) -> dict[str, Any]:
+        if not isinstance(expected, Collection):
+            expected = [expected]
+        for expected_value in expected:
+            critic = DatetimeCritic(
+                critic_field=self.critic_field,
+                weight=self.weight,
+                tolerance=self.tolerance,
+                max_difference=self.max_difference,
+            )
+            result = critic.evaluate(expected_value, actual)
+            if result["match"]:
+                return result
+        return {"match": False, "score": 0}

arcade_google/doc_to_html.py ADDED Viewed

@@ -0,0 +1,99 @@
+def convert_document_to_html(document: dict) -> str:
+    html = (
+        "<html><head>"
+        f"<title>{document['title']}</title>"
+        f'<meta name="documentId" content="{document["documentId"]}">'
+        "</head><body>"
+    )
+    for element in document["body"]["content"]:
+        html += convert_structural_element(element)
+    html += "</body></html>"
+    return html
+def convert_structural_element(element: dict, wrap_paragraphs: bool = True) -> str:
+    if "sectionBreak" in element or "tableOfContents" in element:
+        return ""
+    elif "paragraph" in element:
+        paragraph_content = ""
+        prepend, append = get_paragraph_style_tags(
+            style=element["paragraph"]["paragraphStyle"],
+            wrap_paragraphs=wrap_paragraphs,
+        )
+        for item in element["paragraph"]["elements"]:
+            if "textRun" not in item:
+                continue
+            paragraph_content += extract_paragraph_content(item["textRun"])
+        if not paragraph_content:
+            return ""
+        return f"{prepend}{paragraph_content.strip()}{append}"
+    elif "table" in element:
+        table = [
+            [
+                "".join([
+                    convert_structural_element(element=cell_element, wrap_paragraphs=False)
+                    for cell_element in cell["content"]
+                ])
+                for cell in row["tableCells"]
+            ]
+            for row in element["table"]["tableRows"]
+        ]
+        return table_list_to_html(table)
+    else:
+        raise ValueError(f"Unknown document body element type: {element}")
+def extract_paragraph_content(text_run: dict) -> str:
+    content = text_run["content"]
+    style = text_run["textStyle"]
+    return apply_text_style(content, style)
+def apply_text_style(content: str, style: dict) -> str:
+    content = content.rstrip("\n")
+    content = content.replace("\n", "<br>")
+    italic = style.get("italic", False)
+    bold = style.get("bold", False)
+    if italic:
+        content = f"<i>{content}</i>"
+    if bold:
+        content = f"<b>{content}</b>"
+    return content
+def get_paragraph_style_tags(style: dict, wrap_paragraphs: bool = True) -> tuple[str, str]:
+    named_style = style["namedStyleType"]
+    if named_style == "NORMAL_TEXT":
+        return ("<p>", "</p>") if wrap_paragraphs else ("", "")
+    elif named_style == "TITLE":
+        return "<h1>", "</h1>"
+    elif named_style == "SUBTITLE":
+        return "<h2>", "</h2>"
+    elif named_style.startswith("HEADING_"):
+        try:
+            heading_level = int(named_style.split("_")[1])
+        except ValueError:
+            return ("<p>", "</p>") if wrap_paragraphs else ("", "")
+        else:
+            return f"<h{heading_level}>", f"</h{heading_level}>"
+    return ("<p>", "</p>") if wrap_paragraphs else ("", "")
+def table_list_to_html(table: list[list[str]]) -> str:
+    html = "<table>"
+    for row in table:
+        html += "<tr>"
+        for cell in row:
+            if cell.endswith("<br>"):
+                cell = cell[:-4]
+            html += f"<td>{cell}</td>"
+        html += "</tr>"
+    html += "</table>"
+    return html

arcade_google/doc_to_markdown.py ADDED Viewed

@@ -0,0 +1,64 @@
+import arcade_google.doc_to_html as doc_to_html
+def convert_document_to_markdown(document: dict) -> str:
+    md = f"---\ntitle: {document['title']}\ndocumentId: {document['documentId']}\n---\n"
+    for element in document["body"]["content"]:
+        md += convert_structural_element(element)
+    return md
+def convert_structural_element(element: dict) -> str:
+    if "sectionBreak" in element or "tableOfContents" in element:
+        return ""
+    elif "paragraph" in element:
+        md = ""
+        prepend = get_paragraph_style_prepend_str(element["paragraph"]["paragraphStyle"])
+        for item in element["paragraph"]["elements"]:
+            if "textRun" not in item:
+                continue
+            content = extract_paragraph_content(item["textRun"])
+            md += f"{prepend}{content}"
+        return md
+    elif "table" in element:
+        return doc_to_html.convert_structural_element(element)
+    else:
+        raise ValueError(f"Unknown document body element type: {element}")
+def extract_paragraph_content(text_run: dict) -> str:
+    content = text_run["content"]
+    style = text_run["textStyle"]
+    return apply_text_style(content, style)
+def apply_text_style(content: str, style: dict) -> str:
+    append = "\n" if content.endswith("\n") else ""
+    content = content.rstrip("\n")
+    italic = style.get("italic", False)
+    bold = style.get("bold", False)
+    if italic:
+        content = f"_{content}_"
+    if bold:
+        content = f"**{content}**"
+    return f"{content}{append}"
+def get_paragraph_style_prepend_str(style: dict) -> str:
+    named_style = style["namedStyleType"]
+    if named_style == "NORMAL_TEXT":
+        return ""
+    elif named_style == "TITLE":
+        return "# "
+    elif named_style == "SUBTITLE":
+        return "## "
+    elif named_style.startswith("HEADING_"):
+        try:
+            heading_level = int(named_style.split("_")[1])
+            return f"{'#' * heading_level} "
+        except ValueError:
+            return ""
+    return ""

arcade_google/enums.py ADDED Viewed

File without changes

arcade_google/exceptions.py ADDED Viewed

@@ -0,0 +1,70 @@
+from zoneinfo import available_timezones
+from arcade_tdk.errors import RetryableToolError
+class GoogleToolError(Exception):
+    """Base exception for Google tool errors."""
+    def __init__(self, message: str, developer_message: str | None = None):
+        self.message = message
+        self.developer_message = developer_message
+        super().__init__(self.message)
+    def __str__(self) -> str:
+        base_message = self.message
+        if self.developer_message:
+            return f"{base_message} (Developer: {self.developer_message})"
+        return base_message
+class RetryableGoogleToolError(RetryableToolError):
+    """Raised when there's an error in a Google tool that can be retried."""
+    pass
+class GoogleServiceError(GoogleToolError):
+    """Raised when there's an error building or using the Google service."""
+    pass
+class GmailToolError(GoogleToolError):
+    """Raised when there's an error in the Gmail tools."""
+    pass
+class GoogleCalendarToolError(GoogleToolError):
+    """Raised when there's an error in the Google Calendar tools."""
+    pass
+class InvalidTimezoneError(RetryableGoogleToolError):
+    """Raised when a timezone is provided that is not supported by Python's zoneinfo."""
+    def __init__(self, timezone_str: str):
+        self.timezone_str = timezone_str
+        available_timezones_msg = (
+            "Here is a list of valid timezones (from Python's zoneinfo.available_timezones()): "
+            f"{available_timezones()}"
+        )
+        super().__init__(
+            f"Invalid timezone: '{timezone_str}'",
+            developer_message=available_timezones_msg,
+            additional_prompt_content=available_timezones_msg,
+        )
+class GoogleDriveToolError(GoogleToolError):
+    """Raised when there's an error in the Google Drive tools."""
+    pass
+class GoogleDocsToolError(GoogleToolError):
+    """Raised when there's an error in the Google Docs tools."""
+    pass

arcade-google 0.1.6__py3-none-any.whl → 2.0.0__py3-none-any.whl

arcade-google 0.1.6py3-none-any.whl → 2.0.0py3-none-any.whl