Limit document status update wait time to 60 seconds, and log wait times

Author: daniel-jones-dev

CHANGELOG.md

@@ -5,6 +5,16 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 
+## [Unreleased]
+### Added
+### Changed
+* Limit document status update wait time to 60 seconds, and log wait times.
+### Deprecated
+### Removed
+### Fixed
+### Security
+
+
 ## [1.3.0] - 2021-11-15
 ### Added
 * Add glossary support for document translation.
@@ -102,6 +112,7 @@ Version increased to avoid conflicts with old packages on PyPI.
 Initial version.
 
 
+[Unreleased]: https://github.com/DeepLcom/deepl-python/compare/v1.3.0...HEAD
 [1.3.0]: https://github.com/DeepLcom/deepl-python/compare/v1.2.1...v1.3.0
 [1.2.1]: https://github.com/DeepLcom/deepl-python/compare/v1.2.0...v1.2.1
 [1.2.0]: https://github.com/DeepLcom/deepl-python/compare/v1.1.3...v1.2.0

deepl/translator.py

@@ -820,7 +820,12 @@ def translate_document(
         try:
             status = self.translate_document_get_status(handle)
             while status.ok and not status.done:
-                secs = (status.seconds_remaining or 0) / 2 + 1
+                secs = (status.seconds_remaining or 0) / 2.0 + 1.0
+                secs = max(1.0, min(secs, 60.0))
+                util.log_info(
+                    f"Rechecking document translation status "
+                    f"after sleeping for {secs:.3f} seconds."
+                )
                 time.sleep(secs)
                 status = self.translate_document_get_status(handle)