Expand type annotations and add classes for path item handling

examples/active_layer.py

@@ -28,9 +28,9 @@
         docRef.artLayers.add()
 
     # Display current active layer name
-    ps.echo(docRef.activeLayer.name)
+    print(docRef.activeLayer.name)
 
     # Create and rename a new layer
     new_layer = docRef.artLayers.add()
-    ps.echo(new_layer.name)
+    print(new_layer.name)
     new_layer.name = "test"

examples/add_metadata.py

@@ -13,4 +13,4 @@
     doc.info.provinceState = "Beijing"
     doc.info.title = "My Demo"
     print("Print all metadata of current active document.")
-    ps.echo(doc.info)
+    print(doc.info)

examples/change_color_of_background_and_foreground.py

@@ -34,10 +34,10 @@
     ps.app.backgroundColor = bg_color
 
     # Print current colors
-    ps.echo(f"Foreground RGB: {ps.app.foregroundColor.rgb.red}, "
+    print(f"Foreground RGB: {ps.app.foregroundColor.rgb.red}, "
             f"{ps.app.foregroundColor.rgb.green}, "
             f"{ps.app.foregroundColor.rgb.blue}")
 
-    ps.echo(f"Background RGB: {ps.app.backgroundColor.rgb.red}, "
+    print(f"Background RGB: {ps.app.backgroundColor.rgb.red}, "
             f"{ps.app.backgroundColor.rgb.green}, "
             f"{ps.app.backgroundColor.rgb.blue}")

examples/compare_colors.py

@@ -34,4 +34,4 @@
                color1.rgb.green == color2.rgb.green and
                color1.rgb.blue == color2.rgb.blue)
 
-    ps.echo(f"Colors are {'same' if is_same else 'different'}")
+    print(f"Colors are {'same' if is_same else 'different'}")

examples/convert_smartobject_to_layer.py

@@ -26,12 +26,12 @@
 
     # Convert to smart object
     layer.convertToSmartObject()
-    ps.echo("Layer converted to Smart Object")
+    print("Layer converted to Smart Object")
 
     # Check if it's a smart object
     if layer.kind == ps.LayerKind.SmartObjectLayer:
-        ps.echo("Layer is now a Smart Object")
+        print("Layer is now a Smart Object")
 
         # Convert back to regular layer
         layer.rasterize(ps.RasterizeType.EntireLayer)
-        ps.echo("Smart Object converted back to regular layer")
+        print("Smart Object converted back to regular layer")

examples/current_tool.py

@@ -22,4 +22,4 @@
     current = ps.app.currentTool
 
     # Print current tool name
-    ps.echo(f"Current tool: {current}")
+    print(f"Current tool: {current}")

examples/eval_javascript.py

@@ -21,4 +21,4 @@
     # Execute JavaScript command
     js_code = "app.documents.length"
     result = ps.app.eval_javascript(js_code)
-    ps.echo(f"Number of open documents: {result}")
+    print(f"Number of open documents: {result}")

examples/export_layers_use_export_options_saveforweb.py

@@ -33,7 +33,7 @@ def main():
             image_path = os.path.join(layer_path, f"{layer.name}.png")
             doc.exportDocument(image_path, exportAs=ps.ExportType.SaveForWeb, options=options)
         ps.alert("Task done!")
-        ps.echo(doc.activeLayer)
+        print(doc.activeLayer)
 
 
 if __name__ == "__main__":

examples/get_document_by_name.py

@@ -19,7 +19,7 @@
     # Try to get document named 'test.psd'
     for doc in ps.app.documents:
         if doc.name == "test.psd":
-            ps.echo(doc.name)
+            print(doc.name)
             break
     else:
-        ps.echo("Document not found!")
+        print("Document not found!")

examples/get_layer_by_name.py

@@ -20,5 +20,5 @@
     doc = ps.app.activeDocument
     for layer in doc.layers:
         if layer.name == "example layer":
-            ps.echo(layer.name)
+            print(layer.name)
             break

examples/link_layer.py

@@ -35,9 +35,9 @@
     layer2.link(layer3)
 
     # Check link status
-    ps.echo(f"Layer 1 linked: {layer1.linked}")
-    ps.echo(f"Layer 2 linked: {layer2.linked}")
-    ps.echo(f"Layer 3 linked: {layer3.linked}")
+    print(f"Layer 1 linked: {layer1.linked}")
+    print(f"Layer 2 linked: {layer2.linked}")
+    print(f"Layer 3 linked: {layer3.linked}")
 
     # Move linked layers together
     layer1.translate(100, 100)

examples/open_psd.py

@@ -9,4 +9,4 @@
 
 # style 2
 with Session("your/psd/or/psb/file_path.psd", action="open") as ps:
-    ps.echo(ps.active_document.name)
+    print(ps.active_document.name)

examples/operate_channels.py

@@ -22,7 +22,7 @@
 
     # List all channels
     for channel in doc.channels:
-        ps.echo(f"Channel: {channel.name}")
+        print(f"Channel: {channel.name}")
 
     # Create a new alpha channel
     new_channel = doc.channels.add()

examples/operate_layerSet.py

@@ -41,10 +41,10 @@
 
     # List layers in groups
     for layer in main_group.layers:
-        ps.echo(f"Layer in main group: {layer.name}")
+        print(f"Layer in main group: {layer.name}")
 
     for layer in sub_group.layers:
-        ps.echo(f"Layer in sub group: {layer.name}")
+        print(f"Layer in sub group: {layer.name}")
 
     # Move a layer between groups
     layer1.move(sub_group, ps.ElementPlacement.INSIDE)

examples/session_callback.py

@@ -23,4 +23,4 @@ def on_close():
 
 
 with Session(callback=on_close) as ps:
-    ps.echo("Working in session...")
+    print("Working in session...")

examples/session_new_document.py

@@ -4,4 +4,4 @@
 
 
 with Session(action="new_document") as ps:
-    ps.echo(ps.active_document.name)
+    print(ps.active_document.name)