notion_ruby_mapping 0.3.2 → 0.4.1

data/lib/notion_ruby_mapping/{list.rb → blocks/list.rb}

@@ -5,23 +5,54 @@ module NotionRubyMapping
   class List < Base
     include Enumerable
 
-    def initialize(json: nil, id: nil, database: nil, query: nil)
+    def initialize(json: nil, id: nil, database: nil, parent: nil, query: nil)
       super(json: json, id: id)
       @has_more = @json["has_more"]
       @load_all_contents = !@has_more
       @database = database
+      @parent = parent
       @query = query
       @index = 0
       @has_content = true
     end
     attr_reader :has_more
 
-    ### Public announced methods
 
+    # @return [NotionRubyMapping::List, Enumerator]
+    # @see https://www.notion.so/hkob/List-9a0b32335e0d48849a785ce5e162c760#12e1c261a0944a4095776b7515bef4a1
     def each
       return enum_for(:each) unless block_given?
 
-      if @database
+      if @parent
+        unless @has_content
+          unless @load_all_contents
+            @query.start_cursor = nil
+            @json = @parent.children @query
+            @has_more = @json["has_more"]
+          end
+          @index = 0
+          @has_content = true
+        end
+
+        while @has_content
+          if @index < results.length
+            object = Base.create_from_json(results[@index])
+            @index += 1
+            yield object
+          elsif @has_more
+            if @parent
+              @query.start_cursor = @json["next_cursor"]
+              @json = @parent.children @query
+              @index = 0
+              @has_more = @json["has_more"]
+            else
+              @has_content = false
+            end
+          else
+            @has_content = false
+          end
+        end
+      elsif @database
         unless @has_content # re-exec
           unless @load_all_contents
             @query.start_cursor = nil
@@ -51,6 +82,7 @@ module NotionRubyMapping
           end
         end
       end
+      self
     end
 
     private

data/lib/notion_ruby_mapping/blocks/page.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module NotionRubyMapping
+  # Notion page object
+  class Page < Base
+    ### Public announced methods
+
+    # @param [String] id
+    # @return [NotionRubyMapping::Page, String]
+    # @see https://www.notion.so/hkob/Page-d359650e3ca94424af8359a24147b9a0#7d868b8b81c3473082bbdc7370813a4a
+    def self.find(id, dry_run: false)
+      nc = NotionCache.instance
+      if dry_run
+        Base.dry_run_script :get, nc.page_path(id)
+      else
+        nc.page id
+      end
+    end
+
+    # @param [String] title
+    # @param [Array<String, Property>] assigns
+    # @return [NotionRubyMapping::Database]
+    # @see https://www.notion.so/hkob/Page-d359650e3ca94424af8359a24147b9a0#2e8ca5408afb4f83a92b7b84c0dc9903
+    def build_child_database(title, *assigns)
+      db = Database.new json: {"title" => [TextObject.new(title).property_values_json]},
+                        assign: assigns, parent: {"type" => "page_id", "page_id" => @id}
+      yield db, db.properties if block_given?
+      db
+    end
+
+    def create_child_database(title, *assigns, dry_run: false)
+      build_child_database title, *assigns
+      db = Database.new json: {"title" => [TextObject.new(title).property_values_json]},
+                        assign: assigns, parent: {"type" => "page_id", "page_id" => @id}
+      yield db, db.properties
+      db.save dry_run: dry_run
+    end
+
+    # @return [String] title
+    # @see https://www.notion.so/hkob/Page-d359650e3ca94424af8359a24147b9a0#2ff7209055f346fbbda454cdbb40b1c8
+    def title
+      properties.select { |p| p.is_a? TitleProperty }.map(&:full_text).join ""
+    end
+
+    protected
+
+    # @return [NotionRubyMapping::Base, String]
+    def create(dry_run: false)
+      if dry_run
+        dry_run_script :post, @nc.pages_path, :property_values_json
+      else
+        @new_record = false
+        update_json @nc.create_page_request(property_values_json)
+      end
+    end
+
+    # @return [Hash]
+    def reload_json
+      @nc.page_request @id
+    end
+
+    # @return [NotionRubyMapping::Base, String]
+    def update(dry_run: false)
+      if dry_run
+        dry_run_script :patch, @nc.page_path(@id), :property_values_json
+      else
+        update_json @nc.update_page_request(@id, property_values_json)
+      end
+    end
+  end
+end

data/lib/notion_ruby_mapping/{notion_cache.rb → controllers/notion_cache.rb}

@@ -11,6 +11,8 @@ module NotionRubyMapping
 
     ### initialize
 
+
+    # @see https://www.notion.so/hkob/NotionCache-65e1599864d6425686d495a5a4b3a623#dca210788f114cf59464090782c073bf
     def initialize
       @object_hash = {}
       @client = Faraday::Connection.new "https://api.notion.com" do |builder|
@@ -25,38 +27,42 @@ module NotionRubyMapping
     attr_reader :object_hash
     attr_writer :client # for test only
 
-    # @param [String] notion_token
-    # @return [NotionRubyMapping::NotionCache] self (NotionCache.instance)
-    def create_client(notion_token, wait: 0.3333, debug: false)
-      @notion_token = notion_token
-      @wait = wait
-      @debug = debug
-      self
+    # @param [String] page_id
+    # @return [String (frozen)] block_path
+    def append_block_children_block_path(block_id)
+      "v1/blocks/#{block_id}/children"
     end
 
-    ### create path methods
-
-    # @param [String] database_id
+    # @param [String] page_id
     # @return [String (frozen)] page_path
-    def database_path(database_id)
-      "v1/databases/#{database_id}"
+    def append_block_children_page_path(page_id)
+      "v1/blocks/#{page_id}/children"
     end
 
-    # @param [String] database_id
-    # @return [String (frozen)] page_path
-    def databases_path
-      "v1/databases"
+    # @param [String] id
+    # @param [Hash] payload
+    # @return [Hash]
+    def append_block_children_request(id, payload)
+      request :patch, append_block_children_block_path(id), payload
+    end
+
+    # @param [String] id block_id (with or without "-")
+    # @return [NotionRubyMapping::Base] Block object or nil
+    def block(id)
+      object_for_key(id) { block_request id }
     end
 
     # @param [String] page_id
     # @return [String (frozen)] page_path
-    def page_path(page_id)
-      "v1/pages/#{page_id}"
+    def block_children_page_path(page_id, query_string = "")
+      "v1/blocks/#{page_id}/children#{query_string}"
     end
 
-    # @return [String (frozen)] page_path
-    def pages_path
-      "v1/pages"
+    # @param [String] id
+    # @param [String] query_string
+    # @return [Hash]
+    def block_children_request(id, query_string)
+      request :get, block_children_page_path(id, query_string)
     end
 
     # @param [String] block_id
@@ -65,84 +71,85 @@ module NotionRubyMapping
       "v1/blocks/#{block_id}"
     end
 
-    # @param [String] database_id
-    # @return [String (frozen)] page_path
-    def query_database_path(database_id)
-      "v1/databases/#{database_id}/query"
+    # @param [String] block_id
+    # @return [Hash] response
+    def block_request(block_id)
+      request :get, block_path(block_id)
     end
 
-    ### Notion API call
+    # @return [Hash]
+    def clear_object_hash
+      @object_hash = {}
+    end
 
-    # @param [Symbol] method
-    # @param [String] path
-    # @param [Hash] options
-    # @return [Hash] response hash
-    def request(method, path, options = {})
-      raise "Please call `NotionCache.create_client' before using other methods" unless @notion_token
+    # @param [String] notion_token
+    # @return [NotionRubyMapping::NotionCache] self (NotionCache.instance)
+    def create_client(notion_token, wait: 0.3333, debug: false)
+      @notion_token = notion_token
+      @wait = wait
+      @debug = debug
+      self
+    end
 
-      sleep @wait
-      response = @client.send(method) do |request|
-        request.headers["Authorization"] = "Bearer #{@notion_token}"
-        request.headers["Notion-Version"] = NotionRubyMapping::NOTION_VERSION
-        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
+    # @param [Hash] payload
+    # @return [Hash] response
+    def create_database_request(payload)
+      request :post, databases_path, payload
     end
 
-    # @param [String] page_id
+    # @param [Hash] payload
     # @return [Hash] response
-    def page_request(page_id)
-      request :get, page_path(page_id)
+    def create_page_request(payload)
+      request :post, "v1/pages", payload
+    end
+
+    # @param [String] id database_id (with or without "-")
+    # @return [NotionRubyMapping::Base] Database object or nil
+    def database(id)
+      object_for_key(id) { database_request id }
     end
 
     # @param [String] database_id
-    # @return [Hash] response
-    def database_request(database_id)
-      request :get, database_path(database_id)
+    # @return [String (frozen)] page_path
+    def database_path(database_id)
+      "v1/databases/#{database_id}"
+    end
+
+    # @param [String] id page_id / block_id (with or without "-")
+    # @param [NotionRubyMapping::Query] query query object
+    # @return [NotionRubyMapping::Base] List object
+    def database_query(id, query)
+      Base.create_from_json database_query_request(id, query.query_json)
     end
 
     def database_query_request(database_id, payload)
       request :post, "v1/databases/#{database_id}/query", payload
     end
 
-    # @param [String] block_id
+    # @param [String] database_id
     # @return [Hash] response
-    def block_request(block_id)
-      request :get, block_path(block_id)
+    def database_request(database_id)
+      request :get, database_path(database_id)
     end
 
     # @param [String] database_id
-    # @return [Hash] response
-    def update_database_request(database_id, payload)
-      request :patch, "v1/databases/#{database_id}", payload
+    # @return [String (frozen)] page_path
+    def databases_path
+      "v1/databases"
     end
 
-    # @param [String] page_id
-    # @param [Hash] payload
-    # @return [Hash] response
-    def update_page_request(page_id, payload)
-      request :patch, "v1/pages/#{page_id}", payload
+    # @return [NotionRubyMapping::Base]
+    def destroy_block(id)
+      Base.create_from_json destroy_block_request(id)
     end
 
-    # @param [Hash] payload
-    # @return [Hash] response
-    def create_page_request(payload)
-      request :post, "v1/pages", payload
+    # @param [Hash] response
+    def destroy_block_request(id)
+      request :delete, block_path(id)
     end
 
-    def create_database_request(payload)
-      request :post, databases_path, payload
+    def inspect
+      "NotionCache"
     end
 
     # @param [String] id id string with "-"
@@ -167,34 +174,54 @@ module NotionRubyMapping
       object_for_key(id) { page_request id }
     end
 
-    # @param [String] id database_id (with or without "-")
-    # @return [NotionRubyMapping::Base] Database object or nil
-    def database(id)
-      object_for_key(id) { database_request id }
+    # @param [String] page_id
+    # @return [String (frozen)] page_path
+    def page_path(page_id)
+      "v1/pages/#{page_id}"
     end
 
-    # @param [String] id block_id (with or without "-")
-    # @return [NotionRubyMapping::Base] Block object or nil
-    def block(id)
-      object_for_key(id) { block_request id }
+    # @param [String] page_id
+    # @return [Hash] response
+    def page_request(page_id)
+      request :get, page_path(page_id)
     end
 
-    # @param [String] id page_id / block_id (with or without "-")
-    # @return [NotionRubyMapping::Base] List object
-    def block_children(id)
-      array = []
-      sleep @wait
-      @client.block_children(block_id: id, sleep_interval: @wait, max_retries: 20) do |page|
-        array.concat page.results
-      end
-      Base.create_from_json({"object" => "list", "results" => array})
+    # @return [String (frozen)] page_path
+    def pages_path
+      "v1/pages"
     end
 
-    # @param [String] id page_id / block_id (with or without "-")
-    # @param [NotionRubyMapping::Query] query query object
-    # @return [NotionRubyMapping::Base] List object
-    def database_query(id, query)
-      Base.create_from_json database_query_request(id, query.query_json)
+    # @param [String] database_id
+    # @return [String (frozen)] page_path
+    def query_database_path(database_id)
+      "v1/databases/#{database_id}/query"
+    end
+
+    # @param [Symbol] method
+    # @param [String] path
+    # @param [Hash] options
+    # @return [Hash] response hash
+    def request(method, path, options = {})
+      raise "Please call `NotionCache.create_client' before using other methods" unless @notion_token
+
+      sleep @wait
+      response = @client.send(method) do |request|
+        request.headers["Authorization"] = "Bearer #{@notion_token}"
+        request.headers["Notion-Version"] = NotionRubyMapping::NOTION_VERSION
+        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
 
     # @param [String] id page_id (with or without "-")
@@ -204,9 +231,18 @@ module NotionRubyMapping
       @client.update_database payload.merge({database_id: id})
     end
 
-    # @return [Hash]
-    def clear_object_hash
-      @object_hash = {}
+    # @param [String] database_id
+    # @return [Hash] response
+    def update_database_request(database_id, payload)
+      request :patch, "v1/databases/#{database_id}", payload
+    end
+
+    # @param [String] page_id
+    # @param [Hash] payload
+    # @return [Hash] response
+    def update_page_request(page_id, payload)
+      request :patch, "v1/pages/#{page_id}", payload
     end
+
   end
 end

data/lib/notion_ruby_mapping/{property_cache.rb → controllers/property_cache.rb}

@@ -13,22 +13,20 @@ module NotionRubyMapping
 
     # @param [String] key
     # @return [Property] Property for key
+    # @see https://www.notion.so/hkob/PropertyCache-2451fa64a814432db4809831cc77ba25#9709e2b2a7a0479f9951291a501f65c8
     def [](key)
       @properties[key] ||= Property.create_from_json key, @json[key], @base_type
     end
 
-    # @param [Array] key
-    # @return [Array]
-    def values_at(*key)
-      generate_all_properties
-      @properties.values_at(*key)
+    # @param [Property] property added Property
+    def add_property(property)
+      @properties[property.name] = property
+      self
     end
 
-    def generate_all_properties
-      if @json.empty?
-        @properties.values
-      else
-        @json.keys.map { |key| self[key] }
+    def clear_will_update
+      @properties.each do |_, property|
+        property.clear_will_update
       end
     end
 
@@ -39,16 +37,11 @@ module NotionRubyMapping
       generate_all_properties.each(&block)
     end
 
-    # @param [Property] property added Property
-    def add_property(property)
-      @properties[property.name] = property
-      self
-    end
-
-
-    def clear_will_update
-      @properties.each do |_, property|
-        property.clear_will_update
+    def generate_all_properties
+      if @json.empty?
+        @properties.values
+      else
+        @json.keys.map { |key| self[key] }
       end
     end
 
@@ -81,5 +74,13 @@ module NotionRubyMapping
         end
       end
     end
+
+    # @param [Array] key
+    # @return [Array]
+    # @see https://www.notion.so/hkob/PropertyCache-2451fa64a814432db4809831cc77ba25#6eb10d1d85784063a30feb225f47ede3
+    def values_at(*key)
+      generate_all_properties
+      @properties.values_at(*key)
+    end
   end
 end

data/lib/notion_ruby_mapping/{query.rb → controllers/query.rb}

@@ -14,22 +14,11 @@ module NotionRubyMapping
 
     # @param [Query] other_query other query
     # @return [NotionRubyMapping::Query] updated self (Query object)
-    def and(other_query)
+    def and(another_query)
       if @filter.key? "and"
-        @filter["and"] << other_query.filter
+        @filter["and"] << another_query.filter
       else
-        @filter = {"and" => [@filter, other_query.filter]}
-      end
-      self
-    end
-
-    # @param [Query] other_query other query
-    # @return [NotionRubyMapping::Query] updated self (Query object)
-    def or(other_query)
-      if @filter.key? "or"
-        @filter["or"] << other_query.filter
-      else
-        @filter = {"or" => [@filter, other_query.filter]}
+        @filter = {"and" => [@filter, another_query.filter]}
       end
       self
     end
@@ -50,14 +39,33 @@ module NotionRubyMapping
       self
     end
 
+    # @param [Query] other_query other query
+    # @return [NotionRubyMapping::Query] updated self (Query object)
+    def or(other_query)
+      if @filter.key? "or"
+        @filter["or"] << other_query.filter
+      else
+        @filter = {"or" => [@filter, other_query.filter]}
+      end
+      self
+    end
+
     # @return [Hash]
     def query_json
       parameters = {}
-      parameters[:filter] = filter unless filter.empty?
-      parameters[:sorts] = sort unless sort.empty?
-      parameters[:start_cursor] = start_cursor if start_cursor
-      parameters[:page_size] = page_size if page_size
+      parameters[:filter] = @filter unless @filter.empty?
+      parameters[:sorts] = @sort unless @sort.empty?
+      parameters[:start_cursor] = @start_cursor if @start_cursor
+      parameters[:page_size] = @page_size if @page_size
       parameters
     end
+
+    # @return [String (frozen)]
+    def query_string
+      ans = []
+      ans << "page_size=#{@page_size}" if @page_size
+      ans << "start_cursor=#{@start_cursor}" if @start_cursor
+      ans.empty? ? "" : "?#{ans.join("&")}"
+    end
   end
 end

data/lib/notion_ruby_mapping/{rich_text_array.rb → controllers/rich_text_array.rb}

@@ -19,6 +19,32 @@ module NotionRubyMapping
                            end
       @will_update = will_update
     end
+    attr_writer :will_update
+
+    def self.rich_text_array(key, text_objects = nil)
+      if text_objects.nil?
+        RichTextArray.new key
+      elsif text_objects.is_a? RichTextArray
+        text_objects
+      else
+        RichTextArray.new key, text_objects: text_objects
+      end
+    end
+
+    # @param [String, RichTextObject] to
+    # @return [NotionRubyMapping::RichTextObject] added RichTextObject
+    def <<(to)
+      @will_update = true
+      rto = RichTextObject.text_object(to)
+      @rich_text_objects << rto
+      rto
+    end
+
+    # @param [Numeric] index index number
+    # @return [RichTextObject] selected RichTextObject
+    def [](index)
+      @rich_text_objects[index]
+    end
 
     # @param [Array] json
     # @return [Array] RichTextArray
@@ -62,20 +88,5 @@ module NotionRubyMapping
     def will_update
       @will_update || @rich_text_objects.map(&:will_update).any?
     end
-
-    # @param [String, RichTextObject] to
-    # @return [NotionRubyMapping::RichTextObject] added RichTextObject
-    def <<(to)
-      @will_update = true
-      rto = RichTextObject.text_object(to)
-      @rich_text_objects << rto
-      rto
-    end
-
-    # @param [Numeric] index index number
-    # @return [RichTextObject] selected RichTextObject
-    def [](index)
-      @rich_text_objects[index]
-    end
   end
 end

data/lib/notion_ruby_mapping/objects/emoji_object.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module NotionRubyMapping
+  # TextObject
+  class EmojiObject
+    # @param [String] emoji
+    # @return [TextObject]
+    def initialize(emoji: nil, json: {})
+      @emoji = emoji || json && json["emoji"]
+      @will_update = false
+    end
+    attr_reader :will_update, :emoji
+
+    # @param [EmojiObject, String] uo
+    # @return [EmojiObject] self or created EmojiObject
+    # @see https://www.notion.so/hkob/EmojiObject-4a0d41a10a81490f82471059c5b39b1b#959b7d74c1a54e488b39a96ac8f634e5
+    def self.emoji_object(emoji_or_eo)
+      if emoji_or_eo.is_a? EmojiObject
+        emoji_or_eo
+      else
+        EmojiObject.new emoji: emoji_or_eo
+      end
+    end
+
+    # @param [String] emoji
+    # @see https://www.notion.so/hkob/EmojiObject-4a0d41a10a81490f82471059c5b39b1b#b0520d80de084c1c99e8595db9d36542
+    def emoji=(emoji)
+      @emoji = emoji
+      @will_update = true
+    end
+
+    # @return [Hash]
+    def property_values_json
+      {
+        "type" => "emoji",
+        "emoji" => @emoji,
+      }
+    end
+  end
+end