Add SQLite test scenarios and documentation

Co-authored-by: swissspidy <[email protected]>

Author: Copilot

README.md

@@ -7,6 +7,44 @@ Performs basic database operations using credentials stored in wp-config.php.
 
 Quick links: [Using](#using) | [Installing](#installing) | [Contributing](#contributing) | [Support](#support)
 
+## SQLite Support
+
+This package now supports SQLite databases in addition to MySQL/MariaDB. When using the [SQLite Database Integration plugin](https://github.com/WordPress/sqlite-database-integration/), most `wp db` commands will automatically detect and work with SQLite databases.
+
+**Supported commands with SQLite:**
+- `wp db create` - Creates the SQLite database file
+- `wp db drop` - Deletes the SQLite database file
+- `wp db reset` - Recreates the SQLite database file
+- `wp db query` - Executes SQL queries via PDO
+- `wp db export` - Exports the SQLite database to SQL
+- `wp db import` - Imports SQL into the SQLite database
+- `wp db tables` - Lists tables (via $wpdb)
+- `wp db size` - Shows database file size
+- `wp db prefix` - Shows table prefix (via $wpdb)
+- `wp db columns` - Shows column information (via $wpdb)
+- `wp db search` - Searches database content (via $wpdb)
+- `wp db clean` - Removes tables with prefix (via $wpdb)
+
+**Commands not applicable to SQLite:**
+- `wp db check` - Shows a warning (SQLite doesn't require manual checking)
+- `wp db optimize` - Shows a warning (SQLite auto-optimizes with VACUUM)
+- `wp db repair` - Shows a warning (SQLite doesn't require manual repair)
+- `wp db cli` - Shows a warning (use `wp db query` instead)
+
+**SQLite Detection:**
+
+The command automatically detects SQLite databases when:
+1. The `DB_ENGINE` constant is set to `'sqlite'` in wp-config.php
+2. The `SQLITE_DB_DROPIN_VERSION` constant is defined (plugin loaded)
+3. A `db.php` drop-in exists with SQLite integration
+
+**Database File Location:**
+
+By default, the SQLite database is expected at `wp-content/database/.ht.sqlite`. You can customize this location using:
+- `FQDB` constant - Full path to the database file
+- `FQDBDIR` constant - Directory containing the database
+- `DB_FILE` constant - Database filename (used with FQDBDIR)
+
 ## Using
 
 This package implements the following commands:

features/db-sqlite.feature

@@ -0,0 +1,100 @@
+Feature: Perform database operations with SQLite
+
+  @require-sqlite
+  Scenario: SQLite DB CRUD operations
+    Given a WP install with SQLite
+    And a session_yes file:
+      """
+      y
+      """
+
+    When I run `wp db create`
+    Then the return code should be 1
+    And STDERR should contain:
+      """
+      Database already exists
+      """
+
+    When I run `wp db size`
+    Then STDOUT should contain:
+      """
+      .ht.sqlite
+      """
+
+    When I run `wp db tables`
+    Then STDOUT should contain:
+      """
+      wp_posts
+      """
+
+  @require-sqlite
+  Scenario: SQLite DB query
+    Given a WP install with SQLite
+
+    When I run `wp db query 'SELECT COUNT(*) as total FROM wp_posts'`
+    Then STDOUT should contain:
+      """
+      total
+      """
+
+  @require-sqlite
+  Scenario: SQLite DB export/import
+    Given a WP install with SQLite
+
+    When I run `wp post list --format=count`
+    Then STDOUT should contain:
+      """
+      1
+      """
+
+    When I run `wp db export /tmp/wp-cli-sqlite-behat.sql`
+    Then STDOUT should contain:
+      """
+      Success: Exported
+      """
+
+    When I run `wp db reset < session_yes`
+    Then STDOUT should contain:
+      """
+      Success: Database reset
+      """
+
+    When I run `wp db import /tmp/wp-cli-sqlite-behat.sql`
+    Then STDOUT should contain:
+      """
+      Success: Imported
+      """
+
+    When I run `wp post list --format=count`
+    Then STDOUT should contain:
+      """
+      1
+      """
+
+  @require-sqlite
+  Scenario: SQLite commands that show warnings
+    Given a WP install with SQLite
+
+    When I run `wp db check`
+    Then STDOUT should contain:
+      """
+      Warning: Database check is not supported for SQLite databases
+      """
+
+    When I run `wp db optimize`
+    Then STDOUT should contain:
+      """
+      Warning: Database optimization is not supported for SQLite databases
+      """
+
+    When I run `wp db repair`
+    Then STDOUT should contain:
+      """
+      Warning: Database repair is not supported for SQLite databases
+      """
+
+    When I run `wp db cli`
+    Then STDOUT should contain:
+      """
+      Warning: Interactive console (cli) is not supported for SQLite databases
+      """