Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Nyrest/FastGenericNew
The ultimate fast alternative to Activator.CreateInstance<T> / new T()
https://github.com/Nyrest/FastGenericNew
activator createinstance csharp csharp-library csharp-sourcegenerator delegate dotnet dotnet-core expression fast generic incremental library netframework nuget optimization performance roslyn roslyn-analyzer sourcegenerator
Last synced: about 2 months ago
JSON representation
The ultimate fast alternative to Activator.CreateInstance<T> / new T()
- Host: GitHub
- URL: https://github.com/Nyrest/FastGenericNew
- Owner: Nyrest
- License: mit
- Created: 2020-11-08T16:44:23.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-07-29T00:40:05.000Z (about 2 months ago)
- Last Synced: 2024-07-31T01:52:49.638Z (about 2 months ago)
- Topics: activator, createinstance, csharp, csharp-library, csharp-sourcegenerator, delegate, dotnet, dotnet-core, expression, fast, generic, incremental, library, netframework, nuget, optimization, performance, roslyn, roslyn-analyzer, sourcegenerator
- Language: C#
- Homepage:
- Size: 2.04 MB
- Stars: 222
- Watchers: 6
- Forks: 8
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- RSCG_Examples - https://github.com/Nyrest/FastGenericNew
- csharp-source-generators - FastGenericNew -   The ultimate fast alternative to `Activator.CreateInstance<T>` / `new T()`. Built on SourceGenerator V2 (Incremental Generator). (Source Generators / Other)
README
## ✨ Features
- ✔️ **The best** `CreateInstance` ever
- Up to 50x faster than `Activator.CreateInstance`
- Generic Parameters Support
- Zero boxing/unboxing
- TryGetValue-like TryFastNew API
- Link Mode `PublishTrimmed` Support
- Non-Public Constructor Support
- No Generic Constraints
- Compatible with .NET Standard 2.0
- Multiple backend implementations.
- Heavily tested on Win/Mac/Linux
- 🪛 **Modern** Compiler Integration
- Source Generator v2 (Incremental Generator)
- Highly Configurable ([Props](https://github.com/Nyrest/FastGenericNew/wiki/SourceGenerator-Options))
- Multi-threaded Generation
- 🔥 **Lastest** C#/.NET Features Support
- [C# 8 Nullable](https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/builtin-types/nullable-reference-types) Support
- [C# 10 Parameterless struct constructors](https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/proposals/csharp-10.0/parameterless-struct-constructors) Support (Both invokes or not)
- WebAssembly Support
## 🔧 Installation
> You should only use one of them
### Pre-Compiled Version
```powershell
dotnet add package FastGenericNew --version 3.1.0-preview1
```
```xml
```
### SourceGenerator Version
```powershell
dotnet add package FastGenericNew.SourceGenerator --version 3.1.0-preview1
```
```xml
```
#### SourceGeneratorV2 requires
> ***.NET Standard 2.0*** or above
> ***C# 8.0*** or above
> ***Roslyn 4.0.1*** or above
> ***Modern IDE*** *(Optional)* [VS2022, Rider, VSCode]
## 📖 Examples
```cs
using FastGenericNew;
// Simply replace 'Activator' to 'FastNew'
var obj = FastNew.CreateInstance();
// With parameter(s)
var obj2 = FastNew.CreateInstance("text");
var obj3 = FastNew.CreateInstance("text", 0);
// Try pattern
// NOTE: Try pattern will only check the constructor could be called (exist & callable)
// It will not catch or handle any exceptions thrown in the constructor.
if (FastNew.TryCreateInstance("arg0", out T result));
{
// ...
}
```
### Notes
> **With .NET Framework**, `Activator.CreateInstance()` invokes the parameterless constructor of **ValueType** if
> the constraint is `where T : new()` but appears to **ignore the parameterless constructor if the constraint is `where T : struct`**.
> **But `FastNew.CreateInstance()` will always invoke the parameterless constructor if it's available.**
>
> If you don't want to invoke the parameterless constructor of **ValueType**.
> Consider to use `FastNew.NewOrDefault()` which **will never invoke the parameterless constructor of `ValueType`**
## 🚀 Benchmark
### **Environment**
``` ini
BenchmarkDotNet=v0.13.1, OS=Windows 10.0.22000
AMD Ryzen 9 3900X, 1 CPU, 24 logical and 12 physical cores
.NET SDK=6.0.200-preview.22055.15
[Host] : .NET 6.0.2 (6.0.222.6406), X64 RyuJIT
.NET 5.0 : .NET 5.0.14 (5.0.1422.5710), X64 RyuJIT
.NET 6.0 : .NET 6.0.2 (6.0.222.6406), X64 RyuJIT
.NET Framework 4.8 : .NET Framework 4.8 (4.8.4470.0), X64 RyuJIT
```
### Reference Types
[](https://github.com/Nyrest/FastGenericNew/blob/main/FastGenericNew.Benchmarks/Benchmarks/ReferenceTypeBenchmark.cs)
### Value Types
[](https://github.com/Nyrest/FastGenericNew/blob/main/FastGenericNew.Benchmarks/Benchmarks/ValueTypeBenchmark.cs)
## 📜 License
FastGenericNew is licensed under the [MIT](LICENSE) license.