Ruby Next 项目教程

Ruby Next 项目教程

ruby-next Ruby Next makes modern Ruby code run in older versions and alternative implementations 项目地址: https://gitcode.com/gh_mirrors/ru/ruby-next

1. 项目介绍

Ruby Next 是一个转译器和一组多填充库，旨在使现代 Ruby 代码能够在较旧的 Ruby 版本和替代实现中运行。它支持最新的 Ruby 特性和即将推出的特性（API 和语法），并将其转换为旧版本的 Ruby 代码。例如，你可以在 Ruby 2.5 或 mruby 中使用模式匹配和 Kernel#then。

Ruby Next 的主要目标包括：

• 帮助 Ruby gem 维护者编写使用最新 Ruby 版本的代码，同时仍然支持旧版本。
• 帮助应用程序开发者在不等待最终发布的情况下尝试新特性。
• 支持非 MRI 实现（如 mruby、JRuby、TruffleRuby 等）。
• 帮助社区评估新的、实验性的 MRI 特性。

2. 项目快速启动

安装 Ruby Next

首先，你需要全局安装 Ruby Next gem：

gem install ruby-next

运行示例代码

安装完成后，你可以使用 -ruby-next 标志来运行一个示例脚本：

ruby -ruby-next -e "greet = proc do case it in hello: hello if hello =~ /human/i '🙂' in hello: 'martian' '👽' end end puts greet.call(hello: 'martian')"

使用多填充库

如果你只想使用多填充库，可以按照以下步骤操作：

1. 在 Gemfile 中添加依赖：

   gem "ruby-next-core", "~> 1.0"
   

2. 在代码中加载 Ruby Next：

   require "ruby-next"
   

3. 在需要使用多填充的文件中激活细化：

   using RubyNext
   

3. 应用案例和最佳实践

应用案例

Ruby Next 可以应用于以下场景：

• Ruby gem 维护：使用最新 Ruby 特性编写代码，同时支持旧版本。
• 应用程序开发：在不等待新版本发布的情况下尝试新特性。
• 非 MRI 实现：在 mruby、JRuby 等替代实现中使用现代 Ruby 特性。

最佳实践

• 使用细化：在库开发中使用细化（Refinements）以避免与其他代码的冲突。
• 核心扩展：在应用程序开发中使用核心扩展（Core Extensions），但要注意可能的依赖冲突。
• 调试和日志：使用 Ruby Next 的日志和调试功能来跟踪代码转换和多填充的激活情况。

4. 典型生态项目

以下是一些使用 Ruby Next 的典型生态项目：

• action_policy：一个用于 Ruby on Rails 的授权库。
• anyway_config：一个灵活的配置库，支持多种配置源。
• graphql-fragment_cache：一个用于 GraphQL 的片段缓存库。
• anycable_rails_demo：一个使用 AnyCable 的 Rails 演示项目。

这些项目展示了如何在实际应用中使用 Ruby Next 来支持现代 Ruby 特性并保持对旧版本的支持。

ruby-next Ruby Next makes modern Ruby code run in older versions and alternative implementations 项目地址: https://gitcode.com/gh_mirrors/ru/ruby-next