sequel-duckdb 0.1.0 → 0.2.0

data/.kiro/steering/tech.md

@@ -1,10 +1,12 @@
 # Technology Stack
 
 ## Language & Runtime
+
 - **Ruby**: 3.1+ required
 - **Gem**: Standard Ruby gem structure
 
 ## Dependencies
+
 - **Sequel**: Database toolkit (core dependency)
 - **duckdb**: Official DuckDB client gem for connections
 - **DuckDB**: Target database system
@@ -13,16 +15,19 @@
 - **RuboCop**: Code linting and style enforcement
 
 ## Testing Framework
+
 - **Minitest**: Ruby's built-in testing framework (following sequel-hexspace pattern)
 - **Sequel Mock Database**: For SQL generation testing without database connections
 - **DuckDB In-Memory**: For integration testing with actual database instances
 
 ## Development Tools
+
 - **IRB**: Interactive Ruby console
 - **Git**: Version control
 - **GitHub Actions**: CI/CD (configured)
 
 ## Code Style & Quality
+
 - **RuboCop** configuration enforces:
   - Double quotes for string literals
   - Ruby 3.1 target version
@@ -31,6 +36,7 @@
 ## Common Commands
 
 ### Setup & Installation
+
 ```bash
 # Install dependencies
 bundle install
@@ -43,6 +49,7 @@ bin/console
 ```
 
 ### Development Workflow
+
 ```bash
 # Run tests (primary development command)
 bundle exec rake test
@@ -68,6 +75,7 @@ bundle exec rake release
 ```
 
 ### Testing Commands
+
 ```bash
 # Run all tests
 ruby test/all.rb
@@ -83,6 +91,7 @@ ruby test/database_test.rb -n test_connection
 ```
 
 ### Code Quality
+
 ```bash
 # Run RuboCop with auto-correct
 bundle exec rubocop -a
@@ -94,11 +103,13 @@ bundle exec rubocop lib/
 ## Coding Standards & References
 
 ### Primary Code Style Reference (in order of precedence)
+
 1. **jeremyevans/sequel**: Official Sequel repository - follow all conventions and idioms
 2. **sequel-hexspace**: Secondary reference for adapter patterns
 3. **sequel_impala**: Additional reference for implementation approaches
 
 ### Implementation Guidelines
+
 - Study git history of reference projects to understand implementation order
 - Focus on incremental, testable implementations
 - **ALWAYS write tests BEFORE implementing functionality (TDD)**
@@ -109,6 +120,7 @@ bundle exec rubocop lib/
 - Unit tests must use Sequel's mock database for SQL generation testing
 
 ### Testing Requirements (MANDATORY)
+
 - **Test Structure**: Follow sequel-hexspace test organization exactly
 - **Test Files**: Mirror sequel-hexspace test files (database_test.rb, dataset_test.rb, schema_test.rb, etc.)
 - **SQL Generation Tests**: Every SQL generation method must have unit tests verifying correct SQL output
@@ -119,6 +131,7 @@ bundle exec rubocop lib/
 - **Test Coverage**: Aim for 100% test coverage of all implemented functionality
 
 ### Connection Management
+
 - Use **duckdb** gem exclusively for database connections
 - Follow Sequel's connection pooling patterns
-- Implement proper error handling and connection lifecycle management
+- Implement proper error handling and connection lifecycle management

data/.kiro/steering/testing.md

@@ -12,6 +12,7 @@
 ## Test Structure (Following sequel-hexspace Pattern)
 
 ### Required Test Files
+
 ```
 test/
 ├── all.rb                       # Test runner - loads all test files
@@ -27,6 +28,7 @@ test/
 ### Test Categories
 
 #### 1. SQL Generation Tests (Unit Tests)
+
 - **Purpose**: Test SQL generation without database connections
 - **Tool**: Use Sequel's mock database functionality
 - **Requirements**:
@@ -37,6 +39,7 @@ test/
   - Test all SQL operations: SELECT, INSERT, UPDATE, DELETE, DDL
 
 #### 2. Integration Tests
+
 - **Purpose**: Test actual database operations
 - **Tool**: Use real DuckDB in-memory databases
 - **Requirements**:
@@ -47,6 +50,7 @@ test/
   - Test error handling with real database errors
 
 #### 3. Schema Tests
+
 - **Purpose**: Test schema operations and introspection
 - **Requirements**:
   - Test table creation, modification, and deletion
@@ -56,6 +60,7 @@ test/
   - Test DuckDB-specific schema features
 
 #### 4. Type Conversion Tests
+
 - **Purpose**: Test Ruby ↔ DuckDB type mapping
 - **Requirements**:
   - Test all supported data types
@@ -65,6 +70,7 @@ test/
   - Test binary data and text encoding
 
 #### 5. Error Handling Tests
+
 - **Purpose**: Test proper exception mapping and error scenarios
 - **Requirements**:
   - Test Sequel exception mapping
@@ -78,28 +84,33 @@ test/
 ### For Every Task Involving Code:
 
 1. **Step 1: Write Tests First**
+
    - Create comprehensive test cases covering the functionality
    - Include both positive and negative test cases
    - Test edge cases and error conditions
    - Ensure tests fail initially (Red phase)
 
 2. **Step 2: Minimal Implementation**
+
    - Write the minimal code needed to make tests pass
    - Focus on making tests green, not on perfect implementation
    - Avoid over-engineering at this stage
 
 3. **Step 3: Refactor**
+
    - Improve code quality while keeping tests green
    - Optimize performance if needed
    - Ensure code follows style guidelines
 
 4. **Step 4: Verify Coverage**
+
    - Ensure all implemented functionality has test coverage
    - Add additional tests if gaps are found
 
 ## Test Quality Standards
 
 ### Test Code Quality
+
 - Tests must be clear and readable
 - Test names should describe what is being tested
 - Tests should be independent and isolated
@@ -107,12 +118,14 @@ test/
 - Tests should run quickly (especially unit tests)
 
 ### Test Coverage Requirements
+
 - **100% line coverage** for all implemented functionality
 - **Branch coverage** for all conditional logic
 - **Edge case coverage** for error conditions
 - **Integration coverage** for database operations
 
 ### Test Documentation
+
 - Each test file should have a header explaining its purpose
 - Complex test setups should be documented
 - Test utilities should be well-documented
@@ -121,6 +134,7 @@ test/
 ## Tools and Utilities
 
 ### Mock Database Testing
+
 ```ruby
 # Example of mock database testing for SQL generation
 DB = Sequel.mock
@@ -129,6 +143,7 @@ assert_equal "SELECT * FROM users WHERE (name = 'John')", dataset.sql
 ```
 
 ### Integration Testing Setup
+
 ```ruby
 # Example of integration testing with real DuckDB
 def setup
@@ -143,12 +158,14 @@ end
 ## Continuous Integration
 
 ### Test Execution
+
 - All tests must pass before any code is merged
 - Tests should be run on multiple Ruby versions
 - Tests should be run on different operating systems
 - Performance regression tests should be included
 
 ### Test Reporting
+
 - Test results should be clearly reported
 - Coverage reports should be generated
 - Failed tests should provide clear error messages
@@ -157,6 +174,7 @@ end
 ## Common Testing Patterns
 
 ### Testing SQL Generation
+
 ```ruby
 def test_select_with_where
   dataset = @db[:users].where(name: 'John')
@@ -165,6 +183,7 @@ end
 ```
 
 ### Testing Database Operations
+
 ```ruby
 def test_insert_and_select
   @db[:users].insert(name: 'John', email: 'john@example.com')
@@ -174,6 +193,7 @@ end
 ```
 
 ### Testing Error Conditions
+
 ```ruby
 def test_connection_error
   assert_raises(Sequel::DatabaseConnectionError) do
@@ -185,8 +205,9 @@ end
 ## Remember: NO CODE WITHOUT TESTS
 
 This is not optional. Every implementation task must begin with writing comprehensive tests. This ensures:
+
 - Functionality works as expected
 - Regressions are caught early
 - Code is maintainable and refactorable
 - Documentation through executable examples
-- Confidence in the codebase
+- Confidence in the codebase

data/.mdformat.toml

@@ -0,0 +1,2 @@
+extensions = ["frontmatter", "gfm"]
+number = true

data/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.2.0"
+}

data/.rubocop.yml

@@ -1,103 +1,161 @@
+inherit_from: .rubocop_todo.yml
+
 plugins:
   - rubocop-minitest
   - rubocop-rake
   - rubocop-sequel
 
 AllCops:
-  TargetRubyVersion: 3.1
+  TargetRubyVersion: 4.0
   NewCops: enable
+  SuggestExtensions: false
+  Exclude:
+    - 'vendor/**/*'
+    - 'bin/**/*'
+    - 'tmp/**/*'
 
-Gemspec/DevelopmentDependencies:
+inherit_mode:
+  merge:
+    - Exclude
+
+Layout/IndentationWidth:
+  Width: 2
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+Style/DefWithParentheses:
   Enabled: false
 
-# Disable complexity violations for database adapter code
-Metrics/ModuleLength:
+Style/MethodCallWithoutArgsParentheses:
   Enabled: true
+
+Layout/LineLength:
+  Max: 120
+  AllowedPatterns: ['\A\s*#']
   Exclude:
-    - lib/sequel/adapters/shared/duckdb.rb
+    - '*.gemspec'
+    - 'test/**/*'
 
-Metrics/MethodLength:
+Style/Documentation:
+  Enabled: false
+
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+Style/Lambda:
+  Enabled: false
+
+Style/ParallelAssignment:
+  Enabled: false
+
+Style/GuardClause:
   Enabled: true
-  Exclude:
-    - lib/sequel/adapters/shared/duckdb.rb
-    - test/**/*
-    - test/type_test.rb
 
-Metrics/ClassLength:
+Style/IfUnlessModifier:
   Enabled: true
-  Exclude:
-    - test/**/*
-    - test/type_test.rb
+
+Metrics/MethodLength:
+  Max: 25
+
+Metrics/ClassLength:
+  Max: 200
+
+Metrics/ModuleLength:
+  Max: 200
 
 Metrics/BlockLength:
-  Enabled: true
+  Max: 50
   Exclude:
-    - test/**/*
-    - test/type_test.rb
-    - sequel-duckdb.gemspec
+    - 'test/**/*'
+    - '*.gemspec'
+    - 'Rakefile'
+
+Style/ZeroLengthPredicate:
+  Enabled: false
+
+Naming/MemoizedInstanceVariableName:
+  Enabled: false
+
+Naming/MethodParameterName:
+  MinNameLength: 1
+
+Style/MultilineBlockChain:
+  Enabled: false
 
 Metrics/AbcSize:
-  Enabled: true
+  Max: 35
   Exclude:
-    - lib/sequel/adapters/shared/duckdb.rb
-    - test/**/*
-    - test/type_test.rb
+    - 'test/**/*'
 
 Metrics/CyclomaticComplexity:
-  Enabled: true
-  Exclude:
-    - lib/sequel/adapters/shared/duckdb.rb
-    - test/**/*
-    - test/type_test.rb
+  Max: 15
 
 Metrics/PerceivedComplexity:
+  Max: 12
+
+Metrics/BlockNesting:
+  Max: 4
+
+Naming/AccessorMethodName:
+  Enabled: false
+
+Style/HashSyntax:
+  EnforcedStyle: ruby19
+  EnforcedShorthandSyntax: either
+
+Minitest/AssertEqual:
   Enabled: true
-  Exclude:
-    - lib/sequel/adapters/shared/duckdb.rb
-    - test/**/*
-    - test/type_test.rb
 
-# Disable line length for generated SQL and complex expressions
-Layout/LineLength:
+Minitest/RefuteEqual:
   Enabled: true
-  Exclude:
-    - test/**/*
-    - test/type_test.rb
-    - sequel-duckdb.gemspec
 
 Minitest/MultipleAssertions:
   Enabled: false
 
-# Allow duplicate branches for error handling patterns
-Lint/DuplicateBranch:
-  Enabled: true
+Layout/EmptyLinesAroundClassBody:
+  EnforcedStyle: empty_lines_except_namespace
 
-# Allow database adapter naming patterns
-Naming/MethodParameterName:
-  Enabled: true
+Layout/EmptyLinesAroundModuleBody:
+  EnforcedStyle: empty_lines_except_namespace
 
-Naming/AccessorMethodName:
-  Enabled: true
+Style/TrailingCommaInArguments:
+  EnforcedStyleForMultiline: comma
+
+Style/TrailingCommaInArrayLiteral:
+  EnforcedStyleForMultiline: comma
+
+Style/TrailingCommaInHashLiteral:
+  EnforcedStyleForMultiline: comma
+
+Gemspec/DevelopmentDependencies:
+  Enabled: false
+
+Style/HashLikeCase:
+  Exclude:
+    - 'test/**/*'
+
+Lint/DuplicateBranch:
+  Exclude:
+    - 'test/**/*'
+
+Style/StringConcatenation:
+  Exclude:
+    - 'test/**/*'
 
 Naming/VariableNumber:
-  Enabled: true
   Exclude:
-    - test/**/*
+    - 'test/**/*'
 
-# Allow database adapter patterns
 Lint/EmptyBlock:
-  Enabled: true
   Exclude:
-    - test/**/*
-
-Lint/DuplicateMethods:
-  Enabled: true
+    - 'test/**/*'
 
 Style/TrivialAccessors:
   Enabled: true
 
-Style/StringLiterals:
-  EnforcedStyle: double_quotes
-
-Style/StringLiteralsInInterpolation:
-  EnforcedStyle: double_quotes
+Lint/DuplicateMethods:
+  Enabled: true