python: discourage from deleting objects while paginating over them

Fix #3039
fedora-copr · May 13, 2024 · c3691ef · c3691ef
1 parent faa8fd8
commit c3691ef
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/python/docs/client_v3/pagination.rst b/python/docs/client_v3/pagination.rst
@@ -67,6 +67,12 @@ And finally, in some cases, it may be useful to iterate through all objects, but
     Munch({'id': 5, 'ownername': '@copr', 'projectname': 'copr', 'state': 'canceled', ...})
 
 
+.. warning::
+   Don't remove projects, packages, builds, etc while paginating over them. It
+   may result in skipping some results. Instead, query all objects (using
+   pagination) first, and then delete them.
+
+
 Pagination parameters
 ---------------------