像Subversion中的Git关键字替换?

时间:2012-07-18 05:14:08

标签: git svn version-control version-control-keywords

我曾经在Subversion / SVN下工作,并立即使用称为关键字替换的好功能。只需输入源文件就像:

/*
 *   $Author: ivanovpv $
 *   $Rev: 42 $
 *   $LastChangedDate: 2012-05-25 21:47:42 +0200 (Fri, 25 May 2012) $
 */

每次Subversion都用实际的关键字替换关键字(Author,Rev,LastChangedDate)。

前段时间我被迫转移到Git,只是想知道是否有类似Subversion在Git中的关键字替换?

3 个答案:

答案 0 :(得分:27)

Git没有提供开箱即用的此功能。但是,在Customizing Git上的Git Book中有一章,其中一个例子是如何使用git属性来实现类似的结果。

  

事实证明,您可以编写自己的过滤器   提交/结帐时文件中的替换。这些被称为“干净”   和“涂抹”过滤器。在.gitattributes文件中,您可以设置过滤器   对于特定路径,然后设置将处理文件的脚本   就在它们被检查出来之前(“涂抹”),就在它们出现之前   上演(“干净”)。这些过滤器可以设置为各种乐趣   的东西。

$LastChangedDate: $甚至还有一个例子:

  

另一个有趣的例子是$Date$关键字扩展,RCS风格。   要正确执行此操作,您需要一个带有文件名的小脚本,   计算出该项目的最后提交日期,并插入   日期到文件中。这是一个小的Ruby脚本:

#! /usr/bin/env ruby
data = STDIN.read
last_date = `git log --pretty=format:"%ad" -1`
puts data.gsub('$Date$', '$Date: ' + last_date.to_s + '$')
     

所有脚本都会获得最新的提交   从git log命令开始,将其粘贴到任何$Date$字符串中   在stdin中看到并打印结果 - 它应该很简单   无论你最喜欢哪种语言。你可以命名这个文件   expand_date并将其放在你的道路上。现在,您需要设置过滤器   在Git中(称之为dater)并告诉它使用您的expand_date过滤器   在结帐时弄脏文件。您将使用Perl表达式进行清理   那个提交:

$ git config filter.dater.smudge expand_date
$ git config filter.dater.clean 'perl -pe "s/\\\$Date[^\\\$]*\\\$/\\\$Date\\\$/"'
     

这个Perl片段会删除它在$Date$字符串中看到的任何内容   回到你开始的地方。现在您的过滤器已准备就绪,您可以   通过为该文件设置一个Git属性来测试它   新过滤器并使用$Date$关键字创建文件:

date*.txt filter=dater
$ echo '# $Date$' > date_test.txt If you commit
     

这些更改并再次检出文件,您会看到关键字   适当替代:

$ git add date_test.txt .gitattributes
$ git commit -m "Testing date expansion in Git"
$ rm date_test.txt
$ git checkout date_test.txt
$ cat date_test.txt
# $Date: Tue Apr 21 07:26:52 2009 -0700$
     

您可以看到此技术对自定义应用程序的强大功能。你必须要小心,   但是,因为.gitattributes文件已提交并传递   与项目,但驱动程序(在这种情况下,dater)不是,所以它   不会到处工作。当你设计这些过滤器时,它们应该是   能够优雅地失败并让项目仍能正常运作。

答案 1 :(得分:14)

解决方案

嗯,你可以自己轻松实现这样的功能。

基本上我将commit命令嵌入到shell脚本中。此脚本将首先替换所需的宏,然后提交更改。该项目包含两个文件:

内容?

keysub,bash shell脚本和keysub.awk awk脚本,用于替换特定文件中的关键字。第三个文件是一个配置文件,其中包含应该替换的值(除了提交计数和时间戳之类的可变内容)。

你如何使用它?

您调用keysub而不是使用相同选项提交。 -m-a选项应该在任何其他提交选项之前。一个新选项(应该始终是第一个)是-f,它将配置文件作为值。例如:

$ git add 'someJavaFile.java'
$ keysub -m 'fixed concurrent thread issue'
$ git push

$ git -f .myfile.cnf -m 'enhanced javadoc entries'

keysub

#!/bin/bash

# 0 -- functions/methods
#########################
# <Function description>
function get_timestamp () {
  date    # change this to get a custom timestamp
}

# 1 -- Variable declarations
#############################
# input file for mapping
file=".keysub.cnf"
timestamp=$(get_timestamp)


# 2 -- Argument parsing and flag checks
########################################

# Parsing flag-list
while getopts ":f:m:a" opt;
do
  case $opt in
    f) file=${OPTARG}
       ;;
    a) echo 'Warning, keyword substitution will be incomplete when invoked'
       echo 'with the -a flag. The commit message will not be substituted into'
       echo 'source files. Use -m "message" for full substitutions.'
       echo -e 'Would you like to continue [y/n]? \c'
       read answer
       [[ ${answer} =~ [Yy] ]] || exit 3
       unset answer
       type="commit_a"
       break
       ;;
    m) type="commit_m"
       commitmsg=${OPTARG}
       break
       ;;
   \?) break
       ;;
  esac
done
shift $(($OPTIND - 1))

# check file for typing
if [[ ! -f ${file} ]]
then
  echo 'No valid config file found.'
  exit 1
fi

# check if commit type was supplied
if [[ -z ${type} ]]
then
  echo 'No commit parameters/flags supplied...'
  exit 2
fi

# 3 -- write config file
#########################
sed "
  /timestamp:/ {
    s/\(timestamp:\).*/\1${timestamp}/
  }
  /commitmsg:/ {
    s/\(commitmsg:\).*/\1${commitmsg:-default commit message}/
  }
" ${file} > tmp

mv tmp ${file}

# 4 -- get remaining tags
##########################
author=$(grep 'author' ${file} | cut -f1 -d':' --complement)


# 5 -- get files ready to commit
#################################
git status -s | grep '^[MARCU]' | cut -c1-3 --complement > tmplist

# 6 -- invoke awk and perform substitution
###########################################
# beware to change path to your location of the awk script
for item in $(cat tmplist)
do
  echo ${item}
  awk -v "commitmsg=${commitmsg}" -v "author=${author}" \
      -v "timestamp=${timestamp}" -f "${HOME}/lib/awk/keysub.awk" ${item} \
      > tmpfile
  mv tmpfile ${item}
done
rm tmplist

# 5 -- invoke git commit
#########################
case ${type} in
  "commit_m") git commit -m "${commitmsg}" "$@"
              ;;
  "commit_a") git commit -a "$@"
              ;;
esac

# exit using success code
exit 0

keysub.awk

# 0 BEGIN
##########
BEGIN {
  FS=":"
  OFS=": "
}

# 1 parse source files 
########################
# update author
$0 ~ /.*\$Author.*\$.*/ {
  $2=author " $"
}

# update timestamp
$0 ~ /.*\$LastChangedDate.*\$.*/ {
  $0=$1
  $2=timestamp " $"
}

# update commit message
$0 ~ /.*\$LastChangeMessage.*\$.*/ {
  $2=commitmsg " $"
}

# update commit counts
$0 ~ /.*\$Rev.*\$.*/ {
  ++$2
  $2=$2 " $"
}

# print line
{
  print
}

配置文件

author:ubunut-420
timestamp:Fri Jun 21 20:42:54 CEST 2013
commitmsg:default commit message

说明

我已经尝试了足够好的文档,因此您可以轻松实现它并根据自己的个人需求进行修改。请注意,只要您在源代码中修改它,就可以为宏提供您想要的任何名称。我还希望保持扩展脚本相对容易,你应该能够相当容易地添加新的宏。如果你对扩展或修改脚本感兴趣,你可能也想看看.git目录,那里应该有很多信息可以帮助增强脚本,因为我没有时间调查该文件夹。

答案 2 :(得分:6)

可悲的是没有。

阅读他们的文档,链接附件: Keyword Expansion