Added clone method

CHANGELOG.rst

@@ -2,6 +2,9 @@ Changelog
 =========
 
 
+- Add ``clone()`` method.
+
+
 v0.1.1 (2016-10-10)
 -------------------
 

sugar/__init__.py

@@ -13,6 +13,7 @@
 
 from .arrays import (
     average,
+    clone,
     construct,
     count,
     subtract

sugar/__pkg__.py

@@ -5,7 +5,7 @@
 __package_name__ = 'sugar.py'
 __description__ = 'Python utility library. Based on sugar Javascript Library.'
 __url__ = 'https://github.com/bharadwajyarlagadda/sugar.py'
-__version__ = '0.1.1'
+__version__ = '0.2.0-dev'
 __author__ = 'Bharadwaj Yarlagadda'
 __email__ = 'yarlagaddabharadwaj@gmail.com'
 __license__ = 'MIT License'

sugar/arrays.py

@@ -2,6 +2,8 @@
 
 from __future__ import absolute_import
 
+import copy
+
 
 def average(array):
     """Returns the average for all the values in the given :attr:`array`.
@@ -22,6 +24,25 @@ def average(array):
     return sum(array) / len(array)
 
 
+def clone(array):
+    """Returns a shallow copy of the given list.
+
+    Args:
+        array (list): List of values provided by the user.
+
+    Returns:
+        list: Shallow copy of the given array.
+
+    Example:
+
+        >>> clone([1, 2, 3])
+        [1, 2, 3]
+
+    .. versionadded:: 0.2.0-dev
+    """
+    return copy.copy(array)
+
+
 def construct(var, callback):
     """Constructs an array of :attr:`var` length from the values of
     :attr:`callback`.

tests/test_arrays.py

@@ -4,6 +4,7 @@
 
 from sugar import (
     average,
+    clone,
     construct,
     count,
     subtract
@@ -28,6 +29,14 @@ def test_average(array, expected_average):
     assert average(array) == expected_average
 
 
+@parametrize('array,expected_output', [
+    ([1, 2, 3], [1, 2, 3])
+])
+def test_clone(array, expected_output):
+    """Tests whether the clone method is working properly or not."""
+    assert clone(array) == expected_output
+
+
 @parametrize('length,callback,expected_output', [
     (4, double, [0, 2, 4, 6]),
     (4, triple, [0, 3, 6, 9])