scriptorium 0.0.3 → 0.7.2

data/test/README.md

@@ -0,0 +1,69 @@
+# Scriptorium Test Suite
+
+## Quick Start
+
+### Run All Tests (Unit + Automated Manual Tests)
+```bash
+ruby test/run_automated_tests.rb
+```
+
+### Run Unit Tests Only
+```bash
+ruby test/all
+```
+
+### Run Individual Manual Tests
+```bash
+# Interactive mode (opens browser)
+ruby test/manual/test1.rb
+
+# Automated mode (no browser, just validation)
+ruby test/manual/test1.rb --automated
+```
+
+## Test Types
+
+### Unit Tests (`test/unit/`)
+- **Core functionality tests** - Basic helper methods, file operations
+- **Repo tests** - Repository creation, management, post handling
+- **Post tests** - Individual post functionality
+- **View tests** - View generation and management
+- **Banner SVG tests** - SVG banner generation and validation
+
+### Manual Tests (`test/manual/`)
+- **Integration tests** - End-to-end workflows
+- **Banner feature tests** - Visual verification of SVG banners
+- **Widget tests** - Sidebar widgets and functionality
+- **Layout tests** - Page layout and styling
+
+## Automated Testing
+
+All manual tests support `--automated` mode for CI/CD:
+- No browser interaction required
+- Validates file generation
+- Returns exit codes for automation
+- Use `--automated` as the **last** parameter
+
+## Environment Setup
+
+The test environment is automatically configured:
+- PATH is set to include rbenv shims
+- Test repositories are created in `test/scriptorium-TEST/`
+- Webrick server starts on port 8000 for manual tests
+- Cleanup happens automatically
+
+## Examples
+
+```bash
+# Run all tests
+ruby test/run_automated_tests.rb
+
+# Run specific manual test interactively
+ruby test/manual/test_banner_combinations.rb
+
+# Run specific manual test in automated mode
+ruby test/manual/test_banner_combinations.rb --automated
+
+# Run test3 with specific view
+ruby test/manual/test3.rb blog1 --automated
+``` 

data/test/WEB_INTEGRATION_README.md

@@ -0,0 +1,196 @@
+# Web Integration Test Framework
+
+This directory contains a comprehensive web integration testing framework for the Scriptorium web application, based on the existing TUI integration test patterns.
+
+## Overview
+
+The web integration tests verify that the web application works correctly in test mode, including:
+- Server startup/shutdown in test mode
+- HTTP endpoint functionality
+- Form submission and redirects
+- Test repository isolation
+- Complete workflow testing
+
+## Test Files
+
+### 1. `web_test_helper.rb`
+**Shared helper module** containing common web testing functionality:
+- Web server management (start/stop)
+- HTTP request methods (GET, POST, PUT, DELETE)
+- Response assertions (success, redirect, not found)
+- Test environment setup
+- Repository cleanup
+
+### 2. `web_integration_test.rb`
+**Basic integration tests** for core web functionality:
+- `test_001_basic_web_interaction` - Verifies web app starts and responds
+- `test_002_view_creation_workflow` - Tests dashboard and repository creation
+- `test_003_asset_management_web` - Tests asset management access
+- `test_004_view_configuration_web` - Tests view configuration access
+- `test_005_deployment_configuration_web` - Tests deployment configuration access
+
+### 3. `web_workflow_test.rb`
+**Comprehensive workflow tests** that mirror TUI functionality:
+- `test_001_complete_repository_setup` - Full repository creation workflow
+- `test_002_view_creation_workflow` - View creation via web forms
+- `test_003_post_creation_workflow` - Post creation via web forms
+- `test_004_asset_management_workflow` - Asset management workflow
+- `test_005_view_configuration_workflow` - View configuration workflow
+- `test_006_deployment_workflow` - Deployment configuration workflow
+- `test_007_error_handling` - Error handling and edge cases
+
+## Key Features
+
+### Test Mode Support
+- All tests run with `--test` flag
+- Uses `ui/web/scriptorium-TEST` repository
+- Completely isolated from production data
+- Verifies test mode is active
+
+### HTTP Testing
+- Tests actual HTTP requests/responses
+- Handles redirects (302/303) properly
+- Tests form submissions and validations
+- Verifies response codes and content
+
+### Workflow Testing
+- Tests complete user workflows
+- Sets up test environment (repo + view) as needed
+- Verifies state changes after operations
+- Tests error conditions and edge cases
+
+### Server Management
+- Automatic web server startup/shutdown
+- Waits for server to be ready
+- Cleans up test repositories
+- Handles server process management
+
+## Usage
+
+### Running Individual Tests
+```bash
+# Run basic integration tests
+ruby test/web_integration_test.rb
+
+# Run workflow tests
+ruby test/web_workflow_test.rb
+
+# Run specific test
+ruby test/web_integration_test.rb -n test_001_basic_web_interaction
+```
+
+### Running All Web Tests
+```bash
+# Run all web-related tests
+ruby test/web_integration_test.rb
+ruby test/web_workflow_test.rb
+```
+
+## Test Patterns
+
+### Setup/Teardown
+```ruby
+def setup
+  cleanup_test_repo
+  ENV['DBC_DISABLED'] = 'true'
+  # rbenv hack for correct Ruby version
+end
+
+def teardown
+  cleanup_test_repo
+  stop_web_server
+end
+```
+
+### HTTP Requests
+```ruby
+# GET request
+response = get("/status")
+
+# POST request with form data
+response = post("/create_view", {
+  name: "test-view",
+  title: "Test View"
+})
+```
+
+### Assertions
+```ruby
+# Success response
+assert_response_success(response, "Should succeed")
+
+# Redirect response
+assert_response_redirect(response, "Should redirect")
+
+# Content verification
+assert_includes response.body, "Expected text"
+```
+
+### Test Environment Setup
+```ruby
+# Setup basic test environment (repo + view)
+setup_test_environment
+
+# Or manually
+post("/create_repo", {})
+post("/create_view", { name: "test-view", title: "Test" })
+```
+
+## Architecture
+
+### Helper Module Design
+- **WebTestHelper** - Shared functionality across all web tests
+- **HTTP Methods** - GET, POST, PUT, DELETE with error handling
+- **Assertions** - Response code and content verification
+- **Server Management** - Start, stop, wait, cleanup
+
+### Test Class Structure
+- **Include Helpers** - `Scriptorium::Helpers` and `WebTestHelper`
+- **Setup/Teardown** - Repository cleanup and server management
+- **Test Methods** - Individual workflow tests
+- **Private Methods** - Test-specific helper methods
+
+### Test Isolation
+- Each test starts with clean state
+- Test repository is created/destroyed per test
+- Web server is started/stopped per test
+- No cross-test contamination
+
+## Comparison with TUI Tests
+
+| Aspect | TUI Tests | Web Tests |
+|--------|-----------|-----------|
+| **Interface** | PTY/terminal | HTTP endpoints |
+| **Input** | `send_and_expect` | HTTP requests |
+| **Output** | Terminal output | HTTP responses |
+| **Setup** | Create test repo | Create test repo + start web server |
+| **Isolation** | `--test` flag | `--test` flag |
+| **Speed** | Fast | Medium (HTTP overhead) |
+| **Realism** | Terminal interaction | Web browser interaction |
+
+## Benefits
+
+1. **Real HTTP Testing** - Tests actual web requests/responses
+2. **End-to-End Validation** - Tests complete web stack
+3. **Browser-Like Behavior** - Simulates real user interactions
+4. **Test Mode Verification** - Ensures test isolation works
+5. **Workflow Coverage** - Tests complete user journeys
+6. **Error Handling** - Verifies proper error responses
+7. **Integration Testing** - Tests web app + API working together
+
+## Future Enhancements
+
+- **File Upload Testing** - Test asset upload functionality
+- **Session Management** - Test user sessions and authentication
+- **AJAX Testing** - Test dynamic content loading
+- **Performance Testing** - Response time and load testing
+- **Browser Testing** - Integration with headless browsers
+- **API Testing** - Direct API endpoint testing
+
+## Dependencies
+
+- **Minitest** - Testing framework
+- **Net::HTTP** - HTTP client for testing
+- **JSON** - Response parsing
+- **FileUtils** - File system operations
+- **Scriptorium::Helpers** - Project helper functions

data/test/all

@@ -0,0 +1,83 @@
+#!/usr/bin/env ruby
+
+# Set up environment
+ENV['PATH'] = "#{ENV['HOME']}/.rbenv/shims:#{ENV['PATH']}"
+
+def delete(path)
+  if Dir.exist?(path)
+    puts "Deleting: #{path}"
+    system("rm -rf #{path}")
+  end
+end
+
+t0 = Time.now
+puts "Starting at: #{t0}"
+t1 = t0 + 500
+puts "Finish ETA : #{t1}"
+
+puts
+puts "Killing server..."
+
+system("lsof -ti:4567 | xargs kill -9")
+
+puts
+
+test_repos = %w[scriptorium-TEST  test/scriptorium-TEST ui/web/scriptorium-TEST]
+
+test_repos.each {|repo| delete(repo) }
+
+require 'minitest/autorun'
+
+puts "\n" + "="*60
+puts "Running all Scriptorium tests..."
+puts "="*60
+
+# Initialize global to track which test files have printed their name
+$printed_files = []
+
+# Automatically find and load all test files
+test_files = %w[
+  unit/api.rb
+  unit/post.rb
+  unit/repo.rb
+  unit/view.rb
+  unit/widgets.rb
+  unit/read_commented_file_test.rb
+  unit/asset_management.rb
+  unit/gem_asset_management.rb
+  unit/reddit_test.rb
+  unit/clipboard_test.rb
+  unit/deploy_test.rb
+  unit/deploy_config_test.rb
+  unit/permalink_copy_test.rb
+  unit/post_state_helpers_test.rb
+  unit/edit_post_test.rb
+  unit/contract_test.rb
+  unit/social_test.rb
+  unit/livetext_compatibility.rb
+  unit/livetext_basic.rb
+  unit/syntax_highlighting.rb
+  banner_svg/simple_helpers.rb
+  banner_svg/unit.rb
+  integration/integration_test.rb
+  integration/preview_flow_test.rb
+  livetext_plugin_test.rb
+  unit/core.rb
+  unit/post_index_config_test.rb
+  unit/parse_cmd_test.rb
+  unit/backup_test.rb
+  unit/theme_management_test.rb
+  ed_test.rb
+  tui_integration_test.rb
+  tui_editor_integration_test.rb
+  web_integration_test.rb
+  web_workflow_test.rb
+]
+
+
+# Load all test files
+test_files.each do |file|
+  require_relative file
+rescue => e
+  puts "Error loading #{file}: #{e.message}"
+end

data/test/api_demo.rb

@@ -0,0 +1,99 @@
+#!/usr/bin/env ruby
+
+require_relative '../lib/scriptorium'
+
+# Demo of select_posts and search_posts methods
+puts "=== Scriptorium API Demo: Post Selection and Search ===\n"
+
+api = Scriptorium::API.new(true)
+
+# Create some test data
+api.create_view_and_use("blog", "My Blog")
+api.create_view("tech", "Tech Posts")
+
+# Create posts with different content
+api.create_post("Ruby Programming Guide", "Learn Ruby basics and advanced features", tags: "ruby, programming, tutorial")
+api.create_post("Python vs Ruby", "Comparing Python and Ruby for web development", tags: "python, ruby, comparison")
+api.create_post("Scriptorium API Documentation", "Complete guide to the Scriptorium API", tags: "api, documentation, scriptorium")
+api.create_post("Web Development Tips", "Best practices for modern web development", tags: "web, tips, development")
+
+puts "Created 4 posts with various content\n"
+
+# Demo select_posts with block filtering
+puts "\n=== select_posts Examples ==="
+
+# Filter posts by title containing "Ruby"
+ruby_posts = api.select_posts { |post| post.title.include?("Ruby") }
+puts "Posts with 'Ruby' in title: #{ruby_posts.map(&:title).join(', ')}"
+
+# Filter posts by tags containing "api"
+api_posts = api.select_posts { |post| post.tags.include?("api") }
+puts "Posts tagged with 'api': #{api_posts.map(&:title).join(', ')}"
+
+# Filter posts by title length
+long_title_posts = api.select_posts { |post| post.title.length > 20 }
+puts "Posts with long titles: #{long_title_posts.map(&:title).join(', ')}"
+
+# Demo search_posts with keyword criteria
+puts "\n=== search_posts Examples ==="
+
+# Search by title with regex
+ruby_title_posts = api.search_posts(title: /Ruby/)
+puts "Posts with 'Ruby' in title (regex): #{ruby_title_posts.map(&:title).join(', ')}"
+
+# Search by body content
+body_posts = api.search_posts(body: "development")
+puts "Posts with 'development' in body: #{body_posts.map(&:title).join(', ')}"
+
+# Search by tags
+tagged_posts = api.search_posts(tags: "programming")
+puts "Posts tagged with 'programming': #{tagged_posts.map(&:title).join(', ')}"
+
+# Multiple criteria (AND)
+multi_posts = api.search_posts(title: /Ruby/, body: "basics")
+puts "Posts with 'Ruby' in title AND 'basics' in body: #{multi_posts.map(&:title).join(', ')}"
+
+# Demo with blurb (create a post with blurb)
+puts "\n=== search_posts with Blurb ==="
+api.create_post("Ruby Deep Dive", "Advanced Ruby concepts", blurb: "This is a comprehensive guide to Ruby programming.")
+
+blurb_posts = api.search_posts(blurb: "comprehensive")
+puts "Posts with 'comprehensive' in blurb: #{blurb_posts.map(&:title).join(', ')}"
+
+# Demo draft management
+puts "\n=== Draft Management ==="
+draft_path = api.draft(title: "Temporary Draft", body: "This will be deleted")
+puts "Created draft: #{draft_path}"
+
+drafts = api.drafts
+puts "Drafts before deletion: #{drafts.length}"
+
+api.delete_draft(draft_path)
+drafts = api.drafts
+puts "Drafts after deletion: #{drafts.length}"
+
+# Demo generate_view
+puts "\n=== Generate View ==="
+result = api.generate_view
+puts "Generated view content: #{result}"
+
+# Demo widget generation
+puts "\n=== Widget Generation ==="
+
+# Create widget directory and sample data in the current view
+widget_dir = api.repo.root/:views/api.current_view.name/:widgets/"links"
+FileUtils.mkdir_p(widget_dir)
+File.write(widget_dir/"list.txt", "https://ruby-lang.org, Ruby Language\nhttps://github.com, GitHub")
+
+result = api.generate_widget("links")
+puts "Generated links widget: #{result}"
+
+# Check if widget files were created
+if File.exist?(widget_dir/"links-card.html")
+  puts "Widget card file created successfully"
+else
+  puts "Widget card file not found"
+end
+
+puts "\n=== Demo Complete ==="
+api.destroy 

data/test/assets/images/README.md

@@ -0,0 +1,27 @@
+# Test Images for BannerSVG
+
+This directory contains test images for verifying image background functionality in BannerSVG.
+
+## Expected Images
+
+| Filename | Size | Aspect | Purpose |
+|----------|------|--------|---------|
+| `perfect.png` | 800x100 | 8:1 | Ideal case - matches default banner aspect |
+| `wide.png` | 800x50 | 16:1 | Tests left/right cropping |
+| `tall.png` | 100x100 | 1:1 | Tests top/bottom cropping |
+| `very_tall.png` | 100x400 | 1:4 | Tests extreme vertical cropping |
+| `very_wide.png` | 1600x100 | 16:1 | Tests extreme horizontal cropping |
+| `small.png` | 200x25 | 8:1 | Tests scaling up of small images |
+| `odd_aspect.png` | 500x123 | ~4:1 | Tests non-integer aspect ratios |
+
+## Expected Behavior
+
+- **Perfect match**: Image should display without cropping
+- **Wide images**: Should crop left/right, center the image
+- **Tall images**: Should crop top/bottom, center the image  
+- **Small images**: Should scale up to fill the banner
+- **All images**: Should use `preserveAspectRatio="xMidYMid slice"` for cropping
+
+## Manual Testing
+
+Run `ruby test/manual/test_banner_features.rb` to see these images in action with different banner configurations. 

data/test/banner_svg/simple_helpers.rb

@@ -0,0 +1,13 @@
+module SimpleTestHelpers
+  def assert_present(str, *targets)
+    result = true
+    missing = []
+    targets.each do |t|
+      if ! str.include?(t)
+        result = false
+        missing << t
+      end
+    end
+    assert result, "Targets missing: #{missing.join(", ").inspect}"
+  end
+end