Add timedelta support to timestr_to_secs.

Fixes #4521.

Also mention that `accept_plain_values` is deprecated (#4522).

src/robot/utils/robottime.py

@@ -15,6 +15,7 @@
 
 import re
 import time
+from datetime import timedelta
 
 from .normalizing import normalize
 from .misc import plural_or_not
@@ -39,7 +40,16 @@ def _float_secs_to_secs_and_millis(secs):
 
 
 def timestr_to_secs(timestr, round_to=3, accept_plain_values=True):
-    """Parses time like '1h 10s', '01:00:10' or '42' and returns seconds."""
+    """Parses time strings like '1h 10s', '01:00:10' and '42' and returns seconds.
+
+    Time can also be given as an integer or float or, starting from RF 6.0.1,
+    as a `timedelta` instance.
+
+    The result is rounded according to the `round_to` argument.
+    Use `round_to=None` to disable rounding altogether.
+
+    `accept_plain_values` is considered deprecated and should not be used.
+    """
     if is_string(timestr) or is_number(timestr):
         if accept_plain_values:
             converters = [_number_to_secs, _timer_to_secs, _time_string_to_secs]
@@ -49,6 +59,8 @@ def timestr_to_secs(timestr, round_to=3, accept_plain_values=True):
             secs = converter(timestr)
             if secs is not None:
                 return secs if round_to is None else round(secs, round_to)
+    if isinstance(timestr, timedelta):
+        return timestr.total_seconds()
     raise ValueError("Invalid time string '%s'." % timestr)
 
 

utest/utils/test_robottime.py

@@ -1,7 +1,7 @@
 import unittest
 import re
 import time
-from datetime import datetime
+from datetime import datetime, timedelta
 
 from robot.utils.asserts import (assert_equal, assert_raises_with_msg,
                                  assert_true, assert_not_none)
@@ -154,6 +154,10 @@ def test_timestr_to_secs_with_timer_string(self):
                 exp += 0.5 if inp[0] != '-' else -0.5
                 assert_equal(timestr_to_secs(inp), exp, inp)
 
+    def test_timestr_to_secs_with_timedelta(self):
+        assert_equal(timestr_to_secs(timedelta(minutes=1)), 60)
+        assert_equal(timestr_to_secs(timedelta(microseconds=1000)), 0.001)
+
     def test_timestr_to_secs_custom_rounding(self):
         secs = 0.123456789
         for round_to in 0, 1, 6: