commit | 39ff500790fa8038f80bd2fdcd10c35568a12529 | [log] [tgz] |
---|---|---|
author | Fabrice de Gans-Riberi <Steelskin@users.noreply.github.com> | Fri Jul 17 15:09:31 2015 |
committer | Fabrice de Gans-Riberi <Steelskin@users.noreply.github.com> | Fri Jul 17 15:09:31 2015 |
tree | ed18c4997ff5b89ba7fb75cf6039542d14df24f8 | |
parent | 1ce756f9bdca85793f5a6e4fdffaf0cea9fb2c2b [diff] | |
parent | 67ce2b4d5e93bea3bbbb28f711f0de09228f9de9 [diff] |
Merge pull request #47 from google/unique_ptr Add an option to force use of auto_ptr for legacy STL implementations.
open-vcdiff is an encoder and decoder for the VCDIFF format, as described in RFC 3284: The VCDIFF Generic Differencing and Compression Data Format.
You will need to first synchronize gflags and gtest by running ./fetch_prereq.bat
on Windows or ./fetch_prereq.sh
on other platforms.
A library with a simple API is included, as well as a command-line executable that can apply the encoder and decoder to source, target, and delta files. For further details, please refer to this link.
See INSTALL for (generic) installation instructions for C++: basically
./configure && make && make install
This should compile the unit tests as well as vcdiff
, a simple command-line utility to run the encoder and decoder. Typical usage of vcdiff is as follows (the <
and >
are file redirect operations, not optional arguments):
vcdiff encode -dictionary file.dict < target_file > delta_file vcdiff decode -dictionary file.dict < delta_file > target_file
To see the command-line syntax of vcdiff, use vcdiff --help
or just vcdiff
.
To call the encoder from C++ code, assuming that dictionary, target, and delta are all std::string
objects:
#include <google/vcencoder.h> // Read this file for interface details // [...] open_vcdiff::VCDiffEncoder encoder(dictionary.data(), dictionary.size()); encoder.SetFormatFlags(open_vcdiff::VCD_FORMAT_INTERLEAVED); encoder.Encode(target.data(), target.size(), &delta);
Calling the decoder is just as simple:
#include <google/vcdecoder.h> // Read this file for interface details // [...] open_vcdiff::VCDiffDecoder decoder; decoder.Decode(dictionary.data(), dictionary.size(), delta, &target);
When using the encoder, the C++ application must be linked with the library options -lvcdcom
and -lvcdenc
; when using the decoder, it must be linked with -lvcdcom
and -lvcddec
.
To verify that the package works on your system, especially after making modifications to the source code, please run the unit tests using make check
.
For further details, please refer to this link.