Warn when using a template name found in AppSupport

Author: AliSoftware

Sources/SwiftGen/Commander/TemplateCommands.swift

@@ -26,9 +26,8 @@ enum TemplateCLI {
       try output.write(
         content: """
           ---
-          You can add custom templates in \(Path.appSupportTemplates).
-          You can also specify templates by path using `templatePath` instead of `templateName`.
-          For more information, see the documentation on GitHub.
+          You can also specify custom templates by path, using `templatePath` instead of `templateName`.
+          For more information, see the documentation on GitHub or use `swiftgen template doc`.
           """
       )
     }
@@ -86,8 +85,8 @@ private extension TemplateCLI {
       templates(in: path + parser.templateFolder).map { "   - \($0.lastComponentWithoutExtension)" }
     }
     var lines = ["\(parser.name):"]
-    lines.append("  custom:")
-    lines.append(contentsOf: parserTemplates(in: Path.appSupportTemplates))
+    lines.append("  custom (deprecated):")
+    lines.append(contentsOf: parserTemplates(in: Path.deprecatedAppSupportTemplates))
     lines.append("  bundled:")
     lines.append(contentsOf: parserTemplates(in: Path.bundledTemplates))
     return lines.joined(separator: "\n")

Sources/SwiftGen/Path+CommonLocations.swift

@@ -20,7 +20,8 @@ extension Path {
     return binaryPath
   }()
 
-  static let applicationSupport: Path = {
+  // Deprecated: Remove this in SwiftGen 7.0
+  static let deprecatedApplicationSupport: Path = {
     let paths = NSSearchPathForDirectoriesInDomains(
       .applicationSupportDirectory,
       .userDomainMask,
@@ -32,7 +33,8 @@ extension Path {
     return Path(path)
   }()
 
-  static let appSupportTemplates = Path.applicationSupport + "SwiftGen/templates"
+  // Deprecated: Remove this in SwiftGen 7.0
+  static let deprecatedAppSupportTemplates = Path.deprecatedApplicationSupport + "SwiftGen/templates"
   static let bundledTemplates = binary.parent() + templatesRelativePath
 
   // MARK: Private

Sources/SwiftGen/TemplateRef.swift

@@ -45,8 +45,18 @@ enum TemplateRef: Equatable {
   func resolvePath(forParser parser: ParserCLI) throws -> Path {
     switch self {
     case .name(let templateShortName):
-      var path = Path.appSupportTemplates + parser.templateFolder + "\(templateShortName).stencil"
-      if !path.isFile {
+      var path = Path.deprecatedAppSupportTemplates + parser.templateFolder + "\(templateShortName).stencil"
+      if path.isFile {
+        logMessage(
+          .warning,
+          """
+          Refering templates in Application Support by name will be deprecated in SwiftGen 7.0.
+          For custom templates, please use `templatePath` instead of `templateName` to point to them.
+          We also recommend you move your custom templates from \(Path.deprecatedAppSupportTemplates)
+          to your project's folder so that your project is able to run independently on all machines.
+          """
+        )
+      } else {
         path = Path.bundledTemplates + parser.templateFolder + "\(templateShortName).stencil"
       }
       guard path.isFile else {