优化器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,让开发变得轻松高效!
- CangjieCommunity为仓颉编程语言开发者打造活跃、开放、高质量的社区环境Markdown00
- redis-sdk仓颉语言实现的Redis客户端SDK。已适配仓颉0.53.4 Beta版本。接口设计兼容jedis接口语义,支持RESP2和RESP3协议,支持发布订阅模式,支持哨兵模式和集群模式。Cangjie032
- 每日精选项目🔥🔥 推荐每日行业内最新、增长最快的项目,快速了解行业最新热门项目动态~ 🔥🔥02
- qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workersTSX022
- Yi-CoderYi Coder 编程模型,小而强大的编程助手HTML07
- advanced-javaAdvanced-Java是一个Java进阶教程,适合用于学习Java高级特性和编程技巧。特点:内容深入、实例丰富、适合进阶学习。JavaScript085
- taro开放式跨端跨框架解决方案,支持使用 React/Vue/Nerv 等框架来开发微信/京东/百度/支付宝/字节跳动/ QQ 小程序/H5/React Native 等应用。 https://taro.zone/TypeScript09
- CommunityCangjie-TPC(Third Party Components)仓颉编程语言三方库社区资源汇总05
- Bbrew🍺 The missing package manager for macOS (or Linux)Ruby01
- byzer-langByzer(以前的 MLSQL):一种用于数据管道、分析和人工智能的低代码开源编程语言。Scala04