Skip to content

docs: switch examples from H2 to bundled SQLite, fix Configure.pl bugs#491

Merged
fglock merged 1 commit intomasterfrom
docs/sqlite-configure-improvements
Apr 11, 2026
Merged

docs: switch examples from H2 to bundled SQLite, fix Configure.pl bugs#491
fglock merged 1 commit intomasterfrom
docs/sqlite-configure-improvements

Conversation

@fglock
Copy link
Copy Markdown
Owner

@fglock fglock commented Apr 11, 2026

Summary

  • Switch examples/dbi.pl from H2 to bundled SQLite — no additional driver installation needed to run the example
  • Replace all H2 references in docs with SQLite (bundled) or MySQL/PostgreSQL for external driver examples
  • Recommend ./jperl Configure.pl instead of ./Configure.pl — jperl has built-in HTTPS support, while system Perl may lack IO::Socket::SSL/Net::SSLeay
  • Fix Configure.pl undef warnings — Maven Central results can have missing fields (c, latestVersion, etc.), causing hundreds of "uninitialized value in pattern match" warnings
  • Fix Configure.pl non-interactive STDIN handling — when <STDIN> returns undef (piped/non-interactive), it now warns and defaults to the top-ranked result instead of silently picking a wrong artifact
  • Add *.ent to .gitignore

Files changed

  • examples/dbi.pl — H2 → SQLite (in-memory, bundled)
  • docs/guides/database-access.md — SQLite quick start, updated CLASSPATH examples
  • docs/getting-started/installation.md — SQLite connection example, ./jperl Configure.pl
  • docs/reference/configure.md — all examples use ./jperl Configure.pl, H2 → MySQL/PostgreSQL
  • Configure.pl — fix undef field warnings and non-interactive STDIN fallback
  • .gitignore — add *.ent

Test plan

  • ./jperl examples/dbi.pl runs successfully with SQLite
  • ./jperl Configure.pl --search postgresql runs without undef warnings
  • Non-interactive STDIN defaults to [0] with a warning message
  • No H2 references remain in docs (verified with grep)

Generated with Devin

- Update examples/dbi.pl to use SQLite (bundled, no extra install needed)
- Replace all H2 references in docs with SQLite or MySQL/PostgreSQL
- Recommend running Configure.pl with jperl for built-in HTTPS support
- Fix Configure.pl: guard against undef fields in Maven search results
  (eliminates hundreds of "uninitialized value in pattern match" warnings)
- Fix Configure.pl: handle non-interactive STDIN gracefully with
  validation and fallback to first result

Generated with [Devin](https://cli.devin.ai/docs)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@fglock fglock merged commit d833a1e into master Apr 11, 2026
2 checks passed
@fglock fglock deleted the docs/sqlite-configure-improvements branch April 11, 2026 14:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant