Initial commit (Clean history)

path/to/venv/lib/python3.12/site-packages/docx/settings.py

@@ -0,0 +1,35 @@
+"""Settings object, providing access to document-level settings."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, cast
+
+from docx.shared import ElementProxy
+
+if TYPE_CHECKING:
+    import docx.types as t
+    from docx.oxml.settings import CT_Settings
+    from docx.oxml.xmlchemy import BaseOxmlElement
+
+
+class Settings(ElementProxy):
+    """Provides access to document-level settings for a document.
+
+    Accessed using the :attr:`.Document.settings` property.
+    """
+
+    def __init__(self, element: BaseOxmlElement, parent: t.ProvidesXmlPart | None = None):
+        super().__init__(element, parent)
+        self._settings = cast("CT_Settings", element)
+
+    @property
+    def odd_and_even_pages_header_footer(self) -> bool:
+        """True if this document has distinct odd and even page headers and footers.
+
+        Read/write.
+        """
+        return self._settings.evenAndOddHeaders_val
+
+    @odd_and_even_pages_header_footer.setter
+    def odd_and_even_pages_header_footer(self, value: bool):
+        self._settings.evenAndOddHeaders_val = value