Doc-only changes

Author: NoahStapp

pymongo/asynchronous/collection.py

@@ -1776,7 +1776,9 @@ def find(self, *args: Any, **kwargs: Any) -> AsyncCursor[_DocumentType]:
         improper type. Returns an instance of
         :class:`~pymongo.asynchronous.cursor.AsyncCursor` corresponding to this query.
 
-        Best practice is to call :meth:`AsyncCursor.close` when the cursor is no longer needed,
+        Cursors are closed automatically when they are exhausted (the last batch of data is retrieved from the database).
+        If a cursor is not exhausted, it will be closed automatically upon garbage collection, which leaves resources open but unused for a potentially long period of time.
+        To avoid this, best practice is to call :meth:`AsyncCursor.close` when the cursor is no longer needed,
         or use the cursor in a with statement::
 
             async with collection.find() as cursor:

pymongo/asynchronous/cursor.py

@@ -1263,14 +1263,10 @@ async def next(self) -> _DocumentType:
             self._exhaust_checked = True
             await self._supports_exhaust()
         if self._empty:
-            if self._cursor_type == CursorType.NON_TAILABLE:
-                await self.close()
             raise StopAsyncIteration
         if len(self._data) or await self._refresh():
             return self._data.popleft()
         else:
-            if self._cursor_type == CursorType.NON_TAILABLE:
-                await self.close()
             raise StopAsyncIteration
 
     async def _next_batch(self, result: list, total: Optional[int] = None) -> bool:  # type: ignore[type-arg]

pymongo/asynchronous/mongo_client.py

@@ -205,7 +205,7 @@ def __init__(
         Best practice is to call :meth:`AsyncMongoClient.close` when the client is no longer needed,
         or use the client in a with statement::
 
-            with AsyncMongoClient(url) as client:
+            async with AsyncMongoClient(url) as client:
                 # Use client here.
 
         The `host` parameter can be a full `mongodb URI

pymongo/synchronous/collection.py

@@ -1775,7 +1775,9 @@ def find(self, *args: Any, **kwargs: Any) -> Cursor[_DocumentType]:
         improper type. Returns an instance of
         :class:`~pymongo.cursor.Cursor` corresponding to this query.
 
-        Best practice is to call :meth:`Cursor.close` when the cursor is no longer needed,
+        Cursors are closed automatically when they are exhausted (the last batch of data is retrieved from the database).
+        If a cursor is not exhausted, it will be closed automatically upon garbage collection, which leaves resources open but unused for a potentially long period of time.
+        To avoid this, best practice is to call :meth:`Cursor.close` when the cursor is no longer needed,
         or use the cursor in a with statement::
 
             with collection.find() as cursor:

pymongo/synchronous/cursor.py

@@ -1261,14 +1261,10 @@ def next(self) -> _DocumentType:
             self._exhaust_checked = True
             self._supports_exhaust()
         if self._empty:
-            if self._cursor_type == CursorType.NON_TAILABLE:
-                self.close()
             raise StopIteration
         if len(self._data) or self._refresh():
             return self._data.popleft()
         else:
-            if self._cursor_type == CursorType.NON_TAILABLE:
-                self.close()
             raise StopIteration
 
     def _next_batch(self, result: list, total: Optional[int] = None) -> bool:  # type: ignore[type-arg]