dsba-python1-alpha 0.1.0__py3-none-any.whl

dsba_checkers/__init__.py

@@ -0,0 +1,14 @@
+"""
+dsba-python1-alpha
+──────────────────
+Auto-checkers for the DSBA Python for Data Science course.
+
+Quick start:
+    from dsba_checkers.workshops.w14_scipy import q1, q2, q3, q4, q5, q6, q7
+    q1.check(mean_charges, median_charges, skewness_charges, n_outliers)
+    q1.hint()
+    q1.solution()
+"""
+
+__version__ = "0.1.0"
+__author__  = "DSBA Python Course"

dsba_checkers/base_task.py

@@ -0,0 +1,56 @@
+"""Base class for all DSBA task checkers."""
+
+
+class Task:
+    _hint = "No hint available for this task."
+    _solution = "No solution available for this task."
+    _max_attempts_before_solution = 3
+
+    def __init__(self):
+        self._attempts = 0
+
+    def check(self, *args, **kwargs):
+        self._attempts += 1
+        try:
+            result = self._check(*args, **kwargs)
+        except AssertionError as e:
+            self._print_wrong(str(e))
+            self._maybe_show_solution()
+            return
+        except TypeError as e:
+            print(f"  ✗  Wrong argument types — did you pass the right variables?\n     {e}")
+            return
+        except Exception as e:
+            print(f"  ✗  Unexpected error:\n     {type(e).__name__}: {e}")
+            return
+        if result is True or result is None:
+            self._print_correct()
+        else:
+            self._print_wrong(result if isinstance(result, str) else "")
+            self._maybe_show_solution()
+
+    def hint(self):
+        print(f"\n  💡  Hint:\n  {self._hint}\n")
+
+    def solution(self):
+        print(f"\n  📋  Solution:\n{self._solution}\n")
+
+    def _check(self, *args, **kwargs):
+        raise NotImplementedError
+
+    def _print_correct(self):
+        print("  ✓  Correct!\n")
+
+    def _print_wrong(self, msg=""):
+        print(f"  ✗  Not quite. {msg}\n" if msg else "  ✗  Not quite. Check your logic and try again.\n")
+
+    def _maybe_show_solution(self):
+        if self._attempts >= self._max_attempts_before_solution:
+            print(f"  (You've made {self._attempts} attempts — showing the solution.)")
+            self.solution()
+
+    @staticmethod
+    def _approx_equal(a, b, tol=0.01):
+        if b == 0:
+            return abs(a) < tol
+        return abs(a - b) / abs(b) < tol

dsba_checkers/data/__init__.py

@@ -0,0 +1 @@
+# data sub-package — contains bundled CSV datasets