优化器Optimus:Elixir的命令行参数解析库
Optimus是一个为Elixir设计的命令行参数解析库,它的目标是最大程度地减少手动处理命令行参数的工作。只需配置好Optimus解析器,运行并获取完全验证过的,可以直接使用的值。其灵感来源于出色的Rust库clap.rs。
安装与使用
将Optimus添加到你的mix.exs
文件的依赖列表中:
def deps do
[
{:optimus, "~> 0.2"}
]
end
简单示例
假设我们要创建一个工具,它从以下格式的文件读取数据:
# 时间戳, 值
1481729245, 12.0
1481729245, 13.0
1481729246, 11.1
并输出一些统计指标。还有一个子命令用于验证源文件的完整性。这就是如何使用Optimus来实现这个功能:
defmodule Statcalc do
def main(argv) do
# ...
end
end
(查看完整的示例代码,请参考savonarola/optimus_example仓库)
大部分配置选项都不是强制性的,而且大多数配置参数都有自解释性,除了parser
。对于选项和位置参数,parser
是一个接受字符串参数并返回{:ok, parsed_value}
或{:error, string_reason}
的Lambda函数。还有一些预定义的解析器,如:string
, :integer
和 :float
。没有指定parser
则默认使用:string
。
非必需的options
可以有default
值,可以是一个术语(字符串,数字等)或零参数的Lambda函数。如果option
接受多个值,default
值应为列表,例如[1.0]
或fn -> ["x", "y"] end
。
特色与应用场景
当没有提供有效参数时,程序会退出,并显示详细的错误信息,引导用户使用--help
选项。通过--help
,Optimus会自动生成帮助信息,包括使用方法、可选参数和子命令。此外,--version
也是自动处理的。
在正确传递参数后,Optimus将返回一个Optimus.ParseResult
结构体,其中包含args
, flags
, options
三个映射字段和一个unknown
列表。unknown
列表始终为空,如果在(sub)命令中设置了allow_unknown_args: false
。对于options
中的multiple: true
,其值为列表;对于不带multiple: true
的flags
,值为布尔类型;带有multiple: true
的flags
,值为表示标志出现次数的整数。
致谢
感谢José Valim和其他Elixir创建者,以及Kevin K.和所有贡献者创建了clap.rs。该项目的Logo由Igor Garybaldi创作,并由FunBox赞助。
许可证与版权
Optimus遵循MIT许可。有关更多信息,请查看LICENSE.md文件。
Optimus以其简洁的设计,强大的解析功能和全面的帮助系统,为Elixir开发者提供了编写命令行工具的理想选择。无论是构建复杂的应用还是简单的脚本,它都能让你快速而准确地处理命令行参数,使你能够专注于更重要的任务。现在就加入Optimus,让开发变得轻松高效!
鸿蒙开发工具大赶集
本仓将收集和展示鸿蒙开发工具,欢迎大家踊跃投稿。通过pr附上您的工具介绍和使用指南,并加上工具对应的链接,通过的工具将会成功上架到我们社区。012hertz
Go 微服务 HTTP 框架,具有高易用性、高性能、高扩展性等特点。Go01每日精选项目
🔥🔥 每日精选已经升级为:【行业动态】,快去首页看看吧,后续都在【首页 - 行业动态】内更新,多条更新哦~🔥🔥 每日推荐行业内最新、增长最快的项目,快速了解行业最新热门项目动态~~029kitex
Go 微服务 RPC 框架,具有高性能、强可扩展的特点。Go00Cangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。Cangjie057毕方Talon工具
本工具是一个端到端的工具,用于项目的生成IR并自动进行缺陷检测。Python040PDFMathTranslate
PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译,支持 Google/DeepL/Ollama/OpenAI 等服务,提供 CLI/GUI/DockerPython06mybatis-plus
mybatis 增强工具包,简化 CRUD 操作。 文档 http://baomidou.com 低代码组件库 http://aizuda.comJava03国产编程语言蓝皮书
《国产编程语言蓝皮书》-编委会工作区018- DDeepSeek-R1探索新一代推理模型,DeepSeek-R1系列以大规模强化学习为基础,实现自主推理,表现卓越,推理行为强大且独特。开源共享,助力研究社区深入探索LLM推理能力,推动行业发展。【此简介由AI生成】Python00
热门内容推荐
最新内容推荐
项目优选









