ENH: Adding support for reading .metadata.keywords (#2939)

Co-authored-by: Cimon Lucas (LCM) <[email protected]>

pypdf/_doc_common.py

@@ -243,6 +243,21 @@ def modification_date_raw(self) -> Optional[str]:
         """
         return self.get(DI.MOD_DATE)
 
+    @property
+    def keywords(self) -> Optional[str]:
+        """
+        Read-only property accessing the document's keywords.
+
+        Returns a ``TextStringObject`` or ``None`` if keywords are not
+        specified.
+        """
+        return self._get_text(DI.KEYWORDS)
+
+    @property
+    def keywords_raw(self) -> Optional[str]:
+        """The "raw" version of keywords; can return a ``ByteStringObject``."""
+        return self.get(DI.KEYWORDS)
+
 
 class PdfDocCommon:
     """

tests/test_reader.py

@@ -107,6 +107,8 @@ def test_read_metadata(pdf_path, expected):
         docinfo.creation_date_raw
         docinfo.modification_date
         docinfo.modification_date_raw
+        docinfo.keywords
+        docinfo.keywords_raw
         if "/Title" in metadict:
             assert isinstance(docinfo.title, str)
             assert metadict["/Title"] == docinfo.title