1 个不稳定版本
0.1.2 | 2023年6月2日 |
---|---|
0.1.1 |
|
0.1.0 |
|
#35 在 #启动器
每月 32 次下载
10KB
66 行
X-Launcher 🚀
一个跨平台、无工具限制的项目自动化启动器。
💡 简而言之:X-Launcher 是一个简单的二进制 x
,当执行时,它会在调用目录中搜索 xfile
文件,并向上查找。当它找到一个 xfile
文件时,它会使用它来启动特定项目的工具,方法有:(a) 执行 xfile
文件本身或 (b) 委托给第三方工具(例如,cargo
、make
或 npm
)。
🤔 原因:X-Launcher 通过将 x
作为与项目所需工具交互的通用命令,为使用不同工具和语言的多个项目提供了一致性。此外,它还使得以 xfile
脚本(例如,Bash 或 Python)的形式添加自定义自由工具变得非常容易。
查看 示例 以了解 X-Launcher 可以为您做什么。X-Launcher 设计为与任何工具一起工作。仅举几个例子,X-Launcher 与 Cargo、npm、make、just 和 Poetry 等工具配合良好。
安装
目前,安装 X-Launcher 的官方方式是通过 Cargo
cargo install x-launcher
用法
只需运行 x
。所有参数都将转发到底层工具。
xfile
参考
xfile
可以有两种解释方式
-
如果
xfile
以Unix的shebang开头,则直接执行xfile
文件。在类Unix系统中,这可以通过直接执行xfile
来完成。在Windows上,x
负责解析shebang并使用xfile
作为参数执行正确的程序。为此,如果shebang以除/usr/bin/env
以外的路径开头,将使用环境变量的PATH
变量查找二进制名称。如果shebang以/usr/bin/env
开头,则使用env
的第一个参数来查找可执行文件。 -
如果
xfile
不以shebang开头,则它必须具有!command
或>command
的形式,其中command
被解释为POSIX shell命令(目前不执行任何展开,例如变量或~
)。X-Launcher将在调用目录中执行指定的命令(对于!command
),或xfile
所在的目录中执行(对于>command
)。在后一种情况下,环境变量X_INVOCATION_DIR
被设置为调用目录,以便仍可以检索。
无论如何,传递给x
的参数都会转发给启动的任何程序。
贡献
我们接受错误修复和改进,并愿意讨论想法。然而,请注意,X-Launcher故意保持非常简单。已经有许多优秀的工具可以解决不同的项目自动化需求。X-Launcher正如其名所示,只是一个启动器,并不旨在做得更多。因此,我们可能会拒绝任何旨在将X-Launcher扩展到启动之外的贡献。
许可
X-Launcher根据您的意见,许可为MIT或Apache 2.0。除非您明确声明,否则根据Apache 2.0许可证定义的,您有意提交以包含在此项目中的任何贡献,将按上述方式双许可,不附加任何额外条款或条件。
由Silitics用❤️为OSS制作。
依赖
~19KB