Added average method

CHANGELOG.rst

@@ -3,5 +3,6 @@ Changelog
 
 
 - First release.
+- Add ``average()``.
 - Add ``construct()``.
 - Add ``count()``.

sugar/__init__.py

@@ -12,6 +12,7 @@
 )
 
 from .arrays import (
+    average,
     construct,
     count
 )

sugar/arrays.py

@@ -3,6 +3,25 @@
 from __future__ import absolute_import
 
 
+def average(array):
+    """Returns the average for all the values in the given :attr:`array`.
+
+    Args:
+        array (list): List of values.
+
+    Returns:
+        int/float: Average of all the values in the given list.
+
+    Example:
+
+        >>> average([1, 2, 3])
+        2.0
+
+    .. versionadded:: 0.1.0-dev
+    """
+    return sum(array) / len(array)
+
+
 def construct(var, callback):
     """Constructs an array of :attr:`var` length from the values of
     :attr:`callback`.

tests/test_arrays.py

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