chore: api snippet formatting (#92)

* chore: trying to find an agreeable code format

dart format and the API snippet parser haver incompatible requirements and I'm trying to satisfy both

* chore: more trickery to get function defs spread across 2 lines

* chore: using find to exclude doc examples

The dart format utility keeps munging my api examples file such that it iss incompatible with the API snippet parser, so am using find to gather dart files to format and excluding the snippets explicitly.

* fix: add in dart file in root of lib

* fix: fixing find command format

* fix: remove unneeded arg

.github/workflows/on-pull-request.yml

@@ -22,7 +22,7 @@ jobs:
 
       # Uncomment this step to verify the use of 'dart format' on each commit.
       - name: Verify formatting
-        run: dart format --output=none --set-exit-if-changed .
+        run: find lib/momento.dart lib/src example test -name "*.dart" -not -name doc_example_apis.dart -exec dart format --output=none --set-exit-if-changed {} \;
 
       # Consider passing '--fatal-infos' for slightly stricter analysis.
       - name: Analyze project source

example/doc_example_apis/doc_example_apis.dart

@@ -14,8 +14,7 @@ Future<void> example_API_InstantiateCacheClient() async {
   }
 }
 
-Future<void> example_API_CreateCache(
-    CacheClient cacheClient, String cacheName) async {
+Future<void> example_API_CreateCache(CacheClient cacheClient, String cacheName) async {
   final result = await cacheClient.createCache(cacheName);
   switch (result) {
     case CreateCacheAlreadyExists():
@@ -37,8 +36,7 @@ Future<void> example_API_ListCaches(CacheClient cacheClient) async {
   }
 }
 
-Future<void> example_API_DeleteCache(
-    CacheClient cacheClient, String cacheName) async {
+Future<void> example_API_DeleteCache(CacheClient cacheClient, String cacheName) async {
   final result = await cacheClient.deleteCache(cacheName);
   switch (result) {
     case DeleteCacheError():
@@ -49,8 +47,7 @@ Future<void> example_API_DeleteCache(
   }
 }
 
-Future<void> example_API_Set(
-    CacheClient cacheClient, String cacheName, Value key, Value value) async {
+Future<void> example_API_Set(CacheClient cacheClient, String cacheName, Value key, Value value) async {
   final result = await cacheClient.set(cacheName, key, value);
   switch (result) {
     case SetError():
@@ -61,8 +58,7 @@ Future<void> example_API_Set(
   }
 }
 
-Future<void> example_API_Get(
-    CacheClient cacheClient, String cacheName, Value key) async {
+Future<void> example_API_Get(CacheClient cacheClient, String cacheName, Value key) async {
   final result = await cacheClient.get(cacheName, key);
   switch (result) {
     case GetMiss():
@@ -74,8 +70,7 @@ Future<void> example_API_Get(
   }
 }
 
-Future<void> example_API_Delete(
-    CacheClient cacheClient, String cacheName, Value key) async {
+Future<void> example_API_Delete(CacheClient cacheClient, String cacheName, Value key) async {
   final result = await cacheClient.delete(cacheName, key);
   switch (result) {
     case DeleteError():