uconf 0.4.1

配置

首先，创建文件夹结构

$ cd ~/conf
$ mkdir .uconf
$ touch .uconf/config

然后，设置一些设置

# .uconf/config

[core]
# Install files to my home folder
target = ~/

[categories]
# The host names "myhostname" belongs to the 'shell' and 'x11' categories
myhostname: shell x11

[files]
# Hosts in the 'shell' category should install
# the 'shell/gitconfig' and 'ssh/config' files
shell: shell/gitconfig ssh/config

# Hosts in the 'shell' but not the 'work' category should install
# our authorized_keys
shell && !work: ssh/authorized_keys

[actions]
# Files located in ~/conf/ssh are parsed and written to ~/.ssh/
ssh/* = parse destdir=".ssh/"

# shell/gitconfig goes to ~/.gitconfig
shell/gitconfig = parse destdir="~/.gitconfig"

文件

uconf的核心是其文件处理引擎。

从表面上看，它是一个简单的预处理器，将基于.uconf/config文件中定义的类别解析文件。

换句话说，如果文件shell/gitconfig包含

[user]
#@if work
  name = Raphaël Barrois
  email = raphael.barrois@example.org
#@else
  name = Xelnor
  email = raphael.barrois@polytechnique.org
#@endif

并且基于上面的示例中的myhostname构建，则输出将是

# ~/.gitconfig
[user]
  name = Xelnor
  email = raphael.barrois@polytechnique.org

命令

一旦您的配置文件夹设置完毕，基本命令将包括

$ cd ~/conf
$ uconf make
Building file shell/gitconfig (FileProcessingAction)
Building file ssh/config (FileProcessingAction)
Building file ssh/authorized_keys (FileProcessingAction)

如果您已修改文件，只需回滚其更改即可

$ cd ~/conf
$ uconf back shell/gitconfig
Backporting file shell/gitconfig (FileProcessingAction)

这将更新源文件（例如，在本例中为 ~/conf/shell/gitconfig）以合并目标文件（在此处为 ~/.gitconfig）中的更改。

即使文件包含分支，这也适用，即如果源文件是

[user]
#@if work
  name = Raphaël Barrois
  email = raphael.barrois@example.org
#@else
  name = Xelnor
  email = raphael.barrois@polytechnique.org
#@endif

并且目标文件（在非工作机上）被修改为读取

[user]
  name = Raphaël "Xelnor" Barrois
  email = raphael.barrois@polytechnique.org

然后运行 uconf back shell/gitconfig 的结果将是

[user]
#@if work
  name = Raphaël Barrois
  email = raphael.barrois@example.org
#@else
  name = Raphaël "Xelnor" Barrois
  email = raphael.barrois@polytechnique.org
#@endif