python-docxan 0.0.1__tar.gz → 0.0.3__tar.gz

{python_docxan-0.0.1/src/python_docxan.egg-info → python_docxan-0.0.3}/PKG-INFO

@@ -1,13 +1,12 @@
 Metadata-Version: 2.4
 Name: python-docxan
-Version: 0.0.1
+Version: 0.0.3
 Summary: Create, read, and update Microsoft Word .docx files.
 Author-email: Dan Studios <jangalacharansaisri963@gmail.com>
 License: MIT
-Project-URL: Changelog, https://github.com/python-openxml/python-docx/blob/master/HISTORY.rst
-Project-URL: Documentation, https://python-docx.readthedocs.org/en/latest/
-Project-URL: Homepage, https://github.com/python-openxml/python-docx
-Project-URL: Repository, https://github.com/python-openxml/python-docx
+Project-URL: Documentation, https://readthedocs.org
+Project-URL: Homepage, https://github.com
+Project-URL: Repository, https://github.com
 Keywords: docx,office,openxml,word
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
@@ -24,12 +23,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Topic :: Office/Business :: Office Suites
 Classifier: Topic :: Software Development :: Libraries
 Requires-Python: >=3.9
-Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: lxml>=3.1.0
 Requires-Dist: typing_extensions>=4.9.0
 Dynamic: license-file
-
-# python_docxan
-A Python package for processing docx files.
-

{python_docxan-0.0.1 → python_docxan-0.0.3}/pyproject.toml

@@ -26,10 +26,9 @@ dependencies = [
     "typing_extensions>=4.9.0",
 ]
 description = "Create, read, and update Microsoft Word .docx files."
-dynamic = ["version"]
+version = "0.0.3"
 keywords = ["docx", "office", "openxml", "word"]
 license = { text = "MIT" }
-readme = "README.md"
 requires-python = ">=3.9"
 
 [dependency-groups]
@@ -49,10 +48,9 @@ dev = [
 ]
 
 [project.urls]
-Changelog = "https://github.com/python-openxml/python-docx/blob/master/HISTORY.rst"
-Documentation = "https://python-docx.readthedocs.org/en/latest/"
-Homepage = "https://github.com/python-openxml/python-docx"
-Repository = "https://github.com/python-openxml/python-docx"
+Documentation = "https://readthedocs.org"
+Homepage = "https://github.com"
+Repository = "https://github.com"
 
 [tool.pyright]
 include = ["src/docx", "tests"]
@@ -69,13 +67,8 @@ venv = ".venv"
 
 [tool.pytest.ini_options]
 filterwarnings = [
-    # -- exit on any warning not explicitly ignored here --
     "error",
-
-    # -- pytest-xdist plugin may warn about `looponfailroots` deprecation --
     "ignore::DeprecationWarning:xdist",
-
-    # -- pytest complains when pytest-xdist is not installed --
     "ignore:Unknown config option. looponfailroots:pytest.PytestConfigWarning",
 ]
 looponfailroots = ["src", "tests"]
@@ -100,28 +93,24 @@ target-version = "py38"
 
 [tool.ruff.lint]
 ignore = [
-    "COM812",   # -- over-aggressively insists on trailing commas where not desired --
-    "PT001",    # -- wants @pytest.fixture() instead of @pytest.fixture --
+    "COM812",
+    "PT001",
 ]
 select = [
-    "C4",       # -- flake8-comprehensions --
-    "COM",      # -- flake8-commas --
-    "E",        # -- pycodestyle errors --
-    "F",        # -- pyflakes --
-    "I",        # -- isort (imports) --
-    "PLR0402",  # -- Name compared with itself like `foo == foo` --
-    "PT",       # -- flake8-pytest-style --
-    "SIM",      # -- flake8-simplify --
-    "UP015",    # -- redundant `open()` mode parameter (like "r" is default) --
-    "UP018",    # -- Unnecessary {literal_type} call like `str("abc")`. (rewrite as a literal) --
-    "UP032",    # -- Use f-string instead of `.format()` call --
-    "UP034",    # -- Avoid extraneous parentheses --
+    "C4",
+    "COM",
+    "E",
+    "F",
+    "I",
+    "PLR0402",
+    "PT",
+    "SIM",
+    "UP015",
+    "UP018",
+    "UP032",
+    "UP034",
 ]
 
 [tool.ruff.lint.isort]
 known-first-party = ["docx"]
 known-local-folder = ["helpers"]
-
-[tool.setuptools.dynamic]
-version = {attr = "docx.__version__"}
-

{python_docxan-0.0.1 → python_docxan-0.0.3}/src/docx/extensions.py

@@ -2568,91 +2568,65 @@ def _extensions_replace_table(
                 )
 
 
-def add_hyperlink(
-    self,
-    text,
-    url,
-    paragraph=None
-):
+def add_hyperlink(self, text, url, paragraph=None):
     if not text:
-        raise ValueError(
-            "text must not be empty"
-        )
+        raise ValueError("text must not be empty")
 
     if not url:
-        raise ValueError(
-            "url must not be empty"
-        )
+        raise ValueError("url must not be empty")
 
     if paragraph is None:
-        if self.paragraphs:
-            paragraph = self.paragraphs[-1]
-        else:
-            paragraph = self.add_paragraph()
-
-    part = self.part
+        paragraph = (
+            self.paragraphs[-1]
+            if self.paragraphs
+            else self.add_paragraph()
+        )
 
-    relationship_id = part.relate_to(
+    relationship_id = self.part.relate_to(
         str(url),
         "http://schemas.openxmlformats.org/"
-        "officeDocument/2006/relationships/"
-        "hyperlink",
+        "officeDocument/2006/relationships/hyperlink",
         is_external=True
     )
 
-    hyperlink = self._extensions_element(
-        "w:hyperlink"
-    )
+    p = paragraph._p
 
-    hyperlink.set(
-        "r:id",
-        relationship_id
-    )
+    ns = p.nsmap
 
-    run = self._extensions_element(
-        "w:r"
-    )
+    w = "{" + ns["w"] + "}"
+    r = "{" + ns["r"] + "}"
 
-    run_properties = self._extensions_element(
-        "w:rPr"
+    hyperlink = p.makeelement(
+        w + "hyperlink",
+        {r + "id": relationship_id}
     )
 
-    color = self._extensions_element(
-        "w:color"
-    )
+    run = p.makeelement(w + "r")
+    run_properties = p.makeelement(w + "rPr")
 
-    color.set(
-        "w:val",
-        "0563C1"
+    color = p.makeelement(
+        w + "color",
+        {w + "val": "0563C1"}
     )
 
-    underline = self._extensions_element(
-        "w:u"
+    underline = p.makeelement(
+        w + "u",
+        {w + "val": "single"}
     )
 
-    underline.set(
-        "w:val",
-        "single"
-    )
+    text_element = p.makeelement(w + "t")
+    text_element.text = str(text)
 
     run_properties.append(color)
     run_properties.append(underline)
 
-    text_element = self._extensions_element(
-        "w:t"
-    )
-
-    text_element.text = str(text)
-
     run.append(run_properties)
     run.append(text_element)
     hyperlink.append(run)
 
-    paragraph._p.append(
-        hyperlink
-    )
+    p.append(hyperlink)
 
-    return self
+    return self 
 
 
 def add_code_block(

python_docxan-0.0.3/src/docx/extensions_patch.py

@@ -0,0 +1,101 @@
+"""
+Safe monkey-patch for attaching extension helpers to python-docx Document and Table classes.
+
+This module attaches only callables that are actually defined in
+src/docx/extensions.py (so undefined names like add_qrcode/add_barcode
+are skipped). It also avoids clobbering existing attributes unless
+overwrite=True is used.
+
+Place this file at src/docx/extensions_patch.py and import it from
+your package initialization (or simply importing src.docx.extensions
+will also import this file if you prefer).
+"""
+
+import importlib
+from typing import Any
+
+
+def _attach_if_callable(target_cls: Any, module: Any, name: str, overwrite: bool = True) -> bool:
+    """Attach module.name to target_cls if it is callable.
+
+    Returns True if attached, False otherwise.
+    """
+    func = getattr(module, name, None)
+
+    if not callable(func):
+        return False
+
+    if not overwrite and hasattr(target_cls, name):
+        return False
+
+    setattr(target_cls, name, func)
+    return True
+
+
+def apply_safe_monkeypatch(overwrite: bool = True):
+    """Attach only present callables from docx.extensions to the
+    real python-docx classes (Document, Table).
+
+    overwrite: if False, do not overwrite existing attributes on the
+    target classes.
+    """
+    try:
+        from docx.document import Document as DocumentClass
+        from docx.table import Table
+    except Exception:
+        # python-docx not installed or import failed; nothing to do.
+        return False
+
+    try:
+        # Import the package-local extensions module. In this project the
+        # module lives at src/docx/extensions.py, which imports as
+        # `docx.extensions` when the package is used.
+        ext = importlib.import_module("docx.extensions")
+    except Exception:
+        return False
+
+    doc_methods = [
+        "add_markdown",
+        "add_html",
+        "add_dataframe",
+        "add_chart",
+        "set_watermark",
+        "add_page_numbers",
+        "set_header_footer",
+        "add_cover_page",
+        "add_toc",
+        "add_picture_advanced",
+        "add_image_grid",
+        "add_figure",
+        "render_template",
+        "add_markdown_tables",
+        "add_code_block",
+        "add_hyperlink",
+        "set_metadata",
+        "apply_theme",
+        "theme",
+        "get_stats",
+        "stats",
+        "debug_xml",
+        "validate",
+    ]
+
+    table_methods = [
+        "apply_table_style",
+        "apply_style",
+        "repeat_header",
+    ]
+
+    for name in doc_methods:
+        _attach_if_callable(DocumentClass, ext, name, overwrite=overwrite)
+
+    for name in table_methods:
+        _attach_if_callable(Table, ext, name, overwrite=overwrite)
+
+    return True
+
+
+# Apply by default (safe: only attaches callables that exist in the
+# extensions module). Callers can import this module and call
+# apply_safe_monkeypatch(overwrite=False) to avoid overwriting.
+apply_safe_monkeypatch(overwrite=True)

{python_docxan-0.0.1 → python_docxan-0.0.3/src/python_docxan.egg-info}/PKG-INFO

@@ -1,13 +1,12 @@
 Metadata-Version: 2.4
 Name: python-docxan
-Version: 0.0.1
+Version: 0.0.3
 Summary: Create, read, and update Microsoft Word .docx files.
 Author-email: Dan Studios <jangalacharansaisri963@gmail.com>
 License: MIT
-Project-URL: Changelog, https://github.com/python-openxml/python-docx/blob/master/HISTORY.rst
-Project-URL: Documentation, https://python-docx.readthedocs.org/en/latest/
-Project-URL: Homepage, https://github.com/python-openxml/python-docx
-Project-URL: Repository, https://github.com/python-openxml/python-docx
+Project-URL: Documentation, https://readthedocs.org
+Project-URL: Homepage, https://github.com
+Project-URL: Repository, https://github.com
 Keywords: docx,office,openxml,word
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
@@ -24,12 +23,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Topic :: Office/Business :: Office Suites
 Classifier: Topic :: Software Development :: Libraries
 Requires-Python: >=3.9
-Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: lxml>=3.1.0
 Requires-Dist: typing_extensions>=4.9.0
 Dynamic: license-file
-
-# python_docxan
-A Python package for processing docx files.
-

{python_docxan-0.0.1 → python_docxan-0.0.3}/src/python_docxan.egg-info/SOURCES.txt

@@ -246,6 +246,7 @@ src/docx/comments.py
 src/docx/document.py
 src/docx/exceptions.py
 src/docx/extensions.py
+src/docx/extensions_patch.py
 src/docx/package.py
 src/docx/py.typed
 src/docx/section.py