An open API service indexing awesome lists of open source software.

https://github.com/emik03/emik.sourcegenerators.tattoo

Source generates a file that imports all namespaces.
https://github.com/emik03/emik.sourcegenerators.tattoo

Last synced: about 1 year ago
JSON representation

Source generates a file that imports all namespaces.

Awesome Lists containing this project

README

          

# Emik.SourceGenerators.Tattoo

[![NuGet package](https://img.shields.io/nuget/v/Emik.SourceGenerators.Tattoo.svg?logo=NuGet)](https://www.nuget.org/packages/Emik.SourceGenerators.Tattoo)
[![License](https://img.shields.io/github/license/Emik03/Emik.SourceGenerators.Tattoo.svg?style=flat)](https://github.com/Emik03/Emik.SourceGenerators.Tattoo/blob/main/LICENSE)

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](https://github.com/dotnet/roslyn) and therefore more portable. However, [it may also conflict with other Source Generators](https://github.com/dotnet/runtime/issues/89923), 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`](https://github.com/Emik03/Emik.SourceGenerators.Tattoo/tree/main/) branch is Version 2, and [`legacy`](https://github.com/Emik03/Emik.SourceGenerators.Tattoo/tree/legacy) is Version 1.

This project has a dependency to [Emik.Morsels](https://github.com/Emik03/Emik.Morsels), if you are building this project, refer to its [README](https://github.com/Emik03/Emik.Morsels/blob/main/README.md) first.

Example file output:

```csharp
//
// 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;
// ...
// 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 { }
// ...
```

---

- [Contribute](#contribute)
- [License](#license)

---

## Contribute

Issues and pull requests are welcome to help this repository be the best it can be.

## License

This repository falls under the [MPL-2 license](https://www.mozilla.org/en-US/MPL/2.0/).