18、Ruby项目、库管理与代码文档化指南

Ruby项目、库管理与代码文档化指南

1. Ruby项目与库基础

在Ruby开发中，OpenStruct比Struct更灵活，但代码可读性较差，难以一眼确定使用了哪些属性；而传统的Struct在创建时就能看到属性名。使用库通常很简单，多数情况下用 require 加载相关类和方法即可开始使用。

1.1 RubyGems系统

RubyGems是Ruby程序和库的打包系统，能让开发者将Ruby库打包成便于用户维护和安装的形式，还能轻松管理同一库的不同版本，在命令行用一行命令就能完成安装。

每个单独打包的Ruby库或应用称为gem或RubyGem，有名称、版本号和描述。可在命令行用 gem 命令管理本地安装的gem。如今Ruby默认包含RubyGems，但Ruby 1.8版本并非都有。

1.2 查找Gem

1.2.1 查看本地安装的Gem

在命令行运行 gem list ，会得到类似如下结果：

***  LOCAL   GEMS  ***
bigdecimal (1.2.6)
json (1.8.1)
minitest (5.4.3)

这表明本地安装了三个不同的gem及其版本号。

1.2.2 查询远程Gem服务器

运行 gem list --remote 可查询远程gem服务器（当前由rubygems.org托