Now Actually Using:
- ValidatedConfig: Parse config into validated types at request time
- ParameterBinding: Type-safe parameter representation
- RequestProcessor: Pure business logic with injected dependencies
- resolve_template_path(): Pure function for path resolution
- resolve_parameters(): Pure parameter resolution
New Adapters (adapters.rs):
- NginxVariableResolver: Implements VariableResolver trait
- SqliteQueryExecutor: Implements QueryExecutor trait
- HandlebarsAdapter: Implements TemplateLoader + TemplateRenderer
Handler Flow (Functional Core, Imperative Shell):
1. Parse strings into validated types (types.rs)
2. Create validated config (domain.rs)
3. Resolve template path (pure function)
4. Create adapters (adapters.rs - imperative shell)
5. Call RequestProcessor.process() (pure core)
6. Return HTML (imperative shell)
Benefits:
✓ Type validation happens at request time
✓ Invalid queries caught early (SELECT-only enforced)
✓ Core business logic is pure and testable
✓ Real DI: can swap implementations via traits
✓ Clear separation of concerns
Test Coverage: 47 tests (added 2 adapter tests)
Production: Verified working with all features
The architecture documented in ARCHITECTURE.md is now actually implemented!
- New sqlite_serve.conf: all features on single port 8080
- New zenburn.css: hex color palette, all styles in one cacheable file
- New Zenburn templates: header/footer/card partials
- New start.sh: unified launcher with all endpoint docs
- Removed 3 separate example configs and start scripts
15 files changed, 980 insertions(+), 258 deletions(-)
Advanced Refactoring Principles Applied:
1. Parse, Don't Validate:
- DatabasePath: Validated database paths (not empty)
- SqlQuery: Validated SELECT-only queries (read-only guarantee)
- TemplatePath: Validated .hbs files (type safety)
- NginxVariable: Validated $ prefixed variables
- ParamName: Validated : prefixed SQL parameters
- ParameterBinding: Type-safe parameter configurations
2. Correctness by Construction:
- SqlQuery enforces SELECT-only at parse time
- TemplatePath enforces .hbs extension at parse time
- Illegal states are unrepresentable (can't have invalid query)
- Type system prevents runtime errors
3. Dependency Injection:
- domain.rs: Pure functional core with injected dependencies
- VariableResolver trait: Abstract nginx variable resolution
- QueryExecutor trait: Abstract database access
- TemplateLoader trait: Abstract template loading
- TemplateRenderer trait: Abstract rendering
- RequestProcessor: Testable with mocks, no hard dependencies
4. Functional Core, Imperative Shell:
- domain.rs: Pure business logic (no I/O, fully testable)
- lib.rs: Imperative shell (nginx FFI, actual I/O)
- Clear separation between what and how
New Files:
- src/types.rs (303 lines): Type-safe wrappers with validation
- src/domain.rs (306 lines): Pure functional core with DI
Type Safety Examples:
- SqlQuery::parse("SELECT...") // OK
- SqlQuery::parse("DELETE...") // Compile-time error via Result
- TemplatePath::parse("x.html") // Error: must be .hbs
- NginxVariable::parse("arg_id") // Error: must start with $
Benefits:
✓ Impossible to execute non-SELECT queries
✓ Impossible to use non-.hbs templates
✓ Variables validated at construction time
✓ Pure core is 100% testable with mocks
✓ Type errors caught at compile time, not runtime
Test Coverage: 45 tests
- 18 new type validation tests
- 4 dependency injection tests
- All existing tests still passing
- All tests pure (no nginx runtime needed)
Production verified working.
New Feature: Named SQL Parameters
- Supports both positional (?) and named (:name) parameters
- Named parameters are order-independent and more readable
- Syntax: sqlite_param :param_name $variable
Implementation:
- Updated sqlite_param directive to accept 1 or 2 arguments
- ModuleConfig.query_params now stores (name, variable) pairs
- execute_query() detects named vs positional parameters
- Extracted row_to_map closure to avoid type conflicts
- Named params use rusqlite named parameter binding
Examples (Port 8082):
- Book detail: WHERE id = :book_id
- Genre filter: WHERE genre = :genre_name
- Year range: WHERE year >= :min_year AND year <= :max_year
- Title search: WHERE title LIKE '%' || :search_term || '%'
- Rating filter: WHERE rating >= :min_rating
Benefits of Named Parameters:
- Order-independent: params can be in any order in config
- Self-documenting: :book_id is clearer than first ?
- Maintainable: can add/remove params without reordering
- Recommended for all but simplest queries
Configuration:
- conf/book_named_params.conf: Complete named params example
- start_named_params.sh: Quick start script for port 8082
Documentation:
- Added named vs positional comparison in README_PARAMETERS.md
- Updated README.md with named parameter examples
- Documented both syntaxes in directive reference
All examples tested and working with both parameter styles.
- Updated package name in Cargo.toml: nginx-test → sqlite-serve
- Updated library name: libnginx_test.dylib → libsqlite_serve.dylib
- Updated all load_module directives in nginx configs
- Updated build checks in start scripts
- Updated branding in footer template
- Updated project name in all README files
The name 'sqlite-serve' better reflects the module's purpose:
serving dynamic content from SQLite databases via NGINX.
- Update HttpModule trait implementation to match ngx 0.5.0 API
- Implement HttpModuleLocationConf as separate unsafe trait
- Fix configuration access using Module::location_conf()
- Replace ngx_null_command macro with explicit null command
- Update imports to use correct constant names
- Suppress C FFI naming convention warnings
- Replace hardcoded Person struct with dynamic column handling
- Add configurable directives: sqlite_db, sqlite_query, sqlite_template
- Support arbitrary SQL queries with any table/column structure
- Create generic execute_query() function returning dynamic JSON data
- Update handler to render templates with configurable paths
- Add build.rs for macOS dynamic linking support
- Fix handler return value to prevent 'header already sent' errors
