-
Notifications
You must be signed in to change notification settings - Fork 256
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* Add initial source generator samples - Add samples - Add demo consumption project - Add readme - Update global.json
- Loading branch information
Showing
14 changed files
with
573 additions
and
3 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,12 +1,12 @@ | ||
| { | ||
| "tools": { | ||
| "dotnet": "3.0.101", | ||
| "dotnet": "3.1.300-preview-015115", | ||
| "vs": { | ||
| "version": "16.3" | ||
| "version": "16.6" | ||
| }, | ||
| "xcopy-msbuild": "16.3.0-alpha" | ||
| }, | ||
| "msbuild-sdks": { | ||
| "Microsoft.DotNet.Arcade.Sdk": "5.0.0-beta.20117.3" | ||
| "Microsoft.DotNet.Arcade.Sdk": "5.0.0-beta.20224.11" | ||
| } | ||
| } |
24 changes: 24 additions & 0 deletions
24
samples/CSharp/SourceGenerators/GeneratedDemo/GeneratedDemo.csproj
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,24 @@ | ||
| <Project Sdk="Microsoft.NET.Sdk"> | ||
|
|
||
| <PropertyGroup> | ||
| <OutputType>Exe</OutputType> | ||
| <TargetFramework>netcoreapp3.1</TargetFramework> | ||
| <LangVersion>preview</LangVersion> | ||
| </PropertyGroup> | ||
|
|
||
| <ItemGroup> | ||
| <AdditionalFiles Include="MainSettings.xmlsettings" /> | ||
| <None Include="MainSettings.xmlsettings"> | ||
| <CopyToOutputDirectory>Always</CopyToOutputDirectory> | ||
| </None> | ||
| </ItemGroup> | ||
|
|
||
| <ItemGroup> | ||
| <Analyzer Include="$(OutDir)\..\..\..\SourceGeneratorSamples\$(Configuration)\netstandard2.0\SourceGeneratorSamples.dll" /> | ||
| </ItemGroup> | ||
|
|
||
| <ItemGroup> | ||
| <ProjectReference Include="..\SourceGeneratorSamples\SourceGeneratorSamples.csproj" /> | ||
| </ItemGroup> | ||
|
|
||
| </Project> |
5 changes: 5 additions & 0 deletions
5
samples/CSharp/SourceGenerators/GeneratedDemo/MainSettings.xmlsettings
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,5 @@ | ||
| <?xml version="1.0" encoding="utf-8" ?> | ||
| <Settings name="Main"> | ||
| <Setting name="FirstRun" type="bool">false</Setting> | ||
| <Setting name="CacheSize" type="int">1234</Setting> | ||
| </Settings> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,20 @@ | ||
| using System; | ||
|
|
||
| namespace GeneratedDemo | ||
| { | ||
| class Program | ||
| { | ||
| static void Main(string[] args) | ||
| { | ||
| // Run the various scenarios | ||
| Console.WriteLine("Running HelloWorld:\n"); | ||
| UseHelloWorldGenerator.Run(); | ||
|
|
||
| Console.WriteLine("\n\nRunning AutoNotify:\n"); | ||
| UseAutoNotifyGenerator.Run(); | ||
|
|
||
| Console.WriteLine("\n\nRunning XmlSettings:\n"); | ||
| UseXmlSettingsGenerator.Run(); | ||
| } | ||
| } | ||
| } |
39 changes: 39 additions & 0 deletions
39
samples/CSharp/SourceGenerators/GeneratedDemo/UseAutoNotifyGenerator.cs
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,39 @@ | ||
| using System; | ||
| using AutoNotify; | ||
|
|
||
| namespace GeneratedDemo | ||
| { | ||
| // The view model we'd like to augment | ||
| public partial class ExampleViewModel | ||
| { | ||
| [AutoNotify] | ||
| private string _text = "private field text"; | ||
|
|
||
| [AutoNotify(PropertyName = "Count")] | ||
| private int _amount = 5; | ||
| } | ||
|
|
||
| public static class UseAutoNotifyGenerator | ||
| { | ||
| public static void Run() | ||
| { | ||
| ExampleViewModel vm = new ExampleViewModel(); | ||
|
|
||
| // we didn't explicitly create the 'Text' property, it was generated for us | ||
| string text = vm.Text; | ||
| Console.WriteLine($"Text = {text}"); | ||
|
|
||
| // Properties can have differnt names generated based on the PropertyName argument of the attribute | ||
| int count = vm.Count; | ||
| Console.WriteLine($"Count = {count}"); | ||
|
|
||
| // the viewmodel will automatically implement INotifyPropertyChanged | ||
| vm.PropertyChanged += (o, e) => Console.WriteLine($"Property {e.PropertyName} was changed"); | ||
| vm.Text = "abc"; | ||
| vm.Count = 123; | ||
|
|
||
| // Try adding fields to the ExampleViewModel class above and tagging them with the [AutoNotify] attribute | ||
| // You'll see the matching generated properties visibile in IntelliSense in realtime | ||
| } | ||
| } | ||
| } |
11 changes: 11 additions & 0 deletions
11
samples/CSharp/SourceGenerators/GeneratedDemo/UseHelloWorldGenerator.cs
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,11 @@ | ||
| namespace GeneratedDemo | ||
| { | ||
| public static class UseHelloWorldGenerator | ||
| { | ||
| public static void Run() | ||
| { | ||
| // The static call below is generated at build time, and will list the syntax trees used in the compilation | ||
| HelloWorldGenerated.HelloWorld.SayHello(); | ||
| } | ||
| } | ||
| } |
27 changes: 27 additions & 0 deletions
27
samples/CSharp/SourceGenerators/GeneratedDemo/UseXmlSettingsGenerator.cs
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,27 @@ | ||
| using System; | ||
| using AutoSettings; | ||
|
|
||
| namespace GeneratedDemo | ||
| { | ||
| public static class UseXmlSettingsGenerator | ||
| { | ||
| public static void Run() | ||
| { | ||
| // This XmlSettings generator makes a static property in the XmlSettings class for each .xmlsettings file | ||
|
|
||
| // here we have the 'Main' settings file from MainSettings.xmlsettings | ||
| // the name is determined by the 'name' attribute of the root settings element | ||
| XmlSettings.MainSettings main = XmlSettings.Main; | ||
| Console.WriteLine($"Reading settings from {main.GetLocation()}"); | ||
|
|
||
| // settings are strongly typed and can be read directly from the static instance | ||
| bool firstRun = XmlSettings.Main.FirstRun; | ||
| Console.WriteLine($"Setting firstRun = {firstRun}"); | ||
|
|
||
| int cacheSize = XmlSettings.Main.CacheSize; | ||
| Console.WriteLine($"Setting cacheSize = {cacheSize}"); | ||
|
|
||
| // Try adding some keys to the settings file and see the settings become available to read from | ||
| } | ||
| } | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,35 @@ | ||
| 🚧 Work In Progress | ||
| ======== | ||
|
|
||
| These samples are for an in-progress feature of Roslyn. As such they may change or break as the feature is developed, and no level of support is implied. | ||
|
|
||
| For more infomation on the Source Generators feature, see the [design document](https://github.com/dotnet/roslyn/blob/master/docs/features/source-generators.md). | ||
|
|
||
| Prerequisites | ||
| ----- | ||
|
|
||
| These samples require Visual Studio 16.6 or higher. | ||
|
|
||
| Building the samples | ||
| ----- | ||
| Open `SourceGenerators.sln` in Visual Studio or run `dotnet build` from the `\SourceGenerators` directory. | ||
|
|
||
| Running the samples | ||
| ----- | ||
|
|
||
| The generators must be run as part of another build, as they inject source into the project being built. This repo contains a sample project `GeneratorDemo` that relies of the sample generators to add code to it's compilation. | ||
|
|
||
| Run `GeneratedDemo` in Visual studio or run `dotnet run` from the `GeneratorDemo` directory. | ||
|
|
||
| Using the samples in your project | ||
| ----- | ||
|
|
||
| You can add the sample generators to your own project by adding an item group containing an analyzer reference: | ||
|
|
||
| ```xml | ||
| <ItemGroup> | ||
| <Analyzer Include="path\to\SourceGeneratorSamples.dll"> | ||
| </ItemGroup> | ||
| ``` | ||
|
|
||
| You may need to close and reopen the solution in Visual Studio for the change to take effect. |
Oops, something went wrong.