consider a way to call await as a method to facilitate fluent or functional style APIs

[insinfo]

I really like the style of Dart's async/await syntax, but I think it could use some syntactic sugar without breaking the existing style, a way to use await as a method call to facilitate fluent or functional style APIs,
It makes it a lot easier when you want to solve some things in a single line

import 'dart:async';
import 'dart:convert';
import 'dart:isolate';

class FluentAPI {
  FluentAPI from(String table) {
    return this;
  }

  FluentAPI select([List<String> cols = const ['*']]) {
    return this;
  }

  FluentAPI where(String col, String operator, dynamic val) {
    return this;
  }

  FluentAPI orderBy(String col, String dir) {
    return this;
  }

  FluentAPI limit(int limit) {
    return this;
  }

  FluentAPI offset(int offset) {
    return this;
  }

  Future<List<Map<String, dynamic>>> getAll() {
    return Future.value([
      {'name': 'a'}
    ]);
  }
}

extension ListMapExtension on List<Map> {
  Future<String> toJsonAsync() async {
    final receivePort = ReceivePort();
    await Isolate.spawn(_isolateListMapToJson, [receivePort.sendPort, this]);
    final completer = Completer<String>();
    receivePort.listen((message) {
      completer.complete(message);
      receivePort.close();
    });
    return await completer.future;
  }

  static void _isolateListMapToJson(List args) {
    SendPort sendPort = args.first;
    List<Map<String, dynamic>> map = args[1];
    final json = jsonEncode(map);
    sendPort.send(json);
  }
}

// today
void main() async {
  final json = await (await FluentAPI.new()
          .select()
          .from('table')
          .where('name', 'like', 'a')
          .limit(10)
          .getAll())
      .toJsonAsync();

  print('json $json');
}
// proposal
void main() async {
  final json = await FluentAPI.new()
          .select()
          .from('table')
          .where('name', 'like', 'a')
          .limit(10)
          .getAll()
          .await // <- allow this
          .toJsonAsync();

  print('json $json');
}

[rubenferreira97]

I think #25 is related

[lrhn]

Functional style is why #25 is there.

Returning this like the example suggests is discouraged in Dart, where you should use cascades instead.

Allowing await inside selector chains would be nice, not only because it is over thing that doesn't work on cascades today.

I'm closing this issue, deferring to #25.

[insinfo]

Glad you already have this feature request. I failed to find issue with this feature request.

@lrhn
Why is "Returning this as the example suggests discouraged in Dart"?

[lrhn]

Why is "Returning this as the example suggests discouraged in Dart"?

Because you're expected to use cascades instead. It's even in the style guide:
https://dart.dev/effective-dart/design#avoid-returning-this-from-methods-just-to-enable-a-fluent-interface

[insinfo]

@lrhn
I thought there was some performance or depreciation problem, but I see that it's just a question of code style, right?