Add Custom JSON, Json methods; WIP on tests

tests/Integration/SQLite/CustomTest.php

@@ -63,6 +63,36 @@ describe('::array()', function () {
     });
 });
 
+describe('::jsonArray()', function () {
+    test('returns non-empty array when data found', function () {
+        expect(Custom::jsonArray(Query::selectFromTable(ThrowawayDb::TABLE) . " WHERE data->>'sub' IS NOT NULL", []))
+            ->toContain('[{', '},{', '}]');
+    });
+    test('returns empty array when no data found', function () {
+        expect(Custom::jsonArray(Query::selectFromTable(ThrowawayDb::TABLE) . " WHERE data->>'nothing' = '7'", []))
+            ->toBe('[]');
+    });
+});
+
+describe('::outputJsonArray()', function () {
+    test('outputs non-empty array when data found', function () {
+        ob_clean();
+        ob_start();
+        Custom::outputJsonArray(Query::selectFromTable(ThrowawayDb::TABLE) . " WHERE data->>'sub' IS NOT NULL", []);
+        $json = ob_get_contents();
+        ob_end_clean();
+        expect($json)->toContain('[{', '},{', '}]');
+    });
+    test('outputs empty array when no data found', function () {
+        ob_clean();
+        ob_start();
+        Custom::outputJsonArray(Query::selectFromTable(ThrowawayDb::TABLE) . " WHERE data->>'nothing' = '7'", []);
+        $json = ob_get_contents();
+        ob_end_clean();
+        expect($json)->toBe('[]');
+    });
+});
+
 describe('::single()', function () {
     test('returns a document when one is found', function () {
         $doc = Custom::single('SELECT data FROM ' . ThrowawayDb::TABLE . " WHERE data->>'id' = :id", [':id' => 'one'],
@@ -76,6 +106,19 @@ describe('::single()', function () {
     });
 });
 
+describe('::jsonSingle()', function () {
+    test('returns a document when one is found', function () {
+        expect(Custom::jsonSingle('SELECT data FROM ' . ThrowawayDb::TABLE . " WHERE data->>'id' = :id",
+            [':id' => 'one']))
+            ->toStartWith('{"id":"one",')->toEndWith('}');
+    });
+    test('returns no document when one is not found', function () {
+        expect(Custom::jsonSingle('SELECT data FROM ' . ThrowawayDb::TABLE . " WHERE data->>'id' = :id",
+            [':id' => 'eighty']))
+            ->toBe('{}');
+    });
+});
+
 describe('::nonQuery()', function () {
     test('works when documents match the WHERE clause', function () {
         Custom::nonQuery('DELETE FROM ' . ThrowawayDb::TABLE, []);