feat(timing): enhance timing function with adaptive units and run averaging (#11834)

* feat: add Matrix Exponentiation method
docs: updated the header documentation and added new documentation for
the new function.

* feat: added new function matrix exponetiation method

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* feat: This function uses the tail-recursive form of the Euclidean algorithm to calculate

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* reduced the number of characters per line in the comments

* removed unwanted code

* feat: Implemented a new function to swaap numbers without dummy variable

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* removed previos code

* Done with the required changes

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* Done with the required changes

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* Done with the required changes

* Done with the required changes

* Done with the required changes

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* Update maths/fibonacci.py

Co-authored-by: Tianyi Zheng <tianyizheng02@gmail.com>

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* Done with the required changes

* Done with the required changes

* Done with the required changes

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* feat(timing): enhance timing function with adaptive units and run averaging

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* feat(timing): enhance timing function with adaptive units and run averaging

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Tianyi Zheng <tianyizheng02@gmail.com>
Co-authored-by: Christian Clauss <cclauss@me.com>

Author: 4 people

maths/fibonacci.py

@@ -29,11 +29,20 @@ def time_func(func, *args, **kwargs):
     """
     start = time()
     output = func(*args, **kwargs)
-    end = time()
-    if int(end - start) > 0:
-        print(f"{func.__name__} runtime: {(end - start):0.4f} s")
+    duration = time() - start
+
+    # Adjust the output unit based on the time taken
+    if duration >= 1:
+        unit = "s"
+        time_taken = duration
+    elif duration >= 0.001:
+        unit = "ms"
+        time_taken = duration * 1000
     else:
-        print(f"{func.__name__} runtime: {(end - start) * 1000:0.4f} ms")
+        unit = "µs"
+        time_taken = duration * 1_000_000
+
+    print(f"{func.__name__} runtime: {time_taken:0.4f} {unit}")
     return output