capistrano_colors 项目技术文档

1. 安装指南

1.1 系统要求

• 确保你已经安装了 Ruby 环境。
• 确保你已经安装了 Capistrano。

1.2 安装步骤

1. 打开终端或命令行工具。
2. 运行以下命令安装 capistrano_colors gem：

   sudo gem install capistrano_colors
   

2. 项目的使用说明

2.1 项目安装方式

2.1.1 项目内安装

在项目的 config/deploy.rb 文件中添加以下代码：

require 'capistrano_colors'

2.1.2 系统全局安装

在用户主目录下创建或修改 .caprc 文件，并添加以下代码：

require 'capistrano_colors'

2.2 自定义颜色匹配器

你可以创建自定义的颜色匹配器来定制 Capistrano 的输出格式。使用 colorize 命令可以创建一个颜色匹配器。colorize 可以接受一个选项哈希或一个哈希数组。

选项哈希字段说明

• :match：匹配行的正则表达式。
• :color：匹配行的颜色。
• :prio：规则的优先级（数值越大优先级越高）。
• :attribute：特殊效果（如：下划线、反色、闪烁）。
• :level：指定匹配器应绑定到 Capistrano 的某些日志级别（如：info、debug 等）。
• :prepend：在输出前添加的文本。
• :replace：替换匹配正则表达式的文本。
• :timestamp：显示当前时间。

颜色选项

• :hide：隐藏行。
• :none：无颜色。
• :black：黑色。
• :red：红色。
• :green：绿色。
• :yellow：黄色。
• :blue：蓝色。
• :magenta：品红色。
• :cyan：青色。
• :white：白色。

属性选项

• :bright：高亮。
• :dim：暗淡。
• :underscore：下划线。
• :blink：闪烁。
• :reverse：反色。
• :hidden：隐藏。

2.3 示例

以下是一个自定义颜色匹配器的示例：

require 'capistrano_colors'    

capistrano_color_matchers = [
  { :match => /command finished/,       :color => :hide,      :prio => 10 },
  { :match => /executing command/,      :color => :blue,      :prio => 10, :attribute => :underscore },
  { :match => /^transaction: commit$/,  :color => :magenta,   :prio => 10, :attribute => :blink },
  { :match => /git/,                    :color => :white,     :prio => 20, :attribute => :reverse },
]

colorize(capistrano_color_matchers)

3. 项目API使用文档

3.1 colorize 方法

colorize 方法用于定义自定义的颜色匹配器。它可以接受一个哈希或一个哈希数组作为参数。每个哈希包含以下字段：

• :match：匹配行的正则表达式。
• :color：匹配行的颜色。
• :prio：规则的优先级。
• :attribute：特殊效果。
• :level：日志级别。
• :prepend：在输出前添加的文本。
• :replace：替换匹配正则表达式的文本。
• :timestamp：显示当前时间。

3.2 颜色和属性选项

• 颜色选项：:hide, :none, :black, :red, :green, :yellow, :blue, :magenta, :cyan, :white。
• 属性选项：:bright, :dim, :underscore, :blink, :reverse, :hidden。

4. 项目安装方式

4.1 项目内安装

在 config/deploy.rb 文件中添加：

require 'capistrano_colors'

4.2 系统全局安装

在用户主目录下创建或修改 .caprc 文件，并添加：

require 'capistrano_colors'

通过以上步骤，你可以成功安装并使用 capistrano_colors 来美化 Capistrano 的输出。