Convert XLSX workbooks to single styled HTML file with support for conditional formatting and in-cell images.

These details have been verified by PyPI

Project links

GitHub Statistics

Maintainers

gocova

These details have not been verified by PyPI

Project description

xx2html

xx2html converts Excel workbooks (.xlsx) into a single HTML file while preserving:

Cell formatting and styles
Conditional formatting classes (via condif2css)
Worksheet link behavior
Embedded worksheet images and in-cell rich-value images

Repository: https://github.com/gocova/xx2html
Issues: https://github.com/gocova/xx2html/issues

Installation

pip install xx2html

Usage

from xx2html import apply_openpyxl_patches, create_xlsx_transform

# Explicit entrypoint. Patches are also applied automatically on import.
apply_openpyxl_patches()

transform = create_xlsx_transform(
    sheet_html=(
        '<section id="{enc_sheet_name}" data-sheet-name="{sheet_name}">'
        "{table_generated_html}"
        "</section>"
    ),
    sheetname_html='<a class="sheet-nav" href="#{sheet_name}.A1">{sheet_name}</a>',
    index_html=(
        "<!doctype html><html><head>"
        "{fonts_html}{core_css_html}{user_css_html}{generated_css_html}"
        "{generated_incell_css_html}{conditional_css_html}"
        "</head><body>{sheets_names_generated_html}{sheets_generated_html}"
        "{safari_js}</body></html>"
    ),
    fonts_html="",
    core_css="",
    user_css="",
    safari_js="",
    apply_cf=True,
)

ok, err = transform("input.xlsx", "output.html", "en_US")
if not ok:
    raise RuntimeError(err)

API Map

Public API (xx2html):

apply_openpyxl_patches() -> None
- Applies required openpyxl monkey patches (idempotent).
create_xlsx_transform(...) -> Callable[[str, str, str], tuple[bool, str | None]]
- Returns a transformer callable with signature (source_xlsx, dest_html, locale).
- Returns (True, None) on success, (False, "<error repr>") on failure.

Core helpers (xx2html.core, useful for advanced integrations):

get_worksheet_contents(...) -> WorksheetContents
cova_render_table(worksheet_contents) -> str
get_incell_images_refs(archive) -> tuple[dict[str, str], Exception | None]
get_incell_css(...) -> str
apply_cf_styles(html, cf_style_relations) -> str
update_links(html, encoded_sheet_names, ...) -> str

Template Placeholders

sheet_html requires:

{enc_sheet_name}
{sheet_name}
{table_generated_html}

sheetname_html requires:

{enc_sheet_name}
{sheet_name}

index_html requires:

{sheets_generated_html}
{sheets_names_generated_html}
{source_filename}
{fonts_html}
{core_css_html}
{user_css_html}
{generated_css_html}
{generated_incell_css_html}
{safari_js}
{conditional_css_html}

Monkey Patching Behavior

xx2html relies on an openpyxl monkey patch to carry rich-value metadata used for in-cell images.

The patch is applied automatically when xx2html.core is imported.
The explicit API entrypoint is apply_openpyxl_patches().

Development

pdm sync --group dev --frozen-lockfile
python3 tests/scripts/generate_fixtures.py
pdm run python -m compileall src tests
pdm run pytest

Release

Stable releases are tag-driven and use SemVer tags: vMAJOR.MINOR.PATCH (for example v1.2.3).
Push the tag to GitHub; the publish workflow builds from SCM metadata and publishes with PyPI Trusted Publishing.

License

xx2html is dual-licensed under MIT or Apache-2.0.

Project details

These details have been verified by PyPI

Project links

GitHub Statistics

Maintainers

gocova

These details have not been verified by PyPI

Release history Release notifications | RSS feed

0.18.0rc1 pre-release

Feb 19, 2026

0.17.0rc1 pre-release

Feb 19, 2026

This version

0.16.0rc1 pre-release

Feb 19, 2026

0.15.0b6021700 pre-release

Feb 17, 2026

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xx2html-0.16.0rc1.tar.gz (135.4 kB view details)

Uploaded Feb 19, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

xx2html-0.16.0rc1-py3-none-any.whl (27.0 kB view details)

Uploaded Feb 19, 2026 Python 3

File details

Details for the file xx2html-0.16.0rc1.tar.gz.

File metadata

Download URL: xx2html-0.16.0rc1.tar.gz
Upload date: Feb 19, 2026
Size: 135.4 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for xx2html-0.16.0rc1.tar.gz
Algorithm	Hash digest
SHA256	`f4d1dc2a076c799947fcee07fc23da68ee28951d5a45923c20b96a05b2fbf572`
MD5	`dc0808eeb67b031bad81cddd5aeb5b87`
BLAKE2b-256	`7561fecddc383aacf5c5b2e5bcc515a56e50d8ac40159fece7dd96307f7c3cd2`

See more details on using hashes here.

Provenance

The following attestation bundles were made for xx2html-0.16.0rc1.tar.gz:

Publisher: publish.yml on gocova/xx2html

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: xx2html-0.16.0rc1.tar.gz
- Subject digest: f4d1dc2a076c799947fcee07fc23da68ee28951d5a45923c20b96a05b2fbf572
- Sigstore transparency entry: 967817283
- Sigstore integration time: Feb 19, 2026
Source repository:
- Permalink: gocova/xx2html@dfe2e12974438cf859691ad308b733828ce16e8d
- Branch / Tag: refs/tags/v0.16.0rc1
- Owner: https://github.com/gocova
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@dfe2e12974438cf859691ad308b733828ce16e8d
- Trigger Event: push

File details

Details for the file xx2html-0.16.0rc1-py3-none-any.whl.

File metadata

Download URL: xx2html-0.16.0rc1-py3-none-any.whl
Upload date: Feb 19, 2026
Size: 27.0 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for xx2html-0.16.0rc1-py3-none-any.whl
Algorithm	Hash digest
SHA256	`2fc22b274b77c16f2dea1c25261f23dff915ed44fbb316e551e2f6f9f4f538c6`
MD5	`2ad5a15a420495a5d7a2dbdf8ced6219`
BLAKE2b-256	`06fb1fc533dacfb39887d6e056f32c7d65c986cfd0312918cc7af875c47d4351`

See more details on using hashes here.

Provenance

The following attestation bundles were made for xx2html-0.16.0rc1-py3-none-any.whl:

Publisher: publish.yml on gocova/xx2html

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: xx2html-0.16.0rc1-py3-none-any.whl
- Subject digest: 2fc22b274b77c16f2dea1c25261f23dff915ed44fbb316e551e2f6f9f4f538c6
- Sigstore transparency entry: 967817372
- Sigstore integration time: Feb 19, 2026
Source repository:
- Permalink: gocova/xx2html@dfe2e12974438cf859691ad308b733828ce16e8d
- Branch / Tag: refs/tags/v0.16.0rc1
- Owner: https://github.com/gocova
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@dfe2e12974438cf859691ad308b733828ce16e8d
- Trigger Event: push

xx2html 0.16.0rc1

Navigation

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Meta

Classifiers

Project description

xx2html

Installation

Usage

API Map

Template Placeholders

Monkey Patching Behavior

Development

Release

License

Project details

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance