Merge branch 'develop' for 4.2.0 release

Author: mobrien-ghost

README.md

@@ -336,7 +336,7 @@ Currently, SyntaxSparrow supports Swift Package Manager (SPM).
 To add SyntaxSparrow to your project, add the following line to your dependencies in your Package.swift file:
 
 ```swift
-.package(url: "https://github.com/CheekyGhost-Labs/SyntaxSparrow", from: "4.1.0")
+.package(url: "https://github.com/CheekyGhost-Labs/SyntaxSparrow", from: "4.2.0")
 ```
 
 Then, add SyntaxSparrow as a dependency for your target:

Sources/SyntaxSparrow/Public/Semantics/Components/Accessor.swift

@@ -87,6 +87,26 @@ public struct Accessor: DeclarationComponent, SyntaxChildCollecting {
     /// ```
     public let body: CodeBlock?
 
+    /// Returns `true` when the ``Accessor/effectSpecifiers`` has the `throw` keyword.
+    ///
+    /// For example, the following would return `true`:
+    /// ```swift
+    /// func example() throws
+    /// ```
+    public var isThrowing: Bool {
+        return effectSpecifiers?.throwsSpecifier != nil
+    }
+
+    /// Returns `true` when the ``Accessor/effectSpecifiers`` has the `throw` keyword.
+    ///
+    /// For example, the following would return `true`:
+    /// ```swift
+    /// func example() async
+    /// ```
+    public var isAsync: Bool {
+        return effectSpecifiers?.asyncSpecifier != nil
+    }
+
     // MARK: - Properties: SyntaxChildCollecting
 
     public var childCollection: DeclarationCollection {

Sources/SyntaxSparrow/Public/Semantics/Components/Closure.swift

@@ -88,6 +88,26 @@ public struct Closure: DeclarationComponent {
     /// **Note:** `effectSpecifiers` will be `nil` if no specifiers are found on the node.
     public var effectSpecifiers: EffectSpecifiers? { resolver.resolveEffectSpecifiers() }
 
+    /// Returns `true` when the ``Closure/effectSpecifiers`` has the `throw` keyword.
+    ///
+    /// For example, the following would return `true`:
+    /// ```swift
+    /// func example() throws
+    /// ```
+    public var isThrowing: Bool {
+        return effectSpecifiers?.throwsSpecifier != nil
+    }
+
+    /// Returns `true` when the ``Closure/effectSpecifiers`` has the `throw` keyword.
+    ///
+    /// For example, the following would return `true`:
+    /// ```swift
+    /// func example() async
+    /// ```
+    public var isAsync: Bool {
+        return effectSpecifiers?.asyncSpecifier != nil
+    }
+
     // MARK: - Properties: Convenience
 
     private(set) var resolver: ClosureSemanticsResolver

Sources/SyntaxSparrow/Public/Semantics/Declarations/Function.swift

@@ -72,7 +72,7 @@ public struct Function: Declaration, SyntaxChildCollecting {
         @available(
             *,
             deprecated,
-            message: "`throwsOrRethrowsKeyword` will be deprecated in 2.0 - Please use `effectSpecifiers.throwsSpecifier` instead"
+            message: "`throwsOrRethrowsKeyword` will be deprecated in 5.0 - Please use `effectSpecifiers.throwsSpecifier` instead"
         )
         public var throwsOrRethrowsKeyword: String? {
             effectSpecifiers?.throwsSpecifier
@@ -83,7 +83,7 @@ public struct Function: Declaration, SyntaxChildCollecting {
         @available(
             *,
             deprecated,
-            message: "`asyncKeyword` will be deprecated in 2.0 - Please use `effectSpecifiers.asyncSpecifier` instead"
+            message: "`asyncKeyword` will be deprecated in 5.0 - Please use `effectSpecifiers.asyncSpecifier` instead"
         )
         public var asyncKeyword: String? {
             effectSpecifiers?.asyncSpecifier
@@ -204,6 +204,7 @@ public struct Function: Declaration, SyntaxChildCollecting {
     public var isAsync: Bool {
         return signature.effectSpecifiers?.asyncSpecifier != nil
     }
+
     // MARK: - Properties: Resolving
 
     private(set) var resolver: FunctionSemanticsResolver

Sources/SyntaxSparrow/Public/Semantics/Declarations/Initializer.swift

@@ -71,7 +71,7 @@ public struct Initializer: Declaration, SyntaxChildCollecting {
     @available(
         *,
         deprecated,
-        message: "`throwsOrRethrowsKeyword` will be deprecated in 2.0 - Please use `effectSpecifiers.throwsSpecifier` instead"
+        message: "`throwsOrRethrowsKeyword` will be deprecated in 5.0 - Please use `effectSpecifiers.throwsSpecifier` instead"
     )
     public var throwsOrRethrowsKeyword: String? { effectSpecifiers?.throwsSpecifier }
 
@@ -90,6 +90,26 @@ public struct Initializer: Declaration, SyntaxChildCollecting {
     /// **Note:** `effectSpecifiers` will be `nil` if no specifiers are found on the node.
     public var effectSpecifiers: EffectSpecifiers? { resolver.resolveEffectSpecifiers() }
 
+    /// Returns `true` when the ``Initializer/effectSpecifiers`` has the `throw` keyword.
+    ///
+    /// For example, the following would return `true`:
+    /// ```swift
+    /// func example() throws
+    /// ```
+    public var isThrowing: Bool {
+        return effectSpecifiers?.throwsSpecifier != nil
+    }
+
+    /// Returns `true` when the ``Initializer/effectSpecifiers`` has the `throw` keyword.
+    ///
+    /// For example, the following would return `true`:
+    /// ```swift
+    /// func example() async
+    /// ```
+    public var isAsync: Bool {
+        return effectSpecifiers?.asyncSpecifier != nil
+    }
+
     /// Struct representing the body of the function.
     ///
     /// For example in the following declaration:

SyntaxSparrow.doccarchive/data/documentation/syntaxsparrow.json

@@ -1 +1 @@
-{"metadata":{"extendedModule":"Swift","role":"symbol","title":"!=(_:_:)","fragments":[{"kind":"keyword","text":"static"},{"kind":"text","text":" "},{"text":"func","kind":"keyword"},{"kind":"text","text":" "},{"text":"!=","kind":"identifier"},{"kind":"text","text":" "},{"kind":"text","text":"("},{"text":"Self","kind":"typeIdentifier"},{"text":", ","kind":"text"},{"kind":"typeIdentifier","text":"Self"},{"text":") -> ","kind":"text"},{"text":"Bool","kind":"typeIdentifier","preciseIdentifier":"s:Sb"}],"modules":[{"name":"SyntaxSparrow","relatedModules":["Swift"]}],"symbolKind":"op","externalID":"s:SQsE2neoiySbx_xtFZ::SYNTHESIZED::s:13SyntaxSparrow8AccessorV","roleHeading":"Operator"},"variants":[{"traits":[{"interfaceLanguage":"swift"}],"paths":["\/documentation\/syntaxsparrow\/accessor\/!=(_:_:)"]}],"schemaVersion":{"minor":3,"patch":0,"major":0},"primaryContentSections":[{"declarations":[{"languages":["swift"],"tokens":[{"kind":"keyword","text":"static"},{"text":" ","kind":"text"},{"text":"func","kind":"keyword"},{"text":" ","kind":"text"},{"kind":"identifier","text":"!="},{"text":" ","kind":"text"},{"text":"(","kind":"text"},{"kind":"internalParam","text":"lhs"},{"kind":"text","text":": "},{"text":"Self","kind":"typeIdentifier"},{"kind":"text","text":", "},{"text":"rhs","kind":"internalParam"},{"kind":"text","text":": "},{"kind":"typeIdentifier","text":"Self"},{"kind":"text","text":") -> "},{"kind":"typeIdentifier","text":"Bool","preciseIdentifier":"s:Sb"}],"platforms":["macOS"]}],"kind":"declarations"}],"hierarchy":{"paths":[["doc:\/\/SyntaxSparrow\/documentation\/SyntaxSparrow","doc:\/\/SyntaxSparrow\/documentation\/SyntaxSparrow\/Accessor","doc:\/\/SyntaxSparrow\/documentation\/SyntaxSparrow\/Accessor\/Equatable-Implementations"]]},"kind":"symbol","sections":[],"identifier":{"interfaceLanguage":"swift","url":"doc:\/\/SyntaxSparrow\/documentation\/SyntaxSparrow\/Accessor\/!=(_:_:)"},"abstract":[{"text":"Inherited from ","type":"text"},{"type":"codeVoice","code":"Equatable.!=(_:_:)"},{"text":".","type":"text"}],"references":{"doc://SyntaxSparrow/documentation/SyntaxSparrow/Accessor/!=(_:_:)":{"type":"topic","title":"!=(_:_:)","url":"\/documentation\/syntaxsparrow\/accessor\/!=(_:_:)","identifier":"doc:\/\/SyntaxSparrow\/documentation\/SyntaxSparrow\/Accessor\/!=(_:_:)","kind":"symbol","role":"symbol","abstract":[],"fragments":[{"text":"static","kind":"keyword"},{"text":" ","kind":"text"},{"kind":"keyword","text":"func"},{"kind":"text","text":" "},{"kind":"identifier","text":"!="},{"kind":"text","text":" "},{"text":"(","kind":"text"},{"kind":"typeIdentifier","text":"Self"},{"text":", ","kind":"text"},{"kind":"typeIdentifier","text":"Self"},{"kind":"text","text":") -> "},{"preciseIdentifier":"s:Sb","text":"Bool","kind":"typeIdentifier"}]},"doc://SyntaxSparrow/documentation/SyntaxSparrow":{"kind":"symbol","role":"collection","type":"topic","identifier":"doc:\/\/SyntaxSparrow\/documentation\/SyntaxSparrow","url":"\/documentation\/syntaxsparrow","abstract":[],"title":"SyntaxSparrow"},"doc://SyntaxSparrow/documentation/SyntaxSparrow/Accessor":{"type":"topic","kind":"symbol","url":"\/documentation\/syntaxsparrow\/accessor","role":"symbol","title":"Accessor","identifier":"doc:\/\/SyntaxSparrow\/documentation\/SyntaxSparrow\/Accessor","fragments":[{"kind":"keyword","text":"struct"},{"text":" ","kind":"text"},{"text":"Accessor","kind":"identifier"}],"navigatorTitle":[{"text":"Accessor","kind":"identifier"}],"abstract":[{"type":"text","text":"Represents a Swift accessor declaration."}]},"doc://SyntaxSparrow/documentation/SyntaxSparrow/Accessor/Equatable-Implementations":{"type":"topic","title":"Equatable Implementations","identifier":"doc:\/\/SyntaxSparrow\/documentation\/SyntaxSparrow\/Accessor\/Equatable-Implementations","url":"\/documentation\/syntaxsparrow\/accessor\/equatable-implementations","kind":"article","role":"collectionGroup","abstract":[]}}}
+{"primaryContentSections":[{"kind":"declarations","declarations":[{"tokens":[{"text":"static","kind":"keyword"},{"kind":"text","text":" "},{"text":"func","kind":"keyword"},{"text":" ","kind":"text"},{"kind":"identifier","text":"!="},{"kind":"text","text":" "},{"text":"(","kind":"text"},{"text":"lhs","kind":"internalParam"},{"kind":"text","text":": "},{"kind":"typeIdentifier","text":"Self"},{"kind":"text","text":", "},{"kind":"internalParam","text":"rhs"},{"kind":"text","text":": "},{"kind":"typeIdentifier","text":"Self"},{"text":") -> ","kind":"text"},{"preciseIdentifier":"s:Sb","kind":"typeIdentifier","text":"Bool"}],"languages":["swift"],"platforms":["macOS"]}]}],"variants":[{"traits":[{"interfaceLanguage":"swift"}],"paths":["\/documentation\/syntaxsparrow\/accessor\/!=(_:_:)"]}],"sections":[],"schemaVersion":{"patch":0,"major":0,"minor":3},"metadata":{"extendedModule":"Swift","title":"!=(_:_:)","externalID":"s:SQsE2neoiySbx_xtFZ::SYNTHESIZED::s:13SyntaxSparrow8AccessorV","roleHeading":"Operator","symbolKind":"op","modules":[{"name":"SyntaxSparrow","relatedModules":["Swift"]}],"fragments":[{"kind":"keyword","text":"static"},{"kind":"text","text":" "},{"kind":"keyword","text":"func"},{"text":" ","kind":"text"},{"kind":"identifier","text":"!="},{"kind":"text","text":" "},{"text":"(","kind":"text"},{"text":"Self","kind":"typeIdentifier"},{"text":", ","kind":"text"},{"text":"Self","kind":"typeIdentifier"},{"kind":"text","text":") -> "},{"preciseIdentifier":"s:Sb","text":"Bool","kind":"typeIdentifier"}],"role":"symbol"},"abstract":[{"type":"text","text":"Inherited from "},{"type":"codeVoice","code":"Equatable.!=(_:_:)"},{"text":".","type":"text"}],"hierarchy":{"paths":[["doc:\/\/SyntaxSparrow\/documentation\/SyntaxSparrow","doc:\/\/SyntaxSparrow\/documentation\/SyntaxSparrow\/Accessor","doc:\/\/SyntaxSparrow\/documentation\/SyntaxSparrow\/Accessor\/Equatable-Implementations"]]},"kind":"symbol","identifier":{"interfaceLanguage":"swift","url":"doc:\/\/SyntaxSparrow\/documentation\/SyntaxSparrow\/Accessor\/!=(_:_:)"},"references":{"doc://SyntaxSparrow/documentation/SyntaxSparrow/Accessor/Equatable-Implementations":{"title":"Equatable Implementations","type":"topic","kind":"article","role":"collectionGroup","abstract":[],"identifier":"doc:\/\/SyntaxSparrow\/documentation\/SyntaxSparrow\/Accessor\/Equatable-Implementations","url":"\/documentation\/syntaxsparrow\/accessor\/equatable-implementations"},"doc://SyntaxSparrow/documentation/SyntaxSparrow/Accessor":{"abstract":[{"text":"Represents a Swift accessor declaration.","type":"text"}],"role":"symbol","type":"topic","navigatorTitle":[{"text":"Accessor","kind":"identifier"}],"identifier":"doc:\/\/SyntaxSparrow\/documentation\/SyntaxSparrow\/Accessor","kind":"symbol","url":"\/documentation\/syntaxsparrow\/accessor","fragments":[{"kind":"keyword","text":"struct"},{"kind":"text","text":" "},{"kind":"identifier","text":"Accessor"}],"title":"Accessor"},"doc://SyntaxSparrow/documentation/SyntaxSparrow/Accessor/!=(_:_:)":{"title":"!=(_:_:)","type":"topic","kind":"symbol","role":"symbol","abstract":[],"fragments":[{"text":"static","kind":"keyword"},{"text":" ","kind":"text"},{"text":"func","kind":"keyword"},{"kind":"text","text":" "},{"text":"!=","kind":"identifier"},{"kind":"text","text":" "},{"kind":"text","text":"("},{"kind":"typeIdentifier","text":"Self"},{"kind":"text","text":", "},{"text":"Self","kind":"typeIdentifier"},{"text":") -> ","kind":"text"},{"kind":"typeIdentifier","preciseIdentifier":"s:Sb","text":"Bool"}],"identifier":"doc:\/\/SyntaxSparrow\/documentation\/SyntaxSparrow\/Accessor\/!=(_:_:)","url":"\/documentation\/syntaxsparrow\/accessor\/!=(_:_:)"},"doc://SyntaxSparrow/documentation/SyntaxSparrow":{"abstract":[],"url":"\/documentation\/syntaxsparrow","type":"topic","identifier":"doc:\/\/SyntaxSparrow\/documentation\/SyntaxSparrow","kind":"symbol","role":"collection","title":"SyntaxSparrow"}}}