fix: get document by document name from documents.

Author: loonghao

examples/export_layers_use_export_options_saveforweb.py

@@ -8,6 +8,7 @@
 # Import local modules
 from photoshop import Session
 
+
 PSD_FILE = psd.get_psd_files()
 
 

examples/get_document_by_name.py

@@ -0,0 +1,15 @@
+"""Get document by document name from documents."""
+
+# Import third-party modules
+import examples._psd_files as psd  # Import from examples.
+
+# Import local modules
+from photoshop import Session
+
+
+PSD_FILE = psd.get_psd_files()
+slate_template = PSD_FILE["slate_template.psd"]
+with Session(slate_template, action="open", auto_close=True) as ps:
+    for doc in ps.app.documents:
+        print(doc.name)
+    print(ps.app.documents.getByName("slate_template.psd").fullName)

photoshop/api/_documents.py

@@ -76,5 +76,9 @@ def __getitem__(self, item) -> Document:
     def length(self) -> int:
         return len(list(self.app))
 
-    def getByName(self, document_name: str):
-        return Document(self.app.getByName(document_name))
+    def getByName(self, document_name: str) -> Document:
+        """Get document by given document name."""
+        for doc in self.app:
+            if doc.name == document_name:
+                return Document(doc)
+        raise PhotoshopPythonAPIError(f'Could not find a document named "{document_name}"')

pyproject.toml

@@ -72,7 +72,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.black]
 line-length = 120
-target_version = ['py36']
+target_version = ['py37']
 include = '\.pyi?$'
 exclude = '''