guides: add dart onboarding guide (#4147) (generated) [skip ci]

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

Author: 4 people

docs/guides/dart/.gitignore

@@ -0,0 +1,25 @@
+# Files and directories created by pub
+.dart_tool/
+.buildlog
+.packages
+.project
+.pub/
+build/
+
+# Files created by dart2js
+*.dart.js
+*.part.js
+*.js.deps
+*.js.map
+*.info.json
+
+# Directory created by dartdoc
+doc/api/
+
+# Don't commit pubspec lock file
+pubspec.lock
+
+# IntelliJ
+*.iml
+*.ipr
+*.iws

docs/guides/dart/analysis_options.yaml

@@ -0,0 +1 @@
+include: package:lints/recommended.yaml

docs/guides/dart/lib/saveObjectsMovies.dart

@@ -0,0 +1,38 @@
+import 'package:http/http.dart' as http;
+import 'dart:convert';
+import 'package:algolia_client_search/algolia_client_search.dart';
+
+void main() async {
+  // initiate client
+  final client =
+      SearchClient(appId: 'ALGOLIA_APPLICATION_ID', apiKey: 'ALGOLIA_API_KEY');
+
+  // 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');
+  }
+}

docs/guides/dart/pubspec.yaml

@@ -0,0 +1,16 @@
+name: algolia_snippets
+version: 1.0.0
+
+environment:
+  sdk: ^3.0.0
+
+dependencies:
+  algoliasearch: ^1.0.0
+  algolia_client_search: ^1.0.0
+  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

docs/guides/dart/pubspec_overrides.yaml

@@ -0,0 +1,11 @@
+dependency_overrides:
+  algoliasearch:
+    path: ../../../clients/algoliasearch-client-dart/packages/algoliasearch
+  algolia_client_core:
+    path: ../../../clients/algoliasearch-client-dart/packages/client_core
+  algolia_client_search:
+    path: ../../../clients/algoliasearch-client-dart/packages/client_search
+  algolia_client_insights:
+    path: ../../../clients/algoliasearch-client-dart/packages/client_insights
+  algolia_client_recommend:
+    path: ../../../clients/algoliasearch-client-dart/packages/client_recommend

docs/snippets/dart/pubspec.yaml

@@ -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