commit | 9a2b625d7a5c72160a6097adf3a3e1631aaa9109 | [log] [tgz] |
---|---|---|
author | fdegans@chromium.org <fdegans@chromium.org> | Mon Aug 10 11:47:48 2015 |
committer | fdegans@chromium.org <fdegans@chromium.org> | Mon Aug 10 11:47:48 2015 |
tree | 7d50e4afa46d1b0b2037dd079055a0dc4a02c635 | |
parent | 39ff500790fa8038f80bd2fdcd10c35568a12529 [diff] |
Fix MSVC warnings about implicit value truncations. Cache sizes are required to fit in an unsigned char, so make this explicit. This prevents MSVC from warning in various places that we may be truncating an int to fit in an unsigned char. This means we need to move the enforcement tests to VCDiffStreamingDecoderImpl::InitCustomCodeTable(), and, VCDiffAddressCache::Init() can no longer fail. This also results in moving some unittest content around.
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.