Generates a file that imports all namespaces.
Version 1 contains the original behavior, which is to source generate the file. This has the benefit of hiding the file within temporary directories managed by Roslyn and therefore more portable. However, it may also conflict with other Source Generators, as there is no way to declare precedence.
Version 2 changes this behavior by making a file directly within the project folder named GlobalUsings.g.cs, and writing to the file system directly. This fixes the aforementioned issue, however this behavior may be undesired to some.
Use whichever version best applies to your situation, as both versions are separately maintained.
For maintainers, the main branch is Version 2, and legacy is Version 1.
This project has a dependency to Emik.Morsels, if you are building this project, refer to its README first.
Example file output:
// <auto-generated/>
// Emik.SourceGenerators.Tattoo, v2
#pragma warning disable
global using global::System;
global using global::System.Buffers;
global using global::System.Buffers.Binary;
global using global::System.Buffers.Text;
global using global::System.CodeDom;
global using global::System.CodeDom.Compiler;
// ... <omitted for brevity>
// Polyfills of namespaces in case dependencies are conditional.
namespace System { }
namespace System.Buffers { }
namespace System.Buffers.Binary { }
namespace System.Buffers.Text { }
namespace System.CodeDom { }
namespace System.CodeDom.Compiler { }
// ... <omitted for brevity>Issues and pull requests are welcome to help this repository be the best it can be.
This repository falls under the MPL-2 license.