首页
/ Docile 使用与技术文档

Docile 使用与技术文档

2024-12-26 09:48:18作者:史锋燃Gardner

1. 安装指南

安装 Docile 非常简单。您只需在命令行中运行以下命令:

$ gem install docile

2. 项目使用说明

Docile 是一个用于创建 Ruby 域特定语言(DSL)的工具。它使得创建和使用 DSL 变得更加容易和可控。

基础使用

假设您想要为修改 Array 对象创建一个 DSL,Docile 允许您直接使用 Array 的方法作为 DSL:

with_array([]) do
  push 1
  push 2
  pop
  push 3
end
# 输出: [1, 3]

使用助手方法

如果您想在 DSL 中使用助手方法,Docile 同样支持:

def pop_sum_and_push(n)
  sum = 0
  n.times { sum += pop }
  push sum
end

Docile.dsl_eval([]) do
  push 5
  push 6
  pop_sum_and_push(2)
end
# 输出: [11]

多层和递归 DSL

Docile 还支持创建多层和递归的 DSL,例如用于构建树形结构的 DSL。

块参数

您还可以向 DSL 块传递参数,这在创建类似 Sinatra 的简易 Web 框架时非常有用。

函数式风格的不变 DSL 对象

对于返回新对象而不是修改原对象的方法,Docile 同样支持将其作为 DSL 使用。

访问块的返回值

有时您可能想要访问提供的块的返回值,而不是 DSL 对象本身。在这种情况下,可以使用 dsl_eval_with_block_return

3. 项目API使用文档

以下是 Docile 的一些主要方法:

  • dsl_eval: 执行块,并将方法调用委托给 DSL 对象或块的上下文。
  • dsl_eval_with_block_return: 类似于 dsl_eval,但返回块的执行结果。
  • dsl_eval_immutable: 用于函数式风格的不变对象。

4. 项目安装方式

如前所述,安装 Docile 的方式是通过 Ruby 的 gem 包管理工具:

$ gem install docile

以上就是关于 Docile 的技术文档,希望对您使用此项目有所帮助。

登录后查看全文
热门项目推荐
相关项目推荐

项目优选

收起
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
295
940
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
489
393
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
111
195
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
59
140
HarmonyOS-ExamplesHarmonyOS-Examples
本仓将收集和展示仓颉鸿蒙应用示例代码,欢迎大家投稿,在仓颉鸿蒙社区展现你的妙趣设计!
Cangjie
356
321
leetcodeleetcode
🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer(第 2 版)》、《程序员面试金典(第 6 版)》题解
Java
51
14
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
97
251
ArkAnalyzer-HapRayArkAnalyzer-HapRay
ArkAnalyzer-HapRay 是一款专门为OpenHarmony应用性能分析设计的工具。它能够提供应用程序性能的深度洞察,帮助开发者优化应用,以提升用户体验。
Python
18
6
arkanalyzerarkanalyzer
方舟分析器:面向ArkTS语言的静态程序分析框架
TypeScript
32
38
CangjieMagicCangjieMagic
基于仓颉编程语言构建的 LLM Agent 开发框架,其主要特点包括:Agent DSL、支持 MCP 协议,支持模块化调用,支持任务智能规划。
Cangjie
579
41