rebuild

Author: Ceelog

.github/workflows/ci.yaml

@@ -0,0 +1,16 @@
+on: push
+name: golang-ci
+jobs:
+ checks:
+ name: run
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@main
+ - name: run
+ uses: cedrickring/golang-action@1.5.2
+ env:
+ GO111MODULE: "on"
+ - name: Use Go 1.13
+ uses: cedrickring/golang-action/go1.13@1.5.2
+ env:
+ GO111MODULE: "on"

.gitignore

@@ -0,0 +1,5 @@
+.DS_Store
+.idea/
+book/
+*tmp.go
+TODO

README.md

@@ -1 +1,64 @@
-# miniprogram
+# fastwego/miniprogram
+
+A fast wechat miniprogram development framework written in Golang
+
+## 演示 Demo
+
+[https://github.com/fastwego/miniprogram-demo](https://github.com/fastwego/miniprogram-demo)
+
+## 架构设计
+
+![sdk](./doc/img/sdk.jpg)
+
+## 框架特点
+
+### 快速
+
+「快」作为框架设计的核心理念，体现在方方面面：
+
+- 使用 Go 语言，开发快、编译快、部署快、运行快，轻松服务海量用户
+- 丰富的文档、教程和演示代码，快速上手，5 分钟即可搭建一套完整的微信公众号服务
+- 独立清晰的模块划分，快速熟悉整个框架，没有意外，一切都是你期望的样子
+- 甚至连框架自身的大部分代码也是自动生成的，维护更新快到超乎想象
+
+### 符合直觉
+
+作为第三方开发框架，尽可能贴合官方文档和设计，不引入新的概念，不给开发者添加学习负担
+
+### 官方文档就是最好的文档
+
+每个接口的注释都附带官方文档的链接，让你随时翻阅，省时省心
+
+### 完备的单元测试
+
+100% 覆盖每一个接口，让你每一次调用都信心满满
+
+### 详细的日志
+
+每个关键环节都为你完整记录，Debug 倍轻松，你可以自由定义日志输出，甚至可以关闭日志
+
+### 多账号支持
+
+一套服务支持多个账号，轻松成为第三方开发服务平台，业务节节高
+
+### 支持服务集群
+
+单台服务器支撑不住访问流量/想提高服务可用性？
+
+只需重载 GetAccessTokenFunc 方法，从中控服务获取 AccessToken，即可解决多实例刷新冲突/覆盖的问题
+
+### 活跃的开发者社区
+
+FastWeGo 是一套完整的微信开发框架，包括公众号、开放平台、微信支付、企业微信、小程序、小游戏等微信服务，拥有庞大的开发者用户群体
+
+你遇到的所有问题几乎都可以在社区找到解决方案
+
+## 接口列表
+
+[doc/apilist.md](doc/apilist.md)
+
+## 参与贡献
+
+欢迎提交 pull request / issue / 文档，一起让微信开发更快更好！
+
+Faster we go together!

apis/ad/ad.go

@@ -0,0 +1,18 @@
+// Copyright 2020 FastWeGo
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// Package ad 广告
+package ad
+
+const ()

apis/ad/ad_test.go

@@ -0,0 +1,27 @@
+// Copyright 2020 FastWeGo
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package ad
+
+import (
+"os"
+"testing"
+
+"github.com/fastwego/miniprogram/test"
+)
+
+func TestMain(m *testing.M) {
+test.Setup()
+os.Exit(m.Run())
+}

apis/ad/example_ad_test.go

@@ -0,0 +1,15 @@
+// Copyright 2020 FastWeGo
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package ad_test

apis/customer_message/customer_message.go

@@ -0,0 +1,82 @@
+// Copyright 2020 FastWeGo
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// Package customer_message 客服消息
+package customer_message
+
+import (
+"bytes"
+"net/url"
+
+"github.com/fastwego/miniprogram"
+)
+
+const (
+apiGetTempMedia = "/cgi-bin/media/get"
+apiSend = "/cgi-bin/message/custom/send"
+apiSetTyping = "/cgi-bin/message/custom/typing"
+apiUploadTempMedia = "/cgi-bin/media/upload"
+)
+
+/*
+获取客服消息内的临时素材。即下载临时的多媒体文件。目前小程序仅支持下载图片文件。
+
+
+
+See: https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/customer-message/customerServiceMessage.getTempMedia.html
+
+GET https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID
+*/
+func GetTempMedia(ctx *miniprogram.Miniprogram, params url.Values) (resp []byte, err error) {
+return ctx.Client.HTTPGet(apiGetTempMedia + "?" + params.Encode())
+}
+
+/*
+发送客服消息给用户。详细规则见 发送客服消息
+
+
+
+See: https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/customer-message/customerServiceMessage.send.html
+
+POST https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN
+*/
+func Send(ctx *miniprogram.Miniprogram, payload []byte) (resp []byte, err error) {
+return ctx.Client.HTTPPost(apiSend, bytes.NewReader(payload), "application/json;charset=utf-8")
+}
+
+/*
+下发客服当前输入状态给用户。详见 客服消息输入状态
+
+
+
+See: https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/customer-message/customerServiceMessage.setTyping.html
+
+POST https://api.weixin.qq.com/cgi-bin/message/custom/typing?access_token=ACCESS_TOKEN
+*/
+func SetTyping(ctx *miniprogram.Miniprogram, payload []byte) (resp []byte, err error) {
+return ctx.Client.HTTPPost(apiSetTyping, bytes.NewReader(payload), "application/json;charset=utf-8")
+}
+
+/*
+把媒体文件上传到微信服务器。目前仅支持图片。用于发送客服消息或被动回复用户消息。
+
+
+
+See: https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/customer-message/customerServiceMessage.uploadTempMedia.html
+
+POST https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE
+*/
+func UploadTempMedia(ctx *miniprogram.Miniprogram, payload []byte, params url.Values) (resp []byte, err error) {
+return ctx.Client.HTTPPost(apiUploadTempMedia+"?"+params.Encode(), bytes.NewReader(payload), "application/json;charset=utf-8")
+}