Package

CoreProperties object providing read/write access to the Dublin Core properties for this document.

ImageParts collection object for this package.

Return a reference to the main document part for this package.

Examples include a document part for a WordprocessingML package, a presentation part for a PresentationML package, or a workbook part for a SpreadsheetML package.

Return a list containing a reference to each of the parts in this package.

Return a reference to the Relationships instance holding the collection of relationships for this package.

Called by loading code after all parts and relationships have been loaded.

This method affords the opportunity for any required post-processing.

Return ImagePart containing image specified by image_descriptor.

The image-part is newly created if a matching one is not already present in the collection.

Generate exactly one reference to each of the parts in the package by performing a depth-first traversal of the rels graph.

Generate exactly one reference to each relationship in the package by performing a depth-first traversal of the rels graph.

Return newly added _Relationship instance of reltype between this part and target with key rId.

Target mode is set to RTM.EXTERNAL if is_external is True. Intended for use during load from a serialized package, where the rId is well known. Other methods exist for adding a new relationship to the package during processing.

Return a PackURI instance representing partname matching template.

The returned part-name has the next available numeric suffix to distinguish it from other parts of its type. template is a printf (%)-style template string containing a single replacement item, a '%d' to be used to insert the integer portion of the partname. Example: "/word/header%d.xml"

Return an OpcPackage instance loaded with the contents of pkg_file.

Return part to which this package has a relationship of reltype.

Raises KeyError if no such relationship is found and ValueError if more than one such relationship is found.

Return rId key of new or existing relationship to part.

If a relationship of reltype to part already exists, its rId is returned. Otherwise a new relationship is created and that rId is returned.

Save this package to pkg_file, a path or a stream positioned at byte zero.

Serializes to a sibling temp file, reparses it to confirm it opens, then replaces the destination. A failed save leaves the original untouched and never leaves behind a package Word cannot open. An existing destination keeps its permission bits. A symlink destination is followed and its target replaced.

Raises MalformedPackageError when the serialized output will not reparse, and OSError for a stream in append mode, a stream positioned past byte zero, or a destination symlink that moves mid-save.