Merge pull request #9 from WordPress/lexer-translation

SQLite support via a MySQL parser

Author: aristath

.gitattributes

@@ -4,3 +4,4 @@
 .gitignore export-ignore
 composer.json export-ignore
 phpcs.xml.dist export-ignore
+tests/*.php export-ignore

load.php

@@ -3,12 +3,14 @@
  * Plugin Name: SQLite Database Integration
  * Description: SQLite database driver drop-in. (based on SQLite Integration by Kojima Toshiyasu)
  * Author: WordPress Performance Team
- * Version: 1.0.3
+ * Version: 2.0
  * Requires PHP: 5.6
  * Textdomain: sqlite-database-integration
  *
  * This project is based on the original work of Kojima Toshiyasu and his SQLite Integration plugin,
  * and the work of Evan Mattson and his WP SQLite DB plugin - See https://github.com/aaemnnosttv/wp-sqlite-db
+ *
+ * @package wp-sqlite-integration
  */
 
 define( 'SQLITE_MAIN_FILE', __FILE__ );

phpcs.xml.dist

@@ -23,6 +23,7 @@
 	<file>.</file>
 
 	<rule ref="WordPress-Core"/>
+	<rule ref="WordPress-Docs"/>
 	<rule ref="WordPress.CodeAnalysis.EmptyStatement"/>
 
 	<!-- Directories and third party library exclusions. -->

readme.txt

@@ -4,7 +4,7 @@ Contributors:      wordpressdotorg, aristath
 Requires at least: 6.0
 Tested up to:      6.1
 Requires PHP:      5.6
-Stable tag:        1.0.3
+Stable tag:        2.0
 License:           GPLv2 or later
 License URI:       https://www.gnu.org/licenses/gpl-2.0.html
 Tags:              performance, database
@@ -15,11 +15,16 @@ SQLite-integration plugin from the WordPress Performance Team.
 
 The SQLite plugin is a community, feature plugin. The intent is to allow testing an SQLite integration with WordPress and gather feedback, with the goal of eventually landing it in WordPress core.
 
+This project is based on the original work of Kojima Toshiyasu and his SQLite Integration plugin, and the work of Evan Mattson and his WP SQLite DB plugin - See https://github.com/aaemnnosttv/wp-sqlite-db.
+
+It also includes code from the PHPMyAdmin project (specifically parts of the PHPMyAdmin/sql-parser library), licensed under the GPL v2 or later. More info on the PHPMyAdmin/sql-parser library can be found on [GitHub](https://github.com/phpmyadmin/sql-parser).
+
 == Frequently Asked Questions ==
 
 = What is the purpose of this plugin? =
 
 The primary purpose of the SQLite plugin is to allow testing the use of an SQLite database, with the goal to eventually land in WordPress core.
+
 You can read the original proposal on the [Make blog](https://make.wordpress.org/core/2022/09/12/lets-make-wordpress-officially-support-sqlite/), as well as the [call for testing](https://make.wordpress.org/core/2022/12/20/help-us-test-the-sqlite-implementation/) for more context and useful information.
 
 = Can I use this plugin on my production site? =

tests/QueryRewriterTests.php

@@ -0,0 +1,85 @@
+<?php
+
+require __DIR__ . '/class-wp-sqlite-query-rewriter.php';
+require __DIR__ . '/class-wp-sqlite-lexer.php';
+
+use PHPUnit\Framework\TestCase;
+
+class WP_SQLite_Query_RewriterTests extends TestCase {
+
+
+	public function testConsume() {
+		$r = new WP_SQLite_Query_Rewriter(
+			array(
+				WP_SQLite_Lexer::get_token( ' ', WP_SQLite_Lexer::TYPE_DELIMITER ),
+				WP_SQLite_Lexer::get_token( 'int', WP_SQLite_Lexer::TYPE_KEYWORD, WP_SQLite_Lexer::FLAG_KEYWORD_DATA_TYPE ),
+				WP_SQLite_Lexer::get_token( ' ', WP_SQLite_Lexer::TYPE_DELIMITER ),
+				WP_SQLite_Lexer::get_token( 'DATE_ADD', WP_SQLite_Lexer::TYPE_KEYWORD, WP_SQLite_Lexer::FLAG_KEYWORD_FUNCTION ),
+				WP_SQLite_Lexer::get_token( ' ', WP_SQLite_Lexer::TYPE_DELIMITER ),
+				WP_SQLite_Lexer::get_token( 'SET', WP_SQLite_Lexer::TYPE_KEYWORD ),
+				WP_SQLite_Lexer::get_token( ' ', WP_SQLite_Lexer::TYPE_WHITESPACE ),
+			)
+		);
+		$this->assertEquals(
+			'int',
+			$r->consume(
+				array(
+					'type'  => WP_SQLite_Lexer::TYPE_KEYWORD,
+					'flags' => WP_SQLite_Lexer::FLAG_KEYWORD_DATA_TYPE,
+				)
+			)->value
+		);
+		$this->assertEquals(
+			'DATE_ADD',
+			$r->consume(
+				array(
+					'type'  => WP_SQLite_Lexer::TYPE_KEYWORD,
+					'flags' => WP_SQLite_Lexer::FLAG_KEYWORD_FUNCTION,
+				)
+			)->value
+		);
+	}
+	public function testSkip() {
+		$r = new WP_SQLite_Query_Rewriter(
+			array(
+				WP_SQLite_Lexer::get_token( 'DO', WP_SQLite_Lexer::TYPE_KEYWORD ),
+				WP_SQLite_Lexer::get_token( ' ', WP_SQLite_Lexer::TYPE_WHITESPACE ),
+				WP_SQLite_Lexer::get_token( 'UPDATE', WP_SQLite_Lexer::TYPE_KEYWORD ),
+				WP_SQLite_Lexer::get_token( ' ', WP_SQLite_Lexer::TYPE_WHITESPACE ),
+				WP_SQLite_Lexer::get_token( 'SET', WP_SQLite_Lexer::TYPE_KEYWORD ),
+				WP_SQLite_Lexer::get_token( ' ', WP_SQLite_Lexer::TYPE_WHITESPACE ),
+			)
+		);
+		$this->assertEquals(
+			'DO',
+			$r->skip()->value
+		);
+		$this->assertEquals(
+			'UPDATE',
+			$r->skip()->value
+		);
+	}
+
+	public function skip_over() {
+		$r      = new WP_SQLite_Query_Rewriter(
+			array(
+				WP_SQLite_Lexer::get_token( 'DO', WP_SQLite_Lexer::TYPE_KEYWORD ),
+				WP_SQLite_Lexer::get_token( ' ', WP_SQLite_Lexer::TYPE_WHITESPACE ),
+				WP_SQLite_Lexer::get_token( 'UPDATE', WP_SQLite_Lexer::TYPE_KEYWORD ),
+				WP_SQLite_Lexer::get_token( ' ', WP_SQLite_Lexer::TYPE_WHITESPACE ),
+				WP_SQLite_Lexer::get_token( 'SET', WP_SQLite_Lexer::TYPE_KEYWORD ),
+				WP_SQLite_Lexer::get_token( ' ', WP_SQLite_Lexer::TYPE_WHITESPACE ),
+			)
+		);
+		$buffer = $r->skip_over(
+			array(
+				'values' => array( 'UPDATE' ),
+			)
+		);
+		$this->assertCount( 3, $buffer );
+		$this->assertEquals( 'DO', $buffer[0]->value );
+		$this->assertEquals( ' ', $buffer[1]->value );
+		$this->assertEquals( 'UPDATE', $buffer[2]->value );
+	}
+
+}