react-native-update 8.5.4 → 8.5.5

package/harmony/src/main/cpp/HDiffPatch/CHANGELOG.md

@@ -0,0 +1,153 @@
+# HDiffPatch Change Log
+
+full changelog at: https://github.com/sisong/HDiffPatch/commits   
+
+## [v3.1.0](https://github.com/sisong/HDiffPatch/tree/v3.1.0) - 2020-12-16
+### Added
+* add a memory cache for patch to newStream, can reduce write I/O times;
+* add create_single_compressed_diff()&patch_single_compressed_diff() , preview, still under development! diffData saved as single compressed stream, for optimize decompress memory when patch;
+### Removed
+*  cmdline remove option "-o", no Original diff, you can continue to call patch()|patch_stream() yourself;  
+*  remove patch_decompress_repeat_out(), you need use patch_decompress*() to replace it;
+
+## [v3.0.8](https://github.com/sisong/HDiffPatch/tree/v3.0.8) - 2020-01-01
+### Added
+* patch demo for Android, out lib file libhpatchz.so;
+
+## [v3.0.7](https://github.com/sisong/HDiffPatch/tree/v3.0.7) - 2019-12-19
+### Fixed
+* Fix a bug when create dir's manifest file without checksum (hdiffz -C-no -M...);
+* Fix a bug when create dir's manifest file on windows operating system;
+
+## [v3.0.6](https://github.com/sisong/HDiffPatch/tree/v3.0.6) - 2019-09-18
+### Fixed
+* Fix a patch bug when old file size >=4GB and patch with large cache memory and run as 32bit app;
+
+## [v3.0.5](https://github.com/sisong/HDiffPatch/tree/v3.0.5) - 2019-09-18
+### Fixed
+* Fix a directory patch bug when changed file's sumSize >=4GB and run as 32bit app;
+
+## [v3.0.4](https://github.com/sisong/HDiffPatch/tree/v3.0.4) - 2019-09-06
+### Fixed
+* Fix dir_patch can't remove some files bug when patch to same dir on Windows operating system;
+
+## [v3.0.0](https://github.com/sisong/HDiffPatch/tree/v3.0.0) - 2019-03-01
+### Added
+* hdiffz,hpatchz command line support diff&patch between directories(folder);
+* support checksum plugin: crc32ChecksumPlugin,adler32ChecksumPlugin,adler64ChecksumPlugin,fadler32ChecksumPlugin,fadler64ChecksumPlugin,fadler128ChecksumPlugin,md5ChecksumPlugin ;
+* lzmaCompressPlugin support parallel compress;
+* add parallel compress plugin: pzlibCompressPlugin,pbz2CompressPlugin,lzma2CompressPlugin
+* command line support SFX(self extract archive);
+
+## [v2.5.3](https://github.com/sisong/HDiffPatch/tree/v2.5.3) - 2018-12-25
+### Fixed
+* Fix a bug when cancel LzmaEnc_Encode in lzmaCompressPlugin when diff;
+
+## [v2.5.0](https://github.com/sisong/HDiffPatch/tree/v2.5.0) - 2018-12-01
+### Added
+* resave_compressed_diff(...) support resave diffFile with new compress type;
+
+## [v2.4.2](https://github.com/sisong/HDiffPatch/tree/v2.4.2) - 2018-11-06
+### Added
+* Add CI(ci.appveyor.com) for this repository;
+
+## [v2.4.1](https://github.com/sisong/HDiffPatch/tree/v2.4.1) - 2018-08-14
+### Fixed
+* Fix a memroy bug in zlibCompressPlugin when diff;
+### Added
+* Add CI(travis-ci.org) for this repository;
+
+## [v2.4](https://github.com/sisong/HDiffPatch/tree/v2.4) - 2018-04-26
+### Changed
+* Improve hdiffz,hpatchz command line;
+
+## [v2.3](https://github.com/sisong/HDiffPatch/tree/v2.3) - 2018-03-21
+### Added
+* hpatch_coverList_open_serializedDiff(...),hpatch_coverList_open_compressedDiff(...) support open diffFile read coverList;
+
+## [v2.2.2](https://github.com/sisong/HDiffPatch/tree/v2.2.2) - 2017-09-10
+### Changed
+* Optimize patch_stream_with_cache(...) speed when patch with large cache memory;
+
+## [v2.2.1](https://github.com/sisong/HDiffPatch/tree/v2.2.1) - 2017-09-06
+### Added
+* add compress&decompress plugin lz4hcCompressPlugin,zstdCompressPlugin,zstdDecompressPlugin;
+
+## [v2.2.0](https://github.com/sisong/HDiffPatch/tree/v2.2.0) - 2017-09-02
+### Added
+* Optimize patch_decompress_with_cache(...) speed when patch with large cache memory;
+
+## [v2.1.1](https://github.com/sisong/HDiffPatch/tree/v2.1.1) - 2017-08-23
+### Added
+* add compress&decompress plugin lz4CompressPlugin,lz4DecompressPlugin;
+
+## [v2.1.0](https://github.com/sisong/HDiffPatch/tree/v2.1.0) - 2017-08-22
+### Added
+* create_compressed_diff_stream(...), same as create_compressed_diff(...), but can control memory requires and run speed by different kMatchBlockSize value;
+* add performance test, compare with xdelta3.1;
+
+## [v2.0.3](https://github.com/sisong/HDiffPatch/tree/v2.0.3) - 2017-08-05
+### Added
+* patch_decompress_with_cache(...), same as patch_decompress(...), but support set cache memory size for optimize patch speed;
+* patch_stream_with_cache(...), same as patch_stream(...), but support set cache memory size for optimize patch speed;
+
+
+## [v2.0.0](https://github.com/sisong/HDiffPatch/tree/v2.0.0) - 2017-07-29
+### Added
+* create_compressed_diff(...) support create compressed differential;
+* add compress plugin zlibCompressPlugin, bz2CompressPlugin, lzmaCompressPlugin;
+* patch_decompress(...) support patch apply compressed differential;
+* add decompress plugin zlibDecompressPlugin, bz2DecompressPlugin, lzmaDecompressPlugin;
+
+## [v1.2.2](https://github.com/sisong/HDiffPatch/tree/v1.2.2) - 2017-07-17
+### Fixed
+* Fix a memroy bug when diff (never encountered, maybe happen);
+
+## [v1.2.0](https://github.com/sisong/HDiffPatch/tree/v1.2.0) - 2017-07-02
+### Changed
+* Optimize diff speed;
+
+## [v1.1.4](https://github.com/sisong/HDiffPatch/tree/v1.1.4) - 2017-06-10
+### Added
+* Add MakeFile for support make; by author [JayXon](https://github.com/JayXon);
+### Changed
+* Slightly optimize diff required memory size;
+
+## [v1.1.3](https://github.com/sisong/HDiffPatch/tree/v1.1.3) - 2017-01-01
+### Changed
+* used divsufsort (still can select sais or std::sort) for suffix string sort;
+
+## [v1.1.2](https://github.com/sisong/HDiffPatch/tree/v1.1.2) - 2016-09-01
+### Fixed
+* Fix a bug when write out diffFile on Windows operating system; by author [Wenhai Lin](https://github.com/WenhaiLin);
+
+## [v1.1.1](https://github.com/sisong/HDiffPatch/tree/v1.1.1) - 2015-04-20
+### Fixed
+* Fix a code bug when diff (never encountered, maybe happen);
+
+## [v1.1.0](https://github.com/sisong/HDiffPatch/tree/v1.1.0) - 2014-09-13
+### Added
+* patch_stream(...), same as patch(...) but used O(1) bytes of memory;
+
+## [v1.0.6](https://github.com/sisong/HDiffPatch/tree/v1.0.6) - 2014-09-07
+### Added
+* Diff&Patch support big datas(>2GB, int32 to int64) on 64bit operating system;
+
+## [v1.0.2](https://github.com/sisong/HDiffPatch/tree/v1.0.2) - 2013-08-03
+### Changed
+* Optimize diff speed with two unrelated data;
+
+## [v1.0.1](https://github.com/sisong/HDiffPatch/tree/v1.0.1) - 2013-08-02
+### Fixed
+* Fix diff fail between two equal datas;
+
+## [v1.0.0](https://github.com/sisong/HDiffPatch/tree/v1.0.0) - 2013-06-06
+### Added
+* Add Readme file; 
+* Performance test, compare with BSDiff4.3;
+
+## [Init Release](https://github.com/sisong/HDiffPatch/commit/6d71005c65e1713a8f0c02f9fd2eced32940b4c2) - 2013-05-30
+### Init Release, MIT copyright;
+* create_diff(...) support create differential between two memory datas(src->dst bytes);
+* patch(...) support apply differential for update src bytes to dst bytes;
+* demo app for diff&patch between two files;

package/harmony/src/main/cpp/HDiffPatch/LICENSE

@@ -0,0 +1,48 @@
+MIT License
+
+for HDiffPatch
+Copyright (c) 2012-2021 housisong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+------------------------------------------------------------------------------------------------------------------------------
+
+for libdivsufsort
+Copyright (c) 2003-2008 Yuta Mori All Rights Reserved.
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

package/harmony/src/main/cpp/HDiffPatch/Makefile

@@ -0,0 +1,157 @@
+# args
+DIR_DIFF := 1
+MT       := 1
+LZMA     := 1
+MD5      := 0
+
+
+HPATCH_OBJ := \
+    libHDiffPatch/HPatch/patch.o \
+    file_for_patch.o
+
+ifeq ($(DIR_DIFF),0)
+else
+  HPATCH_OBJ += \
+    dirDiffPatch/dir_patch/dir_patch.o \
+    dirDiffPatch/dir_patch/res_handle_limit.o \
+    dirDiffPatch/dir_patch/ref_stream.o \
+    dirDiffPatch/dir_patch/new_stream.o \
+    dirDiffPatch/dir_patch/dir_patch_tools.o \
+    dirDiffPatch/dir_patch/new_dir_output.o \
+    libHDiffPatch/HDiff/private_diff/limit_mem_diff/adler_roll.o
+endif
+
+
+HDIFF_OBJ := \
+    libHDiffPatch/HDiff/diff.o \
+    libHDiffPatch/HDiff/private_diff/bytes_rle.o \
+    libHDiffPatch/HDiff/private_diff/suffix_string.o \
+    libHDiffPatch/HDiff/private_diff/compress_detect.o \
+    libHDiffPatch/HDiff/private_diff/limit_mem_diff/digest_matcher.o \
+    libHDiffPatch/HDiff/private_diff/limit_mem_diff/stream_serialize.o \
+    libHDiffPatch/HDiff/private_diff/libdivsufsort/divsufsort64.o \
+    libHDiffPatch/HDiff/private_diff/libdivsufsort/divsufsort.o \
+    libHDiffPatch/HDiff/private_diff/limit_mem_diff/adler_roll.o \
+    $(HPATCH_OBJ)
+ifeq ($(DIR_DIFF),0)
+else
+  HDIFF_OBJ += \
+    dirDiffPatch/dir_diff/dir_diff.o \
+    dirDiffPatch/dir_diff/dir_diff_tools.o \
+    dirDiffPatch/dir_diff/dir_manifest.o
+endif
+ifeq ($(MT),0)
+else
+  HDIFF_OBJ += \
+    libParallel/parallel_import.o \
+    libParallel/parallel_channel.o \
+    compress_parallel.o
+endif
+
+
+DEF_FLAGS := \
+    -Os -DNDEBUG -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 \
+    -D_IS_NEED_ALL_CompressPlugin=0 \
+    -D_IS_NEED_DEFAULT_CompressPlugin=0 \
+    -D_CompressPlugin_zlib  \
+    -D_CompressPlugin_bz2  \
+    -D_IS_NEED_ALL_ChecksumPlugin=0 \
+    -D_IS_NEED_DEFAULT_ChecksumPlugin=0 
+ifeq ($(DIR_DIFF),0)
+  DEF_FLAGS += -D_IS_NEED_DIR_DIFF_PATCH=0
+else
+  DEF_FLAGS += \
+    -D_IS_NEED_DIR_DIFF_PATCH=1 \
+    -D_ChecksumPlugin_crc32 \
+    -D_ChecksumPlugin_fadler64
+  ifeq ($(MD5),0)
+  else
+    DEF_FLAGS += -D_ChecksumPlugin_md5 -I'../libmd5'
+  endif
+endif
+ifeq ($(LZMA),0)
+else
+  DEF_FLAGS += \
+    -D_CompressPlugin_lzma -I'../lzma/C' \
+    -D_CompressPlugin_lzma2 -I'../lzma/C'
+endif
+ifeq ($(MT),0)
+  DEF_FLAGS += \
+    -D_7ZIP_ST \
+    -D_IS_USED_MULTITHREAD=0 
+else
+  DEF_FLAGS += \
+    -D_IS_USED_MULTITHREAD=1 \
+    -D_IS_USED_PTHREAD=1
+endif
+
+
+PATCH_LINK := -lz -lbz2
+DIFF_LINK  := $(PATCH_LINK)
+ifeq ($(MT),0)
+else
+  DIFF_LINK += -lpthread
+endif
+
+
+CFLAGS   += $(DEF_FLAGS) 
+CXXFLAGS += $(DEF_FLAGS)
+
+.PHONY: all install clean
+
+all: md5Lib lzmaLib libhdiffpatch.a hdiffz hpatchz
+
+ifeq ($(DIR_DIFF),0)
+  MD5_OBJ     :=
+  md5Lib      :
+else
+  ifeq ($(MD5),0)
+    MD5_OBJ     :=
+    md5Lib      :
+  else
+    MD5_OBJ     := 'md5.o'
+    md5Lib      : # https://sourceforge.net/projects/libmd5-rfc  https://github.com/sisong/libmd5
+	$(CC) -c $(CFLAGS) '../libmd5/md5.c'
+  endif
+endif
+
+ifeq ($(LZMA),0)
+  LZMA_DEC_OBJ :=
+  LZMA_OBJ     :=
+  lzmaLib      :
+else  
+  LZMA_DEC_OBJ := 'LzmaDec.o' 'Lzma2Dec.o' 
+  LZMA_OBJ     := 'LzFind.o' 'LzmaEnc.o' 'Lzma2Enc.o' $(LZMA_DEC_OBJ)
+  LZMA_SRC     := '../lzma/C/LzFind.c' '../lzma/C/LzmaDec.c' '../lzma/C/LzmaEnc.c' \
+		     '../lzma/C/Lzma2Dec.c' '../lzma/C/Lzma2Enc.c'
+  ifeq ($(MT),0)  
+  else  
+    LZMA_OBJ += 'LzFindMt.o' 'MtCoder.o' 'MtDec.o' 'ThreadsP.o'
+    LZMA_SRC += '../lzma/C/LzFindMt.c' '../lzma/C/MtCoder.c' \
+		   '../lzma/C/MtDec.c' '../lzma/C/ThreadsP.c' 
+  endif
+  lzmaLib: # https://github.com/sisong/lzma
+	$(CC) -c $(CFLAGS) $(LZMA_SRC)
+endif
+
+libhdiffpatch.a: $(HDIFF_OBJ)
+	$(AR) rcs $@ $^
+
+hdiffz: 
+	$(CXX) hdiffz.cpp libhdiffpatch.a $(MD5_OBJ) $(LZMA_OBJ) $(CXXFLAGS) $(DIFF_LINK) -o hdiffz
+hpatchz: 
+	$(CC) hpatchz.c $(HPATCH_OBJ) $(MD5_OBJ) $(LZMA_DEC_OBJ) $(CFLAGS) $(PATCH_LINK) -o hpatchz
+
+RM := rm -f
+INSTALL_X := install -m 0755
+INSTALL_BIN := $(DESTDIR)/usr/local/bin
+
+clean:
+	$(RM) libhdiffpatch.a hdiffz hpatchz $(HDIFF_OBJ) $(MD5_OBJ) $(LZMA_OBJ)
+
+install: all
+	$(INSTALL_X) hdiffz $(INSTALL_BIN)/hdiffz
+	$(INSTALL_X) hpatchz $(INSTALL_BIN)/hpatchz
+
+uninstall:
+	$(RM)  $(INSTALL_BIN)/hdiffz  $(INSTALL_BIN)/hpatchz

package/harmony/src/main/cpp/HDiffPatch/README.md

@@ -0,0 +1,307 @@
+# [HDiffPatch](https://github.com/sisong/HDiffPatch)
+[![release](https://img.shields.io/badge/release-v3.1.1-blue.svg)](https://github.com/sisong/HDiffPatch/releases) 
+[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/sisong/HDiffPatch/blob/master/LICENSE) 
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-blue.svg)](https://github.com/sisong/HDiffPatch/pulls)
+[![+issue Welcome](https://img.shields.io/github/issues-raw/sisong/HDiffPatch?color=green&label=%2Bissue%20welcome)](https://github.com/sisong/HDiffPatch/issues)   
+
+[![Build Status](https://travis-ci.org/sisong/HDiffPatch.svg?branch=master)](https://travis-ci.org/sisong/HDiffPatch) 
+[![Build status](https://ci.appveyor.com/api/projects/status/t9ow8dft8lt898cv/branch/master?svg=true)](https://ci.appveyor.com/project/sisong/hdiffpatch/branch/master)   
+
+a C\C++ library and command-line tools for Diff & Patch between binary files or directories(folder); cross-platform; run fast; create small delta/differential; support large files and limit memory requires when diff & patch.   
+   
+( NOTE: This library does not deal with file metadata, such as file last wirte time, permissions, link file, etc... To this library, a file is just as a stream of bytes; You can extend this library or use other tools. )   
+( update Android Apk? Jar or Zip file diff & patch? try [ApkDiffPatch](https://github.com/sisong/ApkDiffPatch)!    
+ but ApkDiffPath can't be used in the Android app store, because it requires re-signing apk;   
+[sfpatcher](https://github.com/sisong/sfpatcher) like [archive-patcher](https://github.com/google/archive-patcher), is designed for Android app store, but patch is much faster than archive-patcher. )   
+   
+---
+## Releases/Binaries
+[Download from latest release](https://github.com/sisong/HDiffPatch/releases) : Command line app for Windows, Linux, MacOS; and .so patch lib for Android.     
+( release files build by projects in path `HDiffPatch/builds` )   
+
+## Builds
+`$ cd <dir>/HDiffPatch`   
+if on linux or macos, try :   
+`$ make LZMA=0`   
+or    
+```
+$ git clone https://github.com/sisong/lzma.git ../lzma
+$ git clone https://github.com/sisong/libmd5.git ../libmd5
+$ make MT=1 MD5=1
+```    
+   
+if on windows, befor compile `builds/vc/HDiffPatch.sln` by `Visual Studio` 
+```
+$ git clone https://github.com/sisong/lzma.git   ../lzma
+$ git clone https://github.com/sisong/libmd5.git ../libmd5
+$ git clone https://github.com/sisong/zlib.git   ../zlib
+$ git clone https://github.com/sisong/bzip2.git   ../bzip2
+```
+   
+build libhpatchz.so for android:   
+* install Android NDK
+* `$ cd <dir>/HDiffPatch/builds/android_ndk_jni_mk`
+* `$ build_libs.sh`   (or `$ build_libs.bat`, then got \*.so files)
+* import file `com/github/sisong/HPatch.java` (from `HDiffPatch/builds/android_ndk_jni_mk/java/`) & .so files, java code can call the patch function in libhpatchz.so
+   
+## diff command line usage:   
+diff     usage: **hdiffz** [options] **oldPath newPath outDiffFile**   
+compress usage: **hdiffz** [-c-...]  **"" newPath outDiffFile**   
+test    usage: **hdiffz**    -t     **oldPath newPath testDiffFile**   
+resave  usage: **hdiffz** [-c-...]  **diffFile outDiffFile**   
+get  manifest: **hdiffz** [-g#...] [-C-checksumType] **inputPath -M#outManifestTxtFile**   
+manifest diff: **hdiffz** [options] **-M-old#oldManifestFile -M-new#newManifestFile oldPath newPath outDiffFile**   
+```
+  oldPath newPath inputPath can be file or directory(folder),
+  oldPath can empty, and input parameter ""
+memory options:
+  -m[-matchScore]
+      DEFAULT; all file load into Memory; best diffFileSize;
+      requires (newFileSize+ oldFileSize*5(or *9 when oldFileSize>=2GB))+O(1)
+        bytes of memory;
+      matchScore>=0, DEFAULT -m-6, recommended bin: 0--4 text: 4--9 etc...
+  -s[-matchBlockSize]
+      all file load as Stream; fast;
+      requires O(oldFileSize*16/matchBlockSize+matchBlockSize*5)bytes of memory;
+      matchBlockSize>=4, DEFAULT -s-64, recommended 16,32,48,1k,64k,1m etc...
+special options:
+  -p-parallelThreadNumber
+      if parallelThreadNumber>1 then open multi-thread Parallel mode;
+      DEFAULT -p-4; requires more and more memory!
+  -c-compressType[-compressLevel]
+      set outDiffFile Compress type & level, DEFAULT uncompress;
+      for resave diffFile,recompress diffFile to outDiffFile by new set;
+      support compress type & level:
+       (re. https://github.com/sisong/lzbench/blob/master/lzbench171_sorted.md )
+        -c-zlib[-{1..9}]                DEFAULT level 9
+        -c-pzlib[-{1..9}]               DEFAULT level 6
+            support run by multi-thread parallel, fast!
+            WARNING: code not compatible with it compressed by -c-zlib!
+              and code size may be larger than if it compressed by -c-zlib. 
+        -c-bzip2[-{1..9}]               (or -bz2) DEFAULT level 9
+        -c-pbzip2[-{1..9}]              (or -pbz2) DEFAULT level 8
+            support run by multi-thread parallel, fast!
+            WARNING: code not compatible with it compressed by -c-bzip2!
+               and code size may be larger than if it compressed by -c-bzip2.
+        -c-lzma[-{0..9}[-dictSize]]     DEFAULT level 7
+            dictSize can like 4096 or 4k or 4m or 128m etc..., DEFAULT 8m
+            support run by 2-thread parallel.
+        -c-lzma2[-{0..9}[-dictSize]]    DEFAULT level 7
+            dictSize can like 4096 or 4k or 4m or 128m etc..., DEFAULT 8m
+            support run by multi-thread parallel, fast!
+            WARNING: code not compatible with it compressed by -c-lzma!
+  -C-checksumType
+      set outDiffFile Checksum type for directory diff, DEFAULT -C-fadler64;
+      (if need checksum for diff between two files, add -D)
+      support checksum type:
+        -C-no                   no checksum
+        -C-crc32
+        -C-fadler64             DEFAULT
+  -n-maxOpenFileNumber
+      limit Number of open files at same time when stream directory diff;
+      maxOpenFileNumber>=8, DEFAULT -n-48, the best limit value by different
+        operating system.
+  -g#ignorePath[#ignorePath#...]
+      set iGnore path list when Directory Diff; ignore path list such as:
+        #.DS_Store#desktop.ini#*thumbs*.db#.git*#.svn/#cache_*/00*11/*.tmp
+      # means separator between names; (if char # in name, need write #: )
+      * means can match any chars in name; (if char * in name, need write *: );
+      / at the end of name means must match directory;
+  -g-old#ignorePath[#ignorePath#...]
+      set iGnore path list in oldPath when Directory Diff;
+      if oldFile can be changed, need add it in old ignore list;
+  -g-new#ignorePath[#ignorePath#...]
+      set iGnore path list in newPath when Directory Diff;
+      in general, new ignore list should is empty;
+  -M#outManifestTxtFile
+      create a Manifest file for inputPath; it is a text file, saved infos of
+      all files and directoriy list in inputPath; this file while be used in 
+      manifest diff, support re-checksum data by manifest diff;
+      can be used to protect historical versions be modified!
+  -M-old#oldManifestFile
+      oldManifestFile is created from oldPath; if no oldPath not need -M-old;
+  -M-new#newManifestFile
+      newManifestFile is created from newPath;
+  -D  force run Directory diff between two files; DEFAULT (no -D) run 
+      directory diff need oldPath or newPath is directory.
+  -d  Diff only, do't run patch check, DEFAULT run patch check.
+  -t  Test only, run patch check, patch(oldPath,testDiffFile)==newPath ? 
+  -f  Force overwrite, ignore write path already exists;
+      DEFAULT (no -f) not overwrite and then return error;
+      if used -f and write path is exist directory, will always return error.
+  -o  DEPRECATED; Original diff, unsupport run with -s -c -C -D;
+      compatible with "diff_demo.cpp",
+      diffFile must patch by "patch_demo.c" or "hpatchz -o ..."
+  -h or -?
+      output Help info (this usage).
+  -v  output Version info.
+```
+   
+## patch command line usage:   
+patch usage: **hpatchz** [options] **oldPath diffFile outNewPath**   
+uncompress usage: **hpatchz** [options] **"" diffFile outNewPath**   
+create  SFX: **hpatchz** [-X-exe#selfExecuteFile] **diffFile -X#outSelfExtractArchive**   
+run     SFX: **selfExtractArchive** [options] **oldPath -X outNewPath**   
+extract SFX: **selfExtractArchive**   (same as: selfExtractArchive -f "" -X "./")
+```
+memory options:
+  -m  oldPath all loaded into Memory;
+      requires (oldFileSize+ 4*decompress stream size)+O(1) bytes of memory.
+  -s[-cacheSize] 
+      DEFAULT -s-64m; oldPath loaded as Stream;
+      requires (cacheSize+ 4*decompress stream size)+O(1) bytes of memory;
+      cacheSize can like 262144 or 256k or 512m or 2g etc....
+special options:
+  -C-checksumSets
+      set Checksum data for directory patch, DEFAULT -C-new-copy;
+      checksumSets support (can choose multiple):
+        -C-diff         checksum diffFile;
+        -C-old          checksum old reference files;
+        -C-new          checksum new files edited from old reference files;
+        -C-copy         checksum new files copy from old same files;
+        -C-no           no checksum;
+        -C-all          same as: -C-diff-old-new-copy;
+  -n-maxOpenFileNumber
+      limit Number of open files at same time when stream directory patch;
+      maxOpenFileNumber>=8, DEFAULT -n-24, the best limit value by different
+        operating system.
+  -f  Force overwrite, ignore write path already exists;
+      DEFAULT (no -f) not overwrite and then return error;
+      support oldPath outNewPath same path!(patch to tempPath and overwrite old)
+      if used -f and outNewPath is exist file:
+        if patch output file, will overwrite;
+        if patch output directory, will always return error;
+      if used -f and outNewPath is exist directory:
+        if patch output file, will always return error;
+        if patch output directory, will overwrite, but not delete
+          needless existing files in directory.
+  -o  DEPRECATED; Original patch; compatible with "patch_demo.c",
+      diffFile must created by "diff_demo.cpp" or "hdiffz -o ..."
+  -h or -?
+      output Help info (this usage).
+  -v  output Version info.
+```
+   
+---
+## library API usage:
+
+*  **create_diff**(newData,oldData,out diffData);
+   
+   release the diffData for update oldData.  
+   `note:` create_diff() out **uncompressed** diffData;     
+    you can compressed it by yourself or use **create_compressed_diff()**/patch_decompress() create **compressed** diffData;   
+    if your file size very large or request faster and less memory requires, you can use **create_compressed_diff_stream()**/patch_decompress(). 
+   
+*  bool **patch**(out newData,oldData,diffData);
+   
+   ok , get the newData. 
+
+---
+*  **patch()** runs in O(oldSize+newSize) time , and requires (oldSize+newSize+diffSize)+O(1) bytes of memory;     
+   **patch_stream()** requires O(1) bytes of memory;   
+   **patch_decompress()** requires (4\*decompress stream size)+O(1) bytes of memory.   
+   
+   **create_diff()** & **create_compressed_diff()** runs in O(oldSize+newSize) time , and if oldSize \< 2G Byte then requires oldSize\*5+newSize+O(1) bytes of memory; if oldSize \>= 2G Byte then requires oldSize\*9+newSize+O(1) bytes of memory;  
+   **create_compressed_diff_stream()** requires O(oldSize\*16/kMatchBlockSize+kMatchBlockSize\*5) bytes of memory.
+
+---
+*  **dir_diff()** & **dir patch APIs** read source code;   
+   
+---
+## HDiffPatch vs BsDiff:
+system: macOS10.12.6, compiler: xcode8.3.3 x64, CPU: i7 2.5G(turbo3.7G,6MB L3 cache),SSD Disk,Memroy:8G*2 DDR3 1600MHz   
+   (purge file cache before every test)
+```
+HDiffPatch2.4 hdiffz run by: -m -c-bzip2-9|-c-lzma-7-4m|-c-zlib-9 oldFile newFile outDiffFile
+              hpatchz run by: -m oldFile diffFile outNewFile
+BsDiff4.3 with bzip2 and all data in memory;
+          (NOTE: when compiling BsDiff4.3-x64, suffix string index type int64 changed to int32, 
+            faster and memroy requires to be halved!)   
+=======================================================================================================
+         Program               Uncompressed Compressed Compressed  BsDiff             hdiffz
+(newVersion<--oldVersion)           (tar)     (bzip2)    (lzma)    (bzip2)    (bzip2   lzma     zlib)
+-------------------------------------------------------------------------------------------------------
+apache-maven-2.2.1-src <--2.0.11    5150720   1213258    1175464    115723     83935    80997    91921
+httpd_2.4.4-netware-bin <--2.2.24  22612480   4035904    3459747   2192308   1809555  1616435  1938953
+httpd-2.4.4-src <-- 2.2.24         31809536   4775534    4141266   2492534   1882555  1717468  2084843
+Firefox-21.0-mac-en-US.app<--20.0  98740736  39731352   33027837  16454403  15749937 14018095 15417854
+emacs-24.3 <-- 23.4               185528320  42044895   33707445  12892536   9574423  8403235 10964939
+eclipse-java-juno-SR2-macosx
+  -cocoa-x86_64 <--x86_32         178595840 156054144  151542885   1595465   1587747  1561773  1567700
+gcc-src-4.8.0 <--4.7.0            552775680  86438193   64532384  11759496   8433260  7288783  9445004
+-------------------------------------------------------------------------------------------------------
+Average Compression                 100.00%    31.76%     28.47%     6.63%     5.58%    5.01%    5.86%
+=======================================================================================================
+
+=======================================================================================================
+   Program   run time(Second)   memory(MB)        run time(Second)              memory(MB)
+               BsDiff hdiffz  BsDiff  hdiffz   BsPatch       hpatchz        BsPatch     hpatchz 
+              (bzip2)(bzip2)  (bzip2)(bzip2)   (bzip2) (bzip2  lzma  zlib)  (bzip2) (bzip2 lzma zlib)
+-------------------------------------------------------------------------------------------------------
+apache-maven...  1.3   0.4       42     28       0.09    0.04  0.03  0.02       14      8     7     6
+httpd bin...     8.6   3.0      148    124       0.72    0.36  0.18  0.13       50     24    23    18
+httpd src...    20     5.1      322    233       0.99    0.46  0.24  0.17       78     44    42    37
+Firefox...      94    28        829    582       3.0     2.2   1.2   0.57      198    106   106    94
+emacs...       109    32       1400   1010       4.9     2.3   1.1   0.78      348    174   168   161
+eclipse        100    33       1500   1000       1.5     0.56  0.57  0.50      350    176   174   172
+gcc-src...     366    69       4420   3030       7.9     3.5   2.1   1.85     1020    518   517   504
+-------------------------------------------------------------------------------------------------------
+Average        100%   28.9%    100%   71.5%      100%   52.3% 29.9% 21.3%      100%  52.3% 50.3% 45.5%
+=======================================================================================================
+```
+   
+## HDiffPatch vs xdelta:
+system: macOS10.12.6, compiler: xcode8.3.3 x64, CPU: i7 2.5G(turbo3.7G,6MB L3 cache),SSD Disk,Memroy:8G*2 DDR3 1600MHz   
+   (purge file cache before every test)
+```
+HDiffPatch2.4 hdiffz run by: -s-128 -c-bzip2-9 oldFile newFile outDiffFile
+              hpatchz run by: -s-4m oldFile diffFile outNewFile
+xdelta3.1 diff run by: -e -s old_file new_file delta_file   
+          patch run by: -d -s old_file delta_file decoded_new_file
+         (NOTE fix: xdelta3.1 diff "gcc-src..." fail, add -B 530000000 diff ok,
+           out 14173073B and used 1070MB memory!)
+=======================================================================================================
+   Program              diff       run time(Second)  memory(MB)    patch run time(Second) memory(MB)
+                  xdelta3   hdiffz   xdelta3 hdiffz xdelta3 hdiffz  xdelta3  hpatchz   xdelta3 hpatchz
+-------------------------------------------------------------------------------------------------------
+apache-maven...   116265     83408     0.16   0.13     65    11       0.07    0.06        12      6
+httpd bin...     2174098   2077625     1.1    1.2     157    15       0.25    0.65        30      8
+httpd src...     2312990   2034666     1.3    1.7     185    15       0.30    0.91        50      8
+Firefox...      28451567  27504156    16     11       225    16       2.0     4.1        100      8
+emacs...        31655323  12033450    19      9.4     220    33       3.2     4.0         97     10
+eclipse          1590860   1636221     1.5    1.2     207    34       0.46    0.49        77      8 
+gcc-src...     107003829  12305741    56     19       224    79       9.7     9.5        102     11 
+           (fix 14173073)
+-------------------------------------------------------------------------------------------------------
+Average           12.18%    7.81%     100%  79.0%     100%  15.5%      100%  169.1%      100%  18.9%
+              (fix 9.78%)
+=======================================================================================================
+
+HDiffPatch2.4 hdiffz run by: -s-64 -c-lzma-7-4m  oldFile newFile outDiffFile
+              hpatchz run by: -s-4m oldFile diffFile outNewFile
+xdelta3.1 diff run by: -S lzma -9 -s old_file new_file delta_file   
+          patch run by: -d -s old_file delta_file decoded_new_file
+          (NOTE fix: xdelta3.1 diff "gcc-src..." fail, add -B 530000000 diff ok,
+            out 11787978B and used 2639MB memory.)
+=======================================================================================================
+   Program              diff       run time(Second)  memory(MB)    patch run time(Second) memory(MB)
+                  xdelta3   hdiffz   xdelta3 hdiffz xdelta3 hdiffz  xdelta3  hpatchz   xdelta3 hpatchz
+-------------------------------------------------------------------------------------------------------
+apache-maven...    98434     83668     0.37   0.29    220    24       0.04    0.06         12     5
+httpd bin...     1986880   1776553     2.5    2.9     356    59       0.24    0.52         30     8
+httpd src...     2057118   1794029     3.3    4.2     375    62       0.28    0.78         50     8
+Firefox...      27046727  21882343    27     32       416    76       1.8     2.2         100     9
+emacs...        29392254   9698236    38     32       413    97       3.1     2.9          97     9
+eclipse          1580342   1589045     3.0    1.9     399    76       0.48    0.48         77     6 
+gcc-src...      95991977   9118368   128     44       417   148       8.9     8.6         102    11 
+           (fix 11787978)
+-------------------------------------------------------------------------------------------------------
+Average           11.24%    6.44%     100%  88.9%     100%  20.0%      100%  151.1%       100%  17.3%
+              (fix 9.06%)
+=======================================================================================================
+```
+  
+---
+## Contact
+housisong@hotmail.com  
+