Metadata-Version: 2.0
Name: fanfou-cli
Version: 0.1.3
Summary: Fanfou Command Line Client
Home-page: https://github.com/j178/fanfou-cli
Author: John Jiang
Author-email: nigelchiang@outlook.com
License: MIT
Keywords: internet,oauth,sns
Platform: UNKNOWN
Requires-Dist: requests-oauthlib

## 饭否命令行客户端

### 安装
- 通过pip安装
```sh
pip install fanfou-cli
```
- 手动安装
```sh
git clone https://github.com/j178/fanfoucli
cd fanfoucli
pip install . --user
```

### 使用

初次使用时，此工具需要获取你的授权才能帮你发饭。
1. 首先执行`fan`的任意命令，工具会指示你在浏览器中打开一个链接：
```sh
$ fan -h
请在浏览器中打开此网址: http://fanfou.com/oauth/authorize?callback_uri=http%3A%2F%2Fu.nigel.top&oauth_t
oken=20a6af62dc1913997c48b7d4f03177ef
```
**这个是饭否官方授权第三方应用的页面，请放心打开。**  

2. 打开之后会出现如下授权页面：
    ![](_images/1.png)
    点击同意，即允许第三方应用操作你在饭否上的数据。

3. 然后，浏览器会重定向到一个链接，浏览器会提示无法打开这个页面，没关系，我们需要的只是这个页面的网址，
即`http://my.nigel.top/callback?oauth_token=db6d6915fe3bb31df2675b9cac1e3569` 这样的东西，将它复制到我们运行的脚本中：
    ```sh
    请将跳转后的网站粘贴到这里: http://my.nigel.top/callback?oauth_token=db6d6915fe3bb31df2675b9cac1e3569
    授权完成，可以愉快地发饭啦！
    ```
OK! 授权已经完成了，现在可以愉快地刷饭了！

**整个授权过程都是使用饭否官方地OAuth API，此工具无法获取到你的密码。如果你想取消对此工具的授权，
可以随时访问 `http://fanfou.com/settings/apps`, 找到`爱米饭`， 然后`取消认证`就可以了啦~。如下图所示：**
![](_images/2.png)

日常使用：
```sh
fan 任意文字，不需要引号，可以包含空格，fan命令之后的任意内容均被当作新饭的内容
```

其他功能：
- 备份所有饭否消息
- 撤回上一条饭
- 一键上锁/解锁
- 在终端上刷饭

### 说明
此工具会在`~/.fancache`(*unix系统)或 `%USERPROFILE%/.fancache`中保存认证凭据(`access_token`)，用户的饭否资料，和你的最新的一条饭否消息。你可以随时删除这个文件，不过删除之后需要重新授权。

### 依赖
- Python3
- requests-oauthlib

### TODO
- [ ] 转发消息
- [ ] colorize

