pyrig scratch

uv run pyrig scratch

# Create or edit .scratch file
vim .scratch

# Execute it
uv run pyrig scratch

# .scratch
"""Temporary experimental code."""

from myproject import MyClass
from myproject.utils import helper

# Test new functionality
obj = MyClass()
result = obj.experimental_method()
print(f"Result: {result}")

# Quick debugging
import pdb; pdb.set_trace()

# Data exploration
import pandas as pd
df = pd.read_csv('data.csv')
print(df.head())

$ uv run pyrig scratch
Result: 42
# ... debugger starts or output appears

# See execution details
uv run pyrig -v scratch

# Suppress pyrig output (script output still shown)
uv run pyrig -q scratch

# .scratch - Testing new API design
from myproject.api import Client

client = Client()
response = client.new_feature(param1='test')
print(response)

# .scratch - Debugging a specific issue
import logging
logging.basicConfig(level=logging.DEBUG)

from myproject.problematic_module import buggy_function

result = buggy_function(edge_case_input)
print(f"Debug: {result}")

# .scratch - Analyzing project data
import pandas as pd
from myproject.data import load_dataset

df = load_dataset()
print(df.describe())
print(df.groupby('category').mean())

# .scratch - Testing external API integration
from myproject.integrations import ThirdPartyAPI

api = ThirdPartyAPI(api_key='test-key')
response = api.fetch_data()
print(response.json())

# .scratch - Trying out new library features
import numpy as np
from new_library import ExperimentalFeature

data = np.random.rand(100)
result = ExperimentalFeature().process(data)
print(result)

myproject/
├── .scratch          # ← Here
├── pyproject.toml
├── src/
│   └── myproject/
└── tests/

# Generate .scratch
uv run pyrig mkroot

# Edit it
vim .scratch

# Run it
uv run pyrig scratch

"""Temporary scratch file for ad-hoc code execution.

This file is not tracked by version control and is intended for:
- Quick prototyping
- Debugging
- Experimental code
- One-off scripts

Run with: uv run pyrig scratch
"""

print("Hello from .scratch!")

# .scratch
# Testing the new authentication flow
# Remember to move to proper test file once working

from myproject.auth import new_auth_flow

result = new_auth_flow.authenticate(user='test')
print(f"Auth result: {result}")

# Clear content
echo '"""Temporary scratch file."""' > .scratch

# Or delete entirely
rm .scratch

# Regenerate default
uv run pyrig mkroot

# 1. Write experimental code
vim .scratch

# 2. Test it
uv run pyrig scratch

# 3. If it works, move to proper module
mv .scratch src/myproject/new_feature.py

# 4. Create tests
uv run pyrig mktests

# 1. Reproduce issue in .scratch
vim .scratch  # Add failing code

# 2. Add debugging
uv run pyrig -v scratch  # See detailed output

# 3. Fix issue in source
vim src/myproject/module.py

# 4. Verify fix
uv run pyrig scratch  # Should work now

# .scratch
raise ValueError("Something went wrong")

$ uv run pyrig scratch
Traceback (most recent call last):
  File ".scratch", line 1, in <module>
    raise ValueError("Something went wrong")
ValueError: Something went wrong

from runpy import run_path

run_path(DotScratchConfigFile.I.path().as_posix())