ce-img-ll 0.2.0

Insert WPS in-cell images into XLSX by editing OOXML parts

ce_img_ll

中文说明

ce_img_ll 通过修改 XLSX 底层 OOXML 部件，把图片以 WPS 单元格内图片（DISPIMG + cellimages.xml）方式批量写入指定单元格。

功能特性

• 统一批量接口 insert_image，可覆盖单个或多个单元格场景。
• 保留工作簿结构，输出采用原子写入，降低损坏风险。
• 提供 Python API 与命令行工具。

兼容性说明

• 本库实现的是 WPS 专有单元格图片机制。
• 在 Microsoft Excel 中，可能显示为公式文本或仅部分兼容。

安装

pip install ce_img_ll

Python 用法

from pathlib import Path
from ce_img_ll import insert_image

insert_image(
    source_xlsx=Path("input.xlsx"),
    output_xlsx=Path("output.xlsx"),
    sheet_name="Sheet1",
    cell_image_map={
        "A1": Path("a.png"),
        "C3": Path("b.jpg"),
    },
)

CLI 用法

ce-img-ll --source-xlsx input.xlsx --output-xlsx out.xlsx --sheet Sheet1 --pair A1=a.png --pair B2=b.png

---

English Documentation

ce_img_ll inserts images into .xlsx cells using WPS-specific in-cell image mechanics by editing OOXML parts directly (DISPIMG + cellimages.xml).

Features

• Single unified batch API: insert_image.
• Works for one or multiple cell-image mappings.
• Preserves workbook structure and writes output atomically.
• Provides both Python API and CLI.

Compatibility

• This library implements WPS-specific in-cell image behavior.
• In Microsoft Excel, cells may show formula text or partial compatibility.

Installation

pip install ce_img_ll

Python Usage

from pathlib import Path
from ce_img_ll import insert_image

insert_image(
    source_xlsx=Path("input.xlsx"),
    output_xlsx=Path("output.xlsx"),
    sheet_name="Sheet1",
    cell_image_map={
        "A1": Path("a.png"),
        "C3": Path("b.jpg"),
    },
)

CLI Usage

ce-img-ll --source-xlsx input.xlsx --output-xlsx out.xlsx --sheet Sheet1 --pair A1=a.png --pair B2=b.png

Development

python -m venv .venv
.venv\\Scripts\\python -m pip install -e . pytest
.venv\\Scripts\\python -m pytest tests