python-hwpx 1.0__tar.gz → 1.2__tar.gz

{python-hwpx-1.0/src/python_hwpx.egg-info → python-hwpx-1.2}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.1
 Name: python-hwpx
-Version: 1.0
+Version: 1.2
 Summary: Hancom HWPX 패키지를 로드하고 편집하기 위한 Python 유틸리티 모음
 Author: python-hwpx Maintainers
 License: Non-Commercial License
-Project-URL: Homepage, https://github.com/hancom-io/python-hwpx
-Project-URL: Documentation, https://github.com/hancom-io/python-hwpx/tree/main/docs
-Project-URL: Issues, https://github.com/hancom-io/python-hwpx/issues
+Project-URL: Homepage, https://github.com/airmang/python-hwpx
+Project-URL: Documentation, https://github.com/airmang/python-hwpx/tree/main/docs
+Project-URL: Issues, https://github.com/airmang/python-hwpx/issues
 Keywords: hwp,hwpx,hancom,opc,xml
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
@@ -45,13 +45,10 @@ python-hwpx는 Hancom HWPX 패키지를 분석하고 편집하기 위한 Python
 
 ### 1. 환경 준비
 
-가상 환경을 만든 뒤 PyPI에 배포된 패키지를 설치하세요.
+pip를 이용해 패키지를 설치합니다.
 
 ```bash
-python -m venv .venv
-source .venv/bin/activate
-python -m pip install --upgrade pip
-python -m pip install python-hwpx
+python pip install python-hwpx
 ```
 
 최신 개발 버전을 사용하거나 소스 코드를 수정하려면 편집 가능한 설치를 권장합니다.

{python-hwpx-1.0 → python-hwpx-1.2}/README.md

@@ -15,13 +15,10 @@ python-hwpx는 Hancom HWPX 패키지를 분석하고 편집하기 위한 Python
 
 ### 1. 환경 준비
 
-가상 환경을 만든 뒤 PyPI에 배포된 패키지를 설치하세요.
+pip를 이용해 패키지를 설치합니다.
 
 ```bash
-python -m venv .venv
-source .venv/bin/activate
-python -m pip install --upgrade pip
-python -m pip install python-hwpx
+python pip install python-hwpx
 ```
 
 최신 개발 버전을 사용하거나 소스 코드를 수정하려면 편집 가능한 설치를 권장합니다.

{python-hwpx-1.0 → python-hwpx-1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx"
-version = "1.0"
+version = "1.2"
 description = "Hancom HWPX 패키지를 로드하고 편집하기 위한 Python 유틸리티 모음"
 readme = { file = "README.md", content-type = "text/markdown" }
 license = { text = "Non-Commercial License" }
@@ -39,9 +39,9 @@ test = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/hancom-io/python-hwpx"
-Documentation = "https://github.com/hancom-io/python-hwpx/tree/main/docs"
-Issues = "https://github.com/hancom-io/python-hwpx/issues"
+Homepage = "https://github.com/airmang/python-hwpx"
+Documentation = "https://github.com/airmang/python-hwpx/tree/main/docs"
+Issues = "https://github.com/airmang/python-hwpx/issues"
 
 [project.scripts]
 hwpx-validate = "hwpx.tools.validator:main"
@@ -57,6 +57,7 @@ include = ["hwpx*"]
 
 [tool.setuptools.package-data]
 "hwpx.tools" = ["_schemas/*.xsd"]
+"hwpx.data" = ["Skeleton.hwpx"]
 
 [tool.pytest.ini_options]
 pythonpath = ["src"]

{python-hwpx-1.0 → python-hwpx-1.2}/src/hwpx/document.py

@@ -22,9 +22,12 @@ from .oxml import (
     RunStyle,
 )
 from .package import HwpxPackage
+from .templates import blank_document_bytes
 
 _HP_NS = "http://www.hancom.co.kr/hwpml/2011/paragraph"
 _HP = f"{{{_HP_NS}}}"
+_HH_NS = "http://www.hancom.co.kr/hwpml/2011/head"
+_HH = f"{{{_HH_NS}}}"
 
 
 class HwpxDocument:
@@ -46,6 +49,12 @@ class HwpxDocument:
         root = HwpxOxmlDocument.from_package(package)
         return cls(package, root)
 
+    @classmethod
+    def new(cls) -> "HwpxDocument":
+        """Return a new blank document based on the default skeleton template."""
+
+        return cls.open(blank_document_bytes())
+
     @classmethod
     def from_package(cls, package: HwpxPackage) -> "HwpxDocument":
         """Create a document backed by an existing :class:`HwpxPackage`."""
@@ -295,6 +304,23 @@ class HwpxDocument:
 
         return self._root.char_property(char_pr_id_ref)
 
+    def ensure_run_style(
+        self,
+        *,
+        bold: bool = False,
+        italic: bool = False,
+        underline: bool = False,
+        base_char_pr_id: str | int | None = None,
+    ) -> str:
+        """Return a ``charPr`` identifier matching the requested flags."""
+
+        return self._root.ensure_run_style(
+            bold=bold,
+            italic=italic,
+            underline=underline,
+            base_char_pr_id=base_char_pr_id,
+        )
+
     def iter_runs(self) -> Iterator[HwpxOxmlRun]:
         """Yield every run element contained in the document."""
 

{python-hwpx-1.0 → python-hwpx-1.2}/src/hwpx/oxml/document.py

@@ -2,8 +2,9 @@
 
 from __future__ import annotations
 
+from copy import deepcopy
 from dataclasses import dataclass
-from typing import Dict, Iterable, Iterator, List, Optional, Sequence, Tuple
+from typing import Callable, Dict, Iterable, Iterator, List, Optional, Sequence, Tuple
 from uuid import uuid4
 import xml.etree.ElementTree as ET
 
@@ -625,6 +626,49 @@ class HwpxOxmlRun:
         self.element = element
         self.paragraph = paragraph
 
+    def _current_format_flags(self) -> Tuple[bool, bool, bool] | None:
+        style = self.style
+        if style is None:
+            return None
+        bold = "bold" in style.child_attributes
+        italic = "italic" in style.child_attributes
+        underline_attrs = style.child_attributes.get("underline")
+        underline = False
+        if underline_attrs is not None:
+            underline = underline_attrs.get("type", "").upper() != "NONE"
+        return bold, italic, underline
+
+    def _apply_format_change(
+        self,
+        *,
+        bold: bool | None = None,
+        italic: bool | None = None,
+        underline: bool | None = None,
+    ) -> None:
+        document = self.paragraph.section.document
+        if document is None:
+            raise RuntimeError("run is not attached to a document")
+
+        current = self._current_format_flags()
+        if current is None:
+            current = (False, False, False)
+
+        target = [
+            current[0] if bold is None else bool(bold),
+            current[1] if italic is None else bool(italic),
+            current[2] if underline is None else bool(underline),
+        ]
+
+        if tuple(target) == current:
+            return
+
+        style_id = document.ensure_run_style(
+            bold=target[0],
+            italic=target[1],
+            underline=target[2],
+        )
+        self.char_pr_id_ref = style_id
+
     @property
     def char_pr_id_ref(self) -> str | None:
         """Return the character property reference applied to the run."""
@@ -737,6 +781,39 @@ class HwpxOxmlRun:
             return
         self.paragraph.section.mark_dirty()
 
+    @property
+    def bold(self) -> bool | None:
+        flags = self._current_format_flags()
+        if flags is None:
+            return None
+        return flags[0]
+
+    @bold.setter
+    def bold(self, value: bool | None) -> None:
+        self._apply_format_change(bold=value)
+
+    @property
+    def italic(self) -> bool | None:
+        flags = self._current_format_flags()
+        if flags is None:
+            return None
+        return flags[1]
+
+    @italic.setter
+    def italic(self, value: bool | None) -> None:
+        self._apply_format_change(italic=value)
+
+    @property
+    def underline(self) -> bool | None:
+        flags = self._current_format_flags()
+        if flags is None:
+            return None
+        return flags[2]
+
+    @underline.setter
+    def underline(self, value: bool | None) -> None:
+        self._apply_format_change(underline=value)
+
 
 class HwpxOxmlMemoGroup:
     """Wrapper providing access to ``<hp:memogroup>`` containers."""
@@ -1323,6 +1400,43 @@ class HwpxOxmlParagraph:
                 attrs["charPrIDRef"] = str(default_char)
         return ET.SubElement(self.element, f"{_HP}run", attrs)
 
+    def add_run(
+        self,
+        text: str = "",
+        *,
+        char_pr_id_ref: str | int | None = None,
+        bold: bool = False,
+        italic: bool = False,
+        underline: bool = False,
+        attributes: dict[str, str] | None = None,
+    ) -> HwpxOxmlRun:
+        """Append a new run to the paragraph and return its wrapper."""
+
+        run_attrs = dict(attributes or {})
+
+        if "charPrIDRef" not in run_attrs:
+            if char_pr_id_ref is not None:
+                run_attrs["charPrIDRef"] = str(char_pr_id_ref)
+            else:
+                document = self.section.document
+                if document is not None:
+                    style_id = document.ensure_run_style(
+                        bold=bool(bold),
+                        italic=bool(italic),
+                        underline=bool(underline),
+                    )
+                    run_attrs["charPrIDRef"] = style_id
+                else:
+                    default_char = self.char_pr_id_ref or "0"
+                    if default_char is not None:
+                        run_attrs["charPrIDRef"] = str(default_char)
+
+        run_element = ET.SubElement(self.element, f"{_HP}run", run_attrs)
+        text_element = ET.SubElement(run_element, f"{_HP}t")
+        text_element.text = text
+        self.section.mark_dirty()
+        return HwpxOxmlRun(run_element, self)
+
     @property
     def tables(self) -> List["HwpxOxmlTable"]:
         """Return the tables embedded within this paragraph."""
@@ -1645,21 +1759,133 @@ class HwpxOxmlSection:
 class HwpxOxmlHeader:
     """Represents a header XML part."""
 
-    def __init__(self, part_name: str, element: ET.Element):
+    def __init__(self, part_name: str, element: ET.Element, document: "HwpxOxmlDocument" | None = None):
         self.part_name = part_name
         self._element = element
         self._dirty = False
+        self._document = document
 
     @property
     def element(self) -> ET.Element:
         return self._element
 
+    @property
+    def document(self) -> "HwpxOxmlDocument" | None:
+        return self._document
+
+    def attach_document(self, document: "HwpxOxmlDocument") -> None:
+        self._document = document
+
     def _begin_num_element(self, create: bool = False) -> ET.Element | None:
         element = self._element.find(f"{_HH}beginNum")
         if element is None and create:
             element = ET.SubElement(self._element, f"{_HH}beginNum")
         return element
 
+    def _ref_list_element(self, create: bool = False) -> ET.Element | None:
+        element = self._element.find(f"{_HH}refList")
+        if element is None and create:
+            element = ET.SubElement(self._element, f"{_HH}refList")
+            self.mark_dirty()
+        return element
+
+    def _char_properties_element(self, create: bool = False) -> ET.Element | None:
+        ref_list = self._ref_list_element(create=create)
+        if ref_list is None:
+            return None
+        element = ref_list.find(f"{_HH}charProperties")
+        if element is None and create:
+            element = ET.SubElement(ref_list, f"{_HH}charProperties", {"itemCnt": "0"})
+            self.mark_dirty()
+        return element
+
+    def _update_char_properties_item_count(self, element: ET.Element) -> None:
+        count = len(list(element.findall(f"{_HH}charPr")))
+        element.set("itemCnt", str(count))
+
+    def _allocate_char_property_id(
+        self,
+        element: ET.Element,
+        *,
+        preferred_id: str | int | None = None,
+    ) -> str:
+        existing: set[str] = {
+            child.get("id") or ""
+            for child in element.findall(f"{_HH}charPr")
+        }
+        existing.discard("")
+
+        if preferred_id is not None:
+            candidate = str(preferred_id)
+            if candidate not in existing:
+                return candidate
+
+        numeric_ids: List[int] = []
+        for value in existing:
+            try:
+                numeric_ids.append(int(value))
+            except ValueError:
+                continue
+        next_id = 0 if not numeric_ids else max(numeric_ids) + 1
+        candidate = str(next_id)
+        while candidate in existing:
+            next_id += 1
+            candidate = str(next_id)
+        return candidate
+
+    def ensure_char_property(
+        self,
+        *,
+        predicate: Callable[[ET.Element], bool] | None = None,
+        modifier: Callable[[ET.Element], None] | None = None,
+        base_char_pr_id: str | int | None = None,
+        preferred_id: str | int | None = None,
+    ) -> ET.Element:
+        """Return a ``<hh:charPr>`` element matching *predicate* or create one.
+
+        When an existing entry satisfies *predicate*, it is returned unchanged.
+        Otherwise a new element is produced by cloning ``base_char_pr_id`` (or the
+        first available entry) and applying *modifier* before assigning a fresh
+        identifier and updating ``itemCnt``.
+        """
+
+        char_props = self._char_properties_element(create=True)
+        if char_props is None:  # pragma: no cover - defensive branch
+            raise RuntimeError("failed to create <charProperties> element")
+
+        if predicate is not None:
+            for child in char_props.findall(f"{_HH}charPr"):
+                if predicate(child):
+                    return child
+
+        base_element: ET.Element | None = None
+        if base_char_pr_id is not None:
+            base_element = char_props.find(f"{_HH}charPr[@id='{base_char_pr_id}']")
+        if base_element is None:
+            existing = char_props.find(f"{_HH}charPr")
+            if existing is not None:
+                base_element = existing
+
+        if base_element is None:
+            new_char_pr = ET.Element(f"{_HH}charPr")
+        else:
+            new_char_pr = deepcopy(base_element)
+            if "id" in new_char_pr.attrib:
+                del new_char_pr.attrib["id"]
+
+        if modifier is not None:
+            modifier(new_char_pr)
+
+        char_id = self._allocate_char_property_id(char_props, preferred_id=preferred_id)
+        new_char_pr.set("id", char_id)
+        char_props.append(new_char_pr)
+        self._update_char_properties_item_count(char_props)
+        self.mark_dirty()
+        document = self.document
+        if document is not None:
+            document.invalidate_char_property_cache()
+        return new_char_pr
+
     def _memo_properties_element(self) -> ET.Element | None:
         ref_list = self._element.find(f"{_HH}refList")
         if ref_list is None:
@@ -1788,6 +2014,8 @@ class HwpxOxmlDocument:
 
         for section in self._sections:
             section.attach_document(self)
+        for header in self._headers:
+            header.attach_document(self)
 
     @classmethod
     def from_package(cls, package: "HwpxPackage") -> "HwpxOxmlDocument":
@@ -1849,6 +2077,80 @@ class HwpxOxmlDocument:
             return None
         return cache.get(normalized)
 
+    def ensure_run_style(
+        self,
+        *,
+        bold: bool = False,
+        italic: bool = False,
+        underline: bool = False,
+        base_char_pr_id: str | int | None = None,
+    ) -> str:
+        """Return a char property identifier matching the requested flags."""
+
+        if not self._headers:
+            raise ValueError("document does not contain any headers")
+
+        target = (bool(bold), bool(italic), bool(underline))
+        header = self._headers[0]
+
+        def element_flags(element: ET.Element) -> Tuple[bool, bool, bool]:
+            bold_present = element.find(f"{_HH}bold") is not None
+            italic_present = element.find(f"{_HH}italic") is not None
+            underline_element = element.find(f"{_HH}underline")
+            underline_present = False
+            if underline_element is not None:
+                underline_present = underline_element.get("type", "").upper() != "NONE"
+            return bold_present, italic_present, underline_present
+
+        def predicate(element: ET.Element) -> bool:
+            return element_flags(element) == target
+
+        def modifier(element: ET.Element) -> None:
+            underline_nodes = list(element.findall(f"{_HH}underline"))
+            base_underline_attrs = dict(underline_nodes[0].attrib) if underline_nodes else {}
+
+            for child in list(element.findall(f"{_HH}bold")):
+                element.remove(child)
+            for child in list(element.findall(f"{_HH}italic")):
+                element.remove(child)
+            for child in underline_nodes:
+                element.remove(child)
+
+            if target[0]:
+                ET.SubElement(element, f"{_HH}bold")
+            if target[1]:
+                ET.SubElement(element, f"{_HH}italic")
+
+            underline_attrs = dict(base_underline_attrs)
+            if target[2]:
+                underline_attrs.setdefault("type", "SOLID")
+                if underline_attrs.get("type", "").upper() == "NONE":
+                    underline_attrs["type"] = "SOLID"
+                underline_attrs.setdefault("shape", base_underline_attrs.get("shape", "SOLID"))
+                if "color" not in underline_attrs and "color" in base_underline_attrs:
+                    underline_attrs["color"] = base_underline_attrs["color"]
+                if "color" not in underline_attrs:
+                    underline_attrs["color"] = "#000000"
+                ET.SubElement(element, f"{_HH}underline", underline_attrs)
+            else:
+                attrs = dict(base_underline_attrs)
+                attrs["type"] = "NONE"
+                attrs.setdefault("shape", base_underline_attrs.get("shape", "SOLID"))
+                if "color" in base_underline_attrs:
+                    attrs["color"] = base_underline_attrs["color"]
+                ET.SubElement(element, f"{_HH}underline", attrs)
+
+        element = header.ensure_char_property(
+            predicate=predicate,
+            modifier=modifier,
+            base_char_pr_id=base_char_pr_id,
+        )
+
+        char_id = element.get("id")
+        if char_id is None:  # pragma: no cover - defensive branch
+            raise RuntimeError("charPr element is missing an id")
+        return char_id
+
     @property
     def memo_shapes(self) -> dict[str, MemoShape]:
         shapes: dict[str, MemoShape] = {}

python-hwpx-1.2/src/hwpx/templates.py

@@ -0,0 +1,33 @@
+"""Embedded templates and sample payloads for HWPX documents."""
+
+from __future__ import annotations
+
+from functools import lru_cache
+from importlib import resources
+from pathlib import Path
+
+
+@lru_cache(maxsize=None)
+def blank_document_bytes() -> bytes:
+    """Return the binary payload for a minimal blank HWPX document."""
+
+    # Prefer a packaged asset when available.
+    try:
+        data_pkg = resources.files("hwpx.data")
+    except (ModuleNotFoundError, AttributeError):  # pragma: no cover - optional dependency
+        data_pkg = None
+    if data_pkg is not None:
+        skeleton = data_pkg / "Skeleton.hwpx"
+        if skeleton.is_file():  # type: ignore[call-arg]
+            with skeleton.open("rb") as stream:  # type: ignore[call-arg]
+                return stream.read()
+
+    # Fall back to the repository examples folder during development.
+    root = Path(__file__).resolve().parent.parent.parent
+    fallback = root / "examples" / "Skeleton.hwpx"
+    if fallback.is_file():
+        return fallback.read_bytes()
+
+    raise FileNotFoundError(
+        "Could not locate Skeleton.hwpx; ensure the template asset is packaged."
+    )

{python-hwpx-1.0 → python-hwpx-1.2/src/python_hwpx.egg-info}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.1
 Name: python-hwpx
-Version: 1.0
+Version: 1.2
 Summary: Hancom HWPX 패키지를 로드하고 편집하기 위한 Python 유틸리티 모음
 Author: python-hwpx Maintainers
 License: Non-Commercial License
-Project-URL: Homepage, https://github.com/hancom-io/python-hwpx
-Project-URL: Documentation, https://github.com/hancom-io/python-hwpx/tree/main/docs
-Project-URL: Issues, https://github.com/hancom-io/python-hwpx/issues
+Project-URL: Homepage, https://github.com/airmang/python-hwpx
+Project-URL: Documentation, https://github.com/airmang/python-hwpx/tree/main/docs
+Project-URL: Issues, https://github.com/airmang/python-hwpx/issues
 Keywords: hwp,hwpx,hancom,opc,xml
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
@@ -45,13 +45,10 @@ python-hwpx는 Hancom HWPX 패키지를 분석하고 편집하기 위한 Python
 
 ### 1. 환경 준비
 
-가상 환경을 만든 뒤 PyPI에 배포된 패키지를 설치하세요.
+pip를 이용해 패키지를 설치합니다.
 
 ```bash
-python -m venv .venv
-source .venv/bin/activate
-python -m pip install --upgrade pip
-python -m pip install python-hwpx
+python pip install python-hwpx
 ```
 
 최신 개발 버전을 사용하거나 소스 코드를 수정하려면 편집 가능한 설치를 권장합니다.

{python-hwpx-1.0 → python-hwpx-1.2}/src/python_hwpx.egg-info/SOURCES.txt

@@ -4,6 +4,8 @@ pyproject.toml
 src/hwpx/__init__.py
 src/hwpx/document.py
 src/hwpx/package.py
+src/hwpx/templates.py
+src/hwpx/data/Skeleton.hwpx
 src/hwpx/opc/package.py
 src/hwpx/oxml/__init__.py
 src/hwpx/oxml/body.py

{python-hwpx-1.0 → python-hwpx-1.2}/tests/test_document_formatting.py

@@ -384,6 +384,31 @@ def test_header_begin_numbering_creates_element_when_missing() -> None:
     assert header.dirty is True
 
 
+def test_header_ensure_char_property_creates_blocks_and_ids() -> None:
+    head_element = ET.Element(f"{HH}head", {"version": "1.4", "secCnt": "1"})
+    header = HwpxOxmlHeader("header.xml", head_element)
+
+    created = header.ensure_char_property(
+        modifier=lambda el: ET.SubElement(el, f"{HH}bold"),
+    )
+
+    ref_list = head_element.find(f"{HH}refList")
+    assert ref_list is not None
+    char_props = ref_list.find(f"{HH}charProperties")
+    assert char_props is not None
+    assert char_props.get("itemCnt") == "1"
+    assert created.get("id") == "0"
+
+    def italic_modifier(element: ET.Element) -> None:
+        for child in list(element.findall(f"{HH}bold")):
+            element.remove(child)
+        ET.SubElement(element, f"{HH}italic")
+
+    second = header.ensure_char_property(modifier=italic_modifier)
+    assert second.get("id") == "1"
+    assert char_props.get("itemCnt") == "2"
+
+
 def test_paragraph_add_shape_and_control_updates_attributes() -> None:
     section, paragraph = _build_section_with_paragraph()
 

{python-hwpx-1.0 → python-hwpx-1.2}/tests/test_memo_and_style_editing.py

@@ -236,3 +236,70 @@ def test_add_memo_with_anchor_creates_paragraph_when_missing() -> None:
     field_end = runs[-1].find(f"{HP}ctrl/{HP}fieldEnd")
     assert field_end is not None
     assert field_end.get("beginIDRef") == "field-02"
+
+
+def test_document_ensure_run_style_creates_bold_entry() -> None:
+    document, _, header = _build_document()
+
+    char_props = header.element.find(f"{HH}refList/{HH}charProperties")
+    assert char_props is not None
+    initial_count = len(list(char_props.findall(f"{HH}charPr")))
+
+    style_id = document.ensure_run_style(bold=True)
+    assert style_id != "10"
+
+    assert char_props.get("itemCnt") == str(initial_count + 1)
+    created = char_props.find(f"{HH}charPr[@id='{style_id}']")
+    assert created is not None
+    assert created.find(f"{HH}bold") is not None
+    underline = created.find(f"{HH}underline")
+    assert underline is not None and underline.get("type") == "NONE"
+
+    style = document.char_property(style_id)
+    assert style is not None and "bold" in style.child_attributes
+
+    assert document.ensure_run_style(bold=True) == style_id
+    assert char_props.get("itemCnt") == str(initial_count + 1)
+
+
+def test_paragraph_add_run_and_toggle_formatting() -> None:
+    document, section, header = _build_document()
+    paragraph = section.paragraphs[0]
+    char_props = header.element.find(f"{HH}refList/{HH}charProperties")
+    assert char_props is not None
+
+    initial_count = len(list(char_props.findall(f"{HH}charPr")))
+    run = paragraph.add_run("서식 적용", bold=True)
+
+    assert run.text == "서식 적용"
+    assert run.bold is True
+    assert run.italic is False
+    assert run.underline is False
+
+    bold_id = run.char_pr_id_ref
+    assert bold_id is not None
+    bold_entry = char_props.find(f"{HH}charPr[@id='{bold_id}']")
+    assert bold_entry is not None
+    assert len(list(char_props.findall(f"{HH}charPr"))) == initial_count + 1
+
+    run.italic = True
+    assert run.bold is True
+    assert run.italic is True
+    italic_id = run.char_pr_id_ref
+    assert italic_id is not None and italic_id != bold_id
+    italic_entry = char_props.find(f"{HH}charPr[@id='{italic_id}']")
+    assert italic_entry is not None
+    assert italic_entry.find(f"{HH}bold") is not None
+    assert italic_entry.find(f"{HH}italic") is not None
+
+    run.underline = True
+    assert run.underline is True
+    underline_id = run.char_pr_id_ref
+    underline_entry = char_props.find(f"{HH}charPr[@id='{underline_id}']")
+    assert underline_entry is not None
+    underline_node = underline_entry.find(f"{HH}underline")
+    assert underline_node is not None and underline_node.get("type", "") != "NONE"
+
+    total_styles = len(list(char_props.findall(f"{HH}charPr")))
+    assert total_styles == initial_count + 3
+    assert char_props.get("itemCnt") == str(total_styles)