CLI编程语言开发工具【免费下载链接】elvishPowerful scripting language versatile interactive shell项目地址https://gitcode.com/gh_mirrors/el/elvish点击查看免费下载导读runtime:是 Elvish 内置的标准模块之一它向脚本与交互式会话暴露当前 Elvish 解释器的运行时环境信息包括可执行文件路径、模块搜索目录、RC 文件路径等四个只读变量。本文以官方参考文档 website/ref/runtime.md 为骨架结合模块源码 pkg/mods/runtime/runtime.go、runtime.d.elv 以及 shell 层的路径解析实现完整讲解这四个变量的语义、取值规则、底层来源与典型用法帮助你编写出能感知自身运行环境的健壮 Elvish 脚本。模块概览一个只读的运行时信息命名空间runtime:模块在 Elvish 的模块体系中属于运行时自省类模块——它不提供任何命令或函数只通过四个只读变量把解释器内部的状态暴露给脚本变量名含义取值失败时$runtime:elvish-path当前 Elvish 可执行文件的路径$nil$runtime:lib-dirs模块搜索目录列表空列表[]$runtime:rc-pathRC 文件路径忽略命令行覆盖非交互模式也可用$nil$runtime:effective-rc-path本次会话实际使用的 RC 文件路径$nil这四个变量全部通过vars.NewReadOnly创建见 runtime.go因此任何对它们的赋值都会报错。模块的官方文档定位是提供关于 Elvish 运行时的信息runtime.md而每个变量的完整语义说明维护在源码中的文档注释里runtime.d.elv二者共同构成了本模块的参考文档。$runtime:elvish-path当前解释器二进制的位置这个变量保存当前正在运行的 Elvish 可执行文件的绝对路径典型输出类似~ put $runtime:elvish-path ▶ /usr/local/bin/elvish在实现上它直接调用 Go 标准库的os.Executable()见 runtime.go如果该调用出错例如在某些受限环境下无法解析自身路径变量值为$nil~ put $runtime:elvish-path ▶ $nil典型用途脚本需要调用同一个 Elvish 解释器而非在PATH中另外查找来重新启动自己或运行子命令时使用此变量可以保证版本与行为一致。注意此变量反映的是当前进程的路径不随PATH变化。$runtime:lib-dirs模块搜索目录$runtime:lib-dirs是一个列表包含 Elvish 查找模块use语句时所搜索的全部目录顺序即搜索优先级~ put $runtime:lib-dirs ▶ [/home/user/.config/elvish/lib /home/user/.local/share/elvish/lib /usr/local/share/elvish/lib]它的值与参考文档 module search directories 一节所述完全一致由 shell 层在启动时计算并写入Evaler.LibDirs字段见 eval.go。目录解析逻辑位于 pkg/shell/paths.go按如下顺序收集配置目录roaming lib$XDG_CONFIG_HOME/elvish/lib未设置XDG_CONFIG_HOME时退回到平台默认配置目录数据目录local lib$XDG_DATA_HOME/elvish/lib未设置时退回平台默认数据目录系统数据目录遍历$XDG_DATA_DIRS中每个目录下的elvish/lib未设置时使用平台默认数据目录列表。如果路径解析过程发生错误例如无法确定任何配置目录$runtime:lib-dirs为空列表[]且 shell 会在启动时向 stderr 打印警告见 shell.go。典型用途调试模块为什么找不到问题时先打印该变量确认搜索目录是否符合预期或在脚本中动态遍历这些目录安装/检查本地模块。$runtime:rc-path与$runtime:effective-rc-pathRC 文件的默认与实际这两个变量是一对语义差异需要仔细区分$runtime:rc-path默认 RC 文件路径$runtime:rc-path是 RC 文件的默认路径其关键特性是忽略任何命令行覆盖如-rc、-norc标志因此它总是指向按约定应该存在的那个 RC 文件非交互模式下也可用——即使本次会话根本不会加载 RC 文件该变量依然有值。它由rcPath()计算优先$XDG_CONFIG_HOME/elvish/rc.elv否则退回平台默认配置目录下的elvish/rc.elv见 paths.go。如果确定路径时出错值为$nil。$runtime:effective-rc-path实际使用的 RC 文件$runtime:effective-rc-path则反映本次会话真正生效的 RC 路径取值规则在 runtime.d.elv 中定义得很明确会话情形effective-rc-path的值非交互模式运行或带-norc标志$nil不加载任何 RC带-rc PATH标志PATH的绝对路径交互模式且未带-norc/-rc与$rc-path相同对应的赋值逻辑位于 shell.go非交互或-norc时保持字段为空-rc提供显式路径时通过filepath.Abs转为绝对路径默认情形下直接沿用rc-path的计算结果。~ put $runtime:rc-path ▶ /home/user/.config/elvish/rc.elv ~ put $runtime:effective-rc-path ▶ /home/user/.config/elvish/rc.elv典型用途在rc.elv内部判断我这次是被正常加载的还是仅仅作为默认路径存在或者确认-rc覆盖是否生效。实现原理一次快照式的命名空间构建runtime:模块的构建函数为Ns(ev *eval.Evaler) *eval.Ns见 runtime.go其实现有两点值得注意快照语义四个变量在模块被加载的那一刻就从Evaler的字段LibDirs、RcPath、EffectiveRcPath读取一次并固化之后不再与解释器状态联动。因此源码注释明确要求Evaler的所有公共属性必须在调用本函数之前设置完毕runtime.go。在正常启动流程中shell.go 的 makeEvaler 先完成路径计算再通过mods.AddTo(ev)安装标准模块顺序恰好满足这一前提。空串归一为$nil路径类变量在值为空字符串时会通过nonEmptyOrNil归一化为$nilruntime.go避免向脚本暴露无意义的空串让脚本可以统一用 $nil判断不可用。测试验证好路径与坏路径两种场景模块的行为由转录测试transcript tests覆盖测试文件 runtime_test.elvts 构造了两组场景好路径场景use-runtime-good-paths将os.Executable桩为返回/path/to/elvish并给Evaler设置LibDirs [/lib/1 /lib/2]、RcPath /path/to/rc.elv、EffectiveRcPath /path/to/effective/rc.elv随后验证四个变量输出对应值坏路径场景use-runtime-bad-paths让os.Executable返回错误、所有Evaler路径字段保持零值验证elvish-path、rc-path、effective-rc-path均为$nil、lib-dirs为空列表。驱动测试的 runtime_test.go 通过//go:embed *.elvts嵌入转录文件并用testutil.Set临时替换runtime.OSExecutable该替换点暴露在 testexport_test.go 中仅测试用。测试注释还特别说明之所以需要手动替换默认模块是因为runtime 模块在初始化时会读取 Evaler 字段runtime_test.go这正好印证了上文快照式构建的实现特性。实践建议如何在脚本中使用runtime:模块runtime:是内置模块无需use即可直接以$runtime:前缀访问。综合上述语义给出几条可直接落地的用法判断自身是否可重入调用$runtime:elvish-path而非在PATH中查找elvish保证子进程与当前解释器同版本if (has-key $runtime:elvish-path $nil) { # 无法确定自身路径退回依赖 PATH 中的 elvish ^elvish -c ... } else { ^$runtime:elvish-path -c ... }排查模块加载失败先打印$runtime:lib-dirs核对期望安装模块的目录是否在搜索路径中注意lib-dirs是列表可用all或下标逐一检查。区分默认 RC与实际 RC当$runtime:effective-rc-path $nil时说明当前会话非交互或-norc不会执行任何 RC 初始化逻辑此时在脚本中应跳过依赖 RC 环境的操作当它等于$rc-path时说明走的是默认路径而非-rc覆盖。需要留意的是这些变量全部为只读快照且面向当前解释器进程的信息因此在不同机器、不同启动标志下取值会不同——脚本中应始终先判空$nil/ 空列表再使用。小结runtime:模块虽然只有四个只读变量却是 Elvish 脚本感知自身运行环境的唯一官方入口elvish-path定位解释器二进制lib-dirs揭示模块搜索路径rc-path与effective-rc-path组合起来则完整刻画了 RC 文件的默认位置与实际加载情况。结合 runtime.go 的快照式实现与 runtime_test.elvts 的双场景测试你可以准确预判每个变量在何种启动条件下取值、何时为$nil从而写出对环境变化更稳健的配置脚本。赞分享CLI编程语言开发工具【免费下载链接】elvishPowerful scripting language versatile interactive shell项目地址https://gitcode.com/gh_mirrors/el/elvish点击查看免费下载相关推荐3 个参数搞定 B 站批量取关BiliBiliToolPro UnfollowBatched 完整配置指南3 个参数搞定 B 站批量取关BiliBiliToolPro UnfollowBatched 完整配置指南 BiliBiliToolPro 是一款支持 Doc后端任务调度工作流自动化ElixirLS反射机制运行时信息获取ElixirLS反射机制运行时信息获取 引言 在Elixir开发过程中你是否曾遇到过这样的困境需要快速了解模块的内部结构、函数签名、类型定义或者想要在运Elvish 0.19.1 版本全解析doc 模块、conj/compact 新命令与 runtime 模块Elvish 0.19.1 版本全解析doc 模块、conj/compact 新命令与 runtime 模块 导读 Elvish 0.19.1 于 2023CLI编程语言开发工具上一篇AlwaysOnTop窗口置顶工具提升多任务处理效率的必备解决方案下一篇重构窗口管理逻辑AlwaysOnTop工具的认知效率革新创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Elvish `runtime:` 模块完全指南：在脚本中获取解释器运行时路径信息
CLI编程语言开发工具【免费下载链接】elvishPowerful scripting language versatile interactive shell项目地址https://gitcode.com/gh_mirrors/el/elvish点击查看免费下载导读runtime:是 Elvish 内置的标准模块之一它向脚本与交互式会话暴露当前 Elvish 解释器的运行时环境信息包括可执行文件路径、模块搜索目录、RC 文件路径等四个只读变量。本文以官方参考文档 website/ref/runtime.md 为骨架结合模块源码 pkg/mods/runtime/runtime.go、runtime.d.elv 以及 shell 层的路径解析实现完整讲解这四个变量的语义、取值规则、底层来源与典型用法帮助你编写出能感知自身运行环境的健壮 Elvish 脚本。模块概览一个只读的运行时信息命名空间runtime:模块在 Elvish 的模块体系中属于运行时自省类模块——它不提供任何命令或函数只通过四个只读变量把解释器内部的状态暴露给脚本变量名含义取值失败时$runtime:elvish-path当前 Elvish 可执行文件的路径$nil$runtime:lib-dirs模块搜索目录列表空列表[]$runtime:rc-pathRC 文件路径忽略命令行覆盖非交互模式也可用$nil$runtime:effective-rc-path本次会话实际使用的 RC 文件路径$nil这四个变量全部通过vars.NewReadOnly创建见 runtime.go因此任何对它们的赋值都会报错。模块的官方文档定位是提供关于 Elvish 运行时的信息runtime.md而每个变量的完整语义说明维护在源码中的文档注释里runtime.d.elv二者共同构成了本模块的参考文档。$runtime:elvish-path当前解释器二进制的位置这个变量保存当前正在运行的 Elvish 可执行文件的绝对路径典型输出类似~ put $runtime:elvish-path ▶ /usr/local/bin/elvish在实现上它直接调用 Go 标准库的os.Executable()见 runtime.go如果该调用出错例如在某些受限环境下无法解析自身路径变量值为$nil~ put $runtime:elvish-path ▶ $nil典型用途脚本需要调用同一个 Elvish 解释器而非在PATH中另外查找来重新启动自己或运行子命令时使用此变量可以保证版本与行为一致。注意此变量反映的是当前进程的路径不随PATH变化。$runtime:lib-dirs模块搜索目录$runtime:lib-dirs是一个列表包含 Elvish 查找模块use语句时所搜索的全部目录顺序即搜索优先级~ put $runtime:lib-dirs ▶ [/home/user/.config/elvish/lib /home/user/.local/share/elvish/lib /usr/local/share/elvish/lib]它的值与参考文档 module search directories 一节所述完全一致由 shell 层在启动时计算并写入Evaler.LibDirs字段见 eval.go。目录解析逻辑位于 pkg/shell/paths.go按如下顺序收集配置目录roaming lib$XDG_CONFIG_HOME/elvish/lib未设置XDG_CONFIG_HOME时退回到平台默认配置目录数据目录local lib$XDG_DATA_HOME/elvish/lib未设置时退回平台默认数据目录系统数据目录遍历$XDG_DATA_DIRS中每个目录下的elvish/lib未设置时使用平台默认数据目录列表。如果路径解析过程发生错误例如无法确定任何配置目录$runtime:lib-dirs为空列表[]且 shell 会在启动时向 stderr 打印警告见 shell.go。典型用途调试模块为什么找不到问题时先打印该变量确认搜索目录是否符合预期或在脚本中动态遍历这些目录安装/检查本地模块。$runtime:rc-path与$runtime:effective-rc-pathRC 文件的默认与实际这两个变量是一对语义差异需要仔细区分$runtime:rc-path默认 RC 文件路径$runtime:rc-path是 RC 文件的默认路径其关键特性是忽略任何命令行覆盖如-rc、-norc标志因此它总是指向按约定应该存在的那个 RC 文件非交互模式下也可用——即使本次会话根本不会加载 RC 文件该变量依然有值。它由rcPath()计算优先$XDG_CONFIG_HOME/elvish/rc.elv否则退回平台默认配置目录下的elvish/rc.elv见 paths.go。如果确定路径时出错值为$nil。$runtime:effective-rc-path实际使用的 RC 文件$runtime:effective-rc-path则反映本次会话真正生效的 RC 路径取值规则在 runtime.d.elv 中定义得很明确会话情形effective-rc-path的值非交互模式运行或带-norc标志$nil不加载任何 RC带-rc PATH标志PATH的绝对路径交互模式且未带-norc/-rc与$rc-path相同对应的赋值逻辑位于 shell.go非交互或-norc时保持字段为空-rc提供显式路径时通过filepath.Abs转为绝对路径默认情形下直接沿用rc-path的计算结果。~ put $runtime:rc-path ▶ /home/user/.config/elvish/rc.elv ~ put $runtime:effective-rc-path ▶ /home/user/.config/elvish/rc.elv典型用途在rc.elv内部判断我这次是被正常加载的还是仅仅作为默认路径存在或者确认-rc覆盖是否生效。实现原理一次快照式的命名空间构建runtime:模块的构建函数为Ns(ev *eval.Evaler) *eval.Ns见 runtime.go其实现有两点值得注意快照语义四个变量在模块被加载的那一刻就从Evaler的字段LibDirs、RcPath、EffectiveRcPath读取一次并固化之后不再与解释器状态联动。因此源码注释明确要求Evaler的所有公共属性必须在调用本函数之前设置完毕runtime.go。在正常启动流程中shell.go 的 makeEvaler 先完成路径计算再通过mods.AddTo(ev)安装标准模块顺序恰好满足这一前提。空串归一为$nil路径类变量在值为空字符串时会通过nonEmptyOrNil归一化为$nilruntime.go避免向脚本暴露无意义的空串让脚本可以统一用 $nil判断不可用。测试验证好路径与坏路径两种场景模块的行为由转录测试transcript tests覆盖测试文件 runtime_test.elvts 构造了两组场景好路径场景use-runtime-good-paths将os.Executable桩为返回/path/to/elvish并给Evaler设置LibDirs [/lib/1 /lib/2]、RcPath /path/to/rc.elv、EffectiveRcPath /path/to/effective/rc.elv随后验证四个变量输出对应值坏路径场景use-runtime-bad-paths让os.Executable返回错误、所有Evaler路径字段保持零值验证elvish-path、rc-path、effective-rc-path均为$nil、lib-dirs为空列表。驱动测试的 runtime_test.go 通过//go:embed *.elvts嵌入转录文件并用testutil.Set临时替换runtime.OSExecutable该替换点暴露在 testexport_test.go 中仅测试用。测试注释还特别说明之所以需要手动替换默认模块是因为runtime 模块在初始化时会读取 Evaler 字段runtime_test.go这正好印证了上文快照式构建的实现特性。实践建议如何在脚本中使用runtime:模块runtime:是内置模块无需use即可直接以$runtime:前缀访问。综合上述语义给出几条可直接落地的用法判断自身是否可重入调用$runtime:elvish-path而非在PATH中查找elvish保证子进程与当前解释器同版本if (has-key $runtime:elvish-path $nil) { # 无法确定自身路径退回依赖 PATH 中的 elvish ^elvish -c ... } else { ^$runtime:elvish-path -c ... }排查模块加载失败先打印$runtime:lib-dirs核对期望安装模块的目录是否在搜索路径中注意lib-dirs是列表可用all或下标逐一检查。区分默认 RC与实际 RC当$runtime:effective-rc-path $nil时说明当前会话非交互或-norc不会执行任何 RC 初始化逻辑此时在脚本中应跳过依赖 RC 环境的操作当它等于$rc-path时说明走的是默认路径而非-rc覆盖。需要留意的是这些变量全部为只读快照且面向当前解释器进程的信息因此在不同机器、不同启动标志下取值会不同——脚本中应始终先判空$nil/ 空列表再使用。小结runtime:模块虽然只有四个只读变量却是 Elvish 脚本感知自身运行环境的唯一官方入口elvish-path定位解释器二进制lib-dirs揭示模块搜索路径rc-path与effective-rc-path组合起来则完整刻画了 RC 文件的默认位置与实际加载情况。结合 runtime.go 的快照式实现与 runtime_test.elvts 的双场景测试你可以准确预判每个变量在何种启动条件下取值、何时为$nil从而写出对环境变化更稳健的配置脚本。赞分享CLI编程语言开发工具【免费下载链接】elvishPowerful scripting language versatile interactive shell项目地址https://gitcode.com/gh_mirrors/el/elvish点击查看免费下载相关推荐3 个参数搞定 B 站批量取关BiliBiliToolPro UnfollowBatched 完整配置指南3 个参数搞定 B 站批量取关BiliBiliToolPro UnfollowBatched 完整配置指南 BiliBiliToolPro 是一款支持 Doc后端任务调度工作流自动化ElixirLS反射机制运行时信息获取ElixirLS反射机制运行时信息获取 引言 在Elixir开发过程中你是否曾遇到过这样的困境需要快速了解模块的内部结构、函数签名、类型定义或者想要在运Elvish 0.19.1 版本全解析doc 模块、conj/compact 新命令与 runtime 模块Elvish 0.19.1 版本全解析doc 模块、conj/compact 新命令与 runtime 模块 导读 Elvish 0.19.1 于 2023CLI编程语言开发工具上一篇AlwaysOnTop窗口置顶工具提升多任务处理效率的必备解决方案下一篇重构窗口管理逻辑AlwaysOnTop工具的认知效率革新创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考