#!/usr/bin/python2.4 # xdelta 3 - delta compression tools and library # Copyright (C) 2003 and onward. Joshua P. MacDonald # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 2 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA # Under construction. # TODO: This is really part test, part performance evaluation suite, and # really incomplete. import os, sys, math, re, time, types, array import xdelta3 HIST_SIZE = 10 # the number of buckets MIN_SIZE = 0 TIME_TOO_SHORT = 0.050 MIN_REPS = 1 MAX_REPS = 1 SKIP_TRIALS = 1 MIN_TRIALS = 3 MAX_TRIALS = 15 #SKIP_TRIALS = 0 #MIN_TRIALS = 1 #MAX_TRIALS = 1 MIN_STDDEV_PCT = 1.5 # stop MAX_RUN = 1000 * 1000 * 10 # # RCSDIR = '/mnt/polaroid/Polaroid/orbit_linux/home/jmacd/PRCS/prcs/b' TMPDIR = '/tmp/xd3regtest.%d' % os.getpid() RUNFILE = os.path.join(TMPDIR, 'run') HFILE = os.path.join(TMPDIR, 'hdr') DFILE = os.path.join(TMPDIR, 'output') RFILE = os.path.join(TMPDIR, 'recon') HEAD_STATE = 0 BAR_STATE = 1 REV_STATE = 2 DATE_STATE = 3 # rcs output RE_TOTREV = re.compile('total revisions: (\\d+)') RE_BAR = re.compile('----------------------------') RE_REV = re.compile('revision (.+)') RE_DATE = re.compile('date: ([^;]+);.*') # xdelta output RE_HDRSZ = re.compile('VCDIFF header size: +(\\d+)') RE_EXTCOMP = re.compile('XDELTA ext comp.*') # # exceptions class SkipRcsException: def __init__(self,reason): self.reason = reason class NotEnoughVersions: def __init__(self): pass class CommandError: def __init__(self,cmd,str): if type(cmd) is types.TupleType or \ type(cmd) is types.ListType: cmd = reduce(lambda x,y: '%s %s' % (x,y),cmd) print 'command was: ',cmd print 'command failed: ',str print 'have fun debugging' # # one version class RcsVersion: def __init__(self,vstr): self.vstr = vstr def __cmp__(self,other): return cmp(self.date, other.date) def Print(self): print '%s %s' % (self.vstr, self.date) # # one rcsfile class RcsFile: def __init__(self, fname): self.fname = fname self.versions = [] self.state = HEAD_STATE def SetTotRev(self,s): self.totrev = int(s) def Rev(self,s): self.rev = RcsVersion(s) if len(self.versions) >= self.totrev: raise SkipRcsException('too many versions (in log messages)') self.versions.append(self.rev) def Date(self,s): self.rev.date = s def Match(self, line, state, rx, gp, newstate, f): if state == self.state: m = rx.match(line) if m: if f: f(m.group(gp)) self.state = newstate return 1 return None def Sum1Rlog(self): f = os.popen('rlog '+self.fname, "r") l = f.readline() while l: if self.Match(l, HEAD_STATE, RE_TOTREV, 1, BAR_STATE, self.SetTotRev): pass elif self.Match(l, BAR_STATE, RE_BAR, 1, REV_STATE, None): pass elif self.Match(l, REV_STATE, RE_REV, 1, DATE_STATE, self.Rev): pass elif self.Match(l, DATE_STATE, RE_DATE, 1, BAR_STATE, self.Date): pass l = f.readline() c = f.close() if c != None: raise c #print '%s versions %d' % (self.fname, len(self.versions)) #for v in self.versions: # v.Print() def Sum1(self): st = os.stat(self.fname) self.rcssize = st.st_size self.Sum1Rlog() if self.totrev != len(self.versions): raise SkipRcsException('wrong version count') self.versions.sort() def Checkout(self,n): v = self.versions[n] out = open(self.Verf(n), "w") cmd = 'co -ko -p%s %s' % (v.vstr, self.fname) total = 0 (inf, stream, err) = os.popen3(cmd, "r") inf.close() buf = stream.read() while buf: total = total + len(buf) out.write(buf) buf = stream.read() v.vsize = total estr = '' buf = err.read() while buf: estr = estr + buf buf = err.read() if stream.close(): raise CommandError(cmd, 'checkout failed: %s\n%s\n%s' % (v.vstr, self.fname, estr)) out.close() err.close() def Vdate(self,n): return self.versions[n].date def Vstr(self,n): return self.versions[n].vstr def Verf(self,n): return os.path.join(TMPDIR, 'input.%d' % n) def PairsByDate(self,runnable): if self.totrev < 2: raise NotEnoughVersions() self.Checkout(0) ntrials = [] if self.totrev < 2: return vtrials for v in range(0,self.totrev-1): if v > 1: os.remove(self.Verf(v-1)) self.Checkout(v+1) if os.stat(self.Verf(v)).st_size < MIN_SIZE or \ os.stat(self.Verf(v+1)).st_size < MIN_SIZE: continue result = TimeRun(runnable.Runner(self.Verf(v), self.Vstr(v), self.Verf(v+1), self.Vstr(v+1))) print 'testing %s %s: ideal %.3f%%: time %.7f: in %u/%u trials' % \ (os.path.basename(self.fname), self.Vstr(v+1), result.r1.ideal, result.time.mean, result.trials, result.reps) ntrials.append(result) os.remove(self.Verf(self.totrev-1)) os.remove(self.Verf(self.totrev-2)) return ntrials # # This class recursively scans a directory for rcsfiles class RcsFinder: def __init__(self): self.subdirs = [] self.rcsfiles = [] self.others = [] self.skipped = [] def Scan1(self,dir): dents = os.listdir(dir) subdirs = [] rcsfiles = [] others = [] for dent in dents: full = os.path.join(dir, dent) if os.path.isdir(full): subdirs.append(full) elif dent[len(dent)-2:] == ",v": rcsfiles.append(RcsFile(full)) else: others.append(full) self.subdirs = self.subdirs + subdirs self.rcsfiles = self.rcsfiles + rcsfiles self.others = self.others + others return subdirs def Crawl(self, dir): subdirs = [dir] while subdirs: s1 = self.Scan1(subdirs[0]) subdirs = subdirs[1:] + s1 def Summarize(self): good = [] for rf in self.rcsfiles: try: rf.Sum1() if rf.totrev < 2: raise SkipRcsException('too few versions (< 2)') except SkipRcsException, e: #print 'skipping file %s: %s' % (rf.fname, e.reason) self.skipped.append(rf) else: good.append(rf) self.rcsfiles = good def PairsByDate(self,runnable): allvtrials = [] good = [] for rf in self.rcsfiles: print 'testing %s on %s with %d versions' % (runnable.type, rf.fname, rf.totrev) try: allvtrials.append(rf.PairsByDate(runnable)) except SkipRcsException: print 'file %s has compressed versions: skipping' % (rf.fname) except NotEnoughVersions: print 'testing %s on %s: not enough versions' % (runnable.type, rf.fname) else: good.append(rf) self.rcsfiles = good return allvtrials # # class Bucks: def __init__(self,low,high): self.low = low self.high = high self.spread = high - low self.bucks = [] for i in range(0,HIST_SIZE): self.bucks.append([low+(self.spread * (i+0.0) / float(HIST_SIZE)), low+(self.spread * (i+0.5) / float(HIST_SIZE)), low+(self.spread * (i+1.0) / float(HIST_SIZE)), 0]) def Add(self, x): assert(x>=self.low) assert(x skip_trials: self.measured.append((elap_clock,elap_time)) #print 'measurement total: %.1f ms' % (total_time * 1000.0) # at least so many if self.trials < (skip_trials + min_trials): #print 'continue: need more trials: %d' % self.trials continue # compute %variance done = 0 if skip_trials + min_trials <= 2: done = 1 self.measured = self.measured + self.measured; self.time = StatList([x[1] for x in self.measured], 'elap time') sp = float(self.time.s) / float(self.time.mean) # what if MAX_TRIALS is exceeded? too_many = (self.trials-skip_trials) >= max_trials good = (100.0 * sp) < min_stddev_pct if done or too_many or good: self.trials = self.trials - skip_trials if not done and not good: #print 'too many trials: %d' % self.trials pass self.clock = StatList([x[0] for x in self.measured], 'elap clock') return # # # def SumList(l): return reduce(lambda x,y: x+y, l) # # returns (total, mean, stddev, q2 (median), # (q3-q1)/2 ("semi-interquartile range"), max-min (spread)) class StatList: def __init__(self,l,desc,hist=0): cnt = len(l) assert(cnt > 1) l.sort() self.cnt = cnt self.l = l self.total = SumList(l) self.mean = self.total / float(self.cnt) self.s = math.sqrt(SumList([(x-self.mean) * (x - self.mean) for x in l]) / float(self.cnt-1)) self.q0 = l[0] self.q1 = l[int(self.cnt/4.0+0.5)] self.q2 = l[int(self.cnt/2.0+0.5)] self.q3 = l[min(self.cnt-1,int((3.0*self.cnt)/4.0+0.5))] self.q4 = l[self.cnt-1]+1 self.hf = "./%s.hist" % desc self.siqr = (self.q3-self.q1)/2.0; self.spread = (self.q4-self.q0) self.str = '%s %d; mean %d; sdev %d; q2 %d; .5(q3-q1) %.1f; spread %d' % \ (desc, self.total, self.mean, self.s, self.q2, self.siqr, self.spread) if hist: f = open(self.hf, "w") self.bucks = Bucks(self.q0,self.q4) for i in l: self.bucks.Add(i) self.bucks.Print(f) f.close() def RunCommand(args): #print "run command", args p = os.spawnvp(os.P_WAIT, args[0], args) if p != 0: raise CommandError(args, 'exited %d' % p) def RunCommandIO(args,infn,outfn): #print "run command io", args p = os.fork() if p == 0: os.dup2(os.open(infn,os.O_RDONLY),0) os.dup2(os.open(outfn,os.O_CREAT|os.O_TRUNC|os.O_WRONLY),1) os.execvp(args[0], args) else: s = os.waitpid(p,0) o = os.WEXITSTATUS(s[1]) if not os.WIFEXITED(s[1]) or o != 0: raise CommandError(args, 'exited %d' % o) def RunXdelta3(args): try: xdelta3.main(args) except Exception, e: raise CommandError(args, "xdelta3.main exception") class GzipInfo: def __init__(self,target,delta): self.tgtsize = os.stat(target).st_size self.dsize = os.stat(delta).st_size class Xdelta3Info: def __init__(self,target,delta): self.extcomp = 0 # TODO: I removed some code that called printhdr self.hdrsize = 0 # to compute these, but printhdr uses stdout (now) self.tgtsize = os.stat(target).st_size self.dsize = os.stat(delta).st_size if self.tgtsize > 0: self.ideal = 100.0 * self.dsize / self.tgtsize; else: self.ideal = 0.0 class Xdelta3Pair: def __init__(self): self.type = 'xdelta3' self.decode_args = '-dqf' self.encode_args = '-eqf' self.presrc = '-s' self.canrep = 1 def Runner(self,old,oldv,new,newv): self.old = old self.oldv = oldv self.new = new self.newv = newv return self def Run(self,trial,reps): RunXdelta3(['-P', '%d' % reps, self.encode_args, self.presrc, self.old, self.new, DFILE]) if trial > 0: return None self.dinfo = Xdelta3Info(self.new,DFILE) if self.dinfo.extcomp: raise SkipRcsException('ext comp') RunXdelta3([self.decode_args, self.presrc, self.old, DFILE, RFILE]) RunCommand(('cmp', self.new, RFILE)) return self.dinfo def Test(): rcsf = RcsFinder() rcsf.Crawl(RCSDIR) if len(rcsf.rcsfiles) == 0: sys.exit(1) rcsf.Summarize() print "rcsfiles: rcsfiles %d; subdirs %d; others %d; skipped %d" % (len(rcsf.rcsfiles), len(rcsf.subdirs), len(rcsf.others), len(rcsf.skipped)) print StatList([x.rcssize for x in rcsf.rcsfiles], "rcssize", 1).str print StatList([x.totrev for x in rcsf.rcsfiles], "totrev", 1).str pairs = rcsf.PairsByDate(Xdelta3Pair()) def Decimals(max): l = [0] step = 1 while 1: r = range(step, step * 10, step) l = l + r if step * 10 >= max: l.append(step * 10) break step = step * 10 return l class Xdelta3Run1: def __init__(self,file,reps=0): self.file = file self.reps = reps self.canrep = 1 def Run(self,trial,reps): if self.reps: assert(reps == 1) reps = self.reps RunXdelta3(['-P', '%d' % reps, '-efq', self.file, DFILE]) if trial > 0: return None return Xdelta3Info(self.file,DFILE) class GzipRun1: def __init__(self,file): self.file = file self.canrep = 0 def Run(self,trial,reps): assert(reps == 1) RunCommandIO(['gzip', '-cf'], self.file, DFILE) if trial > 0: return None return GzipInfo(self.file,DFILE) def SetFileSize(F,L): fd = os.open(F, os.O_CREAT | os.O_WRONLY) os.ftruncate(fd,L) assert(os.fstat(fd).st_size == L) os.close(fd) def ReportSpeed(L,tr,desc): print '%s 0-run length %u: dsize %u: time %.3f ms: encode %.0f B/sec: in %ux%u trials' % \ (desc, L, tr.r1.dsize, tr.time.mean * 1000.0, ((L+tr.r1.dsize) / tr.time.mean), tr.trials, tr.reps) def RunSpeed(): for L in Decimals(MAX_RUN): SetFileSize(RUNFILE, L) trx = TimeRun(Xdelta3Run1(RUNFILE)) ReportSpeed(L,trx,'xdelta3') trg = TimeRun(GzipRun1(RUNFILE)) ReportSpeed(L,trg,'gzip ') if __name__ == "__main__": try: os.mkdir(TMPDIR) Test() RunSpeed() except CommandError: pass else: RunCommand(['rm', '-rf', TMPDIR])