6 个版本 (破坏性)

0.7.0	2021 年 4 月 23 日
0.6.0	2021 年 4 月 19 日
0.5.0	2021 年 2 月 26 日
0.4.0	2021 年 2 月 26 日
0.1.1-dev	2021 年 2 月 23 日

#1083 in Rust 模式

MPL-2.0 许可证

76KB
2K SLoC

fnichol-cime

一个 Rust CI 构建/测试/发布工作流程的演示，支持多平台测试、二进制构建、Docker 镜像构建和 Crates.io 发布。


CI
最新版本
文档
包下载
GitHub 下载
Docker 拉取
许可证

命令行界面
- 用法
- 安装
库
- 用法
- 示例
  - 示例：问候人类
CI 状态
行为准则
问题
贡献
发布历史
作者
许可证

命令行界面

用法

这个程序很简单。要问候当前登录用户，请运行

> fnichol-cime "$USER"
Hello, jdoe!

有关更多帮助和完整用法，请使用 --help 或 -h 标志

> fnichol-cime --help

安装

install.sh (预构建的二进制文件)

在 https://fnichol.github.io/fnichol-cime/install.sh 提供了一个安装程序，该程序安装适用于 Linux、macOS、Windows 和 FreeBSD 等常见系统的合适预构建二进制文件。它可以下载并在本地运行或按以下所示通过 "curl-bash" 风格将其输入到 shell 解释器中。请注意，如果您反对这种想法，请随意查看以下一些替代方案。

要将系统上的最新发布版安装到 $HOME/bin

> curl -sSf https://fnichol.github.io/fnichol-cime/install.sh | sh

当安装程序以 root 运行时，默认安装目录为 /usr/local/bin

> curl -sSf https://fnichol.github.io/fnichol-cime/install.sh | sudo sh

有一个从主分支的 HEAD 构建的夜间发布版可供安装

> curl -sSf https://fnichol.github.io/fnichol-cime/install.sh \
    | sh -s -- --release=nightly

要查看完整选项，请使用 help 使用方法。

> curl -sSf https://fnichol.github.io/fnichol-cime/install.sh \
    | sh -s -- --help

GitHub 发布版（预构建的二进制文件）

每个版本都包含在GitHub 发布中发布的二进制工件。程序 install.sh 从这个位置下载其工件，因此这可以作为手动替代方案。每个工件都附带 MD5 和 SHA256 校验和，以帮助在目标系统上验证工件。

Docker 镜像

每个版本都附带最小镜像（包括从主分支的 HEAD 构建的夜间构建版本），并发布到 Docker Hub。入口点直接调用二进制文件，因此任何传递给 docker run 的参数都将传递给程序。例如，要显示完整的帮助用法

> docker run fnichol/fnichol-cime --help

Cargo 安装

如果您的系统上已安装 Rust，则可以使用 Cargo 直接安装

> cargo install fnichol-cime

从源码安装

要从源安装，您可以克隆 Git 仓库，使用 Cargo 构建，并将二进制文件复制到目标目录。这将从主分支的最新提交构建项目，这可能不对应于最新稳定版本

> git clone https://github.com/fnichol/fnichol-cime.git
> cd fnichol-cime
> cargo build --release
> cp ./target/release/fnichol-cime /dest/path/

库

这个包执行一个高度专业化的算法，以动态生成针对特定主题的英文问候语。这是严肃的业务。

用法

这个包位于 crates.io 上，您可以通过将包添加到项目 Cargo.toml 文件中的依赖项来使用它

[dependencies]
fnichol-cime = { version = "0.7.0", default-features = false }

请注意，默认功能包括构建 CLI 所需的依赖项，而对于库则不需要。

示例

示例：问候人类

假设我们有一个名叫 Jane 的人

let greeting = fnichol_cime::greeting("Jane");
// #=> "Hello, Jane!"

CI 状态

构建（主分支）

操作系统	目标	稳定的 Rust
FreeBSD	`x86_64-unknown-freebsd`
Linux	`arm-unknown-linux-gnueabihf`
Linux	`aarch64-unknown-linux-gnu`
Linux	`i686-unknown-linux-gnu`
Linux	`i686-unknown-linux-musl`
Linux	`x86_64-unknown-linux-gnu`
Linux	`x86_64-unknown-linux-musl`
macOS	`x86_64-apple-darwin`
Windows	`x86_64-pc-windows-msvc`