guides: add dart onboarding guide (#4147)

Co-authored-by: shortcuts <[email protected]>
Co-authored-by: Pierre Millot <[email protected]>

Author: 3 people

.github/workflows/check.yml

@@ -41,7 +41,7 @@ jobs:
     runs-on: ubuntu-22.04
     timeout-minutes: 10
     env:
-      CACHE_VERSION: 1.11 # bump this to run all clients on the CI.
+      CACHE_VERSION: 1.12 # bump this to run all clients on the CI.
     steps:
       - name: debugging - dump GitHub context
         env:

scripts/formatter.ts

@@ -15,13 +15,13 @@ export async function formatter(language: string, cwd: string): Promise<void> {
       }
       break;
     case 'dart':
-      if (cwd.includes('tests') || cwd.includes('snippets')) {
-        await run('dart pub get && dart fix --apply && dart format .', {
+      if (cwd.includes('clients')) {
+        await run('dart pub get && melos bs && melos build --no-select && melos lint', {
           cwd,
           language,
         });
       } else {
-        await run('dart pub get && melos bs && melos build --no-select && melos lint', {
+        await run('dart pub get && dart fix --apply && dart format .', {
           cwd,
           language,
         });

templates/dart/guides/search/saveObjectsMovies.mustache

@@ -0,0 +1,37 @@
+import 'package:http/http.dart' as http;
+import 'dart:convert';
+{{> snippets/import}}
+
+void main() async {
+  // initiate client
+  {{> snippets/init}}
+
+  // read json file from url
+  final datasetRequest = await http.get(
+      Uri.parse('https://dashboard.algolia.com/sample_datasets/movie.json'));
+
+  if (datasetRequest.statusCode == 200) {
+    final moviesData = jsonDecode(datasetRequest.body);
+
+    final batchRequests = <BatchRequest>[];
+
+    for (final movie in moviesData) {
+      batchRequests.add(
+        BatchRequest(action: Action.fromJson('addObject'), body: movie),
+      );
+    }
+
+    try {
+      // push data to algolia
+      await client.batch(
+        indexName: 'movies_index',
+        batchWriteParams: BatchWriteParams(requests: batchRequests),
+      );
+      print("Successfully indexed records!");
+    } catch (e) {
+      print("Error: ${e.toString()}");
+    }
+  } else {
+    throw Exception('Failed to load data');
+  }
+}

templates/dart/snippets/pubspec.mustache

@@ -10,6 +10,7 @@ dependencies:
   algolia_client_insights: ^1.0.0
   algolia_client_recommend: ^1.0.0
   dotenv: ^4.1.0
+  http: ^1.2.2
 
 dev_dependencies:
-  lints: ^5.0.0
+  lints: ^5.0.0