first commit

Author: mscolnick

.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install
+
+      - name: Install the project
+        run: uv sync --all-extras --dev
+
+      - name: Lint
+        run: uv run ruff check .
+
+      - name: Run tests
+        run: uv run pytest tests src

.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

.pre-commit-config.yaml

@@ -0,0 +1,8 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    # Ruff version.
+    rev: v0.8.4
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 marimo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,65 @@
+# marimo + uv Starter Template
+
+A starter template for [marimo](https://marimo.io) notebooks using [uv](https://github.com/astral-sh/uv) for dependency and project management. This template provides a modern Python development setup with best practices for notebook development.
+
+## Features
+
+- 🚀 Python 3.12+ support
+- 📦 Fast dependency management with `uv`
+- 🧪 Testing setup with pytest
+- 🎯 Code quality with Ruff (linting + formatting)
+- 👷 CI/CD with GitHub Actions
+- 📓 Interactive notebook development with marimo
+
+## Prerequisites
+
+- Python 3.12 or higher
+- [uv](https://github.com/astral-sh/uv) installed
+
+## Getting Started
+
+1. Clone this repository:
+
+   ```bash
+   git clone https://github.com/yourusername/marimo-uv-starter-template
+   cd marimo-uv-starter-template
+   ```
+
+2. Run the marimo editor:
+
+   ```bash
+   uv run marimo edit
+   ```
+
+## Development
+
+### Running Tests
+
+```bash
+# Run testing in your regular python files
+uv run pytest tests
+# Running testing in your marimo notebooks
+uv run pytest src
+```
+
+### Linting and formatting
+
+```bash
+uv run ruff check .
+uv run ruff format .
+```
+
+## Project Structure
+
+```markdown
+├── .github/            # GitHub Actions workflows
+├── src/               # Source code
+│   └── app.py        # Sample marimo notebook
+├── tests/            # Test files
+├── pyproject.toml    # Project configuration
+└── uv.lock           # Dependency lock file
+```
+
+## License
+
+MIT

pyproject.toml

@@ -0,0 +1,28 @@
+[project]
+description = "A starter template for marimo notebooks with uv"
+name = "marimo-template"
+requires-python = ">=3.12"
+version = "0.1.0"
+
+[dependency-groups]
+dev = [
+  "pre-commit>=4.0.1",
+  "pytest>=8.3.4",
+  "ruff>=0.8.3",
+]
+
+[tool.pytest.ini_options]
+pythonpath = ["."]
+testpaths = ["tests", "marimo_template"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = [
+  "E", # pycodestyle
+  "F", # pyflakes
+  "I", # isort
+  "B", # flake8-bugbear
+]

src/__init__.py

@@ -0,0 +1,25 @@
+import marimo
+
+__generated_with = "0.10.12"
+app = marimo.App(width="medium")
+
+
+@app.cell
+def _():
+    import marimo as mo
+
+    mo.md("Hello")
+    return (mo,)
+
+
+@app.cell
+def test_cell():
+    from utils import add
+
+    assert add(1, 2) == 3
+    assert 2 == 2
+    return
+
+
+if __name__ == "__main__":
+    app.run()

src/app.py

@@ -0,0 +1,6 @@
+def add(a: int, b: int) -> int:
+    return a + b
+
+
+def subtract(a: int, b: int) -> int:
+    return a - b

src/utils.py

@@ -0,0 +1,9 @@
+from src.utils import add, subtract
+
+
+def test_add():
+    assert add(1, 2) == 3
+
+
+def test_subtract():
+    assert subtract(1, 2) == -1