feat: add Async suffix to generated methods by default

Author: SockworkOrange

Drivers/Generators/CopyFromDeclareGen.cs

@@ -9,7 +9,7 @@ public class CopyFromDeclareGen(DbDriver dbDriver)
     public MemberDeclarationSyntax Generate(string queryTextConstant, string argInterface, Query query)
     {
         return ParseMemberDeclaration($$"""
-            public async Task {{query.Name}}(List<{{argInterface}}> args)
+            public async Task {{query.Name.ToMethodName(dbDriver.Options.WithAsyncSuffix)}}(List<{{argInterface}}> args)
             {
                 {{((ICopyFrom)dbDriver).GetCopyFromImpl(query, queryTextConstant)}}
             }

Drivers/Generators/ExecDeclareGen.cs

@@ -13,7 +13,7 @@ public MemberDeclarationSyntax Generate(string queryTextConstant, string argInte
     {
         var parametersStr = CommonGen.GetMethodParameterList(argInterface, query.Params);
         return ParseMemberDeclaration($$"""
-            public async Task {{query.Name}}({{parametersStr}})
+            public async Task {{query.Name.ToMethodName(dbDriver.Options.WithAsyncSuffix)}}({{parametersStr}})
             {
                 {{GetMethodBody(queryTextConstant, query)}}
             }

Drivers/Generators/ExecLastIdDeclareGen.cs

@@ -13,7 +13,7 @@ public MemberDeclarationSyntax Generate(string queryTextConstant, string argInte
     {
         var parametersStr = CommonGen.GetMethodParameterList(argInterface, query.Params);
         return ParseMemberDeclaration($$"""
-            public async Task<{{dbDriver.GetIdColumnType(query)}}> {{query.Name}}({{parametersStr}})
+            public async Task<{{dbDriver.GetIdColumnType(query)}}> {{query.Name.ToMethodName(dbDriver.Options.WithAsyncSuffix)}}({{parametersStr}})
             {
                 {{GetMethodBody(queryTextConstant, query)}}
             }

Drivers/Generators/ExecRowsDeclareGen.cs

@@ -13,7 +13,7 @@ public MemberDeclarationSyntax Generate(string queryTextConstant, string argInte
     {
         var parametersStr = CommonGen.GetMethodParameterList(argInterface, query.Params);
         return ParseMemberDeclaration($$"""
-            public async Task<long> {{query.Name}}({{parametersStr}})
+            public async Task<long> {{query.Name.ToMethodName(dbDriver.Options.WithAsyncSuffix)}}({{parametersStr}})
             {
                 {{GetMethodBody(queryTextConstant, query)}}
             }

Drivers/Generators/ManyDeclareGen.cs

@@ -15,7 +15,7 @@ public MemberDeclarationSyntax Generate(string queryTextConstant, string argInte
         var parametersStr = CommonGen.GetMethodParameterList(argInterface, query.Params);
         var returnType = $"Task<List<{returnInterface}>>";
         return ParseMemberDeclaration($$"""
-            public async {{returnType}} {{query.Name}}({{parametersStr}})
+            public async {{returnType}} {{query.Name.ToMethodName(dbDriver.Options.WithAsyncSuffix)}}({{parametersStr}})
             {
                 {{GetMethodBody(queryTextConstant, returnInterface, query)}}
             }

Drivers/Generators/OneDeclareGen.cs

@@ -15,7 +15,7 @@ public MemberDeclarationSyntax Generate(string queryTextConstant, string argInte
         var returnType = $"Task<{dbDriver.AddNullableSuffixIfNeeded(returnInterface, false)}>";
         var parametersStr = CommonGen.GetMethodParameterList(argInterface, query.Params);
         return ParseMemberDeclaration($$"""
-            public async {{returnType}} {{query.Name}}({{parametersStr}})
+            public async {{returnType}} {{query.Name.ToMethodName(dbDriver.Options.WithAsyncSuffix)}}({{parametersStr}})
             {
                 {{GetMethodBody(queryTextConstant, returnInterface, query)}}
             }

Extensions/StringExtensions.cs

@@ -51,6 +51,12 @@ public static string ToModelName(this string value, string schema, string defaul
         return $"{schemaName}_{value.TrimEnd('s')}".ToPascalCase(); // TODO implement better way to turn words to singular
     }
 
+    public static string ToMethodName(this string value, bool withAsyncSuffix)
+    {
+        var methodName = value.ToPascalCase();
+        return withAsyncSuffix ? $"{methodName}Async" : methodName;
+    }
+
     public static string AppendSemicolonUnlessEmpty(this string input)
     {
         return input == string.Empty ? "" : $"{input};";

PluginOptions/Options.cs

@@ -25,7 +25,8 @@ public Options(GenerateRequest generateRequest)
         NamespaceName = rawOptions.NamespaceName;
         DotnetFramework = DotnetFrameworkExtensions.ParseName(rawOptions.TargetFramework);
         Overrides = rawOptions.Overrides ?? [];
-
+        WithAsyncSuffix = rawOptions.WithAsyncSuffix;
+        
         if (rawOptions.DebugRequest && generateRequest.Settings.Codegen.Wasm is not null)
             throw new ArgumentException("Debug request mode cannot be used with WASM plugin");
         DebugRequest = rawOptions.DebugRequest;
@@ -57,6 +58,8 @@ public Options(GenerateRequest generateRequest)
     /// </summary>
     public bool UseCentralPackageManagement { get; }
 
+    public bool WithAsyncSuffix { get; }
+
     private static readonly Dictionary<string, DriverName> EngineToDriverMapping = new()
     {
         { "mysql", DriverName.MySqlConnector },

PluginOptions/RawOptions.cs

@@ -9,7 +9,7 @@ public record RawOptions
     public string OverrideDriverVersion { get; init; } = string.Empty;
 
     [JsonPropertyName("generateCsproj")]
-    public bool GenerateCsproj { get; init; } = true; // generating .csproj files by default
+    public bool GenerateCsproj { get; init; } = true;
 
     [JsonPropertyName("targetFramework")]
     public string TargetFramework { get; init; } = DotnetFramework.Dotnet80.ToName();
@@ -31,6 +31,9 @@ public record RawOptions
 
     [JsonPropertyName("useCentralPackageManagement")]
     public bool UseCentralPackageManagement { get; init; }
+
+    [JsonPropertyName("withAsyncSuffix")]
+    public bool WithAsyncSuffix { get; init; } = true;
 }
 
 public class OverrideOption

end2end/EndToEndScaffold/Consts.cs

@@ -20,7 +20,7 @@ public static class Consts
     public const string GenericQuote2 = "\"Only 2 things are infinite, the universe and human stupidity\"";
 
     public static readonly string CreateBojackAuthor = $$"""
-         await this.QuerySql.CreateAuthor(new QuerySql.CreateAuthorArgs 
+         await this.QuerySql.CreateAuthorAsync(new QuerySql.CreateAuthorArgs 
          {
              Id = {{BojackId}},
              Name = {{BojackAuthor}},
@@ -29,23 +29,23 @@ await this.QuerySql.CreateAuthor(new QuerySql.CreateAuthorArgs
          """;
 
     public const string CreateBojackAuthorWithId = $$"""
-         var bojackId = await this.QuerySql.CreateAuthorReturnId(new QuerySql.CreateAuthorReturnIdArgs 
+         var bojackId = await this.QuerySql.CreateAuthorReturnIdAsync(new QuerySql.CreateAuthorReturnIdArgs 
          {
              Name = {{BojackAuthor}},
              Bio = {{BojackTheme}}
          });
          """;
 
     public const string CreateBookByBojack = $$"""
-           var bojackBookId = await QuerySql.CreateBook(new QuerySql.CreateBookArgs
+           var bojackBookId = await QuerySql.CreateBookAsync(new QuerySql.CreateBookArgs
            {
                Name = {{BojackBookTitle}},
                AuthorId = bojackId
            });
            """;
 
     public static readonly string CreateDrSeussAuthor = $$"""
-          await this.QuerySql.CreateAuthor(new QuerySql.CreateAuthorArgs 
+          await this.QuerySql.CreateAuthorAsync(new QuerySql.CreateAuthorArgs 
           {
               Id = {{DrSeussId}},
               Name = {{DrSeussAuthor}},
@@ -54,31 +54,31 @@ await this.QuerySql.CreateAuthor(new QuerySql.CreateAuthorArgs
           """;
 
     public const string CreateDrSeussAuthorWithId = $$"""
-      var drSeussId = await this.QuerySql.CreateAuthorReturnId(new QuerySql.CreateAuthorReturnIdArgs
+      var drSeussId = await this.QuerySql.CreateAuthorReturnIdAsync(new QuerySql.CreateAuthorReturnIdArgs
       {
           Name = {{DrSeussAuthor}},
           Bio = {{DrSeussQuote}}
       });
       """;
 
     public const string CreateBookByDrSeuss = $$"""
-        var drSeussBookId = await QuerySql.CreateBook(new QuerySql.CreateBookArgs
+        var drSeussBookId = await QuerySql.CreateBookAsync(new QuerySql.CreateBookArgs
         {
             AuthorId = drSeussId,
             Name = {{DrSeussBookTitle}}
         });
         """;
 
     public const string CreateFirstGenericAuthor = $$"""
-         var id1 = await this.QuerySql.CreateAuthorReturnId(new QuerySql.CreateAuthorReturnIdArgs
+         var id1 = await this.QuerySql.CreateAuthorReturnIdAsync(new QuerySql.CreateAuthorReturnIdArgs
          {
              Name = {{GenericAuthor}},
              Bio = {{GenericQuote1}}
          });
          """;
 
     public const string CreateSecondGenericAuthor = $$"""
-          var id2 = await this.QuerySql.CreateAuthorReturnId(new QuerySql.CreateAuthorReturnIdArgs
+          var id2 = await this.QuerySql.CreateAuthorReturnIdAsync(new QuerySql.CreateAuthorReturnIdArgs
           {
               Name = {{GenericAuthor}},
               Bio = {{GenericQuote2}}