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

#initializeNotionCache

Returns a new instance of NotionCache.



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

#debugObject

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_tokenObject

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_hashObject (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_cacheObject

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

#waitObject

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_hashHash

Returns:

  • (Hash)


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

def clear_object_hash
  @object_hash = {}
end

#comments_pathString (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_pathString (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_pathString (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



371
372
373
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 371

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

#file_upload_request(file_id) ⇒ Object



367
368
369
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 367

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

#file_uploads_pathString

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

#inspectObject



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

def inspect
  "NotionCache"
end

#list_data_source_templates_path(data_source_id, options = "") ⇒ String

Returns path.

Parameters:

  • data_source_id (String)
  • options (String) (defaults to: "")

Returns:

  • (String)

    path



261
262
263
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 261

def list_data_source_templates_path(data_source_id, options = "")
  "v1/data_sources/#{data_source_id}/templates#{options}"
end

#list_data_source_templates_request(data_source_id, page_size: nil, start_cursor: nil) ⇒ Hash

Returns response hash.

Parameters:

  • data_source_id (String)
  • page_size (Integer) (defaults to: nil)
  • start_cursor (String) (defaults to: nil)

Returns:

  • (Hash)

    response hash



250
251
252
253
254
255
256
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 250

def list_data_source_templates_request(data_source_id, page_size: nil, start_cursor: nil)
  options = []
  options << "page_size=#{page_size}" if page_size
  options << "start_cursor=#{start_cursor}" if start_cursor
  option_str = options.empty? ? "" : "?" + options.join("&")
  request :get, list_data_source_templates_path(data_source_id, option_str)
end

#move_page_path(page_id) ⇒ String

Returns move_page_path.

Parameters:

  • page_id (String)

Returns:

  • (String)

    move_page_path



274
275
276
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 274

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

#move_page_request(page_id, payload) ⇒ Hash

Returns response hash.

Parameters:

  • page_id (String)
  • payload (Hash)

Returns:

  • (Hash)

    response hash



268
269
270
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 268

def move_page_request(page_id, payload)
  request :post, move_page_path(page_id), payload
end

#multipart_clientObject



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



282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 282

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:



302
303
304
305
306
307
308
309
310
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 302

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:



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

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



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

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



327
328
329
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 327

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



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

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



341
342
343
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 341

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

#pages_pathString (frozen)

Returns page_path.

Returns:

  • (String (frozen))

    page_path



346
347
348
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 346

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



352
353
354
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 352

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



379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 379

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)


357
358
359
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 357

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

#retrieve_comments_request(block_id, query) ⇒ Object

Parameters:



363
364
365
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 363

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

#search(query) ⇒ Object



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

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

#search_pathObject



405
406
407
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 405

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)


410
411
412
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 410

def token=(token)
  @notion_token = token
end

#update_block_request(block_id, payload) ⇒ Object



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

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



433
434
435
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 433

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



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

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



440
441
442
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 440

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:



446
447
448
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 446

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



452
453
454
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 452

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

#user_request(user_id) ⇒ Hash

Returns response.

Parameters:

  • user_id (String)

Returns:

  • (Hash)

    response



458
459
460
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 458

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

#usersNotionRubyMapping::ListObject

Returns List Object for UserObject.

Returns:

  • (NotionRubyMapping::ListObject)

    List Object for UserObject



463
464
465
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 463

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



468
469
470
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 468

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

#users_request(query = Query.new) ⇒ Hash

Returns response.

Parameters:

Returns:

  • (Hash)

    response



475
476
477
# File 'lib/notion_ruby_mapping/controllers/notion_cache.rb', line 475

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