如何测试你自己的 RubyGem?

原创 2015年07月07日 10:44:54

如何测试一个Gem

gem 开发完了,想要给别人用,那就需要测试啊,测试一个gem其实很简单,这里我们用 minitest 为例, rspec 也一样适用。先来看看我们当前这个 gem 的目录结构:

-rw-rw-r-- 1 lizhe lizhe   90  72 15:52 Gemfile
-rw-rw-r-- 1 lizhe lizhe  379  73 10:09 Gemfile.lock
drwxrwxr-x 3 lizhe lizhe 4096  72 15:52 lib
-rw-rw-r-- 1 lizhe lizhe 1062  72 15:52 LICENSE.txt
-rw-rw-r-- 1 lizhe lizhe  923  73 10:09 mygem.gemspec
drwxrwxr-x 2 lizhe lizhe 4096  72 18:33 pkg
-rw-rw-r-- 1 lizhe lizhe  187  73 10:35 Rakefile
-rw-rw-r-- 1 lizhe lizhe  556  72 15:52 README.md

打开 mygem.gemspec ,添加minitest

spec.add_development_dependency "minitest", "~> 5.7.0"

执行bundle install安装minitest

新建一个test文件夹,存放我们的测试的用例,然后新建一个test_helper.rb文件,放在里面。test_helper.rb的内容如下:

$LOAD_PATH << "./lib" # 把lib添加到load path

require 'minitest/autorun'  # 引进minitest
require 'mygem'

再来新建一个测试用例,test_mygem.rb

require "test_helper"

class MygemTest < Minitest::Test

  def test_hello_output
    assert_equal(Mygem.hello, "hello from my gem")
  end

end

现在就来执行测试吧:

$ ruby test/test_mygem.rb

/home/lizhe/.rvm/rubies/ruby-2.1.5/lib/ruby/site_ruby/2.1.0/rubygems/core_ext/kernel_require.rb:54:in `require': cannot load such file -- test_helper (LoadError)
    from /home/lizhe/.rvm/rubies/ruby-2.1.5/lib/ruby/site_ruby/2.1.0/rubygems/core_ext/kernel_require.rb:54:in `require'
    from test/test_mygem.rb:1:in `<main>'  

出错了!找不到test_helper,因为它没有在加载路径里嘛,那就来换个方式,require_relative 'test_helper',因为我们的命令是在 gem 根目录下的,所以相对路径就是当前的路径,如果是在 test 目录下执行,就需要写成require_relative '../test_helper'了,还挺麻烦。好,执行一下试一试:

$ ruby test/test_mygem.rb

Run options: --seed 30741

# Running:

.

Finished in 0.000793s, 1260.9959 runs/s, 1260.9959 assertions/s.

1 runs, 1 assertions, 0 failures, 0 errors, 0 skips

利用 Rake::TestTask 简化测试流程

前面的测试方法中,我们要手动添加 lib 目录到 load path ,然后在每个测试用例文件中要require_relative 'test_helper',很是麻烦,现在来简化这一个流程。

首先添加 Rake::TestTaskRakefile 中:

require 'rake/testtask'

Rake::TestTask.new do |t|
  t.libs << 'test' << 'lib'
  t.pattern = "test/test_*.rb"
end

现在把testhelper中的$LOADPATH << './lib'去掉,再把测试用例文件中的 require_relative 替换为 require ,因为rak test task已经把 test 和 lib 两个目录都添加到 load path 中了,然后执行rake test

$ rake test

Run options: --seed 29947

# Running:

.

Finished in 0.000969s, 1031.6447 runs/s, 1031.6447 assertions/s.

1 runs, 1 assertions, 0 failures, 0 errors, 0 skips

进一步简化,每个测试用例文件都要require 'test_helper',也是够麻烦的,能不能让它自动执行这个动作呢?可以,只需要再加上一个选项即可:

require 'rake/testtask'

Rake::TestTask.new do |t|
  t.libs << 'test' << 'lib'
  t.pattern = "test/test_*.rb"
  t.ruby_opts << "-r test_helper" # 添加ruby运行参数,require指定的文件
end

现在把测试用例中的require 'test_helper'这一行也去掉,执行rake test,同样可以运行测试,又少写了一行,:smile :

现在来设置默认的 task :

require 'rake/testtask'

Rake::TestTask.new do |t|
  t.libs << 'test' << 'lib'
  t.pattern = "test/test_*.rb"
  t.ruby_opts << "-r test_helper" # 
添加 ruby 运行参数,require指定的文件
end

task :default => :test

这样我就可以直接执行 rake 就可以跑测试了,连那个 test 都省了。

如果我们有多个测使用例,这个 rake test task 会跑所有测试,如果想跑指定的某一个怎么做呢?指定一个 TEST 参数即可:

rake test TEST=test/test_mygem.rb

参考链接:


本文系OneAPM工程师原创文章。OneAPM是中国基础软件领域的新兴领军企业,能帮助企业用户和开发者轻松实现:缓慢的程序代码和SQL语句的实时抓取。想阅读更多技术文章,请访问OneAPM官方技术博客

版权声明:本文为博主原创文章,未经博主允许不得转载。

相关文章推荐

使用jquery-sortable交互工具和acts_as_list rubygem实现页面拖动排序

拖动不同item从页面上实现的重新排序,并将其保存在数据库中。
  • y_xiao_
  • y_xiao_
  • 2015年11月11日 23:56
  • 567

rubygem-2.6.7.tgz

  • 2016年10月23日 01:14
  • 713KB
  • 下载

rubygem_v1.8.2

  • 2015年03月10日 13:49
  • 201KB
  • 下载

本地源的搭建(Apt、Pypi、Rubygem)

本文介绍了Ubuntu apt源、python pypi源和ruby gem源在本地制作镜像的方法。
  • get_set
  • get_set
  • 2016年03月10日 14:23
  • 2203

Rubygem报no such name xxx.gemspec.rz的解决

这个有可能你本地网络的原因,也有可能是gem源的问题,我采取的方法是更换gem源.你可以使用如下命令显示gem源列表:gem sources -l你可以使用如下命令来删除和新增源:gem source...
  • mydo
  • mydo
  • 2017年03月01日 09:00
  • 1134

fedora 上yum install rubygem-sqlite3-ruby

Before 2 yrs, I came to know about Ruby on Rails(RoR) from the internet. I tried learning it. But fa...

如何开发一个自己的 RubyGem?

什么是 RubyGemRubyGem 是 Ruby 语言的标准源码打包格式。大家一直都在用gem这个命令,但是很少有人知道这个东西是怎么来的,这里我从网上扒下一些资料汇总一下,分享给大家。最后面会有这...

本节介绍使用apt-mirror搭建apt本地源和rubygem本地源的方法

本节介绍使用apt-mirror搭建apt本地源的方法 一台电脑,硬盘需要200g左右,带宽尽量大些,本位以ubuntu 14.04 64位server版为基础源。 1,安装apt-mirror ...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:如何测试你自己的 RubyGem?
举报原因:
原因补充:

(最多只允许输入30个字)