dsba-python1-alpha 0.1.0__tar.gz

dsba_python1_alpha-0.1.0/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: dsba-python1-alpha
+Version: 0.1.0
+Summary: Auto-checkers for the DSBA Python for Data Science course
+Project-URL: Homepage, https://github.com/your-org/dsba-checkers
+License: MIT
+Requires-Python: >=3.8
+Requires-Dist: numpy>=1.21
+Requires-Dist: pandas>=1.3
+Requires-Dist: scipy>=1.7
+Description-Content-Type: text/markdown
+
+# dsba-python1-alpha
+
+Auto-checkers for the **DSBA Python for Data Science** course.  
+Inspired by Kaggle's `learntools` — same `.check()` / `.hint()` / `.solution()` API,  
+all datasets bundled inside the package (no internet required).
+
+## Install
+
+```bash
+pip install dsba-python1-alpha
+```
+
+## Workshop 14 — scipy.stats
+
+```python
+from dsba_checkers.workshops.w14_scipy import q1, q2, q3, q4, q5, q6, q7
+
+# After writing your code:
+q1.check(mean_charges, median_charges, skewness_charges, n_outliers)
+# ✓  Correct!
+
+# Stuck? Ask for a hint:
+q1.hint()
+
+# Give up? Show the solution (also shown automatically after 3 failed attempts):
+q1.solution()
+```
+
+## Available workshops
+
+| Module | Topic |
+|--------|-------|
+| `dsba_checkers.workshops.w14_scipy` | scipy.stats: descriptive stats, correlation, t-tests, Bonferroni |
+
+More workshops coming in future versions.

dsba_python1_alpha-0.1.0/README.md

@@ -0,0 +1,35 @@
+# dsba-python1-alpha
+
+Auto-checkers for the **DSBA Python for Data Science** course.  
+Inspired by Kaggle's `learntools` — same `.check()` / `.hint()` / `.solution()` API,  
+all datasets bundled inside the package (no internet required).
+
+## Install
+
+```bash
+pip install dsba-python1-alpha
+```
+
+## Workshop 14 — scipy.stats
+
+```python
+from dsba_checkers.workshops.w14_scipy import q1, q2, q3, q4, q5, q6, q7
+
+# After writing your code:
+q1.check(mean_charges, median_charges, skewness_charges, n_outliers)
+# ✓  Correct!
+
+# Stuck? Ask for a hint:
+q1.hint()
+
+# Give up? Show the solution (also shown automatically after 3 failed attempts):
+q1.solution()
+```
+
+## Available workshops
+
+| Module | Topic |
+|--------|-------|
+| `dsba_checkers.workshops.w14_scipy` | scipy.stats: descriptive stats, correlation, t-tests, Bonferroni |
+
+More workshops coming in future versions.

dsba_python1_alpha-0.1.0/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_python1_alpha-0.1.0/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_python1_alpha-0.1.0/dsba_checkers/data/__init__.py

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