Added number.is_odd() method

CHANGELOG.rst

@@ -21,6 +21,7 @@ Changelog
 - Add ``is_none()``.
 - Add ``is_multiple_of()``.
 - Add ``is_number()``.
+- Add ``is_odd()``.
 - Add ``is_string()``.
 - Add ``last()``.
 - Add ``random_()``.

docs/example.rst

@@ -161,6 +161,11 @@ Numbers
     >>> _.is_multiple_of(1.5, 0.5)
     True
 
+    >>> _.is_odd(6)
+    False
+    >>> _.is_odd(7)
+    True
+
     >>> result = _.random_(5, 6)
     >>> assert 5 <= result <= 6
     >>> result = _.random_(5)

sugar/__init__.py

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

sugar/number.py

@@ -54,6 +54,27 @@ def is_multiple_of(value, num):
     return value % num == 0
 
 
+def is_odd(num):
+    """Returns True if :attr:`num` is odd.
+
+    Args:
+        num (int/float): Number passed in by the user.
+
+    Returns:
+        bool: True if :attr:`num` is odd else False
+
+    Example:
+
+        >>> is_odd(6)
+        False
+        >>> is_odd(7)
+        True
+
+    .. versionadded:: TODO
+    """
+    return num % 2 != 0
+
+
 def random_(n1=None, n2=None):
     """Returns a random integer/float from :attr:`n1` to :attr:`n2` (both
     inclusive)

tests/test_number.py

@@ -22,6 +22,14 @@ def test_is_multiple_of(value, num, expected):
     assert _.is_multiple_of(value, num) == expected
 
 
+@parametrize('num,expected', [
+    (6, False),
+    (7, True)
+])
+def test_is_odd(num, expected):
+    assert _.is_odd(num) == expected
+
+
 @parametrize('args', [
     (0, 5),
     (2, 5),