Separate out SwiftExtract, a reusable Swift analysis module

This will take a while to finish up but this introduces a new core
foundational module called `SwiftExtract` that allows for analysis of
swift code into an analysis result that then source generators -- such
as swift-java can use.

This is to prepare reuse from other language generators, with a strong
well maintianed analysis core that swift-java has spearheaded here.

This is a massive "move stuff around" so reviewing everyting might be
hard but the long term benefit will be massive.

Author: ktoso

Package.swift

@@ -108,6 +108,11 @@ let package = Package(
       targets: ["SwiftRuntimeFunctions"]
     ),
 
+    .library(
+      name: "SwiftExtract",
+      targets: ["SwiftExtract"]
+    ),
+
     .library(
       name: "JExtractSwiftLib",
       targets: ["JExtractSwiftLib"]
@@ -336,6 +341,30 @@ let package = Package(
       ]
     ),
 
+    .target(
+      name: "SwiftExtract",
+      dependencies: [
+        .product(name: "SwiftBasicFormat", package: "swift-syntax"),
+        .product(name: "SwiftIfConfig", package: "swift-syntax"),
+        .product(name: "SwiftLexicalLookup", package: "swift-syntax"),
+        .product(name: "SwiftParser", package: "swift-syntax"),
+        .product(name: "SwiftSyntax", package: "swift-syntax"),
+        .product(name: "SwiftSyntaxBuilder", package: "swift-syntax"),
+        .product(name: "Logging", package: "swift-log"),
+        "SwiftJavaConfigurationShared",
+      ],
+      path: "Sources/SwiftExtract",
+      resources: [
+        .process("Resources")
+      ],
+      swiftSettings: [
+        .swiftLanguageMode(.v5)
+      ],
+      plugins: [
+        .plugin(name: "_StaticBuildConfigPlugin")
+      ]
+    ),
+
     .target(
       name: "JExtractSwiftLib",
       dependencies: [
@@ -347,19 +376,14 @@ let package = Package(
         .product(name: "ArgumentParser", package: "swift-argument-parser"),
         .product(name: "OrderedCollections", package: "swift-collections"),
         .product(name: "SwiftJavaJNICore", package: "swift-java-jni-core"),
+        "SwiftExtract",
         "SwiftJavaShared",
         "SwiftJavaConfigurationShared",
         "CodePrinting",
       ],
-      resources: [
-        .process("Resources")
-      ],
       swiftSettings: [
         .swiftLanguageMode(.v5),
         .enableUpcomingFeature("BareSlashRegexLiterals"),
-      ],
-      plugins: [
-        .plugin(name: "_StaticBuildConfigPlugin")
       ]
     ),
 
@@ -435,13 +459,26 @@ let package = Package(
       name: "JExtractSwiftTests",
       dependencies: [
         "JExtractSwiftLib",
+        "SwiftExtract",
         "CodePrinting",
       ],
       swiftSettings: [
         .swiftLanguageMode(.v5)
       ]
     ),
 
+    .testTarget(
+      name: "SwiftExtractTests",
+      dependencies: [
+        "SwiftExtract",
+        .product(name: "SwiftSyntax", package: "swift-syntax"),
+        .product(name: "SwiftParser", package: "swift-syntax"),
+      ],
+      swiftSettings: [
+        .swiftLanguageMode(.v5)
+      ]
+    ),
+
     .testTarget(
       name: "SwiftRuntimeFunctionsTests",
       dependencies: [

Sources/JExtractSwiftLib/AnalysisResult.swift

@@ -12,6 +12,7 @@
 //
 //===----------------------------------------------------------------------===//
 
+import SwiftExtract
 import SwiftJavaConfigurationShared
 import SwiftJavaJNICore
 

Sources/JExtractSwiftLib/Common/JavaTypeAnnotations.swift

@@ -12,6 +12,7 @@
 //
 //===----------------------------------------------------------------------===//
 
+import SwiftExtract
 import SwiftJavaJNICore
 
 extension JavaType {

Sources/JExtractSwiftLib/Convenience/JavaType+Extensions.swift

@@ -15,34 +15,7 @@
 import SwiftJavaJNICore
 
 extension String {
-
-  var firstCharacterUppercased: String {
-    guard let f = first else {
-      return self
-    }
-
-    return "\(f.uppercased())\(String(dropFirst()))"
-  }
-
-  var firstCharacterLowercased: String {
-    guard let f = first else {
-      return self
-    }
-
-    return "\(f.lowercased())\(String(dropFirst()))"
-  }
-
-  /// Returns whether the string is of the format `isX`
-  var hasJavaBooleanNamingConvention: Bool {
-    guard self.hasPrefix("is"), self.count > 2 else {
-      return false
-    }
-
-    let thirdCharacterIndex = self.index(self.startIndex, offsetBy: 2)
-    return self[thirdCharacterIndex].isUppercase
-  }
-
-  /// Returns a version of the string correctly escaped for a JNI
+  /// Returns a version of the string correctly escaped for a JNI identifier
   var escapedJNIIdentifier: String {
     self.map {
       if $0 == "_" {
@@ -66,15 +39,6 @@ extension String {
     .joined()
   }
 
-  /// If the string ends with `.swift`, return it without that suffix;
-  /// otherwise return self unchanged
-  func dropSwiftFileSuffix() -> String {
-    if hasSuffix(".swift") {
-      return String(dropLast(".swift".count))
-    }
-    return self
-  }
-
   /// Looks up self as a SwiftJava wrapped class name and converts it
   /// into a `JavaType.class` if it exists in `lookupTable`.
   func parseJavaClassFromSwiftJavaName(in lookupTable: [String: String]) -> JavaType? {
@@ -87,14 +51,6 @@ extension String {
 
     return .class(package: javaPackageName, name: javaClassName)
   }
-
-  /// Unescapes the name if it is surrounded by backticks.
-  var unescapedSwiftName: String {
-    if count >= 2 && hasPrefix("`") && hasSuffix("`") {
-      return String(dropFirst().dropLast())
-    }
-    return self
-  }
 }
 
 extension Array where Element == String {

…tLib/Convenience/String+Extensions.swift …b/Convenience/String+JNIExtensions.swiftSources/JExtractSwiftLib/Convenience/String+Extensions.swift renamed to Sources/JExtractSwiftLib/Convenience/String+JNIExtensions.swift Sources/JExtractSwiftLib/Convenience/String+Extensions.swift renamed to Sources/JExtractSwiftLib/Convenience/String+JNIExtensions.swift

@@ -12,6 +12,8 @@
 //
 //===----------------------------------------------------------------------===//
 
+import SwiftExtract
+
 extension CType {
   /// Lower the given Swift type down to a its corresponding C type.
   ///

Sources/JExtractSwiftLib/FFM/CDeclLowering/CRepresentation.swift

@@ -12,6 +12,7 @@
 //
 //===----------------------------------------------------------------------===//
 
+import SwiftExtract
 import SwiftJavaJNICore
 import SwiftSyntax
 

Sources/JExtractSwiftLib/FFM/CDeclLowering/FFMSwift2JavaGenerator+FunctionLowering.swift

@@ -12,6 +12,7 @@
 //
 //===----------------------------------------------------------------------===//
 
+import SwiftExtract
 import SwiftSyntax
 import SwiftSyntaxBuilder
 

Sources/JExtractSwiftLib/FFM/ConversionStep.swift

@@ -13,6 +13,7 @@
 //===----------------------------------------------------------------------===//
 
 import CodePrinting
+import SwiftExtract
 import SwiftJavaConfigurationShared
 import SwiftJavaJNICore
 import SwiftSyntax

Sources/JExtractSwiftLib/FFM/FFMSwift2JavaGenerator+FoundationData.swift

@@ -13,6 +13,7 @@
 //===----------------------------------------------------------------------===//
 
 import CodePrinting
+import SwiftExtract
 import SwiftJavaConfigurationShared
 import SwiftJavaJNICore