sfq 0.0.35__tar.gz → 0.0.37__tar.gz

{sfq-0.0.35 → sfq-0.0.37}/.github/workflows/publish.yml

@@ -85,6 +85,7 @@ jobs:
           
           echo "Updating src/sfq/http_client.py user_agent to $VERSION"
           sed -i -E "s/(user_agent: str = \"sfq\/)[0-9]+\.[0-9]+\.[0-9]+(\")/\1$VERSION\2/" src/sfq/http_client.py
+          sed -i -E "s/(user_agent: str = \"sfq\/)[0-9]+\.[0-9]+\.[0-9]+(\",)/\1$VERSION\2/" src/sfq/http_client.py
 
       - name: Run tests
         run: pytest --verbose --strict-config

{sfq-0.0.35 → sfq-0.0.37}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sfq
-Version: 0.0.35
+Version: 0.0.37
 Summary: Python wrapper for the Salesforce's Query API.
 Author-email: David Moruzzi <sfq.pypi@dmoruzi.com>
 Keywords: salesforce,salesforce query

{sfq-0.0.35 → sfq-0.0.37}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sfq"
-version = "0.0.35"
+version = "0.0.37"
 description = "Python wrapper for the Salesforce's Query API."
 readme = "README.md"
 authors = [{ name = "David Moruzzi", email = "sfq.pypi@dmoruzi.com" }]

{sfq-0.0.35 → sfq-0.0.37}/src/sfq/__init__.py

@@ -24,7 +24,7 @@ from .exceptions import (
 from .http_client import HTTPClient
 from .query import QueryClient
 from .soap import SOAPClient
-from .utils import get_logger
+from .utils import get_logger, records_to_html_table
 from .debug_cleanup import DebugCleanup
 
 # Define public API for documentation tools
@@ -43,7 +43,7 @@ __all__ = [
     "__version__",
 ]
 
-__version__ = "0.0.35"
+__version__ = "0.0.37"
 """
 ### `__version__`
 
@@ -67,7 +67,7 @@ class SFAuth:
         access_token: Optional[str] = None,
         token_expiration_time: Optional[float] = None,
         token_lifetime: int = 15 * 60,
-        user_agent: str = "sfq/0.0.35",
+        user_agent: str = "sfq/0.0.37",
         sforce_client: str = "_auto",
         proxy: str = "_auto",
     ) -> None:
@@ -132,7 +132,7 @@ class SFAuth:
         self._debug_cleanup = DebugCleanup(sf_auth=self)
 
         # Store version information
-        self.__version__ = "0.0.35"
+        self.__version__ = "0.0.37"
         """
         ### `__version__`
         
@@ -561,3 +561,19 @@ class SFAuth:
         sid = quote(self.access_token, safe="")
         frontdoor_url = f"{self.instance_url}/secur/frontdoor.jsp?sid={sid}"
         webbrowser.open(frontdoor_url)
+
+    def records_to_html_table(
+        self,
+        items: List[Dict[str, Any]],
+        styled: bool = False,
+    ) -> str:
+        """
+        Convert a list of dictionaries to an HTML table.
+
+        :param items: List of dictionaries to convert.
+        :param styled: If True, apply basic CSS styles to the table.
+        :return: HTML string representing the table.
+        """
+        if "records" in items:
+            items = items["records"]
+        return records_to_html_table(items, styled=styled)

{sfq-0.0.35 → sfq-0.0.37}/src/sfq/http_client.py

@@ -28,7 +28,7 @@ class HTTPClient:
     def __init__(
         self,
         auth_manager: AuthManager,
-        user_agent: str = "sfq/0.0.35",
+        user_agent: str = "sfq/0.0.37",
         sforce_client: str = "_auto",
         high_api_usage_threshold: int = 80,
     ) -> None:

{sfq-0.0.35 → sfq-0.0.37}/src/sfq/utils.py

@@ -9,6 +9,7 @@ sensitive data redaction functionality.
 import json
 import logging
 import re
+from html import escape
 from typing import Any, Dict, List, Tuple, Union
 
 # Custom TRACE logging level
@@ -194,3 +195,127 @@ def extract_org_and_user_ids(token_id_url: str) -> Tuple[str, str]:
         return org_id, user_id
     except (IndexError, AttributeError):
         raise ValueError(f"Invalid token ID URL format: {token_id_url}")
+
+
+def dicts_to_html_table(
+    items: List[Dict[str, Any]], styled: bool = False
+) -> str:
+    """
+    Convert a list of dictionaries to a compact HTML table.
+
+    :param items: List of dictionaries to convert
+    :param styled: If True, apply minimal inline CSS for compact styling
+    :return: HTML string for a table with one column per key.
+    :raises ValueError: If input is not a list of dictionaries, or if keys are invalid types.
+    """
+    if not isinstance(items, list):
+        raise ValueError("Input must be a list of dictionaries.")
+
+    def render_value(val: Any) -> str:
+        if val is None:
+            return ""
+        if isinstance(val, (int, float, str, bool)):
+            return str(val)
+        if isinstance(val, list):
+            return (
+                "<ul>"
+                + "".join(f"<li>{render_value(item)}</li>" for item in val)
+                + "</ul>"
+            )
+        if isinstance(val, dict):
+            return dicts_to_html_table([val], styled=styled)
+        try:
+            dumped = json.dumps(val, default=str)
+            if dumped.startswith('"') and dumped.endswith('"'):
+                dumped = dumped[1:-1]
+            return escape(dumped)
+        except Exception:
+            return escape(str(val))
+
+    # Preserve key order by first appearance
+    columns: List[str] = []
+    seen = set()
+    for i, d in enumerate(items):
+        if not isinstance(d, dict):
+            raise ValueError(f"Element at index {i} is not a dictionary.")
+        for k in d.keys():
+            k_str = (
+                k
+                if isinstance(k, str)
+                else str(k)
+                if isinstance(k, (int, float, bool))
+                else None
+            )
+            if k_str is None:
+                raise ValueError(f"Dictionary at index {i} has a non-string key: {k!r}")
+            if k_str not in seen:
+                columns.append(k_str)
+                seen.add(k_str)
+
+    # Build table
+    def get_value_by_str_key(d: Dict[Any, Any], col: str) -> Any:
+        for k in d.keys():
+            k_str = (
+                k
+                if isinstance(k, str)
+                else str(k)
+                if isinstance(k, (int, float, bool))
+                else None
+            )
+            if k_str == col:
+                return d[k]
+        return ""
+
+    if styled:
+        table_style = (
+            "border-collapse:collapse;font-size:12px;line-height:1.2;"
+            "margin:0;padding:0;width:auto;"
+        )
+        td_style = "border:1px solid #ccc;padding:2px 6px;vertical-align:top;"
+        th_style = (
+            "border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;"
+        )
+        if columns:
+            html = [f'<table style="{table_style}"><thead><tr>']
+            html.extend(f'<th style="{th_style}">{col}</th>' for col in columns)
+            html.append("</tr></thead><tbody>")
+            for d in items:
+                html.append("<tr>")
+                html.extend(
+                    f'<td style="{td_style}">{render_value(get_value_by_str_key(d, col))}</td>'
+                    for col in columns
+                )
+                html.append("</tr>")
+            html.append("</tbody></table>")
+        else:
+            html = [
+                f'<table style="{table_style}"><thead></thead><tbody></tbody></table>'
+            ]
+    else:
+        if columns:
+            html = ["<table><thead><tr>"]
+            html.extend(f"<th>{col}</th>" for col in columns)
+            html.append("</tr></thead><tbody>")
+            for d in items:
+                html.append("<tr>")
+                html.extend(
+                    f"<td>{render_value(get_value_by_str_key(d, col))}</td>"
+                    for col in columns
+                )
+                html.append("</tr>")
+            html.append("</tbody></table>")
+        else:
+            html = ["<table><thead></thead><tbody></tbody></table>"]
+
+    return "".join(html)
+
+def records_to_html_table(records: List[Dict[str, Any]], styled: bool = False) -> str:
+    """Convert a list of records to an HTML table."""
+    # really we don't want anything associated with "attributes"
+    normalized_records = []
+    for record in records:
+        if not isinstance(record, dict):
+            raise ValueError(f"Record is not a dictionary: {record!r}")
+        record.pop("attributes", None)
+        normalized_records.append(record)
+    return dicts_to_html_table(normalized_records, styled=styled)

sfq-0.0.37/tests/html/test_complex_nested.html

@@ -0,0 +1 @@
+<table><thead><tr><th>a</th></tr></thead><tbody><tr><td><ul><li>1</li><li><table><thead><tr><th>b</th></tr></thead><tbody><tr><td><ul><li>2</li><li>3</li></ul></td></tr></tbody></table></li><li></li></ul></td></tr></tbody></table>

sfq-0.0.37/tests/html/test_complex_nested_styled.html

@@ -0,0 +1 @@
+<table style="border-collapse:collapse;font-size:12px;line-height:1.2;margin:0;padding:0;width:auto;"><thead><tr><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">a</th></tr></thead><tbody><tr><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;"><ul><li>1</li><li><table style="border-collapse:collapse;font-size:12px;line-height:1.2;margin:0;padding:0;width:auto;"><thead><tr><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">b</th></tr></thead><tbody><tr><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;"><ul><li>2</li><li>3</li></ul></td></tr></tbody></table></li><li></li></ul></td></tr></tbody></table>

sfq-0.0.37/tests/html/test_empty_list.html

@@ -0,0 +1 @@
+<table><thead></thead><tbody></tbody></table>

sfq-0.0.37/tests/html/test_empty_list_styled.html

@@ -0,0 +1 @@
+<table style="border-collapse:collapse;font-size:12px;line-height:1.2;margin:0;padding:0;width:auto;"><thead></thead><tbody></tbody></table>

sfq-0.0.37/tests/html/test_int_float_bool.html

@@ -0,0 +1 @@
+<table><thead><tr><th>i</th><th>f</th><th>b</th></tr></thead><tbody><tr><td>1</td><td>2.5</td><td>True</td></tr></tbody></table>

sfq-0.0.37/tests/html/test_int_float_bool_styled.html

@@ -0,0 +1 @@
+<table style="border-collapse:collapse;font-size:12px;line-height:1.2;margin:0;padding:0;width:auto;"><thead><tr><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">i</th><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">f</th><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">b</th></tr></thead><tbody><tr><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">1</td><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">2.5</td><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">True</td></tr></tbody></table>

sfq-0.0.37/tests/html/test_list_value.html

@@ -0,0 +1 @@
+<table><thead><tr><th>hello</th></tr></thead><tbody><tr><td><ul><li>bob</li><li>sally</li></ul></td></tr></tbody></table>

sfq-0.0.37/tests/html/test_list_value_styled.html

@@ -0,0 +1 @@
+<table style="border-collapse:collapse;font-size:12px;line-height:1.2;margin:0;padding:0;width:auto;"><thead><tr><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">hello</th></tr></thead><tbody><tr><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;"><ul><li>bob</li><li>sally</li></ul></td></tr></tbody></table>

sfq-0.0.37/tests/html/test_multiple_dicts.html

@@ -0,0 +1 @@
+<table><thead><tr><th>x</th><th>z</th></tr></thead><tbody><tr><td>y</td><td></td></tr><tr><td></td><td>w</td></tr></tbody></table>

sfq-0.0.37/tests/html/test_multiple_dicts_styled.html

@@ -0,0 +1 @@
+<table style="border-collapse:collapse;font-size:12px;line-height:1.2;margin:0;padding:0;width:auto;"><thead><tr><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">x</th><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">z</th></tr></thead><tbody><tr><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">y</td><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;"></td></tr><tr><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;"></td><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">w</td></tr></tbody></table>

sfq-0.0.37/tests/html/test_nested_dict.html

@@ -0,0 +1 @@
+<table><thead><tr><th>outer</th></tr></thead><tbody><tr><td><table><thead><tr><th>inner</th></tr></thead><tbody><tr><td>value</td></tr></tbody></table></td></tr></tbody></table>

sfq-0.0.37/tests/html/test_nested_dict_styled.html

@@ -0,0 +1 @@
+<table style="border-collapse:collapse;font-size:12px;line-height:1.2;margin:0;padding:0;width:auto;"><thead><tr><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">outer</th></tr></thead><tbody><tr><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;"><table style="border-collapse:collapse;font-size:12px;line-height:1.2;margin:0;padding:0;width:auto;"><thead><tr><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">inner</th></tr></thead><tbody><tr><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">value</td></tr></tbody></table></td></tr></tbody></table>

sfq-0.0.37/tests/html/test_none_value.html

@@ -0,0 +1 @@
+<table><thead><tr><th>foo</th></tr></thead><tbody><tr><td></td></tr></tbody></table>

sfq-0.0.37/tests/html/test_none_value_styled.html

@@ -0,0 +1 @@
+<table style="border-collapse:collapse;font-size:12px;line-height:1.2;margin:0;padding:0;width:auto;"><thead><tr><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">foo</th></tr></thead><tbody><tr><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;"></td></tr></tbody></table>

sfq-0.0.37/tests/html/test_other_types.html

@@ -0,0 +1 @@
+<table><thead><tr><th>custom</th></tr></thead><tbody><tr><td>custom_str</td></tr></tbody></table>

sfq-0.0.37/tests/html/test_other_types_styled.html

@@ -0,0 +1 @@
+<table style="border-collapse:collapse;font-size:12px;line-height:1.2;margin:0;padding:0;width:auto;"><thead><tr><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">custom</th></tr></thead><tbody><tr><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">custom_str</td></tr></tbody></table>

sfq-0.0.37/tests/html/test_sample_report.html

@@ -0,0 +1 @@
+<table><thead><tr><th>name</th><th>date</th><th>status</th></tr></thead><tbody><tr><td>Sample Report</td><td>2023-01-01</td><td>Completed</td></tr><tr><td>Sample Report 2</td><td>2023-01-02</td><td>In Progress</td></tr><tr><td>Sample Report 3</td><td>2023-01-03</td><td>Not Started</td></tr></tbody></table>

sfq-0.0.37/tests/html/test_sample_report_styled.html

@@ -0,0 +1 @@
+<table style="border-collapse:collapse;font-size:12px;line-height:1.2;margin:0;padding:0;width:auto;"><thead><tr><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">name</th><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">date</th><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">status</th></tr></thead><tbody><tr><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">Sample Report</td><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">2023-01-01</td><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">Completed</td></tr><tr><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">Sample Report 2</td><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">2023-01-02</td><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">In Progress</td></tr><tr><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">Sample Report 3</td><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">2023-01-03</td><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">Not Started</td></tr></tbody></table>

sfq-0.0.37/tests/html/test_single_flat_dict.html

@@ -0,0 +1 @@
+<table><thead><tr><th>a</th><th>c</th></tr></thead><tbody><tr><td>b</td><td>d</td></tr></tbody></table>

sfq-0.0.37/tests/html/test_single_flat_dict_styled.html

@@ -0,0 +1 @@
+<table style="border-collapse:collapse;font-size:12px;line-height:1.2;margin:0;padding:0;width:auto;"><thead><tr><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">a</th><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">c</th></tr></thead><tbody><tr><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">b</td><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">d</td></tr></tbody></table>

sfq-0.0.37/tests/html/test_typecastable_keys_bool.html

@@ -0,0 +1 @@
+<table><thead><tr><th>True</th><th>False</th></tr></thead><tbody><tr><td>truthy</td><td></td></tr><tr><td></td><td>falsey</td></tr></tbody></table>

sfq-0.0.37/tests/html/test_typecastable_keys_bool_styled.html

@@ -0,0 +1 @@
+<table style="border-collapse:collapse;font-size:12px;line-height:1.2;margin:0;padding:0;width:auto;"><thead><tr><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">True</th><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">False</th></tr></thead><tbody><tr><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">truthy</td><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;"></td></tr><tr><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;"></td><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">falsey</td></tr></tbody></table>

sfq-0.0.37/tests/html/test_typecastable_keys_float.html

@@ -0,0 +1 @@
+<table><thead><tr><th>2.5</th></tr></thead><tbody><tr><td>two point five</td></tr></tbody></table>

sfq-0.0.37/tests/html/test_typecastable_keys_float_styled.html

@@ -0,0 +1 @@
+<table style="border-collapse:collapse;font-size:12px;line-height:1.2;margin:0;padding:0;width:auto;"><thead><tr><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">2.5</th></tr></thead><tbody><tr><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">two point five</td></tr></tbody></table>

sfq-0.0.37/tests/html/test_typecastable_keys_int.html

@@ -0,0 +1 @@
+<table><thead><tr><th>1</th></tr></thead><tbody><tr><td>one</td></tr></tbody></table>

sfq-0.0.37/tests/html/test_typecastable_keys_int_styled.html

@@ -0,0 +1 @@
+<table style="border-collapse:collapse;font-size:12px;line-height:1.2;margin:0;padding:0;width:auto;"><thead><tr><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">1</th></tr></thead><tbody><tr><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">one</td></tr></tbody></table>

sfq-0.0.37/tests/test_records_to_html.py

@@ -0,0 +1,45 @@
+import os
+
+import pytest
+
+from sfq import SFAuth
+
+
+@pytest.fixture(scope="module")
+def sf_instance():
+    required_env_vars = [
+        "SF_INSTANCE_URL",
+        "SF_CLIENT_ID",
+        "SF_CLIENT_SECRET",
+        "SF_REFRESH_TOKEN",
+    ]
+
+    missing_vars = [var for var in required_env_vars if not os.getenv(var)]
+    if missing_vars:
+        pytest.fail(f"Missing required env vars: {', '.join(missing_vars)}")
+
+    sf = SFAuth(
+        instance_url=os.getenv("SF_INSTANCE_URL"),
+        client_id=os.getenv("SF_CLIENT_ID"),
+        client_secret=os.getenv("SF_CLIENT_SECRET").strip(),
+        refresh_token=os.getenv("SF_REFRESH_TOKEN"),
+    )
+    return sf
+
+
+def test_html_table_conversion(sf_instance):
+    """
+    Test the HTML table conversion utility.
+    """
+    records = sf_instance.query("SELECT Id,NamespacePrefix FROM Organization LIMIT 1")
+
+    plain_html_table = sf_instance.records_to_html_table(records, styled=False)
+    styled_html_table = sf_instance.records_to_html_table(records, styled=True)
+
+    assert isinstance(plain_html_table, str)
+    assert "<table>" in plain_html_table
+    assert "<tr>" in plain_html_table
+    assert "<td>" in plain_html_table
+    org_id = sf_instance.org_id
+    assert f"<table><thead><tr><th>Id</th><th>NamespacePrefix</th></tr></thead><tbody><tr><td>{org_id}</td><td></td></tr></tbody></table>" == plain_html_table
+    assert f'<table style="border-collapse:collapse;font-size:12px;line-height:1.2;margin:0;padding:0;width:auto;"><thead><tr><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">Id</th><th style="border:1px solid #ccc;padding:2px 6px;background:#f8f8f8;font-weight:bold;">NamespacePrefix</th></tr></thead><tbody><tr><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;">{org_id}</td><td style="border:1px solid #ccc;padding:2px 6px;vertical-align:top;"></td></tr></tbody></table>' == styled_html_table

sfq-0.0.37/tests/test_utils_html_table.py

@@ -0,0 +1,190 @@
+import pytest
+
+from sfq.utils import dicts_to_html_table
+
+
+def test_typecastable_keys():
+    # int key
+    data_int = [{1: "one"}]
+    with open(
+        "./tests/html/test_typecastable_keys_int.html", "r", encoding="utf-8"
+    ) as f:
+        expected = f.read()
+    with open(
+        "./tests/html/test_typecastable_keys_int_styled.html", "r", encoding="utf-8"
+    ) as f:
+        expected_styled = f.read()
+    assert dicts_to_html_table(data_int) == expected
+    assert dicts_to_html_table(data_int, styled=True) == expected_styled
+
+    # float key
+    data_float = [{2.5: "two point five"}]
+    with open(
+        "./tests/html/test_typecastable_keys_float.html", "r", encoding="utf-8"
+    ) as f:
+        expected = f.read()
+    with open(
+        "./tests/html/test_typecastable_keys_float_styled.html", "r", encoding="utf-8"
+    ) as f:
+        expected_styled = f.read()
+    assert dicts_to_html_table(data_float) == expected
+    assert dicts_to_html_table(data_float, styled=True) == expected_styled
+
+    # bool key
+    data_bool = [{True: "truthy"}, {False: "falsey"}]
+    with open(
+        "./tests/html/test_typecastable_keys_bool.html", "r", encoding="utf-8"
+    ) as f:
+        expected = f.read()
+    with open(
+        "./tests/html/test_typecastable_keys_bool_styled.html", "r", encoding="utf-8"
+    ) as f:
+        expected_styled = f.read()
+    assert dicts_to_html_table(data_bool) == expected
+    assert dicts_to_html_table(data_bool, styled=True) == expected_styled
+
+
+def test_empty_list():
+    with open("./tests/html/test_empty_list.html", "r", encoding="utf-8") as f:
+        expected = f.read()
+    with open("./tests/html/test_empty_list_styled.html", "r", encoding="utf-8") as f:
+        expected_styled = f.read()
+    assert dicts_to_html_table([]) == expected
+    assert dicts_to_html_table([], styled=True) == expected_styled
+
+
+def test_single_flat_dict():
+    data = [{"a": "b", "c": "d"}]
+
+    with open("./tests/html/test_single_flat_dict.html", "r", encoding="utf-8") as f:
+        expected = f.read()
+    with open(
+        "./tests/html/test_single_flat_dict_styled.html", "r", encoding="utf-8"
+    ) as f:
+        expected_styled = f.read()
+    assert dicts_to_html_table(data) == expected
+    assert dicts_to_html_table(data, styled=True) == expected_styled
+
+
+def test_multiple_dicts():
+    data = [{"x": "y"}, {"z": "w"}]
+
+    with open("./tests/html/test_multiple_dicts.html", "r", encoding="utf-8") as f:
+        expected = f.read()
+    with open(
+        "./tests/html/test_multiple_dicts_styled.html", "r", encoding="utf-8"
+    ) as f:
+        expected_styled = f.read()
+    assert dicts_to_html_table(data) == expected
+    assert dicts_to_html_table(data, styled=True) == expected_styled
+
+
+def test_none_value():
+    data = [{"foo": None}]
+
+    with open("./tests/html/test_none_value.html", "r", encoding="utf-8") as f:
+        expected = f.read()
+    with open("./tests/html/test_none_value_styled.html", "r", encoding="utf-8") as f:
+        expected_styled = f.read()
+    assert dicts_to_html_table(data) == expected
+    assert dicts_to_html_table(data, styled=True) == expected_styled
+
+
+def test_int_float_bool():
+    data = [{"i": 1, "f": 2.5, "b": True}]
+
+    with open("./tests/html/test_int_float_bool.html", "r", encoding="utf-8") as f:
+        expected = f.read()
+    with open(
+        "./tests/html/test_int_float_bool_styled.html", "r", encoding="utf-8"
+    ) as f:
+        expected_styled = f.read()
+    assert dicts_to_html_table(data) == expected
+    assert dicts_to_html_table(data, styled=True) == expected_styled
+
+
+def test_list_value():
+    data = [{"hello": ["bob", "sally"]}]
+    with open("./tests/html/test_list_value.html", "r", encoding="utf-8") as f:
+        expected = f.read()
+    with open("./tests/html/test_list_value_styled.html", "r", encoding="utf-8") as f:
+        expected_styled = f.read()
+    assert dicts_to_html_table(data) == expected
+    assert dicts_to_html_table(data, styled=True) == expected_styled
+
+
+def test_nested_dict():
+    data = [{"outer": {"inner": "value"}}]
+    data = [{"outer": {"inner": "value"}}]
+    with open("./tests/html/test_nested_dict.html", "r", encoding="utf-8") as f:
+        expected = f.read()
+    with open("./tests/html/test_nested_dict_styled.html", "r", encoding="utf-8") as f:
+        expected_styled = f.read()
+    assert dicts_to_html_table(data) == expected
+    assert dicts_to_html_table(data, styled=True) == expected_styled
+
+
+def test_complex_nested():
+    data = [{"a": [1, {"b": [2, 3]}, None]}]
+    data = [{"a": [1, {"b": [2, 3]}, None]}]
+    with open("./tests/html/test_complex_nested.html", "r", encoding="utf-8") as f:
+        expected = f.read()
+    with open(
+        "./tests/html/test_complex_nested_styled.html", "r", encoding="utf-8"
+    ) as f:
+        expected_styled = f.read()
+    assert dicts_to_html_table(data) == expected
+    assert dicts_to_html_table(data, styled=True) == expected_styled
+
+
+def test_invalid_input_type():
+    # Not printing for error cases
+    with pytest.raises(ValueError):
+        dicts_to_html_table("not a list")
+    with pytest.raises(ValueError):
+        dicts_to_html_table(["not a dict"])
+    # Only non-typecastable keys should raise ValueError
+    with pytest.raises(ValueError):
+        dicts_to_html_table([{(1, 2): "value"}])
+    with pytest.raises(ValueError):
+        dicts_to_html_table([{object(): "value"}])
+    # Also test styled param does not affect error
+    with pytest.raises(ValueError):
+        dicts_to_html_table("not a list", styled=True)
+    with pytest.raises(ValueError):
+        dicts_to_html_table(["not a dict"], styled=True)
+    with pytest.raises(ValueError):
+        dicts_to_html_table([{(1, 2): "value"}], styled=True)
+    with pytest.raises(ValueError):
+        dicts_to_html_table([{object(): "value"}], styled=True)
+
+
+def test_other_types():
+    class Custom:
+        def __str__(self):
+            return "custom_str"
+
+    data = [{"custom": Custom()}]
+    with open("./tests/html/test_other_types.html", "r", encoding="utf-8") as f:
+        expected = f.read()
+    with open("./tests/html/test_other_types_styled.html", "r", encoding="utf-8") as f:
+        expected_styled = f.read()
+    assert dicts_to_html_table(data) == expected
+    assert dicts_to_html_table(data, styled=True) == expected_styled
+
+
+def test_sample_report():
+    data = [
+        {"name": "Sample Report", "date": "2023-01-01", "status": "Completed"},
+        {"name": "Sample Report 2", "date": "2023-01-02", "status": "In Progress"},
+        {"name": "Sample Report 3", "date": "2023-01-03", "status": "Not Started"},
+    ]
+    expected = "<table><tbody><tr><td>name</td><td>Sample Report</td></tr><tr><td>date</td><td>2023-01-01</td></tr><tr><td>status</td><td>Completed</td></tr></tbody></table>"
+    with open("./tests/html/test_sample_report.html", "r", encoding="utf-8") as f:
+        expected = f.read()
+    with open(
+        "./tests/html/test_sample_report_styled.html", "r", encoding="utf-8"
+    ) as f:
+        expected_styled = f.read()
+    assert dicts_to_html_table(data) == expected
+    assert dicts_to_html_table(data, styled=True) == expected_styled

{sfq-0.0.35 → sfq-0.0.37}/uv.lock

@@ -3,5 +3,5 @@ requires-python = ">=3.9"
 
 [[package]]
 name = "sfq"
-version = "0.0.35"
+version = "0.0.37"
 source = { editable = "." }