Added number.is_even() method

CHANGELOG.rst

@@ -17,6 +17,7 @@ Changelog
 - Add ``is_boolean()``.
 - Add ``is_empty()``.
 - Add ``is_equal()``.
+- Add ``is_even()``.
 - Add ``is_none()``.
 - Add ``is_multiple_of()``.
 - Add ``is_number()``.

docs/example.rst

@@ -147,6 +147,11 @@ Numbers
 
     >>> import sugar as _
 
+    >>> _.is_even(6)
+    True
+    >>> _.is_even(7)
+    False
+
     >>> _.is_multiple_of(6, 2)
     True
     >>> _.is_multiple_of(5, 2)

sugar/__init__.py

@@ -33,6 +33,7 @@
 )
 
 from .number import (
+    is_even,
     is_multiple_of,
     random_
 )

sugar/number.py

@@ -7,6 +7,27 @@
 import math
 
 
+def is_even(num):
+    """Returns True if :attr:`num` is even.
+
+    Args:
+        num (int/float): Number passed in by the user.
+
+    Returns:
+        bool: True if :attr:`num` is even else False
+
+    Example:
+
+        >>> is_even(6)
+        True
+        >>> is_even(7)
+        False
+
+    .. versionadded:: TODO
+    """
+    return num % 2 == 0
+
+
 def is_multiple_of(value, num):
     """Returns true if the :attr:`value` is a multiple of :attr:`num`.
 

tests/test_number.py

@@ -5,6 +5,14 @@
 import sugar as _
 
 
+@parametrize('num,expected', [
+    (6, True),
+    (7, False)
+])
+def test_is_even(num, expected):
+    assert _.is_even(num) == expected
+
+
 @parametrize('value,num,expected', [
     (4, 2, True),
     (1.5, 0.5, True),