黑暗检测

一个小型命令行工具，用Rust编写，让您可以找出您今天处于黑暗中的小时数。

用法

使用 darkness-check 应用程序有多种方法，在查找位置时自行查找纬度经度或获取API密钥以便应用程序为您查找之间取得平衡。

无配置：自行提供纬度经度点

darkness-check <LAT> <LONG>

注意：如果您已提供API密钥，这将失败，您应该按城市和国家查找，或者您可以使用环境变量覆盖它

DARK_POINT="52.520008 13.404954" darkness-check 

一点配置

将纬度和经度点放入您的 dark-config.toml 或 dark-config.json。

# dark-config.toml
point = "52.520008 13.404954"

然后调用它，如下所示

darkness-check

dark-config 文件必须在可执行文件的同一目录层级中。（也就是说，它可以在父目录中，等等。）

更多配置，更多灵活性

如果您想按名称查找位置，您需要在 API Ninjas 上创建一个免费账户，并将 key 字段添加到 dark-config.toml。

# dark-config.toml
key = "API_KEY_FROM_API_NINJAS"

然后查找任何城市和国家。

darkness-check berlin germany 

将包含多个单词的城市放在引号中。

darkness-check "mexico city" mexico

dark-config 文件必须在可执行文件的同一目录层级中，但如果不喜欢这样做，API密钥也可以作为环境变量提供。

DARK_KEY="jfhkaljkrhfjrhuljkhs" darkness-check berlin germany 

即将推出

[ ] 在配置中添加多个点。[ ] 将配置文件放在更好的位置。

安装

有两种方法可以安装此工具：手动或使用 cargo install。如果您已经使用Rust，则后者几乎肯定更容易。如果您还没有使用，但想在您的系统上安装它，请从这里开始 开始。如果您不想在系统上安装它或像我一样是个控制狂，您可能会觉得手动安装更符合您的喜好。

手动

下载最新的版本 发布；解压缩并将其添加到您的路径中。

Mac/Linux

可以通过双击下载的文件或使用以下方法解压缩

tar –xvf {downloaded-file-name}.tar.gz

然后，将文件添加到您的 PATH。一种方法是为您的命令行应用程序创建一个文件夹，并将整个文件夹添加到您的 PATH

cd ~ # move to your home folder 
mkdir bin # create a directory called bin
cd <UNCOMPRESSED_DARKNESS_DIRECTORY> # on a mac, to get this path you can drag the folder from finder into the command line
cp darkness-check ~/bin # move it to the directory we created 
echo "export PATH=$HOME/bin:$PATH" >> ~/.zshrc # replace  ~/.zshrc with ~/.bashrc

如果最后一行失败，告诉你没有 ~/.zshrc 或 ~/.bashrc，你可以使用 touch 命令创建一个

touch ~/.bashrc

你可以通过打开一个新的终端窗口并输入以下命令来检查安装是否成功

which darkness-check

现在你可以运行 darkness-check。嗯，几乎可以，如果你在使用Mac。这是一个未签名的应用程序，所以当你第一次尝试运行它时，你会得到一个错误，表明它是未签名的。转到 安全 & 隐私 > 通用，然后点击 允许 anyway。

如果你想使用配置文件，我建议将其添加到 ~ 目录下：touch dark-config.toml。

Windows

Windows用户还会希望将可执行文件添加到他们的 $PATH 中。由于我没有Windows机器，我没有测试过它，但 这篇教程 和 这个视频 展示了步骤。

如果你遇到问题或能提供更多信息，请随时提交问题或PR。

作为 @axodotdev 的入职项目构建。