fmt:
cargo fmt --all
fmt-check:
cargo fmt --all -- --check
readme:
#!/usr/bin/env bash
set -euo pipefail
# Extract rustdoc comments from lib.rs and convert to markdown
echo "Generating README.md from rustdoc..."
# Use cargo doc to generate docs, then extract the main module doc
cargo doc --no-deps --document-private-items --quiet
# Extract the rustdoc content and convert it to README format
sed -n '/^\/\/!/p' src/lib.rs | \
sed 's/^\/\/! \?//' | \
sed 's/^\/\/!$//' > README.md
echo "README.md generated successfully!"
clippy:
cargo clippy --all-targets --all-features -- -D warnings
# Safety check cassette files for leaked credentials using ripgrep
check-cassettes-only:
#!/usr/bin/env bash
set -euo pipefail
echo "🔍 Safety checking cassette files for credential leakage..."
# Get credentials from environment variables
USERNAME="${LASTFM_EDIT_USERNAME:-}"
PASSWORD="${LASTFM_EDIT_PASSWORD:-}"
if [ -z "$USERNAME" ] && [ -z "$PASSWORD" ]; then
echo "⚠️ No LASTFM_EDIT_USERNAME or LASTFM_EDIT_PASSWORD set in environment"
echo " This check requires environment variables to be set to detect leaks"
echo " Skipping credential leak check"
exit 0
fi
# Find all cassette files
cassette_files=$(find tests/fixtures -name "*.yaml" -o -name "*.yml" 2>/dev/null || true)
if [ -z "$cassette_files" ]; then
echo "📭 No cassette files found in tests/fixtures/"
exit 0
fi
echo "📂 Found cassette files:"
echo "$cassette_files" | sed 's/^/ /'
echo
leak_found=false
# Check for password leakage
if [ -n "$PASSWORD" ]; then
echo "🔑 Checking for password leakage..."
if echo "$cassette_files" | xargs rg -l "$PASSWORD" 2>/dev/null; then
echo "❌ CRITICAL SECURITY ALERT: Password found in cassette files above!"
leak_found=true
else
echo "✅ Password not found in cassette files"
fi
echo
fi
# Additional safety checks for common credential patterns
echo "🔍 Checking for other potential credential patterns..."
# Check for unfiltered form data patterns that might contain real credentials
if echo "$cassette_files" | xargs rg -l "password=[^&]*[a-zA-Z0-9]{8,}" 2>/dev/null; then
echo "⚠️ Found potentially unfiltered password fields in files above"
echo " Review these files to ensure passwords are properly filtered"
fi
if echo "$cassette_files" | xargs rg -l "username_or_email=[^&]*@[^&]*\.[^&]+" 2>/dev/null; then
echo "⚠️ Found potentially real email addresses in files above"
echo " Review these files to ensure emails are properly filtered"
fi
if [ "$leak_found" = true ]; then
echo "🚨 CREDENTIAL LEAK DETECTED!"
echo " You must re-filter these cassette files before committing"
echo " Run: cargo run --example filter_cassette <file> to clean them"
echo " Or: cargo run --example mutate_cassette_demo <file> replace-username <safe_name>"
exit 1
else
echo "🔒 All cassette files appear to be safely filtered"
echo " No credential leakage detected"
fi
# Safety check cassette files for leaked credentials using ripgrep
check-cassettes:
just check-cassettes-only
coverage:
#!/usr/bin/env bash
set -euo pipefail
echo "📊 Running code coverage analysis..."
# Check if cargo-tarpaulin is installed
if ! command -v cargo-tarpaulin &> /dev/null; then
echo "📦 Installing cargo-tarpaulin..."
cargo install cargo-tarpaulin
fi
# Run coverage with tarpaulin, excluding VCR tests which require network
echo "🧪 Running tests with coverage..."
cargo tarpaulin \
--verbose \
--out Html \
--output-dir coverage \
--exclude-files "tests/vcr/*" \
--exclude-files "src/bin/*" \
--timeout 120
echo "✅ Coverage report generated in coverage/tarpaulin-report.html"
echo "📂 Open file://$(pwd)/coverage/tarpaulin-report.html to view results"
checks:
just fmt-check
just clippy
cargo test
just check-cassettes
# Version bump, build, commit, and tag
# Usage: just release [patch|minor|major]
release bump_type="patch":
#!/usr/bin/env bash
set -euo pipefail
echo "🚀 Releasing new {{bump_type}} version..."
# Check if cargo-edit is installed
if ! command -v cargo-set-version &> /dev/null; then
echo "❌ cargo-edit is not installed. Installing..."
cargo install cargo-edit
fi
# Get current version
current_version=$(cargo pkgid | cut -d# -f2 | cut -d: -f2)
echo "📦 Current version: $current_version"
# Bump version using cargo-edit
echo "⬆️ Bumping {{bump_type}} version..."
cargo set-version --bump {{bump_type}}
# Get new version
new_version=$(cargo pkgid | cut -d# -f2 | cut -d: -f2)
echo "📦 New version: $new_version"
# Run checks to ensure everything still works
echo "🔍 Running checks..."
just checks
# Build release version
echo "🔨 Building release..."
cargo build --release
# Add all changes
git add .
# Create commit with auto-generated message
echo "💾 Committing changes..."
git commit -m "Bump version to $new_version
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>"
# Create git tag
echo "🏷️ Creating tag v$new_version..."
git tag "v$new_version"
echo "✅ Release v$new_version ready!"
echo "📤 To publish, run:"
echo " git push origin master"
echo " git push origin v$new_version"
echo " cargo publish"
# Full release with automatic push and publish
# Usage: just publish [patch|minor|major]
publish bump_type="patch":
#!/usr/bin/env bash
set -euo pipefail
# Run the release process
just release {{bump_type}}
# Get the new version for confirmation
new_version=$(cargo pkgid | cut -d# -f2 | cut -d: -f2)
echo "🌐 Publishing release v$new_version..."
# Push commits and tags
echo "📤 Pushing to remote..."
git push origin master
git push origin "v$new_version"
# Publish to crates.io
echo "📦 Publishing to crates.io..."
cargo publish
echo "🎉 Release v$new_version published successfully!"
ipython:
python/start_ipython.sh