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>
37 lines
1.3 KiB
Python
37 lines
1.3 KiB
Python
"""Directly exposed API functions and classes, :func:`Document` for now.
|
|
|
|
Provides a syntactically more convenient API for interacting with the OpcPackage graph.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import os
|
|
from typing import IO, TYPE_CHECKING, cast
|
|
|
|
from docx.opc.constants import CONTENT_TYPE as CT
|
|
from docx.package import Package
|
|
|
|
if TYPE_CHECKING:
|
|
from docx.document import Document as DocumentObject
|
|
from docx.parts.document import DocumentPart
|
|
|
|
|
|
def Document(docx: str | IO[bytes] | None = None) -> DocumentObject:
|
|
"""Return a |Document| object loaded from `docx`, where `docx` can be either a path
|
|
to a ``.docx`` file (a string) or a file-like object.
|
|
|
|
If `docx` is missing or ``None``, the built-in default document "template" is
|
|
loaded.
|
|
"""
|
|
docx = _default_docx_path() if docx is None else docx
|
|
document_part = cast("DocumentPart", Package.open(docx).main_document_part)
|
|
if document_part.content_type != CT.WML_DOCUMENT_MAIN:
|
|
tmpl = "file '%s' is not a Word file, content type is '%s'"
|
|
raise ValueError(tmpl % (docx, document_part.content_type))
|
|
return document_part.document
|
|
|
|
|
|
def _default_docx_path():
|
|
"""Return the path to the built-in default .docx package."""
|
|
_thisdir = os.path.split(__file__)[0]
|
|
return os.path.join(_thisdir, "templates", "default.docx")
|