BT

如何利用碎片时间提升技术认知与能力? 点击获取答案

Ruby工具更新:Yard 0.4添加实时文档服务器功能,Gem Bundler负责管理依赖

| 作者 Werner Schuster 关注 6 他的粉丝 ,译者 杨晨 关注 0 他的粉丝 发布于 2009年11月20日. 估计阅读时间: 3 分钟 | 如何结合区块链技术,帮助企业降本增效?让我们深度了解几个成功的案例。

YARD是一个Ruby文档生成器,还支持插件和在注释字符串里的Javadoc风格的元数据等特性

新版本的YARD 0.4.0做出了很多改进,例如对模版系统进行了改写。还有一个新特性,可以允许给某些代码添加元数据值,来限制该代码的文档生成。

最棒的新特性便是实时文档服务器

在每个方法的页面上,增加了由DISQUS实现的崭新的用户评论系统,允许用户针对某个方法贡献更多的信息。

http://yardoc.org/docs上已经有了一个该服务的公开实例,列表中的项目文档都可以使用该特性,例如Rails

Gem Bundler是一个全新的工具,旨在简化项目中对Gem依赖的管理以及对实时Gem require的控制。

Yehuda Katz,Gem Bundler的编写者之一,讲述了这个工具背后的故事

这个工具允许在一个独立于应用程序本身的空间中对所有的依赖进行配置。也就是说,它能够不运行程序就能够发现哪些Gems是应用程序所依赖的。[..]

一旦依赖问题得到解决,开发者就可以将程序运行崭新的系统上,而不需要使用RubyForge(或者Gemcutter)。对于编译型gem来说,这显得尤为重要(必须能够获取所需gem的列表以及在远程系统上编译)。[..]
除此以外,工具还具有为Ruby应用一个重发布的安装打包功能。新的gem发布版或者远程服务器应该不会对一个应用程序的安装包产生任何影响。

所有的依赖在一个Gemfile中列出来了,能够从默认或者定制的Gem源中获取。

所有的依赖能够被聚集到一个命名环境中。当应用程序需要在不同的情况下,例如“production(生产环境)”或者“testing(测试环境)”等等。运行的时候,环境问题就尤为重要。Gem Bundler能够找到Gem,并且在默认环境下使用Bundler.require_env将其包含进来,或者直接在环境名称中指定名字,例如Bundler.require_env(:testing)

更多信息可以在EngineYard博客的Gem Bundler介绍或者Yehuda的Gem Bundler简介中找到更多细节,还可以了解一下Gem Bundler是如何和Rails绑定在一起的。

查看英文原文:Ruby Tools: Yard 0.4 Adds Live Doc Server, Gem Bundler Handles Dependencies

评价本文

专业度
风格

您好,朋友!

您需要 注册一个InfoQ账号 或者 才能进行评论。在您完成注册后还需要进行一些设置。

获得来自InfoQ的更多体验。

告诉我们您的想法

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我
社区评论

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

讨论

登陆InfoQ,与你最关心的话题互动。


找回密码....

Follow

关注你最喜爱的话题和作者

快速浏览网站内你所感兴趣话题的精选内容。

Like

内容自由定制

选择想要阅读的主题和喜爱的作者定制自己的新闻源。

Notifications

获取更新

设置通知机制以获取内容更新对您而言是否重要

BT