Implements extended-properties

.gitignore

@@ -1,9 +1,16 @@
 .coverage
+.vscode
+.idea
+.pytest_cache/
 /dist/
 /docs/.build/
 /*.egg-info
 *.pyc
-.pytest_cache/
 _scratch/
 Session.vim
 /.tox/
+/build/
+build-install.bat
+app.xml
+core.xml
+editor-appproperties.py

docx/__init__.py

@@ -10,6 +10,7 @@
 from docx.opc.constants import CONTENT_TYPE as CT, RELATIONSHIP_TYPE as RT
 from docx.opc.part import PartFactory
 from docx.opc.parts.coreprops import CorePropertiesPart
+from docx.opc.parts.extendedprops import ExtendedPropertiesPart
 
 from docx.parts.document import DocumentPart
 from docx.parts.hdrftr import FooterPart, HeaderPart
@@ -27,6 +28,7 @@ def part_class_selector(content_type, reltype):
 
 PartFactory.part_class_selector = part_class_selector
 PartFactory.part_type_for[CT.OPC_CORE_PROPERTIES] = CorePropertiesPart
+PartFactory.part_type_for[CT.OPC_EXTENDED_PROPERTIES] = ExtendedPropertiesPart
 PartFactory.part_type_for[CT.WML_DOCUMENT_MAIN] = DocumentPart
 PartFactory.part_type_for[CT.WML_FOOTER] = FooterPart
 PartFactory.part_type_for[CT.WML_HEADER] = HeaderPart
@@ -37,6 +39,7 @@ def part_class_selector(content_type, reltype):
 del (
     CT,
     CorePropertiesPart,
+    ExtendedPropertiesPart,
     DocumentPart,
     FooterPart,
     HeaderPart,

docx/document.py

@@ -100,6 +100,14 @@ def core_properties(self):
         properties of this document.
         """
         return self._part.core_properties
+
+    @property
+    def extended_properties(self):
+        """
+        A |AppProperties| object providing read/write access to the app
+        properties of this document.
+        """
+        return self._part.extended_properties
 
     @property
     def inline_shapes(self):

docx/opc/constants.py

@@ -77,6 +77,9 @@ class CONTENT_TYPE(object):
     OPC_CORE_PROPERTIES = (
         'application/vnd.openxmlformats-package.core-properties+xml'
     )
+    OPC_EXTENDED_PROPERTIES = (
+        'application/vnd.openxmlformats-officedocument.extended-properties+xml'
+    )
     OPC_DIGITAL_SIGNATURE_CERTIFICATE = (
         'application/vnd.openxmlformats-package.digital-signature-certificat'
         'e'
@@ -409,8 +412,8 @@ class RELATIONSHIP_TYPE(object):
         '/control'
     )
     CORE_PROPERTIES = (
-        'http://schemas.openxmlformats.org/package/2006/relationships/metada'
-        'ta/core-properties'
+        'http://schemas.openxmlformats.org/package/2006/relationships/metadata'
+        '/core-properties'
     )
     CUSTOM_PROPERTIES = (
         'http://schemas.openxmlformats.org/officeDocument/2006/relationships'

docx/opc/extendedprops.py

@@ -0,0 +1,97 @@
+# encoding: utf-8
+
+"""
+The :mod:`pptx.opc.extendedprops` module defines the ExtendedProperties class, which
+coheres around the concerns of reading and writing application document
+properties to and from the app.xml part of a .docx file.
+"""
+
+from __future__ import absolute_import, division, print_function, unicode_literals
+
+import re
+
+
+def _get_property_name_from_tag(tag):
+    name = tag.split('}')[-1]
+    snake_name = ''.join(['_' + i.lower() if i.isupper() else i for i in name]).lstrip('_')
+    return snake_name
+
+
+class ExtendedProperties(object):
+    """
+    Corresponds to part named ``/docProps/app.xml``, containing the extended
+    document properties for this document package.
+    """
+
+    def __init__(self, element):
+        self._element = element
+        self.template = None
+        self.manager = None
+        self.company = None
+        self.pages = None
+        self.words = None
+        self.characters = None
+        self.presentation_format = None
+        self.lines = None
+        self.paragraphs = None
+        self.slides = None
+        self.notes = None
+        self.total_time = None
+        self.hidden_slides = None
+        self.mm_clips = None
+        self.scale_crop = None
+        self.heading_pairs = None
+        self.titles_of_parts = None
+        self.links_up_to_date = None
+        self.characters_with_space = None
+        self.shared_doc = None
+        self.hyperlink_base = None
+        self.h_links = None
+        self.hyperlinks_changed = None
+        self.dig_sig = None
+        self.application = None
+        self.app_version = None
+        self.doc_security = None
+        self._property_elements = {}
+
+        for child in self._element:
+            property_name = _get_property_name_from_tag(child.tag)
+            if hasattr(self, property_name):
+                setattr(self, property_name, child.text)
+                self._property_elements[property_name] = child
+
+    def set_property(self, property_name, value):
+        if hasattr(self, property_name):
+            xml_element = self._property_elements.get(property_name)
+            if xml_element is not None:
+                xml_element.text = value
+                setattr(self, property_name, value)
+            else:
+                raise AttributeError(f"XML element not found for property '{property_name}'.")
+        else:
+            raise AttributeError(f"Property '{property_name}' not found in ExtendedProperties.")
+
+    # @property
+    # def total_time(self):
+    #     return self._element[1].text
+    #
+    # @total_time.setter
+    # def total_time(self, value):
+    #     self._element[1].text = value
+    #
+    # @property
+    # def template(self):
+    #     return self._element[0].text
+    #
+    # @template.setter
+    # def template(self, value):
+    #     self._element[0].text = value
+    #
+    # @property
+    # def pages(self):
+    #     return self._element[2].text
+    #
+    # @pages.setter
+    # def pages(self, value):
+    #     self._element[2].text = value
+

docx/opc/package.py

@@ -8,6 +8,7 @@
 from docx.opc.packuri import PACKAGE_URI, PackURI
 from docx.opc.part import PartFactory
 from docx.opc.parts.coreprops import CorePropertiesPart
+from docx.opc.parts.extendedprops import ExtendedPropertiesPart
 from docx.opc.pkgreader import PackageReader
 from docx.opc.pkgwriter import PackageWriter
 from docx.opc.rel import Relationships
@@ -40,6 +41,14 @@ def core_properties(self):
         Core properties for this document.
         """
         return self._core_properties_part.core_properties
+
+    @property
+    def extended_properties(self):
+        """
+        |AppProperties| object providing read/write access to the Dublin
+        App properties for this document.
+        """
+        return self._extended_properties_part.extended_properties
 
     def iter_rels(self):
         """
@@ -183,6 +192,19 @@ def _core_properties_part(self):
             core_properties_part = CorePropertiesPart.default(self)
             self.relate_to(core_properties_part, RT.CORE_PROPERTIES)
             return core_properties_part
+
+    @property
+    def _extended_properties_part(self):
+        """
+        |ExtendedPropertiesPart| object related to this package. Creates
+        a default app properties part if one is not present (not common).
+        """
+        try:
+            return self.part_related_by(RT.EXTENDED_PROPERTIES)
+        except KeyError:
+            extended_properties_part = ExtendedPropertiesPart.default(self)
+            self.relate_to(extended_properties_part, RT.EXTENDED_PROPERTIES)
+            return extended_properties_part
 
 
 class Unmarshaller(object):

docx/opc/part.py

@@ -16,6 +16,7 @@
 from .shared import lazyproperty
 
 
+
 class Part(object):
     """
     Base class for package parts. Provides common properties and methods, but

docx/opc/parts/extendedprops.py

@@ -0,0 +1,60 @@
+# encoding: utf-8
+# docx\opc\parts\extendedprops.py
+"""
+App properties part, corresponds to ``/docProps/app.xml`` part in package.
+"""
+
+from __future__ import (
+    absolute_import, division, print_function, unicode_literals
+)
+
+
+from ..constants import CONTENT_TYPE as CT
+from ..extendedprops import ExtendedProperties
+from ..part import XmlPart
+from ...oxml.extendedprops import CT_ExtendedProperties
+from ..packuri import PackURI
+
+
+class ExtendedPropertiesPart(XmlPart):
+    """
+    Corresponds to part named ``/docProps/app.xml``, containing the app
+    document properties for this document package.
+    """
+    @classmethod
+    def default(cls, package):
+        """
+        Return a new |ExtendedPropertiesPart| object initialized with default
+        values for its base properties.
+        """
+        extended_properties_part = cls._new(package)
+        extended_properties = extended_properties_part.extended_properties
+        extended_properties.total_time = '1'
+        # extended_properties.pages = '1'
+        # extended_properties.company = 'Company'
+        # extended_properties.manager = 'Manager'
+        # extended_properties.category = 'Category'
+        # extended_properties.presentation_format = 'Presentation Format'
+        # extended_properties.links_up_to_date = 'false'
+        # extended_properties.characters = '1'
+        # extended_properties.lines = '1'
+        # extended_properties.paragraphs = '1'
+
+        return extended_properties_part
+
+    @property
+    def extended_properties(self):
+        """
+        A |ExtendedProperties| object providing read/write access to the app
+        properties contained in this app properties part.
+        """
+        return ExtendedProperties(self.element)
+
+    @classmethod
+    def _new(cls, package):
+        partname = PackURI('/docProps/app.xml')
+        content_type = CT.OFC_EXTENDED_PROPERTIES
+        extended_properties = CT_ExtendedProperties.new()
+        return ExtendedPropertiesPart(
+            partname, content_type, extended_properties, package
+        )