feat: swanlab.html() type

[Nexisato]

Description

Add swanlab.Html media type for logging HTML content during experiments.

Changes

New media type: Html

• swanlab/sdk/internal/run/transforms/html/ — Html TransformMedia implementation
  • Supports raw HTML string, file path (str / pathlib.Path), file object (TextIO), and nesting (Html wrapping Html)
  • Optional caption parameter (consistent with Image, Audio, etc.)
  • Content-addressed storage: {step:03d}-{sha256[:8]}.html
• swanlab/sdk/typings/run/transforms/html.py — HtmlDataType / HtmlDatasType type aliases

Public API

• swanlab.Html class exported from swanlab/sdk/__init__.py
• swanlab/__init__.pyi — full type stub with English docstring

Proto

• protos/swanlab/metric/column/v1/column.proto — COLUMN_TYPE_HTML enum value
• Auto-generated Go and Python protobuf artifacts (make proto)

Usage

import swanlab

swanlab.init(project="my-html-project", experiment_name="my-html-run")

# Log raw HTML via swanlab.log
swanlab.log({"report": swanlab.Html("<h1>Hello World</h1>")})

# Log from file with caption
swanlab.log({"page": swanlab.Html("./report.html", caption="My Report")})


swanlab.finish()

[gemini-code-assist]

Code Review

This pull request introduces HTML support by adding COLUMN_TYPE_HTML and CHART_TYPE_HTML to the protobuf definitions, and updates the generated Go and Python protobuf files. As there are no review comments, I have no feedback to provide.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[Nexisato]

/gemini review

[gemini-code-assist]

Code Review

This pull request adds support for logging HTML data in SwanLab by introducing Html and log_html to the SDK, updating protobuf definitions with HTML column and chart types, and implementing MIME-type detection during media uploads. The feedback focuses on improving the robustness of the HTML parsing logic, specifically handling potential OSError or ValueError exceptions when checking long raw HTML strings as paths, verifying that input paths are files rather than directories, safely handling non-seekable or binary file-like objects, and ensuring atomic list updates during media upload preparation to prevent list length mismatches.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.