Net4x.AsyncBridge 1.5.0.11

Net4x.AsyncBridge

Net4x.AsyncBridge is a compatibility library that brings modern C# async/await building blocks to a wide range of .NET targets, including older .NET Framework versions and newer .NET/.NET Core runtimes. It provides backports and cross-targeting helpers such as ValueTask, async method builders, IAsyncDisposable support, and utilities that make it easier to write and consume asynchronous code across framework versions.

Authors: Piero Viano

Repository: https://bitbucket.org/pieroviano/asyncbridge

Why this project

Many modern APIs and language features (for example ValueTask, custom async method builders and IAsyncDisposable) were introduced in newer .NET versions. Net4x.AsyncBridge provides compatible implementations and helpers so libraries and applications targeting older frameworks can use these patterns or be cross-compiled for newer TFMs without duplicating runtime behavior.

Features

• ValueTask implementation and related helpers for older frameworks
• Async method builders compatible with the C# async/await compiler-generated patterns
• Backports and extension helpers for IAsyncDisposable
• Utilities to adapt Task-based APIs to more modern patterns
• Cross-targeting support across many TFMs

Supported targets

The solution contains multiple projects targeting a wide set of frameworks. Examples include:

• .NET Framework 2.0 through 4.8 (and many 4.x variations)
• .NET Standard 2.0, 2.1
• .NET 5, 6, 7, 8, 9 (and Windows-specific TFMs where applicable)

See individual project files under src/ and tests/ for exact Target Framework Monikers (TFMs).

Quick start

1. Clone the repository:

   git clone https://bitbucket.org/pieroviano/asyncbridge.git

2. Open the solution in Visual Studio (recommended for older .NET Framework targets) or use the dotnet CLI for SDK-style projects.

3. Reference the projects you need, or build the desired project and reference the produced assemblies.

Example (conceptual):

// Example using the library's ValueTask and async helper types
using AsyncBridge.Threading.Tasks;

public async ValueTask<int> ComputeAsync()
{
 // Implementation using AsyncBridge helpers
 await Task.Delay(10);
 return 42;
}

Building

• For SDK-style projects (netstandard/netcore/net):

  • dotnet build from the repository root or the specific project directory.

• For full .NET Framework projects:

  • Open the solution in Visual Studio and build the solution using the appropriate configuration and platform.

Note: The repository contains many projects targeting different TFMs. Build only the projects you need or the entire solution in Visual Studio.

Running tests

Test projects are located under the tests/ directory. Use the test runner appropriate to each target framework:

• For .NET Core / SDK-style test projects: dotnet test in the test project directory.
• For .NET Framework test projects: run tests from Visual Studio or use the appropriate NUnit/MSTest runner for the targeted framework.

Contributing

Contributions, bug reports, and pull requests are welcome. Please follow these guidelines:

• Fork the repository and create a feature branch.
• Add tests for new behavior where applicable.
• Keep changes targeted and provide a clear description of the problem and your fix.
• Open a pull request describing the change.

License

See LICENSE.txt in the repository root for licensing details.

Acknowledgements

This project was inspired by community efforts to bring async/await support to older frameworks. Thanks to contributors and maintainers who helped shape the implementation.