ExternalSort 2.0.0-beta02

This is a prerelease version of ExternalSort.
dotnet add package ExternalSort --version 2.0.0-beta02
                    
NuGet\Install-Package ExternalSort -Version 2.0.0-beta02
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="ExternalSort" Version="2.0.0-beta02" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="ExternalSort" Version="2.0.0-beta02" />
                    
Directory.Packages.props
<PackageReference Include="ExternalSort" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add ExternalSort --version 2.0.0-beta02
                    
#r "nuget: ExternalSort, 2.0.0-beta02"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#addin nuget:?package=ExternalSort&version=2.0.0-beta02&prerelease
                    
Install ExternalSort as a Cake Addin
#tool nuget:?package=ExternalSort&version=2.0.0-beta02&prerelease
                    
Install ExternalSort as a Cake Tool

External Sort

Contains various utilities to sort and join large amounts of data that is larger than the amount of available RAM.

Documentation

OrderByExternal()

Sort IAsyncEnumerable<T> data.

  IAsyncEnumerable<User> myUsersToSort = ...
  var sortedUsers = myUsersToSort
    .OrderByExternal(u => u.Email);

GroupJoinExternal()

GroupJoin (left outer join) on IAsyncEnumerable<T> data.

  IAsyncEnumerable<User> myUsers = ...
  IAsyncEnumerable<UserComments> myUserComments = ...
  
  var joinedUsersAndComments = myUsersToSort
    .GroupJoinExternal(myUserComments, u => u.UserId, uc => uc.UserId, (user, comments) => new
    {
        User = user,
        Comments = comments.ToList()
    });

ExceptByExternal()

ExceptBy (NOT IN) on IAsyncEnumerable<T> data.

  IAsyncEnumerable<User> myUsers = ...
  IAsyncEnumerable<int> myStaffUserIds = ...
  
  var nonStaffUsers = myUsers
    .ExceptByExternal(myStaffUserIds, u => u.UserId);

DistinctExternal()

Distinct on IAsyncEnumerable<T> data.

  IAsyncEnumerable<User> myUsers = ...
  IAsyncEnumerable<int> myUserAges = myUsers.Select(u => u.Age)
  
  var distinctAges = myUserAges
    .DistinctExternal();

Internally, ExternalSort uses Parquet temp files. See https://github.com/aloneguid/parquet-dotnet for class serialisation options.

Thanks to https://josef.codes/sorting-really-large-files-with-c-sharp/ for the inspiration.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.0.0-beta02 2,873 7/4/2024
2.0.0-beta01 102 7/4/2024
1.2.0 128 5/15/2024
1.2.0-beta001 830 4/15/2024
1.1.0 144 4/14/2024
1.1.0-beta003 186 4/11/2024
1.1.0-beta002 96 4/11/2024
1.1.0-beta001 121 4/10/2024
1.0.0 126 4/9/2024
1.0.0-beta005 155 4/8/2024
1.0.0-beta004 93 4/8/2024
1.0.0-beta003 127 4/8/2024
1.0.0-beta002 111 4/7/2024
1.0.0-beta001 105 4/4/2024