feat: add Python library for reading and parsing Smile data sets (clo… (#249)

* feat: add Python library for reading and parsing Smile data sets (closes #245)

- add a python library in analysis/ folder
- add an example ipynb and marimo notebook for processing data
- add a claude code file for suggestions on how to format this code
- update docs
- add tests for this functionality to the overall project and autofix
deploy

* [autofix.ci] apply automated fixes

* fix: prettier was interfering with vitepress blocks

- automated run of prettier was modifying the vitepress layout

* [autofix.ci] apply automated fixes

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>

Author: gureckis

.github/workflows/autofix.yml

@@ -159,3 +159,31 @@ jobs:
       - name: Run tests
         id: run-tests
         run: npm run test
+
+  python-test:
+    runs-on: ubuntu-latest
+    needs: autofix
+    defaults:
+      run:
+        working-directory: analysis
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ github.event.pull_request.head.repo.full_name }}
+          ref: ${{ github.event.pull_request.head.ref }}
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run Python tests
+        run: uv run pytest --cov=smiledata --cov-report=term-missing

.gitignore

@@ -37,3 +37,18 @@ env/*.zip
 *.service-account*
 components.d.ts
 /.vite
+
+# Python
+analysis/.venv/
+analysis/__pycache__/
+analysis/*.egg-info/
+analysis/.ruff_cache/
+*.pyc
+__pycache__/
+.marimo/
+
+# Test coverage
+analysis/htmlcov/
+analysis/.coverage
+.pytest_cache/
+analysis/notebooks/__marimo__/session

.prettierrc

@@ -5,17 +5,10 @@
   "printWidth": 120,
   "overrides": [
     {
-      "files": "docs/*.md",
+      "files": "docs/**/*.md",
       "options": {
         "printWidth": 80,
-        "proseWrap": "always"
-      }
-    },
-    {
-      "files": "docs/*/*.md",
-      "options": {
-        "printWidth": 80,
-        "proseWrap": "always"
+        "proseWrap": "preserve"
       }
     }
   ]

README.md

@@ -40,6 +40,7 @@ Online docs: [https://smile.gureckislab.org](https://smile.gureckislab.org)
   including Prolific, MTurk, CloudResearch, and more.
 - 📝 [Data provenance features](https://smile.gureckislab.org/analysis.html#data-provenance) include an audit trail
   of which version of the code was used to create each data file.
+- 🐍 Easy-to-use [Python library](https://smile.gureckislab.org/analysis.html#python-analysis-library-smiledata) for data analysis with Polars DataFrames, built-in plotting, and support for Jupyter and Marimo notebooks.
 - 😎 Great-looking and detailed docs, if we do say so ourselves!
 
 ## License

analysis/.python-version

@@ -0,0 +1 @@
+3.11