PleOps.XdeltaSharp 1.3.0

dotnet add package PleOps.XdeltaSharp --version 1.3.0
NuGet\Install-Package PleOps.XdeltaSharp -Version 1.3.0
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="PleOps.XdeltaSharp" Version="1.3.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add PleOps.XdeltaSharp --version 1.3.0
#r "nuget: PleOps.XdeltaSharp, 1.3.0"
#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.
// Install PleOps.XdeltaSharp as a Cake Addin
#addin nuget:?package=PleOps.XdeltaSharp&version=1.3.0

// Install PleOps.XdeltaSharp as a Cake Tool
#tool nuget:?package=PleOps.XdeltaSharp&version=1.3.0

PleOps.XdeltaSharp Build and release GitHub

NOTE: At this stage, this projects can only decompress patch files. It cannot generate / compress.

PleOps.XdeltaSharp offers the possibility to apply delta/patch files with format VCDIFF, as described in the RFC 3284.

This project offers a library and a console application written in pure C# (no calls to C libraries). Making it compatible in every OS that can run a .NET runtime that implements .NET Standard 2.0 (.NET Framework, Mono and .NET).

Release Package
Stable Nuget
Preview Azure Artifacts

The project takes the name from xdelta. Another compression tool in C by Joshua MacDonald that implements the algorithm VCDIFF. It started as a port but due to huge difference between C and C#, dropped and restarted the development just by reading the specification.

Limitations

The latest version does not support:

  • Generate patch files.
  • Patch files with external compression.

Examples

  • Apply a patch file
using var input = new FileStream(inputFile, FileMode.Open);
using var patch = new FileStream(patchFile, FileMode.Open);
using var output = new FileStream(outputFile, FileMode.Create);

using var decoder = new Decoder(input, patch, output);
decoder.ProgressChanged += progress => Console.WriteLine($"Patching progress: {progress}";

decoder.Run();

Documentation

Feel free to ask any question in the project Discussion site!

Check our on-line API documentation.

Build

The project requires to build .NET 6.0 SDK and .NET Framework 4.8 or latest Mono. If you open the project with VS Code and you did install the VS Code Remote Containers extension, you can have an already pre-configured development environment with Docker or Podman.

To build, test and generate artifacts run:

# Only required the first time
dotnet tool restore

# Default target is Stage-Artifacts
dotnet cake

To just build and test quickly, run:

dotnet cake --target=BuildTest

License

This software is license under the MIT license.

Although not used, originally the project was inspired in xdelta with license Apache 2.0.

The algorithm for the ADLER32 checksum was ported from the C version of zlib with the following license:

Copyright (C) 1995-2013 Jean-loup Gailly and Mark Adler

This software is provided 'as-is', without any express or implied
warranty.  In no event will the authors be held liable for any damages
arising from the use of this software.
Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must not
    claim that you wrote the original software. If you use this software
    in a product, an acknowledgment in the product documentation would be
    appreciated but is not required.

2. Altered source versions must be plainly marked as such, and must not be
    misrepresented as being the original software.

3. This notice may not be removed or altered from any source distribution.

Jean-loup Gailly        Mark Adler
jloup@gzip.org          madler@alumni.caltech.edu

The data format used by the zlib library is described by RFCs (Request for
Comments) 1950 to 1952 in the files http://tools.ietf.org/html/rfc1950
(zlib format), rfc1951 (deflate format) and rfc1952 (gzip format).
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  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. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 is compatible.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos 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
1.3.0 473 12/4/2021

## v1.3.0 (December 04, 2021)


As part of this release we had [5 issues](https://github.com/pleonex/xdelta-sharp/milestone/1?closed=1) closed.



__breaking__

- [__#7__](https://github.com/pleonex/xdelta-sharp/pull/7) Change namespaces to Pleosoft.XdeltaSharp and warning cleaning

__bug__

- [__#9__](https://github.com/pleonex/xdelta-sharp/pull/9) Fix throwing exception when win_indicator is zero

__enhancements__

- [__#3__](https://github.com/pleonex/xdelta-sharp/pull/3) Implement PleOps.Cake build system and rename project
- [__#8__](https://github.com/pleonex/xdelta-sharp/pull/8) Validate API with .NET 6 and update build system
- [__#10__](https://github.com/pleonex/xdelta-sharp/pull/10) Change namespace because prefix &quot;Pleosoft&quot; was already reserved in nuget.org