CQHTTP 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: de2676b9e75e72384e908cd5e024390ed4c34b7a
+  data.tar.gz: 21b512289cf71ea8842d5eed659fc0f7e03c522a
+SHA512:
+  metadata.gz: 6c9a2c6fae74f7cee911b84f50b85f0e78995d4c92ec578a9c2483937b223b56a06fa157dacea534a1797414e600222c6c1fbfe1a97fdd6c41801557388c921b
+  data.tar.gz: b501e2bf245e422d41dfada6e17427501790ee8023d6c4c746667c27cf59a44e99945f2e4fe1b817cf34c7ae0185e940d982a35ca3c84810a9217f5e6ef11a93

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/CQHTTP.gemspec

@@ -0,0 +1,24 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'CQHTTP/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'CQHTTP'
+  spec.version       = CQHTTP::VERSION
+  spec.authors       = ['71e6fd52']
+  spec.email         = ['DAStudio.71e6fd52@gmail.com']
+
+  spec.summary       = 'CoolQ HTTP API ruby bind'
+  spec.homepage      = 'https://github.com/71e6fd52/cqhttp-ruby'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.15'
+  spec.add_development_dependency 'rake',    '~> 10.0'
+  spec.add_development_dependency 'rspec',   '~> 3.0'
+end

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in CQHTTP.gemspec
+gemspec

data/README.en.md

@@ -0,0 +1,33 @@
+# CQHTTP ([中文](/README.md))
+
+This gem can make you use [richardchien/coolq-http-api](https://github.com/richardchien/coolq-http-api) in ruby.
+
+## Installation
+
+Add this line to your application's `Gemfile`:
+
+```ruby
+gem 'CQHTTP'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install CQHTTP
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/71e6fd52/cqhttp-ruby

data/README.md

@@ -0,0 +1,33 @@
+# CQHTTP ([English](/README.en,md))
+
+在 ruby 中使用 [richardchien/coolq-http-api](https://github.com/richardchien/coolq-http-api)。
+
+## 安装
+
+在你的应用的 `Gemfile` 加入这行：
+
+```ruby
+gem 'CQHTTP'
+```
+
+然后运行：
+
+    $ bundle
+
+或者你自己安装
+
+    $ gem install CQHTTP
+
+## 使用
+
+TODO: 写使用说明
+
+## 开发
+
+检出这个仓库后，运行 `bin/setup` 来安装依赖关系。然后，运行 `rake spec` 来运行测试。 您还可以运行 `bin/console` 启动交互式提示符(`irb`)，让您进行实验。
+
+要将此 gem 安装到本机上，请运行 `bundle exec rake install`。 要释出新版本，请在 `version.rb` 中更新版本号，然后运行 `bundle exec rake release`，该版本将为该版本创建一个 git 标签，并推送 git 提交和标签，然后将 `.gem` 文件提交到 [rubygems.org]（https://rubygems.org）。
+
+## 贡献
+
+欢迎来 [GitHub](https://github.com/71e6fd52/cqhttp-ruby) 上发起 issues 和 pull requests

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "CQHTTP"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/gen_api_list

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require 'CQHTTP'
+require 'json'
+
+a = CQHTTP::API.new
+puts a.func_list.to_json

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/CQHTTP/API.md

@@ -0,0 +1,429 @@
+# API 描述
+
+## 请求方式
+
+所有 API 都同时支持 GET 和 POST 两种请求方式，参数可通过 URL 参数、表单或 JSON 传入，后两者分别对应 Content-Type `application/x-www-form-urlencoded` 和 `application/json`。如果使用 JSON 传入，参数要放在根级别的 JSON 对象中，且参数的数据类型必须符合 API 列表中给出的每个参数所要求的数据类型，大致如下：
+
+```json
+{"user_id": 123456, "message": "hello"}
+```
+
+API 描述中没有给出默认值的参数均为必填项。
+
+如果配置文件中填写了 token，则每次请求需要在请求头中加入验证头，如：
+
+```http
+GET /send_private_msg?user_id=123456&message=hello HTTP/1.1
+Authorization: token kSLuTF2GC2Q4q4ugm3
+```
+
+`kSLuTF2GC2Q4q4ugm3` 换成你填写的 token。
+
+从 2.1.3 版本开始支持以 query 参数 `access_token` 的形式传入 token，以便在无法修改请求头的情况下使用，例如：
+
+```http
+GET /send_private_msg?access_token=kSLuTF2GC2Q4q4ugm3&user_id=123456&message=hello HTTP/1.1
+```
+
+## 响应说明
+
+对于任何请求:
+
+- 如果请求方式不支持，状态码为 405；
+- 如果 token 不符合，状态码为 401；
+- 如果 POST 请求的 Content-Type 不正确，状态码为 400；
+- 如果 API 不存在，状态码为 404；
+- 剩下的所有情况，无论操作失败还是成功，状态码都是 200。
+
+响应内容为 JSON 格式，基本结构如下：
+
+```json
+{
+    "status": "ok",
+    "retcode": 0,
+    "data": {
+        "id": 123456,
+        "nickname": "滑稽"
+    }
+}
+```
+
+`status` 字段如果是 `ok` 则表示操作成功，同时 `retcode` （返回码）会等于 0，即酷 Q 函数返回了 0，也就是酷 Q 认为成功了，但实际上有某些情况下其实是没有成功的，比如向没有加入的群发送消息，返回码是 0，日志里也没有提示发送失败，但显然是发送不了的。这一点在酷 Q 的 [官方文档](https://d.cqp.me/Pro/%E5%BC%80%E5%8F%91/Error) 也说明了：
+
+>  需要指出的是，某些接口暂未进行错误代码的处理，此时即使发生错误，仍返回0。
+
+`status` 字段如果是 `failed` 则表示操作失败，此时 `retcode` 有两种情况，当大于 0 时，表示是 HTTP API 插件判断出的失败，这个目前有如下情况：
+
+| 返回码     | 说明                                       |
+| ------- | ---------------------------------------- |
+| 100     | 默认的错误码，通常是因为没有传入必要参数，某些接口中也可能因为参数明显无效，比如传入的 QQ 号小于等于 0，此时无需调用酷 Q 函数即可确定失败 |
+| 102 | 酷 Q 函数返回的数据无效，一般是因为传入参数有效但没有权限，比如试图获取没有加入的群组的成员列表 |
+
+另外一种情况是 `retcode` 小于 0，此时即为调用酷 Q 函数的返回码，具体含义直接参考 [Pro/开发/Error](https://d.cqp.me/Pro/%E5%BC%80%E5%8F%91/Error) 和酷 Q 的日志。
+
+`data` 字段为 API 返回数据的内容，对于发送消息、踢人等不需要返回数据的操作，这里为 null，对于获取群成员信息这类操作，这里为所获取的数据的对象，具体的数据内容将会在相应的 API 描述中给出。
+
+后面的 API 描述中将只给出 `data` 字段的内容，放在「响应数据」标题下。
+
+## 发送消息格式
+
+从 2.0.0 版本开始发送消息格式有了较大变化（向下兼容），具体请查看 [消息格式](https://richardchien.github.io/coolq-http-api/#/Message)。
+
+后面提到消息的地方（`message` 字段），将不再具体解释其格式。
+
+## API 列表
+
+### `/get_login_info` 获取登录号信息
+
+#### 参数
+
+无
+
+#### 响应数据
+
+| 字段名 | 数据类型 | 说明 |
+| ----- | ------- | --- |
+| `user_id` | number | QQ 号 |
+| `nickname` | string | QQ 昵称 |
+
+### `/send_private_msg` 发送私聊消息
+
+#### 参数
+
+| 字段名 | 数据类型 | 默认值 | 说明 |
+| ----- | ------- | ----- | --- |
+| `user_id` | number | - | 对方 QQ 号 |
+| `message` | string/array | - | 要发送的内容 |
+| `is_raw` | bool | false | 消息内容是否作为纯文本发送（即不解析 CQ 码），`message` 数据类型为 `array` 时无效 |
+
+#### 响应数据
+
+无
+
+### `/send_group_msg` 发送群消息
+
+#### 参数
+
+| 字段名 | 数据类型 | 默认值 | 说明 |
+| ----- | ------- | ----- | --- |
+| `group_id` | number | - | 群号 |
+| `message` | string/array | - | 要发送的内容 |
+| `is_raw` | bool | false | 消息内容是否作为纯文本发送（即不解析 CQ 码），`message` 数据类型为 `array` 时无效 |
+
+#### 响应数据
+
+无
+
+### `/send_discuss_msg` 发送讨论组消息
+
+#### 参数
+
+| 字段名 | 数据类型 | 默认值 | 说明 |
+| ----- | ------- | ----- | --- |
+| `discuss_id` | number | - | 讨论组 ID（正常情况下看不到，需要从讨论组消息上报的数据中获得） |
+| `message` | string/array | - | 要发送的内容 |
+| `is_raw` | bool | false | 消息内容是否作为纯文本发送（即不解析 CQ 码），`message` 数据类型为 `array` 时无效 |
+
+#### 响应数据
+
+无
+
+### `/send_like` 发送好友赞
+
+#### 参数
+
+| 字段名 | 数据类型 | 默认值 | 说明 |
+| ----- | ------- | ----- | --- |
+| `user_id` | number | - | 对方 QQ 号 |
+| `times` | number | 1 | 赞的次数，每个好友每天最多 10 次 |
+
+#### 响应数据
+
+无
+
+### `/set_group_kick` 群组踢人
+
+#### 参数
+
+| 字段名 | 数据类型 | 默认值 | 说明 |
+| ----- | ------- | ----- | --- |
+| `group_id` | number | - | 群号 |
+| `user_id` | number | - | 要踢的 QQ 号  |
+| `reject_add_request` | bool | `false` | 拒绝此人的加群请求 |
+
+#### 响应数据
+
+无
+
+### `/set_group_ban` 群组单人禁言
+
+#### 参数
+
+| 字段名 | 数据类型 | 默认值 | 说明 |
+| ----- | ------- | ----- | --- |
+| `group_id` | number | - | 群号 |
+| `user_id` | number | - | 要禁言的 QQ 号 |
+| `duration` | number | `30 * 60` | 禁言时长，单位秒，0 表示取消禁言 |
+
+#### 响应数据
+
+无
+
+### `/set_group_anonymous_ban` 群组匿名用户禁言
+
+#### 参数
+
+| 字段名 | 数据类型 | 默认值 | 说明 |
+| ----- | ------- | ----- | --- |
+| `group_id` | number | - | 群号 |
+| `flag` | string | - | 要禁言的匿名用户的 flag（需从群消息上报的数据中获得） |
+| `duration` | number | `30 * 60` | 禁言时长，单位秒，无法取消匿名用户禁言 |
+
+#### 响应数据
+
+无
+
+### `/set_group_whole_ban` 群组全员禁言
+
+#### 参数
+
+| 字段名 | 数据类型 | 默认值 | 说明 |
+| ----- | ------- | ----- | --- |
+| `group_id` | number | - | 群号 |
+| `enable` | bool | `true` | 是否禁言 |
+
+#### 响应数据
+
+无
+
+### `/set_group_admin` 群组设置管理员
+
+#### 参数
+
+| 字段名 | 数据类型 | 默认值 | 说明 |
+| ----- | ------- | ----- | --- |
+| `group_id` | number | - | 群号 |
+| `user_id` | number | - | 要设置管理员的 QQ 号 |
+| `enable` | bool | `true` | true 为设置，false 为取消 |
+
+#### 响应数据
+
+无
+
+### `/set_group_anonymous` 群组匿名
+
+#### 参数
+
+| 字段名 | 数据类型 | 默认值 | 说明 |
+| ----- | ------- | ----- | --- |
+| `group_id` | number | - | 群号 |
+| `enable` | bool | `true` | 是否允许匿名聊天 |
+
+#### 响应数据
+
+无
+
+### `/set_group_card` 设置群名片（群备注）
+
+#### 参数
+
+| 字段名 | 数据类型 | 默认值 | 说明 |
+| ----- | ------- | ----- | --- |
+| `group_id` | number | - | 群号 |
+| `user_id` | number | - | 要设置的 QQ 号 |
+| `card` | string | 空 | 群名片内容，不填或空字符串表示删除群名片 |
+
+#### 响应数据
+
+无
+
+### `/set_group_leave` 退出群组
+
+#### 参数
+
+| 字段名 | 数据类型 | 默认值 | 说明 |
+| ----- | ------- | ----- | --- |
+| `group_id` | number | - | 群号 |
+| `is_dismiss` | bool | `false` | 是否解散，如果登录号是群主，则仅在此项为 true 时能够解散 |
+
+#### 响应数据
+
+无
+
+### `/set_group_special_title` 设置群组专属头衔
+
+#### 参数
+
+| 字段名 | 数据类型 | 默认值 | 说明 |
+| ----- | ------- | ----- | --- |
+| `group_id` | number | - | 群号 |
+| `user_id` | number | - | 要设置的 QQ 号 |
+| `special_title` | string | 空 | 专属头衔，不填或空字符串表示删除专属头衔 |
+| `duration` | number | `-1` | 专属头衔有效期，单位秒，-1 表示永久，不过此项似乎没有效果，可能是只有某些特殊的时间长度有效，有待测试 |
+
+#### 响应数据
+
+无
+
+### `/set_discuss_leave` 退出讨论组
+
+#### 参数
+
+| 字段名 | 数据类型 | 默认值 | 说明 |
+| ----- | ------- | ----- | --- |
+| `discuss_id` | number | - | 讨论组 ID（正常情况下看不到，需要从讨论组消息上报的数据中获得） |
+
+#### 响应数据
+
+无
+
+### `/set_friend_add_request` 处理加好友请求
+
+#### 参数
+
+| 字段名 | 数据类型 | 默认值 | 说明 |
+| ----- | ------- | ----- | --- |
+| `flag` | string | - | 加好友请求的 flag（需从上报的数据中获得） |
+| `approve` | bool | `true` | 是否同意请求 |
+| `remark` | string | 空 | 添加后的好友备注（仅在同意时有效） |
+
+#### 响应数据
+
+无
+
+### `/set_group_add_request` 处理加群请求／邀请
+
+#### 参数
+
+| 字段名 | 数据类型 | 默认值 | 说明 |
+| ----- | ------- | ----- | --- |
+| `flag` | string | - | 加好友请求的 flag（需从上报的数据中获得） |
+| `type` | string | - | `add` 或 `invite`，请求类型（需要和上报消息中的 `sub_type` 字段相符） |
+| `approve` | bool | `true` | 是否同意请求／邀请 |
+| `reason` | string | 空 | 拒绝理由（仅在拒绝时有效） |
+
+#### 响应数据
+
+无
+
+### `/get_group_list` 获取群列表
+
+#### 参数
+
+无
+
+#### 响应数据
+
+响应内容为 JSON 数组，每个元素如下：
+
+| 字段名 | 数据类型 | 说明 |
+| ----- | ------- | --- |
+| `group_id` | number | 群号 |
+| `group_name` | string | 群名称 |
+
+### `/get_group_member_info` 获取群成员信息
+
+#### 参数
+
+| 字段名 | 数据类型 | 默认值 | 说明 |
+| ----- | ------- | ----- | --- |
+| `group_id` | number | - | 群号 |
+| `user_id`  | number | - | QQ 号（不可以是登录号） |
+| `no_cache` | bool | `false` | 是否不使用缓存（使用缓存可能更新不及时，但响应更快） |
+
+#### 响应数据
+
+| 字段名 | 数据类型 | 说明 |
+| ----- | ------- | --- |
+| `group_id` | number | 群号 |
+| `user_id` | number | QQ 号 |
+| `nickname` | string | 昵称 |
+| `card` | string | 群名片／备注 |
+| `sex` | string | 性别，`male` 或 `female` 或 `unknown` |
+| `age` | number | 年龄 |
+| `area` | string | 地区 |
+| `join_time` | number | 加群时间戳 |
+| `last_sent_time` | number | 最后发言时间戳 |
+| `level` | string | 成员等级 |
+| `role` | string | 角色，`owner` 或 `admin` 或 `member` |
+| `unfriendly` | bool | 是否不良记录成员 |
+| `title` | string | 专属头衔 |
+| `title_expire_time` | number | 专属头衔过期时间戳 |
+| `card_changeable` | bool | 是否允许修改群名片 |
+
+### `/get_group_member_list` 获取群成员列表
+
+#### 参数
+
+| 字段名 | 数据类型 | 默认值 | 说明 |
+| ----- | ------- | ----- | --- |
+| `group_id` | number | - | 群号 |
+
+#### 响应数据
+
+响应内容为 JSON 数组，每个元素的内容和上面的 `/get_group_member_info` 接口相同，但对于同一个群组的同一个成员，获取列表时和获取单独的成员信息时，某些字段可能有所不同，例如 `area`、`title` 等字段在获取列表时无法获得，具体应以单独的成员信息为准。
+
+### `/get_stranger_info` 获取陌生人信息
+
+#### 参数
+
+| 字段名 | 数据类型 | 默认值 | 说明 |
+| ----- | ------- | ----- | --- |
+| `user_id` | number | - | QQ 号（不可以是登录号） |
+| `no_cache` | bool | `false` | 是否不使用缓存（使用缓存可能更新不及时，但响应更快） |
+
+#### 响应数据
+
+| 字段名 | 数据类型 | 说明 |
+| ----- | ------- | --- |
+| `user_id` | number | QQ 号 |
+| `nickname` | string | 昵称 |
+| `sex` | string | 性别，`male` 或 `female` 或 `unknown` |
+| `age` | number | 年龄 |
+
+### `/get_cookies` 获取 Cookies
+
+#### 参数
+
+无
+
+#### 响应数据
+
+| 字段名 | 数据类型 | 说明 |
+| ----- | ------- | --- |
+| `cookies` | string | Cookies |
+
+### `/get_csrf_token` 获取 CSRF Token
+
+#### 参数
+
+无
+
+#### 响应数据
+
+| 字段名 | 数据类型 | 说明 |
+| ----- | ------- | --- |
+| `token` | number | CSRF Token |
+
+### `/get_version_info` 获取酷 Q 及 HTTP API 插件的版本信息
+
+#### 参数
+
+无
+
+#### 响应数据
+
+| 字段名 | 数据类型 | 说明 |
+| ----- | ------- | --- |
+| `coolq_edition` | string | 酷 Q 版本，`air` 或 `pro` |
+| `plugin_version` | string | HTTP API 插件版本，例如 `2.1.3` |
+
+## 获取 `data` 目录中的文件的接口
+
+2.1.0 版本开始提供一个简单的静态文件获取服务，请求方式只支持 GET，URL 路径为 `/data/` 加上要请求的文件相对于酷 Q `data` 目录的路径。例如，假设酷 Q 主目录在 `C:\Apps\CQA`，则要获取 `C:\Apps\CQA\data\image\ABCD.jpg.cqimg` 的话，只需请求 `/data/image/ABCD.jpg.cqimg`，响应内容即为要请求的文件。
+
+和上面的其它请求一样，如果配置文件中指定了 token，则每次请求需要在请求头中加入验证头 `Authorization: token your-token`。
+
+另外，请求的路径中不允许出现 `..`，即上级目录的标记，以防止恶意或错误的请求到系统中的其它文件。
+
+本功能默认情况下不开启，在配置文件中将 `serve_data_file` 设置为 `yes` 或 `true` 即可开启，见 [配置文件说明](https://richardchien.github.io/coolq-http-api/#/Configuration)。

data/lib/CQHTTP/api.rb

@@ -0,0 +1,133 @@
+module CQHTTP
+  # All API
+  class API
+    attr_reader :func_list
+
+    # init
+    #
+    # host: String: API address, like 'http://localhost:5700'
+    # type: Symbol or String, 'get', 'form' or 'json;
+    def initialize(host = 'http://localhost:5700', way = :get)
+      @func_list = {}
+      gen
+      @func_list.freeze
+      @network = CQHTTP::Network.gen way, host
+    end
+
+    def respond_to_missing?(method, include_private = false)
+      @func_list.include?(method) || super
+    end
+
+    def method_missing(name, *user_args)
+      return super unless respond_to_missing? name
+
+      args = gen_args name, user_args
+      args.freeze
+      return super if args.nil?
+      return super if args.value? nil
+      call_network name, args
+    end
+
+    private
+
+    ####################################################################
+    #                             api_call                             #
+    ####################################################################
+
+    def gen_args(name, user_args)
+      args = @func_list[name.to_sym]
+      return {} if args == {}
+      return hash_to_args(args, user) if user_args[0].class == {}.class
+      array_to_args(args, user_args)
+    end
+
+    def hash_to_args(default, user)
+      return unless user.size == 1
+      default.merge(user[0].delete_if { |key, _value| !default.key? key })
+    end
+
+    def array_to_args(default, user)
+      return if user.size > default.size
+      it = default.each_key
+      args = user.each_with_object({}) { |value, obj| obj[it.next] = value }
+      hash_to_args default, [args]
+    end
+
+    def call_network(name, args)
+      url = '/' + name.to_s
+      @network.call(url, args)
+    end
+
+    ####################################################################
+    #                               gen                                #
+    ####################################################################
+
+    def skip_head(file)
+      until file.gets.chomp == '## API 列表'; end
+    end
+
+    def skip_to_next_api(file)
+      while (line = file.gets)
+        return nil if line =~ /^## /
+        return line.gsub(%r{^### `\/(.+)`.*$}, '\1').chomp if line =~ /^### /
+      end
+    end
+
+    def skip_to_args(file)
+      until file.gets.chomp == '#### 参数'; end
+      file.gets
+      file.gets.chomp
+    end
+
+    def skip_to_table_head(file)
+      until file.gets =~ /^\|\s*-+\s*\|\s*-+\s*\|\s*-+\s*\|\s*-+\s*\|$/; end
+    end
+
+    def non_arg_check(name, line)
+      return unless line == '无'
+      @func_list[name.to_sym] = {}
+      true
+    end
+
+    def get_default(str)
+      str.sub!(/^`(.+)`$/, '\1')
+      return str.to_i if str =~ /^[+-]?\d+$/
+      return true if str == 'true'
+      return false if str == 'false'
+      m = str.match(/^\s*(\d+)\s*\*\s*(\d+)\s*/)
+      return m[1].to_i * m[2].to_i if m
+      str
+    end
+
+    def get_args(file)
+      args = {}
+      until (line = file.gets) =~ /^$/
+        m = line.match(/^\|\s*`(\w+)`\s*\|\s+.+?\s+\|\s+(.+?)\s+\|/)
+        args[m[1].to_sym] = case m[2]
+                            when '空' then ''
+                            when '-' then nil
+                            else get_default m[2]
+                            end
+      end
+      args
+    end
+
+    def add_to_func_list(name, file)
+      return if non_arg_check(name, skip_to_args(file))
+      skip_to_table_head file
+      @func_list[name.to_sym] = get_args file
+    end
+
+    def gen
+      File.open File.join(File.dirname(__FILE__), 'API.md') do |f|
+        skip_head f
+
+        loop do
+          name = skip_to_next_api f
+          return @func_list unless name
+          add_to_func_list name, f
+        end
+      end
+    end
+  end
+end

data/lib/CQHTTP/network.rb

@@ -0,0 +1,79 @@
+module CQHTTP
+  # get, post
+  #
+  # Example:
+  #   get = Network.gen :get, 'http://localhost:5700'
+  #   json = get.call '/get_login_info'
+  module Network
+    # gen lambda
+    #
+    # type: Symbol or String, 'get', 'form' or 'json;
+    # host: String: API address, like 'http://localhost:5700'
+    def self.gen(type, host) # => lambda
+      case type.to_sym
+      when :get then ->(url, param = nil) { Network.get URI(host + url), param }
+      when :form then ->(url, body) { Network.post_form URI(host + url), body }
+      when :json then ->(url, body) { Network.post_json URI(host + url), body }
+      else raise type
+      end
+    end
+
+    # get url
+    #
+    # uri: URI
+    # params (optional): Hash, url query
+    def self.get(uri, params = nil) # => Hash
+      puts 'GET URL:', uri if $DEBUG
+      uri.query = URI.encode_www_form params if params
+      error Net::HTTP.get_response(uri)
+    end
+
+    # post to url by form
+    #
+    # uri: URI
+    # body: Hash, post body
+    def self.post_form(uri, body) # => Hash
+      puts 'POST URL:', uri if $DEBUG
+      error Net::HTTP.post_form(uri, body)
+    end
+
+    # post to url by json
+    #
+    # uri: URI
+    # body: Hash, post body
+    def self.post_json(uri, body)
+      puts 'POST URL:', uri if $DEBUG
+      error Net::HTTP.post(
+        uri,
+        body.to_json,
+        'Content-Type' => 'application/json'
+      )
+    end
+
+    private_class_method
+
+    def self.error(res)
+      coolq_error http_error res
+    end
+
+    def self.http_error(res)
+      case res.code.to_i
+      when 200 then return JSON.parse res.body
+      when 405 then raise '请求方式不支持'
+      when 401 then raise 'token 不符合'
+      when 400 then raise 'POST 请求的 Content-Type 不正确'
+      when 404 then raise 'API 不存在'
+      end
+      raise res.code.to_s
+    end
+
+    def self.coolq_error(json)
+      case json['retcode'].to_i
+      when 0 then return json
+      when 100 then raise '参数错误'
+      when 102 then raise '没有权限'
+      end
+      raise json['retcode'].to_s
+    end
+  end
+end

data/lib/CQHTTP/qq.rb

@@ -0,0 +1,45 @@
+#
+class QQ
+  include QQAPI
+  attr_reader :json
+
+  def initialize(hostname: '0.0.0.0', port: 9455)
+    @server = TCPServer.new(hostname, port)
+    @event_method = []
+  end
+
+  def bind(func)
+    @event_method << func
+  end
+
+  def run
+    loop do
+      socket = @server.accept
+
+      head socket
+
+      socket.print "HTTP/1.1 204\r\nContent-Type: application/json\r\n\r\n"
+      data = socket.gets
+      @json = JSON.parse data
+
+      @event_method.each { |func| func.call self }
+
+      socket.close
+    end
+  end
+
+  private
+
+  def head(socket)
+    puts 'head'
+    while (line = socket.gets) != "\r\n"
+      put line
+    end
+    puts 'end'
+  end
+
+  def put(text)
+    print '  '
+    puts text
+  end
+end

data/lib/CQHTTP/version.rb

@@ -0,0 +1,3 @@
+module CQHTTP
+  VERSION = "0.1.1"
+end

data/lib/CQHTTP.rb

@@ -0,0 +1,8 @@
+require 'CQHTTP/version'
+
+require 'CQHTTP/api.rb'
+require 'CQHTTP/network.rb'
+
+require 'uri'
+require 'net/http'
+require 'json'

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification
+name: CQHTTP
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- 71e6fd52
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-09-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: 
+email:
+- DAStudio.71e6fd52@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- CQHTTP.gemspec
+- Gemfile
+- README.en.md
+- README.md
+- Rakefile
+- bin/console
+- bin/gen_api_list
+- bin/setup
+- lib/CQHTTP.rb
+- lib/CQHTTP/API.md
+- lib/CQHTTP/api.rb
+- lib/CQHTTP/network.rb
+- lib/CQHTTP/qq.rb
+- lib/CQHTTP/version.rb
+homepage: https://github.com/71e6fd52/cqhttp-ruby
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.13
+signing_key: 
+specification_version: 4
+summary: CoolQ HTTP API ruby bind
+test_files: []