Added exclude() method

CHANGELOG.rst

@@ -5,6 +5,7 @@ Changelog
 - Add ``clone()``.
 - Add ``compact()``.
 - Add ``every()``.
+- Add ``exclude()``.
 
 
 v0.1.1 (2016-10-10)

README.rst

@@ -55,6 +55,13 @@ Install using pip:
     >>> every([2, 2, 3], 2)
     False
 
+    >>> exclude([11, 22, 33], 22)
+    [11, 33]
+    >>> exclude([11, 22, 33], 44)
+    [11, 22, 33]
+    >>> exclude([11, 22, 33], [11, 22])
+    [33]
+
     >>> sugar.subtract([1, 2, 3], 2)
     [1, 3]
     >>> sugar.subtract ([1, 2, 3], [1, 3])

sugar/__init__.py

@@ -18,5 +18,6 @@
     construct,
     count,
     every,
+    exclude,
     subtract
 )

sugar/arrays.py

@@ -138,6 +138,31 @@ def every(array, value):
     return all(element == value for element in array)
 
 
+def exclude(array, value):
+    """Returns a new array with every element that does not match
+    :attr:`value`.
+
+    Args:
+        array(list): List of values provided by the user.
+        value(int/float/str): A value that needs to be excluded.
+
+    Returns:
+        list: List excluding the give :attr:`value`.
+
+    Example:
+
+        >>> exclude([11, 22, 33], 22)
+        [11, 33]
+        >>> exclude([11, 22, 33], 44)
+        [11, 22, 33]
+        >>> exclude([11, 22, 33], [11, 22])
+        [33]
+
+    .. versionadded:: 0.2.0-dev
+    """
+    return subtract(array, value)
+
+
 def subtract(array, item):
     """Subtracts :attr:`item` from the :attr:`array` and returns the result
     as a new array. If :attr:`item` is also an array, all elements in it will

tests/test_arrays.py

@@ -9,6 +9,7 @@
     construct,
     count,
     every,
+    exclude,
     subtract
 )
 
@@ -75,6 +76,16 @@ def test_every(array, value, expected_output):
     assert every(array, value) == expected_output
 
 
+@parametrize('array,item,expected_output', [
+    ([1, 2, 3], 3, [1, 2]),
+    ([1, 2, 3], [1, 3], [2]),
+    ([1, 2, 3], 4, [1, 2, 3])
+])
+def test_exclude(array, item, expected_output):
+    """Tests whether the exclude method is working properly or not."""
+    assert exclude(array, item) == expected_output
+
+
 @parametrize('array,item,expected_output', [
     ([1, 2, 3], 3, [1, 2]),
     ([1, 2, 3], [1, 3], [2]),