Update 2023.08.1 (#103)

# Conflicts:
#   poetry.lock
#   pyproject.toml
#   src/atm/func.py

Author: shorodilov

src/atm/func.py

@@ -79,10 +79,10 @@ def withdraw_rev(target: int,
     limited with ``limit`` argument).
 
     Usage:
-    #
-    # >>> assert withdraw_rev(0) == []
-    # >>> assert withdraw_rev(14) == [(10, 1), (2, 2)]
-    # >>> assert withdraw_rev(17) == [(9, 1), (4, 2)]
+
+    >>> assert withdraw_rev(0) == []
+    >>> assert withdraw_rev(14) == [(10, 1), (2, 2)]
+    >>> assert withdraw_rev(17) == [(9, 1), (4, 2)]
 
     """
 
@@ -103,8 +103,8 @@ def get_total(values: Iterable[Tuple[int, int]]) -> int:
 
     Usage:
 
-    >>> assert get_total([(1, 50), (1, 500), (2, 2000), (2, 10000)]) == 24550
-    >>> assert get_total([(1, 10000), (1, 5000), (1, 2000), (1, 500)]) == 17500
+    >>> assert get_total([(1, 50), (1, 500), (2, 2000), (2, 10000)]) == 24500
+    >>> assert get_total([(1, 500), (1, 2000), (1, 5000), (1, 10000)]) == 17545
     >>> assert get_total([(1, 2000)]) == 2000
 
     """

src/sequences/func.py

@@ -13,6 +13,12 @@ def is_palindrome(origin: Union[str, int], /) -> bool:
     """
     Return a palindrome check result
 
+    :param origin: value to test
+    :type origin: str | int
+
+    :return: return a palindrome check result
+    :rtype: bool
+
     This function implements two pointers method. The left pointer is
     initialized at the beginning of an origin string, and the right one -
     at the end. The check cycle compares characters at left and right
@@ -21,12 +27,6 @@ def is_palindrome(origin: Union[str, int], /) -> bool:
     returns True. Punctuation, word boundaries and capitalization are
     ignored.
 
-    :param origin: value to test
-    :type origin: str | int
-
-    :return: return a palindrome check result
-    :rtype: bool
-
     Usage:
 
     >>> assert is_palindrome("aba") is True
@@ -150,18 +150,18 @@ def are_parentheses_balanced(origin: str, /) -> bool:
     """
     Return a validation result for a given parentheses sequence
 
-    Validation rules:
-
-    - each opening parentheses must be closed by the same type parentheses
-    - open parentheses must be closed in the correct order
-    - any non-parentheses characters are to be ignored
-
     :param origin: a parentheses sequence to validate
     :type origin: str
 
     :return: a validation result
     :rtype: bool
 
+    Validation rules:
+
+    - each opening parentheses must be closed by the same type parentheses
+    - open parentheses must be closed in the correct order
+    - any non-parentheses characters are to be ignored
+
     Usage:
 
     >>> assert are_parentheses_balanced("({[]})") is True