{ *************************************************************************** * * * This source 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 code 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. * * * * A copy of the GNU General Public License is available on the World * * Wide Web at . You can also * * obtain it by writing to the Free Software Foundation, * * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * * * *************************************************************************** Author: Vincent Snijders Name: svn2revisioninc - creates an include file with the revision number Synopsis: svn2revisioninc sourcedir revision.inc Description: svn2revisioninc creates an include file with the current revision number. If the source directory contains a .svn subdirectory, it tries to execute svnversion to get the revision number. If that fails - for example, because it can't find svnversion - it opens .svn/entries to get the revision number of the source directory. If it can't find revision information, it checks whether the revision.inc exists. If it exists and seems to be created with svn2revisioninc, it will leave the file as is. Otherwise it will create a new revision.inc, indicating that the revision number is unknown. If the source directory don't contains a .svn subdirectory, it search for a .git directory. If i exist, it tries to execute git to get the revision number. } program Svn2RevisionInc; {$mode objfpc}{$H+} uses Classes, CustApp, SysUtils, Process, UTF8Process, LCLProc, FileUtil, Dom, XmlRead, GetOpts; type { TSvn2RevisionApplication } TSvn2RevisionApplication = class(TCustomApplication) private SourceDirectory, RevisionIncFileName: string; RevisionIncDirName: string; RevisionStr: string; MainBranch: string; ConstName: string; Verbose: boolean; UseStdOut: boolean; function FindRevision: boolean; function IsValidRevisionInc: boolean; procedure WriteRevisionInc; function ParamsValid: boolean; procedure ShowHelp; function CanCreateRevisionInc: boolean; function ConstStart: string; procedure Show(msg: string); function IsThisGitUpstreamBranch: boolean; function GetGitBranchPoint: string; function GitRevisionFromGitCommit: boolean; public constructor Create(TheOwner: TComponent); override; destructor Destroy; override; procedure Run; end; var Application: TSvn2RevisionApplication = nil; const RevisionIncComment = '// Created by Svn2RevisionInc'; function TSvn2RevisionApplication.FindRevision: boolean; var GitDir: string; function GetRevisionFromGitVersion : boolean; var GitVersionProcess: TProcessUTF8; Buffer: string; n: LongInt; begin Result:=false; GitVersionProcess := TProcessUTF8.Create(nil); try with GitVersionProcess do begin CommandLine := 'git log -1 --pretty=format:"%b"'; Options := [poUsePipes, poWaitOnExit]; try CurrentDirectory:=GitDir; Execute; SetLength(Buffer, 80); n:=OutPut.Read(Buffer[1], 80); if (Pos('git-svn-id:', Buffer) > 0) then begin //Read version is OK Result:=true; RevisionStr := Copy(Buffer, 1, n); System.Delete(RevisionStr, 1, Pos('@', RevisionStr)); System.Delete(RevisionStr, Pos(' ', RevisionStr), Length(RevisionStr)); end; except // ignore error, default result is false end; end; finally GitVersionProcess.Free; end; end; function GetRevisionFromSvnVersion : boolean; var SvnVersionProcess: TProcessUTF8; Buffer: string; n: LongInt; begin Result:=false; SvnVersionProcess := TProcessUTF8.Create(nil); try with SvnVersionProcess do begin CommandLine := 'svnversion -n "' + SourceDirectory + '"'; Options := [poUsePipes, poWaitOnExit]; try Execute; SetLength(Buffer, 80); n:=OutPut.Read(Buffer[1], 80); RevisionStr := Copy(Buffer, 1, n); // If cannot determine svn version it will return localized message // "Unversioned directory" with no error result but svn revisions // always start with a number. Result:=(n > 0) and (RevisionStr[1] in ['0'..'9']); SetLength(Buffer, 1024); n:=Stderr.Read(Buffer[1], 1024); Show('Retrieved revision with svnversion.'); Show(''); Show('svnversion error:'); Show(Copy(Buffer, 1, n)); Show(''); except // ignore error, default result is false end; end; finally SvnVersionProcess.Free; end; end; function GetRevisionFromEntriesTxt: boolean; var EntriesFileName: string; EntriesText: Text; line: string; begin Result:=false; EntriesFileName:=AppendPathDelim(SourceDirectory)+'.svn'+PathDelim+'entries'; if FileExistsUTF8(EntriesFileName) then begin try AssignFile(EntriesText, EntriesFileName); Reset(EntriesText); try // skip three lines Readln(EntriesText, line); if line<>'' then begin Readln(EntriesText); Readln(EntriesText); Readln(EntriesText, RevisionStr); Result := RevisionStr <> ''; end; finally CloseFile(EntriesText); end; except // ignore error, default result is false end; end; end; function GetRevisionFromEntriesXml: boolean; var EntriesFileName: string; EntriesDoc: TXMLDocument; EntryNode: TDomNode; begin Result:=false; EntriesFileName:=AppendPathDelim(SourceDirectory)+'.svn'+PathDelim+'entries'; if FileExistsUTF8(EntriesFileName) then begin try ReadXMLFile(EntriesDoc, EntriesFileName); try EntryNode := EntriesDoc.FirstChild.FirstChild; while not Result and (EntryNode<>nil) do begin if EntryNode.Attributes.GetNamedItem('name').NodeValue='' then begin RevisionStr:=EntryNode.Attributes.GetNamedItem('revision').NodeValue; Result:=true; end; EntryNode := EntryNode.NextSibling; end; finally EntriesDoc.Free; end; except // ignore error, default result is false end; end; end; begin Result := GetRevisionFromSvnVersion or GetRevisionFromEntriesTxt or GetRevisionFromEntriesXml; if not Result then begin GitDir:= AppendPathDelim(SourceDirectory)+'.git'; if DirectoryExistsUTF8(GitDir) then begin if IsThisGitUpstreamBranch then Result := GetRevisionFromGitVersion else Result := GitRevisionFromGitCommit; end; end; end; constructor TSvn2RevisionApplication.Create(TheOwner: TComponent); begin inherited Create(TheOwner); RevisionStr := 'Unknown'; end; destructor TSvn2RevisionApplication.Destroy; begin inherited Destroy; end; function TSvn2RevisionApplication.IsValidRevisionInc: boolean; var Lines: TStringList; begin Result:=false; if FileExistsUTF8(RevisionIncFileName) then begin Lines := TStringList.Create; Lines.LoadFromFile(UTF8ToSys(RevisionIncFileName)); if (Lines.Count=2) and (Lines[0]=RevisionIncComment) and (copy(Lines[1], 1, length(ConstStart))=ConstStart) then Result:=true; end; end; procedure TSvn2RevisionApplication.WriteRevisionInc; var RevisionIncText: Text; begin AssignFile(RevisionIncText, RevisionIncFileName); Rewrite(RevisionIncText); writeln(RevisionIncText, RevisionIncComment); writeln(RevisionIncText, ConstStart, RevisionStr, ''';'); CloseFile(RevisionIncText); debugln(format('Created %s for revision: %s', [RevisionIncFileName, RevisionStr])); end; procedure TSvn2RevisionApplication.ShowHelp; function ExtractFileBaseName(FileName: string): string; begin Result := ChangeFileExt(ExtractFileName(FileName), ''); end; begin debugln; debugln(ParamStrUTF8(0)); debugln; debugln(ExtractFileBaseName(ParamStrUTF8(0)), ' [Options]'); debugln('or'); debugln(ExtractFileBaseName(ParamStrUTF8(0)), ' [Options] '); debugln('or'); debugln(ExtractFileBaseName(ParamStrUTF8(0)), ' [Options] '); debugln; debugln('Options:'); debugln(' --o Output file'); debugln(' --c= Name of constant (default RevisionStr)'); debugln(' --s write revision to stdout, do not create inc file'); debugln(' --v Be more verbose'); debugln(' --h This help screen'); debugln; debugln('Note: default current directory'); debugln(' default revision.inc'); debugln(' --o overrides '); debugln; debugln(' 1st switchless parameter = '); debugln(' 2nd switchless parameter = '); halt(1); end; function TSvn2RevisionApplication.ParamsValid: boolean; var i: integer; index: integer; begin Result := False; //reset Verbose := False; ConstName := 'RevisionStr'; SourceDirectory:=ChompPathDelim(ExtractFilePath(ParamStrUTF8(0))); RevisionIncFileName := ExpandFileNameUTF8('revision.inc'); //find switchless parameters index := 1; for i := 1 to ParamCount do begin if Copy(ParamStrUTF8(i),1,1) <> '-' then begin case index of 1: SourceDirectory:=ChompPathDelim(ParamStrUTF8(i)); 2: RevisionIncFileName := ExpandFileNameUTF8(ParamStrUTF8(i)); end; Inc(index); end; end; //parse options if HasOption('h', 'help') or HasOption('?') then ShowHelp; if HasOption('v') then Verbose := True; if HasOption('s') then UseStdOut := True; if HasOption('c') then ConstName := GetOptionValue('c'); if HasOption('o') then RevisionIncFileName := GetOptionValue('o'); //show options Show('SourceDirectory: ' + SourceDirectory); Show('RevisionIncFileName: ' + RevisionIncFileName); Show('ConstName: ' + ConstName); Show(''); //checks if not DirectoryExistsUTF8(SourceDirectory) then begin debugln('Error: Source directory "', SourceDirectory, '" doesn''t exist.'); exit; end; RevisionIncDirName:=ExtractFilePath(ExpandFileNameUTF8(RevisionIncFileName)); if (not UseStdOut) and (not DirectoryExistsUTF8(RevisionIncDirName)) then begin debugln('Error: Target Directory "', RevisionIncDirName, '" doesn''t exist.'); exit; end; if ConstName[1] in ['0'..'9'] then begin debugln('Error: Invalid constant name ', ConstName, '.'); exit; end; Result := True; end; function TSvn2RevisionApplication.CanCreateRevisionInc: boolean; begin if (FileExistsUTF8(RevisionIncFileName)) then Result:= FileIsWritable(RevisionIncFileName) else Result := DirectoryIsWritable(RevisionIncDirName); end; function TSvn2RevisionApplication.ConstStart: string; begin Result := Format('const %s = ''', [ConstName]); end; procedure TSvn2RevisionApplication.Show(msg: string); begin if Verbose then debugln(msg); end; { Determine what branch we are in by looking at the 'git branch' output. Sample output: $ git branch custom-patches docs dubydebugger externtools filebrowser * filefilters fixes graeme upstream work } function TSvn2RevisionApplication.IsThisGitUpstreamBranch: boolean; const cBufSize = 2048; MainBranchNames: array[0..1] of string = ('upstream', 'master'); var p: TProcessUTF8; Buffer: string; s: string; i, j: integer; n: LongInt; sl: TStringList; begin Result := false; p := TProcessUTF8.Create(nil); try sl := TStringList.Create; p.CommandLine := 'git branch'; p.Options := [poUsePipes, poWaitOnExit]; p.Execute; // Now lets process the output SetLength(Buffer, cBufSize); s := ''; repeat n := p.Output.Read(Buffer[1], cBufSize); s := s + Copy(Buffer, 1, n); until n < cBufSize; sl.Text := s; // Search for the active branch marker '*' symbol. // Guess the main branch name. Support 'master' and 'upstream'. MainBranch := ''; for i := 0 to sl.Count-1 do begin for j := Low(MainBranchNames) to High(MainBranchNames) do begin if Pos(MainBranchNames[j], sl[i]) > 0 then begin MainBranch := MainBranchNames[j]; if sl[i][1] = '*' then begin Result := True; exit; end; end; end; end; finally sl.Free; p.Free; end; end; { Determine the commit at which we branched away from 'upstream'. Note the SHA1 commit we are looking for is always the last one in the list that has the '-' prefix added. Example output: $ git rev-list --boundary HEAD...upstream a39f9f70f96b9533377c2cad27155066a0b01411 3874aa82b83fedaa19459fedaa30f4582251b9a1 0379257d111d465bf28e879d6b87080d9e896648 5dd8ca18ef06520a524bfac9648103d440fbe0bc -d1fba5c3f36a4816c933a8f7f361c585258b5b01 } function TSvn2RevisionApplication.GetGitBranchPoint: string; const READ_BYTES = 2048; var p: TProcessUTF8; MemStream: TMemoryStream; n, i, NumBytes, BytesRead: integer; s: string; sl: TStringList; begin Result := ''; BytesRead := 0; sl := Nil; MemStream := TMemoryStream.Create; p := TProcessUTF8.Create(nil); try p.CommandLine := 'git rev-list --boundary HEAD...' + MainBranch; p.Options := [poUsePipes]; p.Execute; // read while the process is running while p.Running do begin MemStream.SetSize(BytesRead + READ_BYTES); // make sure we have room // try reading it NumBytes := p.Output.Read((MemStream.Memory + BytesRead)^, READ_BYTES); if NumBytes > 0 then Inc(BytesRead, NumBytes) else // no data, wait 100 ms Sleep(100); end; // read last part repeat MemStream.SetSize(BytesRead + READ_BYTES); NumBytes := p.Output.Read((MemStream.Memory + BytesRead)^, READ_BYTES); if NumBytes > 0 then Inc(BytesRead, NumBytes); until NumBytes <= 0; MemStream.SetSize(BytesRead); sl := TStringList.Create; sl.LoadFromStream(MemStream); { now search for the '-' marker. Should be the last one, so search in reverse. } for i := sl.Count-1 downto 0 do begin s := sl[i]; n := Pos('-', s); if n > 0 then begin Result := Copy(s, 2, Length(s)); exit; end; end; finally sl.Free; p.Free; MemStream.Free; end; end; { Get the branch point, and exact the SVN revision from that commit log } function TSvn2RevisionApplication.GitRevisionFromGitCommit: Boolean; const cBufSize = 80; var sha1: string; p: TProcessUTF8; Buffer: string; n: LongInt; s: string; begin Result := False; sha1 := GetGitBranchPoint; p := TProcessUTF8.Create(nil); try with p do begin CommandLine := 'git show --summary --pretty=format:"%b" ' + sha1; Options := [poUsePipes, poWaitOnExit]; try Execute; { now process the output } SetLength(Buffer, cBufSize); s := ''; repeat n := OutPut.Read(Buffer[1], cBufSize); s := s + Copy(Buffer, 1, n); until n < cBufSize; { now search for our marker } if (Pos('git-svn-id:', s) > 0) then begin Result := True; RevisionStr := s; System.Delete(RevisionStr, 1, Pos('@', RevisionStr)); System.Delete(RevisionStr, Pos(' ', RevisionStr), Length(RevisionStr)); end; except // ignore error, default result is false end; end; finally p.Free; end; end; procedure TSvn2RevisionApplication.Run; begin if not ParamsValid then ShowHelp; if not CanCreateRevisionInc then exit; if UseStdOut then begin if FindRevision then debugln(RevisionStr); end else if FindRevision or not IsValidRevisionInc then WriteRevisionInc; end; begin Application := TSvn2RevisionApplication.Create(nil); Application.Run; Application.Free; end.