LanguageFeatures/Records/metadata_annotations_A01_t02.dart

// Copyright (c) 2022, the Dart project authors.  Please see the AUTHORS file
// for details. All rights reserved. Use of this source code is governed by a
// BSD-style license that can be found in the LICENSE file.

/// @assertion @metadata (a, b) function() {}
/// This could be a metadata annotation @metadata(a, b) associated with a
/// function declaration with no return type. Or it could be a metadata
/// annotation @metadata associated with a function whose return type is the
/// record type (a, b).
///
/// In practice, idiomatically written code is clear thanks to whitespace:
///
/// @metadata(a, b) function() {}
///
/// @metadata (a, b) function() {}
///
/// The former applies (a, b) to the metadata annotation and the latter is a
/// return type. We disambiguate in the same way, by making whitespace after a
/// metadata annotation name significant. Change the grammar to:
///
/// metadatum ::= identifier                                 // Existing rule.
///             | qualifiedName                              // Existing rule.
///             | constructorDesignation NO_SPACE arguments  // Changed.
/// The NO_SPACE lexical rule matches when there are no whitespace characters or
/// comments (according to the existing WHITESPACE and COMMENT lexical rules)
/// between the constructorDesignation and arguments. In other words, for an
/// argument list to be part of the metadata annotation, the ( must occur
/// immediately after the last character in the constructorDesignation. The last
/// character in constructorDesignation may be an identifier or the > in a type
/// argument list.
///
/// @description Checks that if there is a space between @metadata and (a, b)
/// then (a, b) denotes a record. Test functions with comment between a
/// metadata and a return type
/// @author sgrekhov22@gmail.com

import "../../Utils/expect.dart";

const Meta = "meta";

@Meta/* comment */(int, String) foo1() => (1, "2");

@Meta// comment
(int, String) foo2() => (3, "4");

@Meta /* comment */() foo3() => ();

@Meta// comment
() foo4() => ();

@Meta/* comment */ (int, {String name}) foo5() => (5, name: "name");

@Meta /* comment */ (int, {String name}) foo6() => (6, name: "name");

main() {
  Expect.equals(1, foo1().$1);
  Expect.equals("2", foo1().$2);
  Expect.equals(3, foo2().$1);
  Expect.equals("4", foo2().$2);
  Expect.equals((), foo3());
  Expect.equals((), foo4());
  Expect.equals(5, foo5().$1);
  Expect.equals("name", foo5().name);
  Expect.equals(6, foo6().$1);
  Expect.equals("name", foo6().name);
}