wechat 0.15.0 → 0.16.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fce405bc512324a4f862cab6f746833ec387b6a5eed1fc9f720a9bda16e309da
-  data.tar.gz: 932fba467df6c8f357e713bd63e6a5537436fe8e34fc1a9c50f0c9d5010a6707
+  metadata.gz: 21cc679665961f23e1a3f1ed4c061fc03f83adbc769e8902051218a36117891f
+  data.tar.gz: 4aa87ae135591958906787ba284d142a834cad1eca2cbd5106455864c82cd051
 SHA512:
-  metadata.gz: 6a2f9892ae32dd7c86f9e4f80d026cef254f738dbb93cab3d8ae3a411307144eb767077e0b781652d2fcc768d2a51cb504e3134bc0c4e0efc4b30066b78152ce
-  data.tar.gz: 2fba8e299e8cb2614852d587bd84287463a57ae91248dcc8d729ee0539038160ff2ec3f469c4ffad9e3906ae87c2b12020bc6c47501b12127593202da2483322
+  metadata.gz: 37da06392ad0595dc8ecfe971667c6c7fdeaa26e81e6d6affc128443dbf5a4865fe996fbde4f68e2991eb391caf1fbacd33d49acc84bb4a6e74a3115b68b7d8d
+  data.tar.gz: 0a0adf9373431db6d4da5e00191883ca3df035defcf82717e5e4ee648107fa4b39b07f959729036bdc4400c07080b8b5955cb968021611bf418394db8bc2370b

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## v0.16.1 (released at 2022-07-20)
+
+* Add api urllink.generate support. by @iuhoay #313
+* Fix WARNING: Zeitwerk defines the constant ActionController after the directory
+
+## v0.16.0 (released at 2022-06-06)
+
+* Support wechat draft. #305
+* Add environment variable for configuring http proxy to ignore IP address changes everytime after app deployment, by @Awlter #312
+* Soft drop support for Ruby 2.6, because EOL time 12 Apr 2022.
+
+## v0.15.1 (released at 2022-02-16)
+
+* fix "Psych::BadAlias (Unknown alias: default)" in ruby 3.1.0 #309, reported by @otorain
+
 ## v0.15.0 (released at 2021-12-21)
 
 * Add wechat message json format support, by @younthu #306

data/README-CN.md

@@ -7,11 +7,11 @@ WeChat Gem 帮助开发者方便地在 Rails 环境中集成[微信公众平台]
 
 - 微信公众平台/企业微信[发送消息](http://qydev.weixin.qq.com/wiki/index.php?title=%E5%8F%91%E9%80%81%E6%B6%88%E6%81%AF) API（命令行和 Web 环境都可以使用）
 - [接收消息](http://qydev.weixin.qq.com/wiki/index.php?title=%E6%8E%A5%E6%94%B6%E6%B6%88%E6%81%AF%E4%B8%8E%E4%BA%8B%E4%BB%B6)（必须运行 Web 服务器）
-- [微信JS-SDK](http://qydev.weixin.qq.com/wiki/index.php?title=%E5%BE%AE%E4%BF%A1JS%E6%8E%A5%E5%8F%A3) config 接口注入权限验证
+- [微信 JS-SDK](http://qydev.weixin.qq.com/wiki/index.php?title=%E5%BE%AE%E4%BF%A1JS%E6%8E%A5%E5%8F%A3) config 接口注入权限验证
 - OAuth 2.0 认证机制
 - 接收消息会话 ( Session ) 记录机制（可选）
 
-命令行工具 `wechat` 可以调用各种无需 Web 环境的 API，同时也提供了 Rails Controller 的 Responder DSL 。可以帮助开发者方便地在Rails 应用中集成微信的消息处理，包括主动推送的和被动响应的消息。
+命令行工具 `wechat` 可以调用各种无需 Web 环境的 API，同时也提供了 Rails Controller 的 Responder DSL 。可以帮助开发者方便地在 Rails 应用中集成微信的消息处理，包括主动推送的和被动响应的消息。
 
 如果您的 App 还需要集成微信 OAuth2.0 除了简便的 `wechat_oauth2` 指令，也可以考虑 [omniauth-wechat-oauth2](https://github.com/skinnyworm/omniauth-wechat-oauth2) 以便和 [devise](https://github.com/heartcombo/devise) 集成提供完整的用户认证。
 
@@ -28,7 +28,7 @@ WeChat Gem 帮助开发者方便地在 Rails 环境中集成[微信公众平台]
 ```
 gem install "wechat"
 # 如果使用 Ruby 版本小于 2.6
-# gem install wechat -v 0.12.2
+# gem install wechat -v 0.12.4
 ```
 
 或者添加下面这行到 `Gemfile`:
@@ -36,16 +36,16 @@ gem install "wechat"
 ```
 gem 'wechat'
 # 如果使用 Rails 版本小于 6
-# gem 'wechat', '~> 0.12.2'
+# gem 'wechat', '~> 0.12.4'
 ```
 
-运行下面这行代码来安装:
+运行下面这行代码来安装：
 
 ```console
 bundle install
 ```
 
-运行下面这行代码来生成必要文件:
+运行下面这行代码来生成必要文件：
 
 ```console
 rails generate wechat:install
@@ -53,7 +53,7 @@ rails generate wechat:install
 
 运行 `rails g wechat:install` 后会自动生成 wechat.yml 配置，还有 wechats_controller 及相关路由配置到当前 Rails 项目。
 
-启用 Session 会话记录:
+启用 Session 会话记录：
 
 ```console
 rails g wechat:session
@@ -70,7 +70,7 @@ rails g wechat:redis_store
 
 Redis 存贮相比默认的文件存贮，可以允许 Rails 应用运行在多台服务器中。如果只有一台服务器，仍然推荐使用默认的文件存贮，另外命令行不会读取 Redis 存贮的 Token 或者 Ticket。
 
-启用数据库配置微信账户:
+启用数据库配置微信账户：
 
 ```console
 rails g wechat:config
@@ -196,7 +196,7 @@ test:
  #  secret: "my_secret"
 ```
 
-支持微信公众平台 / 企业微信多账号的注意点 ( 例如: 增加账号 `wx2` ):
+支持微信公众平台 / 企业微信多账号的注意点 ( 例如：增加账号 `wx2` ):
 
 * 配置文件可增加多个微信公众平台 ( 企业微信 ) 配置，用法类似 Rails 中 `config/database.yml` 多数据库配置的处理。 `development`,  `test`,  `production` 是默认账号的配置段，要想增加账号 `wx2`，你需要增加配置段 `wx2_development`,  `wx2_test`,  `wx2_production`。
 
@@ -219,7 +219,7 @@ test:
 environment | 字串 | 必填。配置对应的运行环境，一般有：`production`、`development`、`test`。比如  `production`  配置仅在生产环境有效。默认为  `development`。 
 account | 字串 | 必填。自定义的微信账户名称。同一  `environment`  下，账户名称不允许重复。 
 enabled | 布尔 | 必填。配置是否生效。默认  `true`。 
-appid | 字串 | 公众号 id , 此字段和  `corpid`  两者必填其一。 
+appid | 字串 | 公众号 id ，此字段和  `corpid`  两者必填其一。 
 secret | 字串 | 公众号相关配置。当公众号  `appid`  存在时必填。 
 corpid | 字串 | 企业号 id。此字段和 `appid` 两者必填其一。
 corpsecret | 字串 | 企业号相关配置。当企业号 `corpid` 存在时必填。
@@ -229,7 +229,7 @@ encoding_aes_key | 字串 | 当 `encrypt_mode` 为 `true` 时必填。
 token | 字串 | 必填。
 access_token | 字串 | 必填。存储 `access token` 文件的路径。
 jsapi_ticket | 字串 | 必填。存储 `jsapi ticket` 文件的路径。
-skip_verify_ssl | 布尔|
+skip_verify_ssl | 布尔 |
 timeout | 整数 | 默认值是 20。
 trusted_domain_fullname | 字串 |
 
@@ -237,7 +237,7 @@ trusted_domain_fullname | 字串 |
 
 ##### 配置优先级
 
-注意在Rails项目根目录下运行 `wechat` 命令行工具会优先使用 `config/wechat.yml `中的 `default`配置，如果失败则使用 `~\.wechat.yml` 中的配置，以便于在生产环境下管理多个微信账号应用。
+注意在 Rails 项目根目录下运行 `wechat` 命令行工具会优先使用 `config/wechat.yml `中的 `default`配置，如果失败则使用 `~\.wechat.yml` 中的配置，以便于在生产环境下管理多个微信账号应用。
 
 如果启用数据库账户配置，数据库中的账户信息在读入  `wechat.yml`  或环境变量之后被载入。当存在同名账户时，数据库中的配置会覆盖前两者。
 
@@ -245,9 +245,9 @@ trusted_domain_fullname | 字串 |
 
 微信服务器有时请求会花很长时间，如果不配置默认为 20 秒，可视情况配置。
 
-##### 配置跳过SSL认证
+##### 配置跳过 SSL 认证
 
-Wechat 服务器有报道曾出现 [RestClient::SSLCertificateNotVerified](http://qydev.weixin.qq.com/qa/index.php?qa=11037) 错误，此时可以选择关闭SSL验证。`skip_verify_ssl: true`
+Wechat 服务器有报道曾出现 [RestClient::SSLCertificateNotVerified](http://qydev.weixin.qq.com/qa/index.php?qa=11037) 错误，此时可以选择关闭 SSL 验证。`skip_verify_ssl: true`
 
 #### 为每个 Responder 配置不同的 appid 和 secret
 
@@ -292,7 +292,7 @@ end
 </body>
 ```
 
-在开发模式下，由于程序往往通过微信调试工具的服务器端调试工具反向代理被访问，此时需要配置 `trusted_domain_fullname` 以便wechat gem 可以使用正确的域名做 JS-SDK 的权限签名。
+在开发模式下，由于程序往往通过微信调试工具的服务器端调试工具反向代理被访问，此时需要配置 `trusted_domain_fullname` 以便 wechat gem 可以使用正确的域名做 JS-SDK 的权限签名。
 
 #### OAuth2.0 验证接口支持
 
@@ -333,13 +333,13 @@ end
 
 `wechat_oauth2 `封装了 OAuth2.0 验证接口和 Cookies 处理逻辑，用户仅需提供业务代码块即可。userid 指的是微信企业成员 userid，openid 是关注该公众号的用户 openid。
 
-注意:
-* 如果使用 `wechat_responder`, 请不要在 Controller 里定义 `show` 和 `create` 方法, 否则会报错。
-* 如果遇到“ redirect_uri 参数错误”的错误信息，请登录服务号管理后台，查看“开发者中心/网页服务/网页授权获取用户基本信息”的授权回调页面域名已正确配置。
+注意：
+* 如果使用 `wechat_responder`，请不要在 Controller 里定义 `show` 和 `create` 方法，否则会报错。
+* 如果遇到 “ redirect_uri 参数错误” 的错误信息，请登录服务号管理后台，查看 “开发者中心/网页服务/网页授权获取用户基本信息” 的授权回调页面域名已正确配置。
 
 ## 关于接口权限
 
-Wechat Gem 内部不会检查权限, 但因公众号类型不同和微信服务器端通讯时，可能会被拒绝详细权限控制可参考[官方文档](https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1433401084)。
+Wechat Gem 内部不会检查权限，但因公众号类型不同和微信服务器端通讯时，可能会被拒绝详细权限控制可参考[官方文档](https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1433401084)。
 
 ## 使用命令行
 
@@ -387,7 +387,7 @@ Wechat Public Account commands:
   wechat qrcode_create_limit_scene [SCENE_ID_OR_STR]            # 请求永久二维码
   wechat qrcode_create_scene [SCENE_ID_OR_STR, EXPIRE_SECONDS]  # 请求临时二维码
   wechat qrcode_download [TICKET, QR_CODE_PIC_PATH]             # 通过 ticket 下载二维码
-  wechat queryrecoresultfortext [VOICE_ID]                      # AI开放接口-获取语音识别结果
+  wechat queryrecoresultfortext [VOICE_ID]                      # AI 开放接口 - 获取语音识别结果
   wechat shorturl [LONG_URL]                                    # 长链接转短链接
   wechat tag [TAGID]                                            # 获取标签下粉丝列表
   wechat tag_add_user [TAG_ID, OPEN_IDS]                        # 批量为用户打标签
@@ -397,7 +397,7 @@ Wechat Public Account commands:
   wechat tag_update [TAG_ID, TAGNAME]                           # 更新标签名字
   wechat tags                                                   # 获取所有标签
   wechat template_message [OPENID, TEMPLATE_YAML_PATH]          # 模板消息接口
-  wechat translatecontent [CONTENT]                             # AI开放接口-微信翻译
+  wechat translatecontent [CONTENT]                             # AI 开放接口 - 微信翻译
   wechat user [OPEN_ID]                                         # 获取用户基本信息
   wechat user_batchget [OPEN_ID_LIST]                           # 批量获取用户基本信息
   wechat user_change_group [OPEN_ID, TO_GROUP_ID]               # 移动用户分组
@@ -451,7 +451,7 @@ Wechat Enterprise Account commands:
   wechat menu_delete                                       # 删除菜单
   wechat menu_trymatch [USER_ID]                           # 测试个性化菜单匹配结果
   wechat message_send [OPENID, TEXT_MESSAGE]               # 发送文字消息
-  wechat qrcode_download [TICKET, QR_CODE_PIC_PATH]        # 通过ticket下载二维码
+  wechat qrcode_download [TICKET, QR_CODE_PIC_PATH]        # 通过 ticket 下载二维码
   wechat tag [TAG_ID]                                      # 获取标签成员
   wechat tag_add_department [TAG_ID, PARTY_IDS]            # 增加标签部门
   wechat tag_add_user [TAG_ID, USER_IDS]                   # 增加标签成员
@@ -587,7 +587,7 @@ template:
       value: "您好，您已报名成功"
       color: "#0A0A0A"
     keynote1:
-      value: "XX活动"
+      value: "XX 活动"
       color: "#CCCCCC"
     keynote2:
       value: "2014 年 9 月 16 日"
@@ -668,14 +668,14 @@ class WechatsController < ActionController::Base
     request.reply.text "echo: #{content}" #Just echo
   end
 
-  # 当请求的文字信息内容为 'help' 时, 使用这个 responder 处理
+  # 当请求的文字信息内容为 'help' 时，使用这个 responder 处理
   on :text, with: 'help' do |request|
     request.reply.text 'help content' #回复帮助信息
   end
 
-  # 当请求的文字信息内容为'<n>条新闻'时, 使用这个responder处理, 并将n作为第二个参数
-  on :text, with: /^(\d+)条新闻$/ do |request, count|
-    # 微信最多显示8条新闻，大于8条将只取前8条
+  # 当请求的文字信息内容为'<n>条新闻'时，使用这个 responder 处理，并将 n 作为第二个参数
+  on :text, with: /^(\d+) 条新闻$/ do |request, count|
+    # 微信最多显示 8 条新闻，大于 8 条将只取前 8 条
     news = (1..count.to_i).each_with_object([]) { |n, memo| memo << { title: '新闻标题', content: "第#{n}条新闻的内容#{n.hash}" } }
     request.reply.news(news) do |article, n, index| # 回复"articles"
       article.item title: "#{index} #{n[:title]}", description: n[:content], pic_url: 'http://www.baidu.com/img/bdlogo.gif', url: 'http://www.baidu.com/'
@@ -737,7 +737,7 @@ class WechatsController < ActionController::Base
     # request.reply.voice(request[:MediaId])
 
     voice_id = request[:MediaId]
-    # 开通语音识别后，用户每次发送语音给服务号时，微信会在推送的语音消息XML数据包中，增加一个 Recognition 字段
+    # 开通语音识别后，用户每次发送语音给服务号时，微信会在推送的语音消息 XML 数据包中，增加一个 Recognition 字段
     recognition = request[:Recognition]
     request.reply.text "#{voice_id} #{recognition}"
   end
@@ -806,12 +806,12 @@ class WechatsController < ActionController::Base
     request.reply.success # request is XML result hash.
   end
 
-  # 当无任何 responder 处理用户信息时,使用这个 responder 处理
+  # 当无任何 responder 处理用户信息时，使用这个 responder 处理
   on :fallback, respond: 'fallback message'
 end
 ```
 
-在 controller 中使用 `wechat_responder` 引入 Responder DSL, 之后可以用
+在 controller 中使用 `wechat_responder` 引入 Responder DSL，之后可以用
 
 ```
 on <message_type> do |message|
@@ -823,26 +823,26 @@ end
 
 目前支持的 message_type 有如下几种
 
-- :text 响应文字消息,可以用 `:with` 参数来匹配文本内容  `on(:text, with:'help'){|message, content| ...}`
+- :text 响应文字消息，可以用 `:with` 参数来匹配文本内容  `on(:text, with:'help'){|message, content| ...}`
 - :image 响应图片消息
 - :voice 响应语音消息
 - :shortvideo 响应短视频消息
 - :video 响应视频消息
 - :label_location 响应地理位置消息
 - :link 响应链接消息
-- :event 响应事件消息, 可以用 `:with` 参数来匹配事件类型，同文字消息类似，支持正则表达式匹配
-- :click 虚拟响应事件消息, 微信传入:event，但 gem 内部会单独处理
-- :view 虚拟响应事件消息, 微信传入:event，但 gem 内部会单独处理
+- :event 响应事件消息，可以用 `:with` 参数来匹配事件类型，同文字消息类似，支持正则表达式匹配
+- :click 虚拟响应事件消息，微信传入:event，但 gem 内部会单独处理
+- :view 虚拟响应事件消息，微信传入:event，但 gem 内部会单独处理
 - :scan  虚拟响应事件消息
 - :batch_job  虚拟响应事件消息
 - :location 虚拟响应上报地理位置事件消息
-- :fallback 默认响应，当收到的消息无法被其他responder响应时，会使用这个responder.
+- :fallback 默认响应，当收到的消息无法被其他 responder 响应时，会使用这个 responder.
 
 ### 多客服消息转发
 
 ```ruby
 class WechatsController < ActionController::Base
-  # 当无任何responder处理用户信息时，转发至客服处理。
+  # 当无任何 responder 处理用户信息时，转发至客服处理。
   on :fallback do |message|
     message.reply.transfer_customer_service
   end

data/README.md

@@ -35,7 +35,7 @@ Use `gem install`
 ```
 gem install "wechat"
 # If your ruby version < 2.6
-# gem install wechat -v 0.12.2
+# gem install wechat -v 0.12.4
 ```
 
 Or add it to your app's `Gemfile`:
@@ -43,7 +43,7 @@ Or add it to your app's `Gemfile`:
 ```
 gem 'wechat'
 # If your rails version < 6.0
-# gem 'wechat', '~> 0.12.2'
+# gem 'wechat', '~> 0.12.4'
 ```
 
 Run the following command to install it:
@@ -381,8 +381,8 @@ Feel safe if you can not read Chinese in the comments, it's kept there in order
 ```
 $ wechat
 Wechat Public Account commands:
-  wechat addvoicetorecofortext [VOICE_ID]                       # AI开放接口-提交语音
-  wechat callbackip                                             # 获取微信服务器IP地址
+  wechat addvoicetorecofortext [VOICE_ID]                       # AI 开放接口 - 提交语音
+  wechat callbackip                                             # 获取微信服务器 IP 地址
   wechat clear_quota                                            # 接口调用次数清零
   wechat custom_image [OPENID, IMAGE_PATH]                      # 发送图片客服消息
   wechat custom_music [OPENID, THUMBNAIL_PATH, MUSIC_URL]       # 发送音乐客服消息
@@ -417,8 +417,8 @@ Wechat Public Account commands:
   wechat message_mass_preview [WX_NAME, MPNEWS_MEDIA_ID]        # 预览图文消息素材
   wechat qrcode_create_limit_scene [SCENE_ID_OR_STR]            # 请求永久二维码
   wechat qrcode_create_scene [SCENE_ID_OR_STR, EXPIRE_SECONDS]  # 请求临时二维码
-  wechat qrcode_download [TICKET, QR_CODE_PIC_PATH]             # 通过ticket下载二维码
-  wechat queryrecoresultfortext [VOICE_ID]                      # AI开放接口-获取语音识别结果
+  wechat qrcode_download [TICKET, QR_CODE_PIC_PATH]             # 通过 ticket 下载二维码
+  wechat queryrecoresultfortext [VOICE_ID]                      # AI 开放接口 - 获取语音识别结果
   wechat shorturl [LONG_URL]                                    # 长链接转短链接
   wechat tag [TAGID]                                            # 获取标签下粉丝列表
   wechat tag_add_user [TAG_ID, OPEN_IDS]                        # 批量为用户打标签
@@ -428,7 +428,7 @@ Wechat Public Account commands:
   wechat tag_update [TAG_ID, TAGNAME]                           # 更新标签名字
   wechat tags                                                   # 获取所有标签
   wechat template_message [OPENID, TEMPLATE_YAML_PATH]          # 模板消息接口
-  wechat translatecontent [CONTENT]                             # AI开放接口-微信翻译
+  wechat translatecontent [CONTENT]                             # AI 开放接口 - 微信翻译
   wechat user [OPEN_ID]                                         # 获取用户基本信息
   wechat user_batchget [OPEN_ID_LIST]                           # 批量获取用户基本信息
   wechat user_change_group [OPEN_ID, TO_GROUP_ID]               # 移动用户分组
@@ -450,10 +450,10 @@ Wechat Enterprise Account commands:
   wechat batch_replaceparty [BATCH_PARTY_CSV_MEDIA_ID]     # 全量覆盖部门
   wechat batch_replaceuser [BATCH_USER_CSV_MEDIA_ID]       # 全量覆盖成员
   wechat batch_syncuser [SYNC_USER_CSV_MEDIA_ID]           # 增量更新成员
-  wechat callbackip                                        # 获取微信服务器IP地址
+  wechat callbackip                                        # 获取微信服务器 IP 地址
   wechat clear_quota                                       # 接口调用次数清零
-  wechat convert_to_openid [USER_ID]                       # userid转换成openid
-  wechat convert_to_userid [OPENID]                        # openid转换成userid
+  wechat convert_to_openid [USER_ID]                       # userid 转换成 openid
+  wechat convert_to_userid [OPENID]                        # openid 转换成 userid
   wechat custom_image [OPENID, IMAGE_PATH]                 # 发送图片客服消息
   wechat custom_music [OPENID, THUMBNAIL_PATH, MUSIC_URL]  # 发送音乐客服消息
   wechat custom_news [OPENID, NEWS_YAML_PATH]              # 发送图文客服消息
@@ -483,7 +483,7 @@ Wechat Enterprise Account commands:
   wechat menu_delete                                       # 删除菜单
   wechat menu_trymatch [USER_ID]                           # 测试个性化菜单匹配结果
   wechat message_send [OPENID, TEXT_MESSAGE]               # 发送文字消息
-  wechat qrcode_download [TICKET, QR_CODE_PIC_PATH]        # 通过ticket下载二维码
+  wechat qrcode_download [TICKET, QR_CODE_PIC_PATH]        # 通过 ticket 下载二维码
   wechat tag [TAG_ID]                                      # 获取标签成员
   wechat tag_add_department [TAG_ID, PARTY_IDS]            # 增加标签部门
   wechat tag_add_user [TAG_ID, USER_IDS]                   # 增加标签成员
@@ -592,7 +592,7 @@ Sending custom_news should also be defined as a yaml file, like `articles.yml`
 articles:
  -
   title: "习近平在布鲁日欧洲学院演讲"
-  description: "新华网比利时布鲁日4月1日电 国家主席习近平1日在比利时布鲁日欧洲学院发表重要演讲"
+  description: "新华网比利时布鲁日 4 月 1 日电 国家主席习近平 1 日在比利时布鲁日欧洲学院发表重要演讲"
   url: "http://news.sina.com.cn/c/2014-04-01/232629843387.shtml"
   pic_url: "http://i3.sinaimg.cn/dy/c/2014-04-01/1396366518_bYays1.jpg"
 ```

data/bin/wechat

@@ -50,8 +50,8 @@ class App < Thor
     end
 
     desc 'department_update [DEPARTMENT_ID, NAME]', '更新部门'
-    method_option :parentid, aliases: '-p', desc: '父亲部门id。根部门id为1', default: nil
-    method_option :order, aliases: '-o', desc: '在父部门中的次序值。order值小的排序靠前。', default: nil
+    method_option :parentid, aliases: '-p', desc: '父亲部门id。根部门id为1', default: nil, check_default_type: false
+    method_option :order, aliases: '-o', desc: '在父部门中的次序值。order值小的排序靠前。', default: nil, check_default_type: false
     def department_update(departmentid, name)
       api_opts = options.slice(:parentid, :order)
       puts wechat_api.department_update(departmentid, name, api_opts[:parentid], api_opts[:order])
@@ -97,8 +97,8 @@ class App < Thor
     end
 
     desc 'user_simplelist [DEPARTMENT_ID]', '获取部门成员'
-    method_option :fetch_child, aliases: '-c', desc: '是否递归获取子部门下面的成员', default: 1
-    method_option :status, aliases: '-s', desc: '0 获取全部成员，1 获取已关注成员列表，2 获取禁用成员列表，4 获取未关注成员列表。status可叠加', default: 0
+    method_option :fetch_child, aliases: '-c', desc: '是否递归获取子部门下面的成员', default: 1, check_default_type: false
+    method_option :status, aliases: '-s', desc: '0 获取全部成员，1 获取已关注成员列表，2 获取禁用成员列表，4 获取未关注成员列表。status可叠加', default: 0, check_default_type: false
     def user_simplelist(departmentid = 1)
       api_opts = options.slice(:fetch_child, :status)
 
@@ -111,8 +111,8 @@ class App < Thor
     end
 
     desc 'user_list [DEPARTMENT_ID]', '获取部门成员详情'
-    method_option :fetch_child, aliases: '-c', desc: '是否递归获取子部门下面的成员', default: 0
-    method_option :status, aliases: '-s', desc: '0 获取全部成员，1 获取已关注成员列表，2 获取禁用成员列表，4 获取未关注成员列表。status可叠加', default: 0
+    method_option :fetch_child, aliases: '-c', desc: '是否递归获取子部门下面的成员', default: 0, check_default_type: false
+    method_option :status, aliases: '-s', desc: '0 获取全部成员，1 获取已关注成员列表，2 获取禁用成员列表，4 获取未关注成员列表。status可叠加', default: 0, check_default_type: false
     def user_list(departmentid = 1)
       api_opts = options.slice(:fetch_child, :status)
 
@@ -230,12 +230,53 @@ class App < Thor
       puts wechat_api.wxa_msg_sec_check(content)
     end
 
+    desc 'wxa_generate_urllink [PATH]', '获取小程序 URL Link'
+    def wxa_generate_urllink(path)
+      body_hash = { path: path, expire_type: 0 }
+      puts wechat_api.wxa_generate_urllink(body_hash)
+    end
+
     desc 'media_uploadnews [MPNEWS_YAML_PATH]', '上传图文消息素材'
     def media_uploadnews(mpnews_yaml_path)
-      mpnew = YAML.load(File.read(mpnews_yaml_path))
+      mpnew = Wechat::ApiLoader.load_yaml(File.read(mpnews_yaml_path))
       puts wechat_api.media_uploadnews(Wechat::Message.new(MsgType: 'uploadnews').mpnews(mpnew[:articles]))
     end
 
+    desc 'draft_add [ARTICLE_YAML_PATH]', '新建草稿'
+    def draft_add(article_yaml_path)
+      yml_hash = Wechat::ApiLoader.load_yaml(File.read(article_yaml_path))
+      puts wechat_api.draft_add(Wechat::Message.new(MsgType: 'draft_news').draft_news(yml_hash[:articles]))
+    end
+
+    desc 'draft_get [MEDIA_ID]', '获取草稿'
+    def draft_get(media_id)
+      puts wechat_api.draft_get(media_id)
+    end
+
+    desc 'draft_delete [MEDIA_ID]', '删除草稿'
+    def draft_delete(media_id)
+      puts wechat_api.draft_delete(media_id)
+    end
+
+    desc 'draft_count', '获取草稿总数'
+    def draft_count
+      puts wechat_api.draft_count
+    end
+
+    desc 'draft_batchget [OFFSET, COUNT]', '获取草稿列表'
+    method_option :no_content, aliases: '-no_content', desc: '不要返回 content 字段', default: true, check_default_type: false
+    def draft_batchget(offset, count)
+      api_opts = options.slice(:no_content)
+      wechat_api.draft_batchget(offset, count, no_content: api_opts[:no_content])
+    end
+
+    desc 'draft_switch', '检查草稿箱和发布功能开关状态'
+    method_option :enable_draft, aliases: '-enable_draft', desc: '立刻开启草稿箱和发布功能', default: false, check_default_type: false
+    def draft_switch
+      api_opts = options.slice(:enable_draft)
+      puts wechat_api.draft_switch(checkonly: api_opts[:enable_draft] || false)
+    end
+
     desc 'message_mass_delete [MSG_ID]', '删除群发消息'
     def message_mass_delete(msg_id)
       puts wechat_api.message_mass_delete(msg_id)
@@ -349,13 +390,13 @@ class App < Thor
 
   desc 'menu_create [MENU_YAML_PATH]', '创建菜单'
   def menu_create(menu_yaml_path)
-    menu = YAML.load(File.read(menu_yaml_path))
+    menu = Wechat::ApiLoader.load_yaml(File.read(menu_yaml_path))
     puts 'Menu created' if wechat_api.menu_create(menu)
   end
 
   desc 'menu_addconditional [CONDITIONAL_MENU_YAML_PATH]', '创建个性化菜单'
   def menu_addconditional(conditional_menu_yaml_path)
-    conditional_menu = YAML.load(File.read(conditional_menu_yaml_path))
+    conditional_menu = Wechat::ApiLoader.load_yaml(File.read(conditional_menu_yaml_path))
     add_result = wechat_api.menu_addconditional(conditional_menu)
     puts "Conditional menu created: #{add_result}" if add_result
   end
@@ -408,7 +449,7 @@ class App < Thor
 
   desc 'material_add_news [MPNEWS_YAML_PATH]', '永久图文素材上传'
   def material_add_news(mpnews_yaml_path)
-    new = YAML.load(File.read(mpnews_yaml_path))
+    new = Wechat::ApiLoader.load_yaml(File.read(mpnews_yaml_path))
     puts wechat_api.material_add_news(Wechat::Message.new(MsgType: 'mpnews').mpnews(new['articles']))
   end
 
@@ -479,13 +520,13 @@ class App < Thor
 
   desc 'custom_news [OPENID, NEWS_YAML_PATH]', '发送图文客服消息'
   def custom_news(openid, news_yaml_path)
-    articles = YAML.load(File.read(news_yaml_path))
+    articles = Wechat::ApiLoader.load_yaml(File.read(news_yaml_path))
     puts wechat_api.custom_message_send Wechat::Message.to(openid).news(articles['articles'])
   end
 
   desc 'template_message [OPENID, TEMPLATE_YAML_PATH]', '模板消息接口'
   def template_message(openid, template_yaml_path)
-    template = YAML.load(File.read(template_yaml_path))
+    template = Wechat::ApiLoader.load_yaml(File.read(template_yaml_path))
     puts wechat_api.template_message_send Wechat::Message.to(openid).template(template['template'])
   end
 
@@ -556,6 +597,10 @@ class App < Thor
   def clear_quota
     puts wechat_api.clear_quota
   end
+
+  def self.exit_on_failure?
+    true
+  end
 end
 
 App.start

data/lib/action_controller/wechat_responder.rb

@@ -38,29 +38,36 @@ module ActionController
       self.trusted_domain_fullname = opts[:trusted_domain_fullname] || cfg.trusted_domain_fullname
       self.oauth2_cookie_duration = opts[:oauth2_cookie_duration] || cfg.oauth2_cookie_duration.to_i.seconds
       self.timeout = opts[:timeout] || cfg.timeout
-      self.qcloud_token_lifespan = opts[:qcloud_token_lifespan] || cfg.qcloud_token_lifespan
       self.skip_verify_ssl = opts.key?(:skip_verify_ssl) ? opts[:skip_verify_ssl] : cfg.skip_verify_ssl
 
+      proxy_url = opts.key?(:proxy_url) ? opts[:proxy_url] : cfg.proxy_url
+      proxy_port = opts.key?(:proxy_port) ? opts[:proxy_port] : cfg.proxy_port
+      proxy_username = opts.key?(:proxy_username) ? opts[:proxy_username] : cfg.proxy_username
+      proxy_password = opts.key?(:proxy_password) ? opts[:proxy_password] : cfg.proxy_password
+
       return Wechat.api if account == :default && opts.empty?
 
       access_token = opts[:access_token] || cfg.access_token
       jsapi_ticket = opts[:jsapi_ticket] || cfg.jsapi_ticket
       qcloud_env = opts[:qcloud_env] || cfg.qcloud_env
       qcloud_token = opts[:qcloud_token] || cfg.qcloud_token
+      qcloud_token_lifespan = opts[:qcloud_token_lifespan] || cfg.qcloud_token_lifespan
 
       api_type = opts[:type] || cfg.type
       secret = corpid.present? ? opts[:corpsecret] || cfg.corpsecret : opts[:secret] || cfg.secret
 
-      get_wechat_api(api_type, corpid, appid, secret, access_token, agentid, timeout, skip_verify_ssl, jsapi_ticket, qcloud_env, qcloud_token, qcloud_token_lifespan)
+      network_setting = Wechat::NetworkSetting.new(timeout, skip_verify_ssl, proxy_url, proxy_port, proxy_username, proxy_password)
+      qcloud_setting = Wechat::Qcloud::Setting.new(qcloud_env, qcloud_token, qcloud_token_lifespan)
+      get_wechat_api(api_type, corpid, appid, secret, access_token, agentid, network_setting, jsapi_ticket, qcloud_setting)
     end
 
-    def get_wechat_api(api_type, corpid, appid, secret, access_token, agentid, timeout, skip_verify_ssl, jsapi_ticket, qcloud_env, qcloud_token, qcloud_token_lifespan)
+    def get_wechat_api(api_type, corpid, appid, secret, access_token, agentid, network_setting, jsapi_ticket, qcloud_setting)
       if api_type && api_type.to_sym == :mp
-        Wechat::MpApi.new(appid, secret, access_token, timeout, skip_verify_ssl, jsapi_ticket, qcloud_env, qcloud_token, qcloud_token_lifespan)
+        Wechat::MpApi.new(appid, secret, access_token, network_setting, jsapi_ticket, qcloud_setting)
       elsif corpid.present?
-        Wechat::CorpApi.new(corpid, secret, access_token, agentid, timeout, skip_verify_ssl, jsapi_ticket)
+        Wechat::CorpApi.new(corpid, secret, access_token, agentid, network_setting, jsapi_ticket)
       else
-        Wechat::Api.new(appid, secret, access_token, timeout, skip_verify_ssl, jsapi_ticket)
+        Wechat::Api.new(appid, secret, access_token, network_setting, jsapi_ticket)
       end
     end
   end

data/lib/wechat/api.rb

@@ -2,15 +2,16 @@
 
 module Wechat
   class Api < ApiBase
-    def initialize(appid, secret, token_file, timeout, skip_verify_ssl, jsapi_ticket_file)
+    def initialize(appid, secret, token_file, network_setting, jsapi_ticket_file)
       super()
-      @client = HttpClient.new(Wechat::Api::API_BASE, timeout, skip_verify_ssl)
+      @client = HttpClient.new(Wechat::Api::API_BASE, network_setting)
       @access_token = Token::PublicAccessToken.new(@client, appid, secret, token_file)
       @jsapi_ticket = Ticket::PublicJsapiTicket.new(@client, @access_token, jsapi_ticket_file)
       @qcloud = nil
     end
 
     include Concern::Common
+    include Concern::Draft
 
     def template_message_send(message)
       post 'message/template/send', message.to_json, content_type: :json

data/lib/wechat/api_loader.rb

@@ -12,17 +12,19 @@ module Wechat
       js_token_file = options[:js_token_file] || c.jsapi_ticket.presence || '/var/tmp/wechat_jsapi_ticket'
       type = options[:type] || c.type
 
+      network_setting = Wechat::NetworkSetting.new(c.timeout, c.skip_verify_ssl, c.proxy_url, c.proxy_port, c.proxy_username, c.proxy_password)
       if c.appid && c.secret && token_file.present?
         if type == 'mp'
           qcloud_env = options[:qcloud_env] || c.qcloud_env
           qcloud_token_file = options[:qcloud_token_file] || c.qcloud_token_file.presence || '/var/tmp/qcloud_access_token'
           qcloud_token_lifespan = options[:qcloud_token_lifespan] || c.qcloud_token_lifespan
-          Wechat::MpApi.new(c.appid, c.secret, token_file, c.timeout, c.skip_verify_ssl, js_token_file, qcloud_env, qcloud_token_file, qcloud_token_lifespan)
+          qcloud_setting = Wechat::Qcloud::Setting.new(qcloud_env, qcloud_token_file, qcloud_token_lifespan)
+          Wechat::MpApi.new(c.appid, c.secret, token_file, network_setting, js_token_file, qcloud_setting)
         else
-          Wechat::Api.new(c.appid, c.secret, token_file, c.timeout, c.skip_verify_ssl, js_token_file)
+          Wechat::Api.new(c.appid, c.secret, token_file, network_setting, js_token_file)
         end
       elsif c.corpid && c.corpsecret && token_file.present?
-        Wechat::CorpApi.new(c.corpid, c.corpsecret, token_file, c.agentid, c.timeout, c.skip_verify_ssl, js_token_file)
+        Wechat::CorpApi.new(c.corpid, c.corpsecret, token_file, c.agentid, network_setting, js_token_file)
       else
         raise 'Need create ~/.wechat.yml with wechat appid and secret or running at rails root folder so wechat can read config/wechat.yml'
       end
@@ -40,15 +42,27 @@ module Wechat
       @configs = loading_config!
     end
 
+    def self.load_yaml(result)
+      YAML.respond_to?(:unsafe_load) ? YAML.unsafe_load(result) : YAML.safe_load(result)
+    end
+
     private_class_method def self.loading_config!
       configs = config_from_file || config_from_environment
       configs.merge!(config_from_db)
 
-      configs.transform_keys! { |key| key.to_sym rescue key }
+      configs.transform_keys! do |key|
+        key.to_sym
+      rescue StandardError
+        key
+      end
       configs.each do |key, cfg|
         raise "wrong wechat configuration format for #{key}" unless cfg.is_a?(Hash)
 
-        cfg.transform_keys! { |key| key.to_sym rescue key }
+        cfg.transform_keys! do |sub_key|
+          sub_key.to_sym
+        rescue StandardError
+          sub_key
+        end
       end
 
       if defined?(::Rails)
@@ -77,28 +91,28 @@ module Wechat
     private_class_method def self.config_from_db
       return {} unless class_exists?('WechatConfig')
 
-      environment = defined?(::Rails) ? Rails.env.to_s : ENV['RAILS_ENV'] || 'development'
+      environment = defined?(::Rails) ? Rails.env.to_s : ENV.fetch('RAILS_ENV', 'development')
       WechatConfig.get_all_configs(environment)
     end
 
     private_class_method def self.config_from_file
       if defined?(::Rails)
-        config_file = ENV['WECHAT_CONF_FILE'] || Rails.root.join('config', 'wechat.yml')
+        config_file = ENV.fetch('WECHAT_CONF_FILE') { Rails.root.join('config', 'wechat.yml') }
         resolve_config_file(config_file, Rails.env.to_s)
       else
         require 'erb'
-        rails_config_file = ENV['WECHAT_CONF_FILE'] || File.join(Dir.getwd, 'config', 'wechat.yml')
+        rails_config_file = ENV.fetch('WECHAT_CONF_FILE') { File.join(Dir.getwd, 'config', 'wechat.yml') }
         application_config_file = File.join(Dir.getwd, 'config', 'application.yml')
         home_config_file = File.join(Dir.home, '.wechat.yml')
         if File.exist?(rails_config_file)
-          rails_env = ENV['RAILS_ENV'] || 'development'
+          rails_env = ENV.fetch('RAILS_ENV', 'development')
           if File.exist?(application_config_file) && !defined?(::Figaro)
             require 'figaro'
             Figaro::Application.new(path: application_config_file, environment: rails_env).load
           end
           config = resolve_config_file(rails_config_file, rails_env)
           if config.present? && (default = config[:default]) && (default['appid'] || default['corpid'])
-            puts "Using rails project #{ENV['WECHAT_CONF_FILE'] || 'config/wechat.yml'} #{rails_env} setting..."
+            puts "Using rails project #{ENV.fetch('WECHAT_CONF_FILE', 'config/wechat.yml')} #{rails_env} setting..."
             return config
           end
         end
@@ -110,9 +124,7 @@ module Wechat
       return unless File.exist?(config_file)
 
       begin
-        # rubocop:disable Security/YAMLLoad
-        raw_data = YAML.load(ERB.new(File.read(config_file)).result)
-        # rubocop:enable Security/YAMLLoad
+        raw_data = load_yaml(ERB.new(File.read(config_file)).result)
       rescue NameError
         puts "WARNING: If using 'Rails.application.credentials.wechat_secret!' in wechat.yml, you need run in 'rails c' and access via 'Wechat.api' or gem 'figaro' instead."
       end
@@ -135,22 +147,26 @@ module Wechat
     end
 
     private_class_method def self.config_from_environment
-      value = { appid: ENV['WECHAT_APPID'],
-                secret: ENV['WECHAT_SECRET'],
-                corpid: ENV['WECHAT_CORPID'],
-                corpsecret: ENV['WECHAT_CORPSECRET'],
-                agentid: ENV['WECHAT_AGENTID'],
-                token: ENV['WECHAT_TOKEN'],
-                access_token: ENV['WECHAT_ACCESS_TOKEN'],
-                encrypt_mode: ENV['WECHAT_ENCRYPT_MODE'],
-                timeout: ENV['WECHAT_TIMEOUT'],
-                skip_verify_ssl: ENV['WECHAT_SKIP_VERIFY_SSL'],
-                encoding_aes_key: ENV['WECHAT_ENCODING_AES_KEY'],
-                jsapi_ticket: ENV['WECHAT_JSAPI_TICKET'],
-                qcloud_env: ENV['WECHAT_QCLOUD_ENV'],
-                qcloud_token_file: ENV['WECHAT_QCLOUD_TOKEN'],
-                qcloud_token_lifespan: ENV['WECHAT_QCLOUD_TOKEN_LIFESPAN'],
-                trusted_domain_fullname: ENV['WECHAT_TRUSTED_DOMAIN_FULLNAME'] }
+      value = { appid: ENV.fetch('WECHAT_APPID', nil),
+                secret: ENV.fetch('WECHAT_SECRET', nil),
+                corpid: ENV.fetch('WECHAT_CORPID', nil),
+                corpsecret: ENV.fetch('WECHAT_CORPSECRET', nil),
+                agentid: ENV.fetch('WECHAT_AGENTID', nil),
+                token: ENV.fetch('WECHAT_TOKEN', nil),
+                access_token: ENV.fetch('WECHAT_ACCESS_TOKEN', nil),
+                encrypt_mode: ENV.fetch('WECHAT_ENCRYPT_MODE', nil),
+                timeout: ENV.fetch('WECHAT_TIMEOUT', nil),
+                skip_verify_ssl: ENV.fetch('WECHAT_SKIP_VERIFY_SSL', nil),
+                proxy_url: ENV.fetch('WECHAT_PROXY_URL', nil),
+                proxy_port: ENV.fetch('WECHAT_PROXY_PORT', nil),
+                proxy_username: ENV.fetch('WECHAT_PROXY_USERNAME', nil),
+                proxy_password: ENV.fetch('WECHAT_PROXY_PASSWORD', nil),
+                encoding_aes_key: ENV.fetch('WECHAT_ENCODING_AES_KEY', nil),
+                jsapi_ticket: ENV.fetch('WECHAT_JSAPI_TICKET', nil),
+                qcloud_env: ENV.fetch('WECHAT_QCLOUD_ENV', nil),
+                qcloud_token_file: ENV.fetch('WECHAT_QCLOUD_TOKEN', nil),
+                qcloud_token_lifespan: ENV.fetch('WECHAT_QCLOUD_TOKEN_LIFESPAN', nil),
+                trusted_domain_fullname: ENV.fetch('WECHAT_TRUSTED_DOMAIN_FULLNAME', nil) }
       { default: value }
     end
 

data/lib/wechat/concern/common.rb

@@ -104,6 +104,11 @@ module Wechat
         post 'msg_sec_check', JSON.generate(content: content), base: Wechat::Api::WXA_BASE
       end
 
+      def wxa_generate_urllink(body_hash)
+        # https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/url-link/urllink.generate.html
+        post 'generate_urllink', JSON.generate(body_hash), base: Wechat::Api::WXA_BASE
+      end
+
       def menu
         get 'menu/get'
       end
@@ -113,7 +118,7 @@ module Wechat
       end
 
       def menu_create(menu)
-        # 微信不接受7bit escaped json(eg \uxxxx), 中文必须UTF-8编码, 这可能是个安全漏洞
+        # 微信不接受 7bit escaped json(eg \uxxxx)，中文必须 UTF-8 编码，这可能是个安全漏洞
         post 'menu/create', JSON.generate(menu)
       end
 

data/lib/wechat/concern/draft.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Wechat
+  module Concern
+    module Draft
+      def draft_add(mpnews_articles)
+        draft_add_params_hash = { articles: mpnews_articles }
+        post 'draft/add', JSON.generate(draft_add_params_hash)
+      end
+
+      def draft_get(media_id)
+        post 'draft/get', JSON.generate(media_id: media_id)
+      end
+
+      def draft_delete(media_id)
+        post 'draft/delete', JSON.generate(media_id: media_id)
+      end
+
+      def draft_update(media_id, mpnews_articles, index: 0)
+        draft_update_params_hash = { media_id: media_id,
+                                     index: index,
+                                     articles: mpnews_articles }
+        post 'draft/update', JSON.generate(draft_update_params_hash)
+      end
+
+      def draft_count
+        get 'draft/count'
+      end
+
+      def draft_batchget(offset, count, no_content: false)
+        draft_batchget_params_hash = { offset: offset,
+                                       count: count,
+                                       no_content: (no_content ? 1 : 0) }
+        post 'draft/batchget', JSON.generate(draft_batchget_params_hash)
+      end
+
+      def draft_switch(checkonly: true)
+        post 'draft/switch', nil, params: { checkonly: (checkonly ? 1 : 0) }
+      end
+    end
+  end
+end

data/lib/wechat/controller_api.rb

@@ -5,7 +5,7 @@ module Wechat
     extend ActiveSupport::Concern
 
     module ClassMethods
-      attr_accessor :wechat_api_client, :wechat_cfg_account, :token, :appid, :corpid, :agentid, :encrypt_mode, :timeout, :qcloud_token_lifespan,
+      attr_accessor :wechat_api_client, :wechat_cfg_account, :token, :appid, :corpid, :agentid, :encrypt_mode, :timeout,
                     :skip_verify_ssl, :encoding_aes_key, :trusted_domain_fullname, :oauth2_cookie_duration
     end
 

data/lib/wechat/corp_api.rb

@@ -4,9 +4,9 @@ module Wechat
   class CorpApi < ApiBase
     attr_reader :agentid
 
-    def initialize(appid, secret, token_file, agentid, timeout, skip_verify_ssl, jsapi_ticket_file)
+    def initialize(appid, secret, token_file, agentid, network_setting, jsapi_ticket_file)
       super()
-      @client = HttpClient.new(QYAPI_BASE, timeout, skip_verify_ssl)
+      @client = HttpClient.new(QYAPI_BASE, network_setting)
       @access_token = Token::CorpAccessToken.new(@client, appid, secret, token_file)
       @agentid = agentid
       @jsapi_ticket = Ticket::CorpJsapiTicket.new(@client, @access_token, jsapi_ticket_file)
@@ -143,7 +143,7 @@ module Wechat
     end
 
     def menu_create(menu)
-      # 微信不接受7bit escaped json(eg \uxxxx), 中文必须UTF-8编码, 这可能是个安全漏洞
+      # 微信不接受 7bit escaped json(eg \uxxxx)，中文必须 UTF-8 编码，这可能是个安全漏洞
       post 'menu/create', JSON.generate(menu), params: { agentid: agentid }
     end
 

data/lib/wechat/http_client.rb

@@ -6,16 +6,21 @@ module Wechat
   class HttpClient
     attr_reader :base, :ssl_context, :httprb
 
-    def initialize(base, timeout, skip_verify_ssl)
+    def initialize(base, network_setting)
       @base = base
       @httprb = if HTTP::VERSION.to_i >= 4
-                  HTTP.timeout(write: timeout, connect: timeout, read: timeout)
+                  HTTP.timeout(write: network_setting.timeout, connect: network_setting.timeout, read: network_setting.timeout)
                 else
-                  HTTP.timeout(:global, write: timeout, connect: timeout, read: timeout)
+                  HTTP.timeout(:global, write: network_setting.timeout, connect: network_setting.timeout, read: network_setting.timeout)
                 end
+
+      unless network_setting.proxy_url.nil?
+        @httprb = @httprb.via(network_setting.proxy_url, network_setting.proxy_port.to_i, network_setting.proxy_username, network_setting.proxy_password)
+      end
+
       @ssl_context = OpenSSL::SSL::SSLContext.new
       @ssl_context.ssl_version = 'TLSv1_2'
-      @ssl_context.verify_mode = OpenSSL::SSL::VERIFY_NONE if skip_verify_ssl
+      @ssl_context.verify_mode = OpenSSL::SSL::VERIFY_NONE if network_setting.skip_verify_ssl
     end
 
     def get(path, get_header = {})

data/lib/wechat/message.rb

@@ -33,7 +33,6 @@ module Wechat
     class ArticleBuilder
       attr_reader :items
 
-      delegate :count, to: :items
       def initialize
         @items = []
       end
@@ -203,6 +202,10 @@ module Wechat
       update(MsgType: 'template', Template: template_fields)
     end
 
+    def draft_news(collection)
+      update(MsgType: 'draft_news', Articles: collection)
+    end
+
     def to_xml
       ws = message_hash.delete(:WechatSession)
       xml = message_hash.to_xml(root: 'xml', children: 'item', skip_instruct: true, skip_types: true)
@@ -244,6 +247,8 @@ module Wechat
         json_hash['news'] = { 'articles' => json_hash.delete('articles') }
       when 'mpnews'
         json_hash = { 'articles' => json_hash['articles'] }
+      when 'draft_news'
+        json_hash = json_hash['articles']
       when 'ref_mpnews'
         json_hash['msgtype'] = 'mpnews'
         json_hash.delete('articles')

data/lib/wechat/mp_api.rb

@@ -2,12 +2,12 @@
 
 module Wechat
   class MpApi < ApiBase
-    def initialize(appid, secret, token_file, timeout, skip_verify_ssl, jsapi_ticket_file, qcloud_env, qcloud_token_file, qcloud_token_lifespan)
+    def initialize(appid, secret, token_file, network_setting, jsapi_ticket_file, qcloud_setting)
       super()
-      @client = HttpClient.new(Wechat::Api::API_BASE, timeout, skip_verify_ssl)
+      @client = HttpClient.new(Wechat::Api::API_BASE, network_setting)
       @access_token = Token::PublicAccessToken.new(@client, appid, secret, token_file)
       @jsapi_ticket = Ticket::PublicJsapiTicket.new(@client, @access_token, jsapi_ticket_file)
-      @qcloud = Qcloud::Token.new(@client, @access_token, qcloud_env, qcloud_token_file, qcloud_token_lifespan)
+      @qcloud = Qcloud::Token.new(@client, @access_token, qcloud_setting)
     end
 
     include Concern::Common

data/lib/wechat/network_setting.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Wechat
+  class NetworkSetting
+    attr_reader :timeout, :skip_verify_ssl, :proxy_url, :proxy_port, :proxy_username, :proxy_password
+
+    def initialize(timeout, skip_verify_ssl, proxy_url, proxy_port, proxy_username, proxy_password)
+      @timeout = timeout
+      @skip_verify_ssl = skip_verify_ssl
+      @proxy_url = proxy_url
+      @proxy_port = proxy_port
+      @proxy_username = proxy_username
+      @proxy_password = proxy_password
+    end
+  end
+end

data/lib/wechat/qcloud/setting.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Wechat
+  module Qcloud
+    class Setting
+      attr_reader :qcloud_env, :qcloud_token, :qcloud_token_lifespan
+
+      def initialize(qcloud_env, qcloud_token, qcloud_token_lifespan)
+        @qcloud_env = qcloud_env
+        @qcloud_token = qcloud_token
+        @qcloud_token_lifespan = qcloud_token_lifespan
+      end
+    end
+  end
+end

data/lib/wechat/qcloud/token.rb

@@ -10,12 +10,12 @@ module Wechat
     class Token
       attr_reader :client, :access_token, :qcloud_env, :qcloud_token_file, :qcloud_token_lifespan, :qcloud_token, :qcloud_token_expired_time
 
-      def initialize(client, access_token, qcloud_env, qcloud_token_file, lifespan)
+      def initialize(client, access_token, qcloud_setting)
         @client = client
         @access_token = access_token
-        @qcloud_env = qcloud_env
-        @qcloud_token_file = qcloud_token_file
-        @qcloud_token_lifespan = lifespan
+        @qcloud_env = qcloud_setting.qcloud_env
+        @qcloud_token_file = qcloud_setting.qcloud_token
+        @qcloud_token_lifespan = qcloud_setting.qcloud_token_lifespan
         @random_generator = Random.new
       end
 

data/lib/wechat.rb

@@ -2,6 +2,7 @@
 
 require 'zeitwerk'
 loader = Zeitwerk::Loader.for_gem
+loader.ignore("#{__dir__}/action_controller")
 loader.ignore("#{__dir__}/generators/**/*.rb")
 loader.setup
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wechat
 version: !ruby/object:Gem::Version
-  version: 0.15.0
+  version: 0.16.1
 platform: ruby
 authors:
 - Skinnyworm
@@ -35,7 +35,7 @@ cert_chain:
   ZM9IDtdMg8E/4ujwilV8HKmgU77vVN6vSMvxx8zQFSz9a6GbdpB4egPZ++peSk/Q
   uaIJtOX6M4VC6u7eZfotARKyUy6EcoN2zNqEAQ==
   -----END CERTIFICATE-----
-date: 2021-12-21 00:00:00.000000000 Z
+date: 2022-07-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -85,6 +85,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.6.0
+- !ruby/object:Gem::Dependency
+  name: psych
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.3.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.3.2
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
@@ -161,14 +175,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '5.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '5.1'
+- !ruby/object:Gem::Dependency
+  name: rspec-mocks
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.10.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.10.2
 - !ruby/object:Gem::Dependency
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
@@ -217,6 +245,7 @@ files:
 - lib/wechat/api_loader.rb
 - lib/wechat/cipher.rb
 - lib/wechat/concern/common.rb
+- lib/wechat/concern/draft.rb
 - lib/wechat/concern/qcloud.rb
 - lib/wechat/controller_api.rb
 - lib/wechat/corp_api.rb
@@ -224,6 +253,8 @@ files:
 - lib/wechat/http_client.rb
 - lib/wechat/message.rb
 - lib/wechat/mp_api.rb
+- lib/wechat/network_setting.rb
+- lib/wechat/qcloud/setting.rb
 - lib/wechat/qcloud/token.rb
 - lib/wechat/responder.rb
 - lib/wechat/signature.rb
@@ -239,10 +270,15 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/Eric-Guo/wechat/issues
   changelog_uri: https://github.com/Eric-Guo/wechat/releases
-  documentation_uri: https://github.com/Eric-Guo/wechat/tree/v0.15.0#readme
-  source_code_uri: https://github.com/Eric-Guo/wechat/tree/v0.15.0
+  documentation_uri: https://github.com/Eric-Guo/wechat/tree/v0.16.1#readme
+  source_code_uri: https://github.com/Eric-Guo/wechat/tree/v0.16.1
   rubygems_mfa_required: 'true'
-post_install_message:
+post_install_message: |-
+  *****WECHAT BREAK CHANGE*****
+  Including correct version of `psych` after upgrade wechat, if not sure, using v3.3.2.
+  Ruby 3.1’s incompatible changes to its YAML module (Psych 4), detail see:
+  https://www.ctrl.blog/entry/ruby-psych4.html
+  *****************************
 rdoc_options: []
 require_paths:
 - lib
@@ -257,7 +293,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.8.11
 requirements: []
-rubygems_version: 3.2.33
+rubygems_version: 3.3.18
 signing_key:
 specification_version: 4
 summary: DSL for wechat message handling and API