build: migrate to .NET Core Local Tools (#4)

* chore: add T4 local tool
* chore: remove dotnet-cli-tool & update Mono.T4
* style: optimize t4 file
* docs: remove install dotnet-cli-tool process

Author: nogic1008

.config/dotnet-tools.json

@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "isRoot": true,
+  "tools": {
+    "dotnet-t4": {
+      "version": "2.2.1",
+      "commands": [
+        "t4"
+      ]
+    }
+  }
+}

README.md

@@ -26,22 +26,36 @@ This sample uses [Mono.TextTemplating](https://github.com/mono/t4) which is a T4
 
 ## Processes
 
-### 1. Create Project
+### 1. Install .NET local tool
 
 ```console
-> dotnet new console
+# You should create manifest file before install local tool.
+> dotnet new tool-manifest
+# Install T4 tool in local
+> dotnet tool install dotnet-t4
 ```
 
-### 2. Add `LangVersion` to .csproj
+```json
+{
+  "version": 1,
+  "isRoot": true,
+  "tools": {
+    "dotnet-t4": {
+      "version": "2.2.1",
+      "commands": [
+        "t4"
+      ]
+    }
+  }
+}
+```
 
-- Set `LangVersion` to *8.0*.
+**Note: You should call `dotnet tool restore` command after cloned repo.**
 
-```diff
-   <PropertyGroup>
-+    <LangVersion>8.0</LangVersion>
-     <OutputType>Exe</OutputType>
-     <TargetFramework>netcoreapp3.0</TargetFramework>
-   </PropertyGroup>
+### 2. Create Project
+
+```console
+> dotnet new console -n T4Sample -o ./src
 ```
 
 ### 3. Create Table and Column Entities
@@ -54,30 +68,18 @@ This sample uses [Mono.TextTemplating](https://github.com/mono/t4) which is a T4
 The program code generated by T4 file depends on this package.
 
 ```console
-> dotnet add package Mono.TextTemplating --version 2.0.5
-```
-
-### 5. Install T4 Cli Tool
-
-Add `DotNetCliToolReference` in csproj to use [dotnet-t4-project-tool](https://www.nuget.org/packages/dotnet-t4-project-tool/).
-
-```diff
-  <ItemGroup>
-+    <DotNetCliToolReference Include="dotnet-t4-project-tool" Version="2.0.5" />
-     <PackageReference Include="Mono.TextTemplating" Version="2.0.5" />
-   </ItemGroup>
+> dotnet add package Mono.TextTemplating --version 2.2.1
 ```
 
-### 6. Add Task to Prebuild and Cleanup
+### 5. Add Task to Prebuild and Cleanup
 
 #### Define Target Files
 
 Define `TextTemplate` and `Genarated` using Glob.
 
 ```diff
   <ItemGroup>
-     <DotNetCliToolReference Include="dotnet-t4-project-tool" Version="2.0.5" />
-     <PackageReference Include="Mono.TextTemplating" Version="2.0.5" />
+     <PackageReference Include="Mono.TextTemplating" Version="2.2.1" />
 +    <TextTemplate Include="**\*.tt" />
 +    <Generated Include="**\*.Generated.cs" />
    </ItemGroup>
@@ -113,7 +115,7 @@ Define Task to delete `*.Generated.cs`.
 +  </Target>
 ```
 
-### 7. Create T4 Interface and define implements
+### 6. Create T4 Interface and define implements
 
 `TransFormText()`, Called by Program to use T4 Classes are defined in *\*.Generated.cs*.
 But \*.Generated.cs is generated just before the build.
@@ -133,14 +135,14 @@ namespace T4Sample
 }
 ```
 
-### 8. Create T4 Template File & Class
+### 7. Create T4 Template File & Class
 
 Note that T4 class should be defined with `partial` class.
 
 - [TableEntityTemplate.tt](./src/TableEntityTemplate.tt)
 - [TableEntityTemplate.cs](./src/TableEntityTemplate.cs)
 
-### 9. Call T4 Class in Program.cs
+### 8. Call T4 Class in Program.cs
 
 Note that variable type should be an interface. **Don't** use `var` or `TableEntityTemplate`.
 

src/T4Sample.csproj

@@ -6,8 +6,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <DotNetCliToolReference Include="dotnet-t4-project-tool" Version="2.0.5" />
-    <PackageReference Include="Mono.TextTemplating" Version="2.0.5" />
+    <PackageReference Include="Mono.TextTemplating" Version="2.2.1" />
     <TextTemplate Include="**\*.tt" />
     <Generated Include="**\*.Generated.cs" />
   </ItemGroup>

src/TableEntityTemplate.tt

@@ -1,69 +1,44 @@
 <#@ template language="C#" #>
 <#@ assembly name="System.Core" #>
 <#@ import namespace="System.Linq" #>
-<#@ import namespace="System.Collections.Generic" #>
+<#@ output extension=".cs" #>
 using System;
 using System.Collections.Generic;
 
 namespace <#= NameSpace #>
 {
-<#
-    if (!string.IsNullOrEmpty(Table.Description))
-    {
-#>
+<# if (!string.IsNullOrEmpty(Table.Description)) { #>
     /// <summery>
     /// <#= Table.Description #>
     /// </summery>
-<#
-    }
-#>
+<# } #>
     public class <#= Table.Name.ToPascalCase() #>
     {
-<#
-        foreach (var x in Table.Columns)
-        {
-#>
-<#
-            if (!string.IsNullOrEmpty(x.Description))
-            {
-#>
+<# foreach (var x in Table.Columns) { #>
+<# if (!string.IsNullOrEmpty(x.Description)) { #>
         /// <summery>
         /// <#= x.Description #>
         /// </summery>
-<#
-            }
-#>
+<# } // End if #>
         public <#= GetColumnType(x) #> <#= x.Name.ToPascalCase() #> { get; <#= x.IsPrimary ? "" : "set; " #>}
 
-<#
-        }
-#>
+<# } // End foreach #>
         public <#= Table.Name.ToPascalCase() #>(
             <#= string.Join(",\n            ", Table.Columns.Where(x => x.IsPrimary).Select(d => $"{GetColumnType(d)} {d.Name.ToCamelCase()}")) #>
         )
         {
-<#
-            foreach (var x in Table.Columns.Where(x => x.IsPrimary))
-            {
-#>
+<# foreach (var x in Table.Columns.Where(x => x.IsPrimary)) { #>
             <#= x.Name.ToPascalCase() #> = <#= x.Name.ToCamelCase() #>;
-<#
-            }
-#>
+<# } #>
         }
 
         public <#= Table.Name.ToPascalCase() #>(
             <#= string.Join(",\n            ", Table.Columns.Select(d => $"{GetColumnType(d)} {d.Name.ToCamelCase()}")) #>
         )
         {
-<#
-            foreach (var x in Table.Columns)
-            {
-#>
+<# foreach (var x in Table.Columns) { #>
             <#= x.Name.ToPascalCase() #> = <#= x.Name.ToCamelCase() #>;
-<#
-            }
-#>
+<# } #>
         }
     }
 }