Add some new examples references in docs.

Diptorup Deb · Diptorup Deb · commit cee456fefa06 · 2021-12-21T12:27:28.000-06:00
diff --git a/examples/python/_runner.py b/examples/python/_runner.py
@@ -55,7 +55,7 @@ def run_examples(example_description, glbls_dict):
             print("Available examples:")
             print(", ".join(fns))
         else:
-            print("No examples are availble.")
+            print("No examples are available.")
         exit(0)
     if args.run == "all":
         fns = []
diff --git a/examples/python/device_selection.py b/examples/python/device_selection.py
@@ -103,6 +103,32 @@ def create_device_with_aspects():
     dev.print_device_info()
 
 
+def list_devices():
+    """Programmatically get a list of the available devices.
+
+    The list can be filtered based on backend or device_type.
+    """
+    print("Get a list of all devices:\n")
+
+    for d in dpctl.get_devices():
+        d.print_device_info()
+    print("=======================================\n")
+
+    print("Get the list of only OpenCL devices:\n")
+
+    for d in dpctl.get_devices(backend="opencl"):
+        d.print_device_info()
+
+    print("=======================================\n")
+
+    print("Get all OpenCL CPU devices:\n")
+
+    for d in dpctl.get_devices(backend="opencl", device_type="cpu"):
+        d.print_device_info()
+
+    print("=======================================\n")
+
+
 if __name__ == "__main__":
     import _runner as runner
 
