28 创建 Ruby 项目

在上一篇我们学习了如何编写可重用代码，利用 Ruby 的常用库来提升我们的开发效率。接下来，我们将深入探索如何实际创建自己的 Ruby 项目。在这一过程中，我们将讨论项目的目录结构、如何初始化一个新的 Ruby 项目、使用 Bundler 管理依赖关系以及如何编写基本的代码结构。

一、项目结构

在创建 Ruby 项目之前，首先要了解一个典型的 Ruby 项目的目录结构。良好的项目结构可以帮助我们更好地组织代码，使得项目更加可维护。

以下是一个简单 Ruby 项目的推荐结构：

my_ruby_project/
│
├── lib/                # 存放主要的业务逻辑代码
│   └── my_ruby_project.rb
│
├── spec/               # 存放测试代码（使用 RSpec）
│   └── my_ruby_project_spec.rb
│
├── Gemfile             # Gem 的依赖文件
├── .gitignore          # Git 忽略文件
└── README.md           # 项目的文档说明

二、初始化项目

1. 创建项目目录

打开终端，运行以下命令创建项目目录：

mkdir my_ruby_project
cd my_ruby_project

2. 初始化 Ruby 项目

我们可以通过创建 Gemfile 文件来启动 Bundler，这让我们可以管理项目依赖。使用以下命令创建 Gemfile：

bundle init

这会在项目根目录下生成一个名为 Gemfile 的文件，我们可以在其中添加需要的 Gems。

3. 编辑 Gemfile

打开 Gemfile，可以添加如 rspec 这样的测试库作为依赖：

source 'https://rubygems.org'

gem 'rspec'

4. 安装依赖

在命令行中运行以下命令来安装依赖：

bundle install

这将安装 Gemfile 中列出的所有库，并生成一个 Gemfile.lock 文件。

三、编写代码

1. 编写主要逻辑代码

在 lib/ 目录下创建一个新的 Ruby 文件 my_ruby_project.rb，并编写简单的代码：

# lib/my_ruby_project.rb

class MyRubyProject
  def greet(name)
    "Hello, #{name}!"
  end
end

2. 编写测试代码

在 spec/ 目录下创建一个名为 my_ruby_project_spec.rb 的文件，使用 RSpec 编写简单的测试：

# spec/my_ruby_project_spec.rb

require 'rspec'
require_relative '../lib/my_ruby_project'

RSpec.describe MyRubyProject do
  it 'returns a greeting message' do
    project = MyRubyProject.new
    expect(project.greet('World')).to eq('Hello, World!')
  end
end

四、运行测试

执行以下命令来运行测试：

rspec spec/my_ruby_project_spec.rb

如果一切顺利，你应该会看到测试通过的消息！

五、总结

在本篇教程中，我们通过创建一个简单的 Ruby 项目，了解到了 Ruby 项目的基本结构、如何初始化项目、如何管理依赖以及如何编写简单的代码和测试。下一篇将重点介绍版本控制与协作的内容，这对团队开发尤为重要，确保代码质量和历史记录！

通过这些实践，你将能逐步掌握 Ruby 的开发流程，并为将来的项目打下良好的基础。如果你对本教程有任何疑问或建议，请随时与我联系！