Class: NotionRubyMapping::NotionCache

Inherits:
Object
  • Object
show all
Includes:
Singleton
Defined in:
lib/notion_ruby_mapping/controllers/notion_cache.rb

Overview

singleton class of caching Notion objects

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ NotionCache

Returns a new instance of NotionCache.

See Also:



16
17
18
19
20
21
22
23
24
25
26
27
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 16

def initialize
  @object_hash = {}
  @client = Faraday.new "https://api.notion.com" do |conn|
    conn.request :json
    conn.response :json
    conn.headers["Notion-Version"] = NotionRubyMapping::NOTION_VERSION
  end
  @notion_token = nil
  @wait = 0.3333
  @debug = false
  @use_cache = true
end

Instance Attribute Details

#client=(value) ⇒ Object (writeonly)

for test only



29
30
31
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 29

def client=(value)
  @client = value
end

#debug ⇒ Object

Returns the value of attribute debug.



30
31
32
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 30

def debug
  @debug
end

#notion_token ⇒ Object

Returns the value of attribute notion_token.



30
31
32
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 30

def notion_token
  @notion_token
end

#object_hash ⇒ Object (readonly)

Returns the value of attribute object_hash.



28
29
30
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 28

def object_hash
  @object_hash
end

#use_cache ⇒ Object

Returns the value of attribute use_cache.



30
31
32
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 30

def use_cache
  @use_cache
end

#wait ⇒ Object

Returns the value of attribute wait.



30
31
32
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 30

def wait
  @wait
end

Instance Method Details

#append_block_children_block_path(block_id) ⇒ String (frozen)

Returns block_path.

Parameters:

  • block_id (String)

Returns:

  • (String (frozen)) —

    block_path



42
43
44
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 42

def append_block_children_block_path(block_id)
  "v1/blocks/#{block_id}/children"
end

#append_block_children_page_path(page_id) ⇒ String (frozen)

Returns page_path.

Parameters:

  • page_id (String)

Returns:

  • (String (frozen)) —

    page_path



48
49
50
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 48

def append_block_children_page_path(page_id)
  "v1/blocks/#{page_id}/children"
end

#append_block_children_request(id, payload) ⇒ Hash

Parameters:

  • id (String)
  • payload (Hash)

Returns:

  • (Hash) 


55
56
57
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 55

def append_block_children_request(id, payload)
  request :patch, append_block_children_block_path(id), payload
end

#append_comment_request(json) ⇒ Object 



59
60
61
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 59

def append_comment_request(json)
  request :post, comments_path, json
end

#block(id) ⇒ NotionRubyMapping::Base

Returns Block object or nil.

Parameters:

  • id (String) —

    block_id (with or without “-”)

Returns:



65
66
67
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 65

def block(id)
  object_for_key(id) { block_request id }
end

#block_children_page_path(page_id, query_string = "") ⇒ String (frozen)

Returns page_path.

Parameters:

  • page_id (String)

Returns:

  • (String (frozen)) —

    page_path



71
72
73
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 71

def block_children_page_path(page_id, query_string = "")
  "v1/blocks/#{page_id}/children#{query_string}"
end

#block_children_request(id, query_string) ⇒ Hash

Parameters:

  • id (String)
  • query_string (String)

Returns:

  • (Hash) 


78
79
80
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 78

def block_children_request(id, query_string)
  request :get, block_children_page_path(id, query_string)
end

#block_path(block_id) ⇒ String (frozen)

Returns page_path.

Parameters:

  • block_id (String)

Returns:

  • (String (frozen)) —

    page_path



84
85
86
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 84

def block_path(block_id)
  "v1/blocks/#{block_id}"
end

#block_request(block_id) ⇒ Hash

Returns response.

Parameters:

  • block_id (String)

Returns:

  • (Hash) —

    response



90
91
92
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 90

def block_request(block_id)
  request :get, block_path(block_id)
end

#clear_object_hash ⇒ Hash

Returns:

  • (Hash) 


95
96
97
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 95

def clear_object_hash
  @object_hash = {}
end

#comments_path ⇒ String (frozen)

Returns:

  • (String (frozen)) 


100
101
102
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 100

def comments_path
  "v1/comments"
end

#complete_a_file_upload_path(file_id) ⇒ Object 



104
105
106
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 104

def complete_a_file_upload_path(file_id)
  "v1/file_uploads/#{file_id}/complete"
end

#complete_a_file_upload_request(file_id) ⇒ Object 



108
109
110
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 108

def complete_a_file_upload_request(file_id)
  request :post, complete_a_file_upload_path(file_id)
end

#create_client(notion_token, wait: 0.3333, debug: false) ⇒ NotionRubyMapping::NotionCache

Returns self (NotionCache.instance).

Parameters:

  • notion_token (String)

Returns:



114
115
116
117
118
119
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 114

def create_client(notion_token, wait: 0.3333, debug: false)
  @notion_token = notion_token
  @wait = wait
  @debug = debug
  self
end

#create_data_source_request(payload) ⇒ Hash

Returns response.

Parameters:

  • payload (Hash)

Returns:

  • (Hash) —

    response



129
130
131
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 129

def create_data_source_request(payload)
  request :post, data_sources_path, payload
end

#create_database_request(payload) ⇒ Hash

Returns response.

Parameters:

  • payload (Hash)

Returns:

  • (Hash) —

    response



123
124
125
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 123

def create_database_request(payload)
  request :post, databases_path, payload
end

#create_file_upload_request(payload = {}) ⇒ Hash

Returns response.

Parameters:

  • payload (Hash) (defaults to: {})

Returns:

  • (Hash) —

    response



135
136
137
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 135

def create_file_upload_request(payload = {})
  request :post, file_uploads_path, payload
end

#create_page_request(payload) ⇒ Hash

Returns response.

Parameters:

  • payload (Hash)

Returns:

  • (Hash) —

    response



141
142
143
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 141

def create_page_request(payload)
  request :post, "v1/pages", payload
end

#data_source(id) ⇒ NotionRubyMapping::Base

Returns DataSource object or nil.

Parameters:

  • id (String) —

    data_source_id (with or without “-”)

Returns:



153
154
155
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 153

def data_source(id)
  object_for_key(id) { data_source_request id }
end

#data_source_path(data_source_id) ⇒ String (frozen)

Returns data_source_path.

Parameters:

  • database_id (String)

Returns:

  • (String (frozen)) —

    data_source_path



165
166
167
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 165

def data_source_path(data_source_id)
  "v1/data_sources/#{data_source_id}"
end

#data_source_query_request(data_source_id, query) ⇒ Object

Parameters:



178
179
180
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 178

def data_source_query_request(data_source_id, query)
  request :post, "v1/data_sources/#{data_source_id}/query#{query.database_query_string}", query.query_json
end

#data_source_request(data_source_id) ⇒ Hash

Returns response.

Parameters:

  • data_source_id (String)

Returns:

  • (Hash) —

    response



190
191
192
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 190

def data_source_request(data_source_id)
  request :get, data_source_path(data_source_id)
end

#data_sources_path ⇒ String (frozen)

Returns page_path.

Returns:

  • (String (frozen)) —

    page_path



200
201
202
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 200

def data_sources_path
  "v1/data_sources"
end

#database(id) ⇒ NotionRubyMapping::Base

Returns Database object or nil.

Parameters:

  • id (String) —

    database_id (with or without “-”)

Returns:



147
148
149
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 147

def database(id)
  object_for_key(id) { database_request id }
end

#database_path(database_id) ⇒ String (frozen)

Returns database_path.

Parameters:

  • database_id (String)

Returns:

  • (String (frozen)) —

    database_path



159
160
161
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 159

def database_path(database_id)
  "v1/databases/#{database_id}"
end

#database_request(database_id) ⇒ Hash

Returns response.

Parameters:

  • database_id (String)

Returns:

  • (Hash) —

    response



184
185
186
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 184

def database_request(database_id)
  request :get, database_path(database_id)
end

#databases_path ⇒ String (frozen)

Returns page_path.

Returns:

  • (String (frozen)) —

    page_path



195
196
197
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 195

def databases_path
  "v1/databases"
end

#destroy_block(id) ⇒ NotionRubyMapping::Base

Parameters:

  • id (String)

Returns:



206
207
208
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 206

def destroy_block(id)
  Base.create_from_json destroy_block_request(id)
end

#destroy_block_request(id) ⇒ Hash

Parameters:

  • id (String)

Returns:

  • (Hash) 


212
213
214
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 212

def destroy_block_request(id)
  request :delete, block_path(id)
end

#file_upload_path(file_id) ⇒ Object 



339
340
341
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 339

def file_upload_path(file_id)
  "v1/file_uploads/#{file_id}"
end

#file_upload_request(file_id) ⇒ Object 



335
336
337
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 335

def file_upload_request(file_id)
  request :get, file_upload_path(file_id)
end

#file_uploads_path ⇒ String

Returns:

  • (String) 


231
232
233
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 231

def file_uploads_path
  "v1/file_uploads"
end

#hex_id(id) ⇒ String

Returns id without “-”.

Parameters:

  • id (String) —

    id string with “-”

Returns:

  • (String) —

    id without “-”

See Also:



238
239
240
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 238

def hex_id(id)
  id&.gsub "-", ""
end

#inspect ⇒ Object 



242
243
244
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 242

def inspect
  "NotionCache"
end

#multipart_client ⇒ Object 



32
33
34
35
36
37
38
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 32

def multipart_client
  @multipart_client ||= Faraday.new "https://api.notion.com" do |conn|
    conn.request :multipart, flat_encode: true
    conn.response :json
    conn.headers["Notion-Version"] = NotionRubyMapping::NOTION_VERSION
  end
end

#multipart_request(path, fname, options = {}) ⇒ Hash

Returns response hash.

Parameters:

  • path (String)
  • fname (String)
  • options (Hash) (defaults to: {})

Returns:

  • (Hash) —

    response hash



250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 250

def multipart_request(path, fname, options = {})
  raise "Please call `NotionRubyMapping.configure' before using other methods" unless @notion_token

  content_type = MIME::Types.type_for(fname).first.to_s

  sleep @wait
  body = options.map { |k, v| [k, Faraday::Multipart::ParamPart.new(v, "text/plain")] }.to_h
  file_part = Faraday::Multipart::FilePart.new(fname, content_type, File.basename(fname))
  response = multipart_client.send(:post) do |request|
    request.headers["Authorization"] = "Bearer #{@notion_token}"
    request.headers["content-Type"] = "multipart/form-data"
    request.path = path
    request.body = {file: file_part}.merge body
  end
  p response.body if @debug
  response.body
end

#object_for_key(id) ⇒ NotionRubyMapping::Base

Parameters:

  • id (String) —

    id (with or without “-”)

Returns:



270
271
272
273
274
275
276
277
278
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 270

def object_for_key(id)
  key = hex_id(id)
  return @object_hash[key] if @use_cache && @object_hash.key?(key)

  json = yield(@client)
  ans = Base.create_from_json json
  @object_hash[key] = ans if @use_cache
  ans
end

#page(id) ⇒ NotionRubyMapping::Base

Returns Page object or nil.

Parameters:

  • id (String) —

    page_id (with or without “-”)

Returns:



282
283
284
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 282

def page(id)
  object_for_key(id) { page_request id }
end

#page_path(page_id) ⇒ String (frozen)

Returns page_path.

Parameters:

  • page_id (String)

Returns:

  • (String (frozen)) —

    page_path



288
289
290
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 288

def page_path(page_id)
  "v1/pages/#{page_id}"
end

#page_property_path(page_id, property_id) ⇒ String (frozen)

Returns page_property_path.

Parameters:

  • page_id (String)
  • property_id (String)

Returns:

  • (String (frozen)) —

    page_property_path



295
296
297
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 295

def page_property_path(page_id, property_id)
  [page_path(page_id), "properties/#{property_id}"].join "/"
end

#page_property_request(page_id, property_id, query = {}) ⇒ Hash

Returns response.

Parameters:

  • page_id (String)
  • property_id (String)

Returns:

  • (Hash) —

    response



302
303
304
305
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 302

def page_property_request(page_id, property_id, query = {})
  p "page_id = #{page_id}, property_id = #{property_id}, query = #{query}" if @debug
  request :get, page_property_path(page_id, property_id), query
end

#page_request(page_id) ⇒ Hash

Returns response.

Parameters:

  • page_id (String)

Returns:

  • (Hash) —

    response



309
310
311
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 309

def page_request(page_id)
  request :get, page_path(page_id)
end

#pages_path ⇒ String (frozen)

Returns page_path.

Returns:

  • (String (frozen)) —

    page_path



314
315
316
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 314

def pages_path
  "v1/pages"
end

#query_data_source_path(data_source_id) ⇒ String (frozen)

Returns page_path.

Parameters:

  • database_id (String)

Returns:

  • (String (frozen)) —

    page_path



320
321
322
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 320

def query_data_source_path(data_source_id)
  "v1/data_sources/#{data_source_id}/query"
end

#request(method, path, options = {}) ⇒ Hash

Returns response hash.

Parameters:

  • method (Symbol)
  • path (String)
  • options (Hash) (defaults to: {})

Returns:

  • (Hash) —

    response hash



347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 347

def request(method, path, options = {})
  raise "Please call `NotionRubyMapping.configure' before using other methods" unless @notion_token

  sleep @wait
  response = @client.send(method) do |request|
    request.headers["Authorization"] = "Bearer #{@notion_token}"
    case method
    when :get, :delete
      request.url path, options
    when :post, :put, :patch
      request.headers["Content-Type"] = "application/json"
      request.path = path
      request.body = options.to_json unless options.empty?
    else
      raise StandardError, "Unknown method: #{method}"
    end
    request.options.merge!(options.delete(:request)) if options.key? :request
  end
  p response.body if @debug
  response.body
end

#retrieve_comments_path(block_id) ⇒ Object

Parameters:

  • block_id (String) 


325
326
327
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 325

def retrieve_comments_path(block_id)
  "v1/comments?block_id=#{block_id}"
end

#retrieve_comments_request(block_id, query) ⇒ Object

Parameters:



331
332
333
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 331

def retrieve_comments_request(block_id, query)
  request :get, retrieve_comments_path(block_id), (query&.query_json || {})
end

#search(query) ⇒ Object 



369
370
371
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 369

def search(query)
  request(:post, search_path, query)
end

#search_path ⇒ Object 



373
374
375
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 373

def search_path
  "v1/search"
end

#send_file_upload_path(id) ⇒ String

Parameters:

  • id (String)

Returns:

  • (String) 


226
227
228
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 226

def send_file_upload_path(id)
  "v1/file_uploads/#{id}/send"
end

#send_file_upload_request(fname, id, options = {}) ⇒ Hash

Parameters:

  • fname (String)
  • id (String)
  • options (Hash) (defaults to: {})

Returns:

  • (Hash) 


220
221
222
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 220

def send_file_upload_request(fname, id, options = {})
  multipart_request(send_file_upload_path(id), fname, options)
end

#token=(token) ⇒ Object

Parameters:

  • token (String) 


378
379
380
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 378

def token=(token)
  @notion_token = token
end

#update_block_request(block_id, payload) ⇒ Object 



382
383
384
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 382

def update_block_request(block_id, payload)
  request :patch, block_path(block_id), payload
end

#update_data_source_request(data_source_id, payload) ⇒ Hash

Returns response.

Parameters:

  • data_source_id (String)

Returns:

  • (Hash) —

    response



401
402
403
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 401

def update_data_source_request(data_source_id, payload)
  request :patch, data_source_path(data_source_id), payload
end

#update_database_request(database_id, payload) ⇒ Hash

Returns response.

Parameters:

  • database_id (String)

Returns:

  • (Hash) —

    response



395
396
397
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 395

def update_database_request(database_id, payload)
  request :patch, database_path(database_id), payload
end

#update_page_request(page_id, payload) ⇒ Hash

Returns response.

Parameters:

  • page_id (String)
  • payload (Hash)

Returns:

  • (Hash) —

    response



408
409
410
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 408

def update_page_request(page_id, payload)
  request :patch, page_path(page_id), payload
end

#user(id) ⇒ NotionRubyMapping::UserObject

Returns UserObject object or nil.

Parameters:

  • id (String) —

    user_id (with or without “-”)

Returns:



414
415
416
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 414

def user(id)
  UserObject.new json: user_request(id)
end

#user_path(user_id) ⇒ String (frozen)

Returns user_path.

Parameters:

  • user_id (String)

Returns:

  • (String (frozen)) —

    user_path



420
421
422
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 420

def user_path(user_id)
  "v1/users/#{user_id}"
end

#user_request(user_id) ⇒ Hash

Returns response.

Parameters:

  • user_id (String)

Returns:

  • (Hash) —

    response



426
427
428
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 426

def user_request(user_id)
  request :get, user_path(user_id)
end

#users ⇒ Array<NotionRubyMapping::UserObject>

Returns UserObject array.

Returns:



431
432
433
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 431

def users
  List.new json: users_request, type: "user_object", value: true
end

#users_path(option = "") ⇒ String (frozen)

Returns user_path.

Returns:

  • (String (frozen)) —

    user_path



436
437
438
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 436

def users_path(option = "")
  "v1/users#{option}"
end

#users_request(query = Query.new) ⇒ Hash

Returns response.

Parameters:

Returns:

  • (Hash) —

    response



443
444
445
 
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 443

def users_request(query = Query.new)
  request :get, users_path, query.query_json
end