如何创建自己的ruby gem包
编写一个最简单的例子
1. 建好如下文件夹
注意:lib目录下必须有个和你gem名字一样的rb文件。
- $ cd hola
- $ tree
- .
- ├── hola.gemspec
- └── lib
- └── hola.rb
2. 编写代码
. hola.rb
- % cat lib/hola.rb
- class Hola
- def self.hi
- puts "Hello world!"
- end
- end
.hola.gemspec
- % cat hola.gemspec
- Gem::Specification.new do |s|
- s.name = 'hola'
- s.version = '0.0.0'
- s.date = '2010-04-28'
- s.summary = "Hola!"
- s.description = "A simple hello world gem"
- s.authors = ["Nick Quaranto"]
- s.email = 'nick@quaran.to'
- s.files = ["lib/hola.rb"]
- s.homepage =
- 'http://rubygems.org/gems/hola'
- end
这里面可以设置很多属性。
上面字段的意思,比较简单。相信大家都能理解。
3.编译生成gem
- % gem build hola.gemspec
- Successfully built RubyGem
- Name: hola
- Version: 0.0.0
- File: hola-0.0.0.gem
- % gem install ./hola-0.0.0.gem
- Successfully installed hola-0.0.0
- 1 gem installed
4.测试使用
- % irb
- >> require 'hola'
- => true
- >> Hola.hi
- Hello world!
注意:在ruby 1.9.2之前到版本里面,需要先require 'rubygem',才能使用我们写的gem.
5.发布到rubygems网站
- $ curl -u tom https://rubygems.org/api/v1/api_key.yaml >
- ~/.gem/credentials
- Enter host password for user 'tom':
设定完之后发布
- % gem push hola-0.0.0.gem
- Pushing gem to RubyGems.org...
- Successfully registered gem: hola (0.0.0)
发布成功。
这样任何一个人都可以使用你写的gem了。
稍微复杂的rubygem例子
上面的例子只有一个ruby文件,一般gem应该没有这么简单的。
下面说下有多个ruby文件该怎么写。
1. 目录结构
多了个hola目录和translator.rb文件
- % tree
- .
- ├── hola.gemspec
- └── lib
- ├── hola
- │ └── translator.rb
- └── hola.rb
2. 代码
lib/hola/translator.rb
- % cat lib/hola/translator.rb
- class Hola::Translator
- def initialize(language)
- @language = language
- end
- def hi
- case @language
- when :spanish
- "hola mundo"
- else
- "hello world"
- end
- end
- end
lib/hola.rb
- % cat lib/hola.rb
- class Hola
- def self.hi(language = :english)
- translator = Translator.new(language)
- translator.hi
- end
- end
- require 'hola/translator'
.hola.gemspec
- % cat hola.gemspec
- Gem::Specification.new do |s|
- s.name = 'hola'
- s.version = '0.0.0'
- s.date = '2010-04-28'
- s.summary = "Hola!"
- s.description = "A simple hello world gem"
- s.authors = ["Nick Quaranto"]
- s.email = 'nick@quaran.to'
- s.files = ["lib/hola.rb", "lib/hola/translator.rb"]
- s.homepage =
- 'http://rubygems.org/gems/hola'
- end
其他步骤和上面一样了。很简单吧!
最后说下怎么写个 gem包含可执行文件的例子。
这个也很简单。像rake就是典型的包含可执行文件的gem.
1. 在刚才工程目录下建个bin文件夹
生成可执行文件,并且修改权限为可运行。
- % mkdir bin
- % touch bin/hola
- % chmod a+x bin/hola
2. 修改可执行文件内容
bin/hola
- #!/usr/bin/env ruby
- require 'hola'
- puts Hola.hi(ARGV[0])
测试下
- % ruby -Ilib ./bin/hola
- hello world
- % ruby -Ilib ./bin/hola spanish
- hola mundo
3 .最后修改gemspec
- % head -4 hola.gemspec
- Gem::Specification.new do |s|
- s.name = 'hola'
- s.version = '0.0.1'
- s.executables << 'hola'
其他就和上面一样了。很简单吧。
------------------------------------------------------------------------------
什么是RubyGems?
RubyGems是一个方便而强大的Ruby程序包管理器,Ruby的第三方插件是用gem方式来管理,非常容易发布和共享,一个简单的命令就可以安装上 第三方的扩展库。特点:能远程安装包,包之间依赖关系的管理,简单可靠的卸载,查询机制,能查询本地和远程服务器的包信息,能保持一个包的不同版本,基于 Web的查看接口,能查看你安装的gem的信息。
安装RubyGems
官方站点 http://rubygems.org/pages/download
下载地址:http://rubyforge.org/frs/?group_id=126
Windows 用户直接下载.zip压缩包,解压缩,从CMD提示窗口下进入 setup.rb所在目录, 运行 ruby setup.rb 即可安装。
Ruby1.9.1 以后的版本自带RubyGems,直接在CMD窗口下输入指令 gem update --system 升级到最新版即可。
gem包的安装方式:
RubyGems.org 是官方的Gem托管中心,RubyGems就是从这里远程下载gem包的。RubyGems 将所有的gem包 安装到 /[ruby root]/lib/ruby/gems/[ver]/ 目录下,这其中包括了cache、doc、gems、specifications 4个目录,cache下放置下载的原生gem包,gems下则放置的是解压过的gem包。当安装过程中遇到问题时,可以进入这些目录,手动删除有问题的 gem包,然后重新运行 gem install [gemname] 命令即可。
RubyGems命令详解:
我们以目前最新的 rubygems 1.8.16 为例:
# 查看RubyGems软件的版本
gem -v
# 更新升级RubyGems软件自身
gem update --system
# 更新所有已安装的gem包
$ gem update
# 更新指定的gem包
# 注意:gem update [gemname]不会升级旧版本的包,可以使用 gem install [gemname] --version=[ver]代替
$ gem update [gemname]
# 安装指定gem包,程序先从本机查找gem包并安装,如果本地没有,则从远程gem安装。
gem install [gemname]
# 仅从本机安装gem包
gem install -l [gemname]
# 仅从远程安装gem包
gem install -r [gemname]
# 安装gem包,但不安装相关文档文件
gem install [gemname] --no-ri --no-rdoc
# 安装指定版本的gem包
gem install [gemname] --version=[ver]
# 删除指定的gem包,注意此命令将删除所有已安装的版本
gem uninstall [gemname]
# 删除某指定版本gem
gem uninstall [gemname] --version=[ver]
# 查看本机已安装的所有gem包
gem list
# 列出远程RubyGems.org 上有此关键字的gem包(可用正则表达式)
gem list -r keyword
# 列出远程RubyGems.org 上所有Gmes清单,并保存到文件。
gem list -r > remote_gem_list.txt
#查看所有gem包文档及资料
gem server
#显示RubyGem使用帮助
gem help
#列出RubyGem命令一些使用范例
gem help example
更多命令请参考官方文档: http://guides.rubygems.org/command-reference/
如何创建自己的ruby gem包的更多相关文章
- Ruby Gem命令详解
转自:http://www.jianshu.com/p/728184da1699 Gem介绍: Gem是一个管理Ruby库和程序的标准包,它通过Ruby Gem(如 http://rubygems.o ...
- Ruby Gem命令
Gem是一个管理Ruby库和程序的标准包,它通过Ruby Gem(如 http://rubygems.org/ )源来查找.安装.升级和卸载软件包,非常的便捷. Ruby 1.9.2版本默认已安装Ru ...
- ruby 制作自己的gem包
在ruby工程目录下新建一个文件:crowdSystem.gemspec.需要在lib目录下存在同一名称的ruby库文件:crowdSystem.rb
- npm包与gem包--在线&离线安装
目录 NPM 在线 离线 GEM 在线 离线 NPM NPM,即为Node的包管理工具,官网为 https://www.npmjs.com/,我们可以在站内搜索所需要的NPM包,了解相关的使用规则 安 ...
- ruby gem tips(转)
淘宝源: https://ruby.taobao.org 升级ruby gem gem update --system 查看gem版本 gem -v 查看gem版本,gems安装目录,remote s ...
- (转)-编写第一个ROS(创建工作空间workspace和功能包package)
原文网址:http://www.cnblogs.com/liuamin/p/5704281.html 刚接触ROS,学着写了第一个程序,怕以后忘记,就将其步骤记录下来.. 首先你必须保证你电脑已安装配 ...
- 创建可执行的JAR包
创建可执行的JAR文件包,需要使用带cvfm参数的jar命令,命令如下:JAR cvfm test.jar manifest.mf testtest.jar和manifest.mf为两个文件,分别对应 ...
- SSIS从理论到实战,再到应用(1)----创建自己的第一个包
原文:SSIS从理论到实战,再到应用(1)----创建自己的第一个包 其实,如果你使用sql2008的导出导入工具的时候,你就已经在使用包了. 目标:使用sql2008 导入导出工具,导入excel数 ...
- 编写第一个ROS(创建工作空间workspace和功能包package)
刚接触ROS,学着写了第一个程序,怕以后忘记,就将其步骤记录下来.. 首先你必须保证你电脑已安装配置好ROS. 1.创建工作空间(workspace) 我们所创建功能包package,应该全部放到一个 ...
随机推荐
- 【CSWS2014 Summer School】互联网广告中的匹配和排序算法-蒋龙(下)
[CSWS2014 Summer School]互联网广告中的匹配和排序算法-蒋龙(上) Fig19,用到了矩阵,这个我没有听太明白,蒋博士也没有详细说明.不过可以明确的一点就是,我们常说的K-mea ...
- Java从零开始学二十九(大数操作(BigIntger、BigDecimal)
一.BigInteger 如果在操作的时候一个整型数据已经超过了整数的最大类型长度long的话,则此数据就无法装入,所以,此时要使用BigInteger类进行操作. 不可变的任意精度的整数.所有操作中 ...
- 10个最受欢迎的Java类(转)
原文:http://www.csdn.net/article/2012-06-04/2806277 每一个Java程序员都有一份属于自己的Java类排名表.这个排名表没有严格的规定,也没有可遵循的规则 ...
- vb sendmessage 详解1
SendMessage函数的常用消息及其应用(有点长,希望能对大家有所帮助)函数原型: Declare Function SendMessage Lib "user32" Alia ...
- java基础50道编程题
50道JAVA基础编程练习题 [程序1] 题目:古典问题:有一对兔子,从出生后第3个月起每个月都生一对兔子,小兔子长到第三个月后每个月又生一对兔子,假如兔子都不死,问每个月的兔子对数为多少? 程序分析 ...
- 获取TrustedInstaller
Windows Registry Editor Version 5.00 [HKEY_CLASSES_ROOT\*\shell\runas] @="获取TrustedInstaller权限& ...
- javascript 1.5s跳转
<script type="text/javascript"> var t = 1.5; window.onload=countDown; function count ...
- jquery 保留两个小数的方法
$()); 直接使用:toFixed(2)
- java装箱拆箱
基本数据类型的自动装箱(autoboxing).拆箱(unboxing)是自J2SE 5.0开始提供的功能. 一般我们要创建一个类的对象的时候,我们会这样: Class a = new Class(p ...
- 从 高斯 到 正态分布 到 Z分布 到 t分布
正态分布是如何被高斯推导出来的, 我感觉高斯更像是猜出了正态分布. 详见这篇文章:<正态分布的前世今生> http://songshuhui.NET/archives/76501 说一说理 ...