Add orderRandom query

Author: abnegate

templates/android/library/src/main/java/io/package/Query.kt.twig

@@ -151,6 +151,13 @@ class Query(
          */
         fun orderDesc(attribute: String) = Query("orderDesc", attribute).toJson()
 
+        /**
+         * Sort results randomly.
+         *
+         * @returns The query string.
+         */
+        fun orderRandom() = Query("orderRandom").toJson()
+
         /**
          * Return results before documentId.
          *

templates/dart/lib/query.dart.twig

@@ -153,6 +153,10 @@ class Query {
   static String orderDesc(String attribute) =>
       Query._('orderDesc', attribute).toString();
 
+  /// Sort results randomly.
+  static String orderRandom() =>
+      Query._('orderRandom').toString();
+
   /// Return results before [id].
   /// 
   /// Refer to the [Cursor Based Pagination]({{sdk.url}}/docs/pagination#cursor-pagination)

templates/dart/test/query_test.dart.twig

@@ -190,6 +190,13 @@ void main() {
     expect(query['method'], 'orderDesc');
   });
 
+  test('returns orderRandom', () {
+    final query = jsonDecode(Query.orderRandom());
+    expect(query['attribute'], null);
+    expect(query['values'], null);
+    expect(query['method'], 'orderRandom');
+  });
+
   test('returns cursorBefore', () {
     final query = jsonDecode(Query.cursorBefore('custom'));
     expect(query['attribute'], null);

templates/deno/src/query.ts.twig

@@ -81,6 +81,9 @@ export class Query {
   static orderAsc = (attribute: string): string =>
     new Query("orderAsc", attribute).toString();
 
+  static orderRandom = (): string =>
+    new Query("orderRandom").toString();
+
   static cursorAfter = (documentId: string): string =>
     new Query("cursorAfter", undefined, documentId).toString();
 

templates/deno/test/query.test.ts.twig

@@ -153,6 +153,11 @@ describe('Query', () => {
         `{"method":"orderDesc","attribute":"attr"}`,
     ));
 
+    test('orderRandom', () => assertEquals(
+        Query.orderRandom().toString(),
+        `{"method":"orderRandom"}`,
+    ));
+
     test('cursorBefore', () => assertEquals(
         Query.cursorBefore('attr').toString(),
         `{"method":"cursorBefore","attribute":"attr"}`,

templates/dotnet/Package/Query.cs.twig

@@ -138,6 +138,10 @@ namespace {{ spec.title | caseUcfirst }}
             return new Query("orderDesc", attribute, null).ToString();
         }
 
+        public static string OrderRandom() {
+            return new Query("orderRandom", null, null).ToString();
+        }
+
         public static string Limit(int limit) {
             return new Query("limit", null, limit).ToString();
         }

templates/go/query.go.twig

@@ -268,7 +268,14 @@ func OrderDesc(attribute string) string {
 	return parseQuery(queryOptions{
 		Method:    "orderDesc",
 		Attribute: &attribute,
-	})}
+	})
+}
+
+func OrderRandom() string {
+	return parseQuery(queryOptions{
+		Method: "orderRandom",
+	})
+}
 
 func CursorBefore(documentId interface{}) string {
 	values := toArray(documentId)

templates/kotlin/src/main/kotlin/io/appwrite/Query.kt.twig

@@ -41,6 +41,8 @@ class Query(
 
         fun orderDesc(attribute: String) = Query("orderDesc", attribute).toJson()
 
+        fun orderRandom() = Query("orderRandom").toJson()
+
         fun cursorBefore(documentId: String) = Query("cursorBefore", null, listOf(documentId)).toJson()
 
         fun cursorAfter(documentId: String) = Query("cursorAfter", null, listOf(documentId)).toJson()

templates/php/src/Query.php.twig

@@ -233,6 +233,16 @@ class Query implements \JsonSerializable
         return (new Query('orderDesc', $attribute, null))->__toString();
     }
 
+    /**
+     * Order Random
+     *
+     * @return string
+     */
+    public static function orderRandom(): string
+    {
+        return (new Query('orderRandom', null, null))->__toString();
+    }
+
     /**
      * Limit
      *

templates/php/tests/QueryTest.php.twig

@@ -131,6 +131,10 @@ final class QueryTest extends TestCase {
         $this->assertSame('orderDesc("attr")', Query::orderDesc('attr'));
     }
 
+    public function testOrderRandom(): void {
+        $this->assertSame('orderRandom()', Query::orderRandom());
+    }
+
     public function testCursorBefore(): void {
         $this->assertSame('cursorBefore("attr")', Query::cursorBefore('attr'));
     }