From 31a15a666e69d96b5062596c79641645a64fcdb2 Mon Sep 17 00:00:00 2001
From: ankitjavalkar
Date: Wed, 16 Nov 2016 11:47:26 +0530
Subject: Modify docstrings of evaluators

---
 yaksh/python_assertion_evaluator.py | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

(limited to 'yaksh/python_assertion_evaluator.py')

diff --git a/yaksh/python_assertion_evaluator.py b/yaksh/python_assertion_evaluator.py
index 8924643..1cc4fa4 100644
--- a/yaksh/python_assertion_evaluator.py
+++ b/yaksh/python_assertion_evaluator.py
@@ -37,6 +37,26 @@ class PythonAssertionEvaluator(CodeEvaluator):
             return self.exec_scope
 
     def check_code(self, user_answer, file_paths, partial_grading, test_case, weight):
+        """ Function validates user answer by running an assertion based test case
+        against it
+
+        Returns
+        --------
+        Returns a tuple (success, error, test_case_weight)
+
+        success - Boolean, indicating if code was executed successfully, correctly
+        weight - Float, indicating total weight of all successful test cases
+        error - String, error message if success is false
+
+        returns (True, "Correct answer", 1.0) : If the student script passes all
+        test cases/have same output, when compared to the instructor script
+
+        returns (False, error_msg, 0.0): If the student script fails a single
+        test/have dissimilar output, when compared to the instructor script.
+
+        Returns (False, error_msg, 0.0): If mandatory arguments are not files or if
+        the required permissions are not given to the file(s).
+        """
         success = False
         test_case_weight = 0.0
         try:
-- 
cgit