hazy 0.0.3

# Hazy工具包

Hazy工具包是[Hazy](https://hazy.com)网络服务的命令行界面（CLI）。它使用Python开发，代码在[github.com/hazy/toolbelt](https://github.com/hazy/toolbelt）下以[MIT许可证](https://github.com/hazy/toolbelt/blob/master/LICENSE)发布。

## 状态 - WIP

该工具包及其针对的JSON API都在积极开发中，目前尚未准备好供公共使用。

## 安装

### 使用

工具包设计为预构建的独立二进制文件使用。一种启动的方法是从[发布页面](https://github.com/hazy/toolbelt/releases)下载您架构的最新二进制文件，并将二进制文件放在您的PATH上的某个位置。

或者，在OSX上，您可以使用Homebrew安装

`sh brew tap hazy/toolbelt brew install hazy `

或者如果您使用Python3，可以直接从PyPI安装

`sh pip install hazy `

### 开发

您可以通过将依赖项安装到Python3环境中并开发egg来安装工具包进行本地开发

`sh pip install -r requirements.txt python setup.py develop `

这将安装一个在您本地Python环境的bin文件夹中的二进制文件。您可以使用例如以下命令来检查它是否在您的路径上

`sh which hazy `

### 构建

注意，截至写作时间（2018年8月7日），PyInstaller已被验证与Python 3.6兼容，并在3.7下有一些问题。

您可以使用PyInstaller构建一个独立的二进制文件（适用于您的架构）。这需要额外的依赖项。

首先确保你已经安装了 [Pandoc](https://pandoc.org/installing.html)，例如使用 Homebrew

`sh brew install pandoc `

然后安装额外的 Python 依赖项

`sh pip install -r maintainer-requirements.txt `

然后你可以使用以下命令进行构建

`sh ./_build.sh `

这将把一个独立的二进制文件写入到 ./dist/hazy。你可以选择使用以下命令将其复制到 /usr/local/bin/hazy

`sh ./_link.sh `

### 发布

你可以通过在 ./VERSION 中增加版本号并运行以下命令来将工具包的新版本发布到 PyPI

`sh ./_release.sh `

TODO

• [ ] 更新发布脚本以发布二进制文件

• [ ] 为多个平台构建二进制文件

## 使用

运行 hazy 命令不带参数或带 –help 标志以获取使用信息

`sh hazy --help `

你可以深入查看资源/命令组的使用信息以及单个命令的使用信息，例如

`sh hazy auth --help hazy auth login --help `

更详细的 [文档可在 Hazy 网站上找到](https://hazy.com/docs)。

## 测试

运行测试需要 nose 和 coverage，它们包含在 maintainer-requirements.txt 中。

然后，运行例如

`sh nosetests --with-coverage --cover-package hazy `