Merge pull request #943 from planetlabs/938-update-example-in-docstring

938 update example in docstring

planet/clients/data.py

@@ -65,16 +65,16 @@ class Searches(Paged):
 
 
 class DataClient:
-    """Low-level asynchronous access to Planet's data API.
+    """High-level asynchronous access to Planet's data API.
 
     Example:
         ```python
         >>> import asyncio
-        >>> from planet import Session, DataClient
+        >>> from planet import Session
         >>>
         >>> async def main():
         ...     async with Session() as sess:
-        ...         cl = DataClient(sess)
+        ...         cl = sess.client('data')
         ...         # use client here
         ...
         >>> asyncio.run(main())

planet/clients/orders.py

@@ -72,11 +72,11 @@ class OrdersClient:
     Example:
         ```python
         >>> import asyncio
-        >>> from planet import Session, OrdersClient
+        >>> from planet import Session
         >>>
         >>> async def main():
         ...     async with Session() as sess:
-        ...         cl = OrdersClient(sess)
+        ...         cl = sess.client('orders')
         ...         # use client here
         ...
         >>> asyncio.run(main())
@@ -119,7 +119,7 @@ async def create_order(self, request: dict) -> dict:
 
         ```python
         >>> import asyncio
-        >>> from planet import Session, OrdersClient
+        >>> from planet import Session
         >>> from planet.order_request import build_request, product
         >>>
         >>> async def main():
@@ -129,7 +129,7 @@ async def create_order(self, request: dict) -> dict:
         ...         [product(image_ids, 'analytic_udm2', 'psscene')]
         ...     )
         ...     async with Session() as sess:
-        ...         cl = OrdersClient(sess)
+        ...         cl = sess.client('orders')
         ...         order = await cl.create_order(request)
         ...
         >>> asyncio.run(main())

planet/clients/subscriptions.py

@@ -25,6 +25,21 @@ class SubscriptionsClient:
     exceptions raised by this class are categorized by HTTP client
     (4xx) or server (5xx) errors. This client's level of abstraction is
     low.
+
+    High-level asynchronous access to Planet's subscriptions API:
+
+    Example:
+        ```python
+        >>> import asyncio
+        >>> from planet import Session
+        >>>
+        >>> async def main():
+        ...     async with Session() as sess:
+        ...         cl = sess.client('subscriptions')
+        ...         # use client here
+        ...
+        >>> asyncio.run(main())
+        ```
     """
 
     def __init__(self,