Merge branch 'release/1.0.0-alpha.1'

Author: xen0n

.gitignore

@@ -5,8 +5,8 @@
 /Gopkg.lock
 
 
-# Created by https://www.gitignore.io/api/go,vim,linux,emacs,macos,visualstudiocode
-# Edit at https://www.gitignore.io/?templates=go,vim,linux,emacs,macos,visualstudiocode
+# Created by https://www.toptal.com/developers/gitignore/api/go,vim,linux,emacs,macos,visualstudiocode,intellij+all
+# Edit at https://www.toptal.com/developers/gitignore?templates=go,vim,linux,emacs,macos,visualstudiocode,intellij+all
 
 ### Emacs ###
 # -*- mode: gitignore; -*-
@@ -67,16 +67,108 @@ flycheck_*.el
 *.so
 *.dylib
 
-# Test binary, build with `go test -c`
+# Test binary, built with `go test -c`
 *.test
 
 # Output of the go coverage tool, specifically when used with LiteIDE
 *.out
 
+# Dependency directories (remove the comment below to include it)
+# vendor/
+
 ### Go Patch ###
 /vendor/
 /Godeps/
 
+### Intellij+all ###
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
+
+# User-specific stuff
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+# Gradle
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# Gradle and Maven with auto-import
+# When using Gradle or Maven with auto-import, you should exclude module files,
+# since they will be recreated, and may cause churn.  Uncomment if using
+# auto-import.
+# .idea/artifacts
+# .idea/compiler.xml
+# .idea/jarRepositories.xml
+# .idea/modules.xml
+# .idea/*.iml
+# .idea/modules
+# *.iml
+# *.ipr
+
+# CMake
+cmake-build-*/
+
+# Mongo Explorer plugin
+.idea/**/mongoSettings.xml
+
+# File-based project format
+*.iws
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Cursive Clojure plugin
+.idea/replstate.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+# Android studio 3.1+ serialized cache file
+.idea/caches/build_file_checksums.ser
+
+### Intellij+all Patch ###
+# Ignores the whole .idea folder and all .iml files
+# See https://github.com/joeblau/gitignore.io/issues/186 and https://github.com/joeblau/gitignore.io/issues/360
+
+.idea/
+
+# Reason: https://github.com/joeblau/gitignore.io/issues/186#issuecomment-249601023
+
+*.iml
+modules.xml
+.idea/misc.xml
+*.ipr
+
+# Sonarlint plugin
+.idea/sonarlint
+
 ### Linux ###
 
 # temporary files which can be created if a process still has a handle open of a deleted file
@@ -98,7 +190,7 @@ flycheck_*.el
 .LSOverride
 
 # Icon must end with two \r
-Icon
+Icon
 
 # Thumbnails
 ._*
@@ -122,13 +214,15 @@ Temporary Items
 ### Vim ###
 # Swap
 [._]*.s[a-v][a-z]
+!*.svg  # comment out if you don't need vector files
 [._]*.sw[a-p]
 [._]s[a-rt-v][a-z]
 [._]ss[a-gi-z]
 [._]sw[a-p]
 
 # Session
 Session.vim
+Sessionx.vim
 
 # Temporary
 .netrwhist
@@ -143,9 +237,10 @@ tags
 !.vscode/tasks.json
 !.vscode/launch.json
 !.vscode/extensions.json
+*.code-workspace
 
 ### VisualStudioCode Patch ###
 # Ignore all local history of files
 .history
 
-# End of https://www.gitignore.io/api/go,vim,linux,emacs,macos,visualstudiocode
+# End of https://www.toptal.com/developers/gitignore/api/go,vim,linux,emacs,macos,visualstudiocode,intellij+all

.golangci.yml

@@ -0,0 +1,39 @@
+run:
+  timeout: 2m
+
+linters:
+  enable:
+    # enabled by default
+    # https://golangci-lint.run/usage/linters/
+    - govet
+    - errcheck
+    - staticcheck
+    - unused
+    - gosimple
+    - structcheck
+    - varcheck
+    - ineffassign
+    - deadcode
+    - typecheck
+    # project additions
+    # keep this list alphabetically sorted
+    - bodyclose
+    - goconst
+    # - gofmt  -- goimports contains this
+    - goimports
+    - gosec
+    - misspell
+    - nakedret
+    - nolintlint
+    - prealloc
+    - unconvert
+
+linters-settings:
+  gofmt:
+    simplify: true
+  goimports:
+    local-prefixes: github.com/xen0n/go-workwx
+  misspell:
+    locale: US
+  nakedret:
+    max-func-lines: 1

.travis.yml

@@ -1,7 +1,8 @@
 language: go
 go:
-  - "1.12.x"
   - "1.13.x"
+  - "1.14.x"
+  - "1.15.x"
 go_import_path: github.com/xen0n/go-workwx
 branches:
   # https://bors.tech/documentation/getting-started/
@@ -13,12 +14,13 @@ branches:
     - 'develop'
     - 'master'
 cache:
-  - $GOPATH/pkg/dep
+  - $HOME/.cache/go-build
+  - $GOPATH/pkg/mod
 before_install:
   - export GO111MODULE=on
-  - go get -u -v honnef.co/go/tools/cmd/staticcheck
+  - curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v1.33.0
+  - ./ci/run-lint.sh
 install:
   - go install -v ./...
 script:
-  - ./ci/run-lint.sh
   - go test -v ./...

README.md

@@ -36,6 +36,7 @@ in at least 2 of Qiniu's internal systems.
 
 ## Features
 
+* 支持最近 3 个 Go 版本
 * 包名短
 * 支持覆盖 API `Host`，用于自己拦一层网关、临时调试等等奇葩需求
 * 支持使用自定义 `http.Client`
@@ -61,7 +62,8 @@ in at least 2 of Qiniu's internal systems.
 * [x] 通讯录管理 (**部分支持**，见下)
 * [ ] 外部联系人管理
 * [ ] 应用管理
-* [x] 消息发送 (除接收消息、修改群聊会话外全部支持)
+* [x] 消息发送 (除修改群聊会话外全部支持)
+* [x] 消息接收 (**接口尚不稳定，极有可能做出不兼容改动，先不要用**)
 * [x] 素材管理 (**支持上传**, 见下)
 
 <details>
@@ -108,8 +110,29 @@ in at least 2 of Qiniu's internal systems.
 <summary>外部联系人管理 API</summary>
 
 * [ ] 离职成员的外部联系人再分配
-* [ ] 成员对外信息
-* [ ] 获取外部联系人详情
+* [x] 成员对外信息
+* [x] 客户管理
+    - [x] 获取客户列表
+    - [x] 获取客户详情
+    - [x] 修改客户备注信息
+* [x] 客户标签管理
+   - [x] 管理企业标签
+   - [x] 编辑客户企业标签
+* [x] 变更回调通知
+    - [x] 添加企业客户事件
+    - [x] 编辑企业客户事件
+    - [x] 外部联系人免验证添加成员事件
+    - [x] 删除企业客户事件
+    - [x] 删除跟进成员事件
+    - [x] 客户接替失败事件
+    - [x] 客户群变更事件
+
+</details>
+
+<details>
+<summary>身份验证 API</summary>
+
+* [x] 获取访问用户身份
 
 </details>
 
@@ -129,7 +152,7 @@ in at least 2 of Qiniu's internal systems.
 <summary>消息发送 API</summary>
 
 * [x] 发送应用消息
-* [ ] 接收消息
+* [x] 接收消息
 * [x] 发送消息到群聊会话
     - [x] 创建群聊会话
     - [ ] 修改群聊会话