1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105
|
//
// This source file is part of the Swift.org open source project
//
// Copyright (c) 2023 Apple Inc. and the Swift project authors
// Licensed under Apache License v2.0 with Runtime Library Exception
//
// See https://swift.org/LICENSE.txt for license information
// See https://swift.org/CONTRIBUTORS.txt for Swift project authors
//
extension __Expression {
/// Create an instance of this type representing a complete syntax node.
///
/// - Parameters:
/// - syntaxNode: The complete syntax node (expression, declaration,
/// statement, etc.)
///
/// - Returns: A new instance of this type.
///
/// - Warning: This function is used to implement the `@Test`, `@Suite`,
/// `#expect()` and `#require()` macros. Do not call it directly.
public static func __fromSyntaxNode(_ syntaxNode: String) -> Self {
Self(kind: .generic(syntaxNode))
}
/// Create an instance of this type representing a string literal.
///
/// - Parameters:
/// - sourceCode: The source code representation of the string literal,
/// including leading and trailing punctuation.
/// - stringValue: The actual string value of the string literal
///
/// - Returns: A new instance of this type.
///
/// - Warning: This function is used to implement the `@Test`, `@Suite`,
/// `#expect()` and `#require()` macros. Do not call it directly.
public static func __fromStringLiteral(_ sourceCode: String, _ stringValue: String) -> Self {
Self(kind: .stringLiteral(sourceCode: sourceCode, stringValue: stringValue))
}
/// Create an instance of this type representing a binary operation.
///
/// - Parameters:
/// - lhs: The left-hand operand.
/// - op: The operator.
/// - rhs: The right-hand operand.
///
/// - Returns: A new instance of this type.
///
/// - Warning: This function is used to implement the `@Test`, `@Suite`,
/// `#expect()` and `#require()` macros. Do not call it directly.
public static func __fromBinaryOperation(_ lhs: Self, _ op: String, _ rhs: Self) -> Self {
return Self(kind: .binaryOperation(lhs: lhs, operator: op, rhs: rhs))
}
/// Create an instance of this type representing a function call.
///
/// - Parameters:
/// - value: The value on which the member function is being invoked, if
/// any.
/// - functionName: The name of the member function.
/// - argumentLabel: Optionally, the argument label.
/// - argumentValue: The value of the argument to the function.
///
/// - Returns: A new instance of this type.
///
/// - Warning: This function is used to implement the `@Test`, `@Suite`,
/// `#expect()` and `#require()` macros. Do not call it directly.
public static func __fromFunctionCall(_ value: Self?, _ functionName: String, _ arguments: (label: String?, value: Self)...) -> Self {
let arguments = arguments.map(Kind.FunctionCallArgument.init)
return Self(kind: .functionCall(value: value, functionName: functionName, arguments: arguments))
}
/// Create an instance of this type representing a property access.
///
/// - Parameters:
/// - value: The value whose property was accessed.
/// - keyPath: The key path, relative to `value`, that was accessed, not
/// including a leading backslash or period.
///
/// - Returns: A new instance of this type.
///
/// - Warning: This function is used to implement the `@Test`, `@Suite`,
/// `#expect()` and `#require()` macros. Do not call it directly.
public static func __fromPropertyAccess(_ value: Self, _ keyPath: Self) -> Self {
return Self(kind: .propertyAccess(value: value, keyPath: keyPath))
}
/// Create an instance of this type representing a negated expression
/// using the `!` operator..
///
/// - Parameters:
/// - expression: The expression that was negated.
/// - isParenthetical: Whether or not `expression` was enclosed in
/// parentheses (and the `!` operator was outside it.) This argument
/// affects how this expression is represented as a string.
///
/// - Returns: A new instance of this type.
///
/// - Warning: This function is used to implement the `@Test`, `@Suite`,
/// `#expect()` and `#require()` macros. Do not call it directly.
public static func __fromNegation(_ expression: Self, _ isParenthetical: Bool) -> Self {
return Self(kind: .negation(expression, isParenthetical: isParenthetical))
}
}
|