feat: support Query\Builder::toRawSql()

CHANGELOG.md

@@ -4,6 +4,7 @@ Added
 - Added deprecation warnings to `Connection::runDdl` and `Connection::runDdls` (#98)
 - Added  `ManagesMutations::insertOrUpdateUsingMutation` and `UsesMutations::insertOrUpdateUsingMutation` to do upserts (#109)
 - Added Support for `Schema\Builder::dropIfExists()` (#115)
+- Added Support for `Query\Builder::toRawSql()` (#123)
 
 Changed
 - `Connection::waitForOperation` and `Connection::isDoneOperation` has been removed. (#99)

src/Connection.php

@@ -200,7 +200,7 @@ public function disconnect()
      */
     protected function getDefaultQueryGrammar(): QueryGrammar
     {
-        return new QueryGrammar();
+        return (new QueryGrammar())->setConnection($this);
     }
 
     /**
@@ -420,6 +420,24 @@ public function prepareBindings(array $bindings)
         return $bindings;
     }
 
+    /**
+     * @inheritDoc
+     */
+    protected function escapeBool($value)
+    {
+        return $value ? 'true' : 'false';
+    }
+
+    /**
+     * @inheritDoc
+     */
+    protected function escapeString($value)
+    {
+        return str_contains($value, "\n")
+            ? 'r"""' . addcslashes($value, '"') . '"""'
+            : '"' . addcslashes($value, '"') . '"';
+    }
+
     /**
      * @inheritDoc
      */

tests/Query/BuilderTest.php

@@ -867,4 +867,27 @@ public function test_sharedLock(): void
         $qb = $conn->table(self::TABLE_NAME_USER);
         $qb->sharedLock()->get();
     }
+
+    public function test_toRawSql(): void
+    {
+        $conn = $this->getDefaultConnection();
+
+        $sql = $conn->table(self::TABLE_NAME_USER)->where('b', true)->toRawSql();
+        $this->assertSame($sql, 'select * from `User` where `b` = true', 'true');
+
+        $sql = $conn->table(self::TABLE_NAME_USER)->where('b', false)->toRawSql();
+        $this->assertSame($sql, 'select * from `User` where `b` = false', 'false');
+
+        $sql = $conn->table(self::TABLE_NAME_USER)->where('t', 'test')->toRawSql();
+        $this->assertSame($sql, 'select * from `User` where `t` = "test"', 'text');
+
+        $sql = $conn->table(self::TABLE_NAME_USER)->where('t', '"tes\'s"')->toRawSql();
+        $this->assertSame($sql, 'select * from `User` where `t` = "\"tes\'s\""', 'escaped');
+
+        $sql = $conn->table(self::TABLE_NAME_USER)->where('t', "tes\nt")->toRawSql();
+        $this->assertSame($sql, "select * from `User` where `t` = r\"\"\"tes\nt\"\"\"", 'newline');
+
+        $sql = $conn->table(self::TABLE_NAME_USER)->where('t', "t\"e\"s\nt")->toRawSql();
+        $this->assertSame($sql, "select * from `User` where `t` = r\"\"\"t\\\"e\\\"s\nt\"\"\"", 'newline with escaped quote');
+    }
 }