12 个版本 (7 个重大更新)
0.8.0 | 2023年4月26日 |
---|---|
0.6.0 | 2023年4月21日 |
0.4.0 | 2022年5月9日 |
0.3.2 | 2020年11月26日 |
0.1.0 | 2020年5月16日 |
#9 in 配置
每月 627,488 次下载
在 513 个Crates中(32 个直接使用)
50KB
445 行
等等
这是一个允许您确定应用程序配置、数据、缓存以及其他文件位置的Rust库。现有的Rust库通常不会给您选择它们遵循的标准/约定的机会。相反,等等库为您提供了选择。
约定
等等支持以下约定
策略
等等有两种操作模式:BaseStrategy
和 AppStrategy
- 使用
BaseStrategy
,您只需获取相应目录的位置。例如,对于config_dir()
- XDG:
~/.config
- 苹果:
~/Library/Preferences
- Windows:
~\AppData\Roaming
- XDG:
- 使用
AppStrategy
,您提供附加信息以获取应用程序目录的位置。例如,如果您提供以下详细信息:{ top_level_domain: "org", author: "Acme Corp", app_name: "Frobnicator Plus" }
,您将得到- XDG:
~/.config/frobnicator-plus
- Unix:
~/.frobnicator-plus
- 苹果:
~/Library/Preferences/org.acmecorp.FrobnicatorPlus
- Windows:
~\AppData\Roaming\Acme Corp\Frobnicator Plus
- XDG:
注意:主目录(~)的位置由home
crate决定。
便利函数
Etcetera还为每个平台提供了选择适当策略的便利函数
base_strategy::choose_base_strategy
&app_strategy::choose_app_strategy
:在Windows上使用Windows
,在其他地方使用XDG
。这被大多数CLI工具和一些GUI工具在各个平台上使用。base_strategy::choose_native_strategy
&app_strategy::choose_native_strategy
:在Windows上使用Windows
,在macOS/iOS上使用Apple
,在其他地方使用XDG
。这被各个平台上的大多数GUI应用程序使用。
依赖关系
~0–12MB
~68K SLoC