docbase 2.1.2 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 20af66cc5d5085854e9aef5f65e57383291a8f217961a4fa6cead0bb2e678941
-  data.tar.gz: 24cf39072ac1eaf9c4cc700f6ee2bcc694939b5c4d26427cb932aedeabf499f0
+  metadata.gz: 04de1814e9cdba377e46783519ead41b3471972cd19d4e32c058eb952ad9261d
+  data.tar.gz: 30f7944856b0157e89cc178b72f2d437a2ae1b1a6352b6437840566d461115fa
 SHA512:
-  metadata.gz: 12a494552034d86ba01f68a95e30a438ed068307223d83dd23b9e92fa23f15a85dc98cee60577342696b123ec2b5153f0935d77b58a3887f810da919beb7b0f8
-  data.tar.gz: d5dc0fea1f5d08a13ea5df13c38c504e11a80b5a82f121ce9afe7d087cb1d4b06d48188434939bd41758a67029aacc692fd7db8466fd5db9c1f2fe6023a3ef7c
+  metadata.gz: 63c7b0575d1b5ca821ae2cf0c6cde0ba94514321ce061f7f8f4c1e8a63e6ab8040e2d219a857d87b5b71e375e539faf16e427f900fa5265b2fcda755bc901644
+  data.tar.gz: af1764af0574365f63fdc14e9a206fb983632cb17c705cb442f68f9228c92b87a4c4c8af2fa66bf31200c77b0b02a408c85fa023445d62c0cfe9c4565d61dc2c

data/CHANGELOG.md

@@ -1,3 +1,13 @@
+## 3.0.0
+
+* DocBase API v3対応
+* プロフィール、所属グループ一覧、メンバー削除、コメント一覧、メモ本文部分更新、グッジョブAPIを追加
+* `users`の`include_user_groups`引数を削除（v3で廃止）
+* Ruby 3.4以降向けに`base64`依存を追加
+* `X-Api-Version`ヘッダを削除（v3トークンでAPIバージョンが決まる）
+* `create_comment`が`post_id`をリクエストボディに含めてしまう不具合を修正
+* バイナリ取得用コネクションがJSON用と共有されていた不具合を修正
+
 ## 2.1.2
 
 * 利用制限時にリトライできるように

data/README.md

@@ -36,13 +36,33 @@ client = DocBase::Client.new(access_token: 'your_access_token', team: 'your_team
     * [#16](https://github.com/krayinc/docbase-ruby/issues/16)
     * true or false
 
+### profile
+
+```ruby
+client.profile.body
+```
+
 ### users
 
 ```ruby
 client.users(q: 'name')
 client.users(q: 'name', page: 2)
 client.users(q: 'name', page: 1, per_page: 100)
-client.users(q: 'name', page: 1, per_page: 100, include_user_groups: true)
+```
+
+所属グループはv3ではユーザー検索APIのレスポンスに含まれません。`user_groups`を利用してください。
+
+#### User groups
+
+```ruby
+client.user_groups(1).body
+client.user_groups(1, page: 2, per_page: 20).body
+```
+
+#### Delete user
+
+```ruby
+client.delete_user(1)
 ```
 
 ### tags
@@ -150,6 +170,25 @@ params = {
 client.update_post(params)
 ```
 
+#### Partial body update
+
+```ruby
+params = {
+  id: 1,
+  operations: [
+    {
+      start: 3,
+      end: 5,
+      old_content: "line3\r\nline4\r\nline5",
+      content: 'new text',
+    },
+  ],
+  notice: true,
+}
+
+client.update_post_body(params)
+```
+
 #### Archive
 
 ```ruby
@@ -170,6 +209,13 @@ client.delete_post(1)
 
 ### Comment
 
+#### List
+
+```ruby
+client.comments(1).body
+client.comments(1, page: 2, per_page: 20, order: 'desc').body
+```
+
 #### Create
 
 ```ruby
@@ -188,6 +234,28 @@ client.create_comment(params)
 client.delete_comment(1)
 ```
 
+### good jobs
+
+#### List
+
+```ruby
+client.good_jobs(1).body
+client.good_jobs(1, page: 2, per_page: 100, order: 'desc').body
+```
+
+#### Create
+
+```ruby
+client.create_good_job(1)
+client.create_good_job(1, notice: false)
+```
+
+#### Delete
+
+```ruby
+client.delete_good_job(1, 111)
+```
+
 ### attachments
 
 #### Create

data/docbase.gemspec

@@ -17,6 +17,7 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
+  spec.add_dependency 'base64'
   spec.add_dependency 'faraday', '>= 0.15.2'
   spec.add_dependency 'faraday_middleware', '>= 0.12.2'
 end

data/lib/docbase/client.rb

@@ -21,8 +21,28 @@ module DocBase
       @team
     end
 
-    def users(q: nil, page: 1, per_page: 100, include_user_groups: false)
-      request(method: :get, path: "/teams/#{team!}/users", params: { q: q, page: page, per_page: per_page, include_user_groups: include_user_groups })
+    def profile
+      request(method: :get, path: "/teams/#{team!}/profile")
+    end
+
+    def users(q: nil, page: 1, per_page: 100)
+      request(
+        method: :get,
+        path: "/teams/#{team!}/users",
+        params: { q: q, page: page, per_page: per_page }
+      )
+    end
+
+    def user_groups(user_id, page: 1, per_page: 20)
+      request(
+        method: :get,
+        path: "/teams/#{team!}/users/#{user_id}/groups",
+        params: { page: page, per_page: per_page }
+      )
+    end
+
+    def delete_user(id)
+      request(method: :delete, path: "/teams/#{team!}/users/#{id}")
     end
 
     def tags
@@ -71,12 +91,20 @@ module DocBase
 
     def update_post(params)
       post_id = params[:id].to_i
-      raise NotSetTeamError if post_id <= 0
+      raise NotSetPostIdError if post_id <= 0
 
       post_params = except(params, :id)
       request(method: :patch, path: "/teams/#{team!}/posts/#{post_id}", params: post_params)
     end
 
+    def update_post_body(params)
+      post_id = params[:id].to_i
+      raise NotSetPostIdError if post_id <= 0
+
+      body_params = except(params, :id)
+      request(method: :patch, path: "/teams/#{team!}/posts/#{post_id}/body", params: body_params)
+    end
+
     def delete_post(id)
       request(method: :delete, path: "/teams/#{team!}/posts/#{id}")
     end
@@ -89,18 +117,54 @@ module DocBase
       request(method: :put, path: "/teams/#{team!}/posts/#{id}/unarchive")
     end
 
+    def comments(post_id, page: 1, per_page: 20, order: 'asc', created_after: nil, created_before: nil)
+      request(
+        method: :get,
+        path: "/teams/#{team!}/posts/#{post_id}/comments",
+        params: {
+          page: page,
+          per_page: per_page,
+          order: order,
+          created_after: created_after,
+          created_before: created_before,
+        }
+      )
+    end
+
     def create_comment(params)
       post_id = params[:post_id].to_i
-      raise NotSetTeamError if post_id <= 0
+      raise NotSetPostIdError if post_id <= 0
 
       comment_params = except(params, :post_id)
-      request(method: :post, path: "/teams/#{team!}/posts/#{post_id}/comments", params: params)
+      request(method: :post, path: "/teams/#{team!}/posts/#{post_id}/comments", params: comment_params)
     end
 
     def delete_comment(id)
       request(method: :delete, path: "/teams/#{team!}/comments/#{id}")
     end
 
+    def good_jobs(post_id, page: 1, per_page: 100, order: 'asc', created_after: nil, created_before: nil)
+      request(
+        method: :get,
+        path: "/teams/#{team!}/posts/#{post_id}/good_jobs",
+        params: {
+          page: page,
+          per_page: per_page,
+          order: order,
+          created_after: created_after,
+          created_before: created_before,
+        }
+      )
+    end
+
+    def create_good_job(post_id, params = {})
+      request(method: :post, path: "/teams/#{team!}/posts/#{post_id}/good_jobs", params: params)
+    end
+
+    def delete_good_job(post_id, good_job_id)
+      request(method: :delete, path: "/teams/#{team!}/posts/#{post_id}/good_jobs/#{good_job_id}")
+    end
+
     def upload(paths)
       paths = [paths] unless paths.instance_of?(Array)
 
@@ -134,7 +198,7 @@ module DocBase
     end
 
     def connection_for_binary
-      @connection ||= Faraday.new({ url: @url, headers: headers }) do |faraday|
+      @connection_for_binary ||= Faraday.new({ url: @url, headers: headers }) do |faraday|
         faraday.request :json
         faraday.adapter Faraday.default_adapter
       end
@@ -145,12 +209,12 @@ module DocBase
         'Accept'         => 'application/json',
         'User-Agent'     => USER_AGENT,
         'X-DocBaseToken' => access_token,
-        'X-Api-Version'  => '2',
       }
     end
 
     def request(method:, path:, params: nil, for_binary: false)
-      response = for_binary ? connection_for_binary.send(method, path, params) : connection.send(method, path, params)
+      conn = for_binary ? connection_for_binary : connection
+      response = conn.send(method, path, params)
       raise TooManyRequestError if retry_on_rate_limit_exceeded && response.status == 429
       response
     rescue TooManyRequestError

data/lib/docbase/version.rb

@@ -1,3 +1,3 @@
 module DocBase
-  VERSION = '2.1.2'
+  VERSION = '3.0.0'
 end

metadata

@@ -1,15 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: docbase
 version: !ruby/object:Gem::Version
-  version: 2.1.2
+  version: 3.0.0
 platform: ruby
 authors:
 - ttakuru88
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-05-11 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
@@ -64,7 +77,6 @@ homepage: https://github.com/krayinc/docbase-ruby
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -79,8 +91,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
-signing_key: 
+rubygems_version: 4.0.10
 specification_version: 4
 summary: DocBase API Client, written in Ruby
 test_files: []