ac2db33732
- Create Economist SubmissionTracking package correctly: * mainArticle = full blog post content * coverLetter = 216-word SIR— letter * Links to blog post via blogPostId - Archive 'Letter to The Economist' from blog posts (it's the cover letter) - Fix date display on article cards (use published_at) - Target publication already displaying via blue badge Database changes: - Make blogPostId optional in SubmissionTracking model - Economist package ID: 68fa85ae49d4900e7f2ecd83 - Le Monde package ID: 68fa2abd2e6acd5691932150 Next: Enhanced modal with tabs, validation, export 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
59 lines
2.2 KiB
Python
59 lines
2.2 KiB
Python
"""DrawingML-related objects are in this subpackage."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import TYPE_CHECKING
|
|
|
|
from docx.oxml.drawing import CT_Drawing
|
|
from docx.shared import Parented
|
|
|
|
if TYPE_CHECKING:
|
|
import docx.types as t
|
|
from docx.image.image import Image
|
|
|
|
|
|
class Drawing(Parented):
|
|
"""Container for a DrawingML object."""
|
|
|
|
def __init__(self, drawing: CT_Drawing, parent: t.ProvidesStoryPart):
|
|
super().__init__(parent)
|
|
self._parent = parent
|
|
self._drawing = self._element = drawing
|
|
|
|
@property
|
|
def has_picture(self) -> bool:
|
|
"""True when `drawing` contains an embedded picture.
|
|
|
|
A drawing can contain a picture, but it can also contain a chart, SmartArt, or a
|
|
drawing canvas. Methods related to a picture, like `.image`, will raise when the drawing
|
|
does not contain a picture. Use this value to determine whether image methods will succeed.
|
|
|
|
This value is `False` when a linked picture is present. This should be relatively rare and
|
|
the image would only be retrievable from the filesystem.
|
|
|
|
Note this does not distinguish between inline and floating images. The presence of either
|
|
one will cause this value to be `True`.
|
|
"""
|
|
xpath_expr = (
|
|
# -- an inline picture --
|
|
"./wp:inline/a:graphic/a:graphicData/pic:pic"
|
|
# -- a floating picture --
|
|
" | ./wp:anchor/a:graphic/a:graphicData/pic:pic"
|
|
)
|
|
# -- xpath() will return a list, empty if there are no matches --
|
|
return bool(self._drawing.xpath(xpath_expr))
|
|
|
|
@property
|
|
def image(self) -> Image:
|
|
"""An `Image` proxy object for the image in this (picture) drawing.
|
|
|
|
Raises `ValueError` when this drawing does contains something other than a picture. Use
|
|
`.has_picture` to qualify drawing objects before using this property.
|
|
"""
|
|
picture_rIds = self._drawing.xpath(".//pic:blipFill/a:blip/@r:embed")
|
|
if not picture_rIds:
|
|
raise ValueError("drawing does not contain a picture")
|
|
rId = picture_rIds[0]
|
|
doc_part = self.part
|
|
image_part = doc_part.related_parts[rId]
|
|
return image_part.image
|