• Home
  • Guides
  • API
  • GitHub
Search Results for

    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).
    
    • Improve this Doc
    In This Article
    • Limitations
    • Examples
    • Documentation
    • Build
    • License
    Back to top Copyright (c) 2015 Benito Palacios Sánchez