notion_ruby_mapping 3.0.5 → 3.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 129deebb939e145eb0c9adc431cbec81edb0d67cbefca8f38dfb7e2550a221b4
-  data.tar.gz: f82b0f5d77b8de97d0e31cd8f2cb583ba8ce80e58c68b9698359600e59b221e4
+  metadata.gz: a52b1e5d063d287acdc0bb5bfa88f48c666c3f8d550115db524cc4243dda5cc6
+  data.tar.gz: 4d38fd4b35fb0ac10c0302d04d726aaa5f43672e46c32700c8758ee5d481b406
 SHA512:
-  metadata.gz: 9bf2499aa0a6f91b97206325534eeb1bafa027727b1bc5a24798ad7c6fc7040aa3e24e84c02179f9916994c2bb59ba60600f3e7d7faaedeb5c61a721fd0e5d33
-  data.tar.gz: 624eb4a6364d528ceb413b7dda9dd946d41d72914372545f51c8785df4f654a9ee138615aac56d409b2f781ecc3d3933cbc14fa132943903a7a5841d5669a49a
+  metadata.gz: e2c267cbffaa97b9cb1c70f9b254c7e1976dd7956bb9359929d151905b82ee0ef459d75e585943765022aa921d5ec91176a40459b10b072a0feac00ef07da9bf
+  data.tar.gz: b8b05c7683b1bb6969db57dfce0656cf1c92529ec7167a5f9250c1cf80453e44df8dc7fc55501c4fab6515b3b10587e1d247c2aec9049eac4f520fdb7053b9d2

data/README.md

@@ -136,6 +136,7 @@ NotionRubyMapping.configuration { |c| c.notion_token = ENV["NOTION_API_TOKEN"] }
 
 ## 3. ChangeLog
 
+- 2026/1/25 [v3.0.6] add move page, list templates, and create child page to page
 - 2025/12/15 [v3.0.5] add AudioBlock
 - 2025/12/9 [v3.0.4] Fix the issue where page.parent could not be executed for pages with a data source as parent
 - 2025/10/25 [v3.0.3] Add default template option for create_child_page and build_child_page

data/lib/notion_ruby_mapping/blocks/base.rb

@@ -7,7 +7,7 @@ module NotionRubyMapping
     # @param [Hash, nil] json
     # @param [String, nil] id
     # @param [Array<Property, Class, String>] assign
-    def initialize(json: nil, id: nil, assign: [], parent: nil, template_page: nil)
+    def initialize(json: nil, id: nil, assign: [], parent: nil, template_page: nil, position: nil)
       @nc = NotionCache.instance
       @json = json
       @id = @nc.hex_id(id || @json && @json["id"])
@@ -23,6 +23,11 @@ module NotionRubyMapping
       elsif template_page
         payload_json["template"] = {"type" => "template_id", "template_id" => template_page.id}
       end
+      if %w[page_start page_end].include? position
+        payload_json["position"] = {"type" => position}
+      elsif position
+        payload_json["position"] = {"type" => "after_block", "after_block" => {"id" => position}}
+      end
       @payload = Payload.new(payload_json)
       @property_cache = nil
       @created_time = nil

data/lib/notion_ruby_mapping/blocks/data_source.rb

@@ -126,6 +126,13 @@ module NotionRubyMapping
       self
     end
 
+    # @param [Integer] page_size
+    # @return [NotionRubyMapping::List] List of Template object
+    def templates(page_size: nil)
+      json = @nc.list_data_source_templates_request(id, page_size: page_size)
+      List.new type: "template", value: id, json: json, query: Query.new
+    end
+
     # @return [Hash] created json for property schemas (for update data_source)
     def update_property_schema_json
       @payload.update_property_schema_json @property_cache, data_source_title

data/lib/notion_ruby_mapping/blocks/list.rb

@@ -23,6 +23,8 @@ module NotionRubyMapping
         @user_object = value
       when "search"
         @search = value
+      when "template"
+        @template = value
       end
       @query = query
       @index = 0
@@ -82,6 +84,11 @@ module NotionRubyMapping
                  query: -> { @nc.search @search.payload.merge(@query.query_json) },
                  create_object: ->(json) { Base.create_from_json json },
                  &block
+      elsif @template
+        each_sub base: @template,
+                 query: -> { @nc.list_data_source_templates_request @template, start_cursor: @query.start_cursor },
+                 create_object: ->(json) { TemplateObject.new json: json },
+                 &block
       end
       self
     end
@@ -125,7 +132,7 @@ module NotionRubyMapping
 
     # @return [Hash]
     def results
-      @json["results"]
+      @json[@template ? "templates" : "results"]
     end
   end
 end

data/lib/notion_ruby_mapping/blocks/page.rb

@@ -59,6 +59,40 @@ module NotionRubyMapping
       db.save dry_run: dry_run
     end
 
+    # @return [NotionRubyMapping::Base]
+    def build_child_page(template_page: nil, position: nil)
+      page = Page.new assign: [TitleProperty, "title"], parent: {"type" => "page_id", "page_id" => @id},
+                      template_page: template_page, position: position
+      pp = page.properties
+      pp.clear_will_update
+      yield page, pp if block_given?
+      page
+    end
+
+    # @param [Boolean] dry_run true if dry_run
+    # @return [NotionRubyMapping::Base]
+    def create_child_page(template_page: nil, position: nil, dry_run: false)
+      page = Page.new assign: [TitleProperty, "title"], parent: {"type" => "page_id", "page_id" => @id},
+                      template_page: template_page, position: position
+      pp = page.properties
+      pp.clear_will_update
+      yield page, pp if block_given?
+      page.save dry_run: dry_run
+    end
+
+    # @param [Page, DataSource] page_or_data_source
+    # @param [Boolean] dry_run true if dry_run
+    # @return [NotionRubyMapping::Page, String]
+    def move_to(page_or_data_source, dry_run: false)
+      key = page_or_data_source.is_a?(Page) ? "page_id" : "data_source_id"
+      json = {"parent" => {"type" => key, key => page_or_data_source.id}}
+      if dry_run
+        self.class.dry_run_script :post, @nc.move_page_path(@id), json
+      else
+        update_json @nc.move_page_request(@id, json)
+      end
+    end
+
     # @return [String] 公開URL
     def public_url
       @json["public_url"]

data/lib/notion_ruby_mapping/controllers/notion_cache.rb

@@ -243,6 +243,38 @@ module NotionRubyMapping
       "NotionCache"
     end
 
+    # @param [String] data_source_id
+    # @param [Integer] page_size
+    # @param [String] start_cursor
+    # @return [Hash] response hash
+    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
+
+    # @param [String] data_source_id
+    # @param [String] options
+    # @return [String] path
+    def list_data_source_templates_path(data_source_id, options = "")
+      "v1/data_sources/#{data_source_id}/templates#{options}"
+    end
+
+    # @param [String] page_id
+    # @param [Hash] payload
+    # @return [Hash] response hash
+    def move_page_request(page_id, payload)
+      request :post, move_page_path(page_id), payload
+    end
+
+    # @param [String] page_id
+    # @return [String] move_page_path
+    def move_page_path(page_id)
+      "v1/pages/#{page_id}/move"
+    end
+
     # @param [String] path
     # @param [String] fname
     # @param [Hash] options
@@ -427,7 +459,7 @@ module NotionRubyMapping
       request :get, user_path(user_id)
     end
 
-    # @return [Array<NotionRubyMapping::UserObject>] UserObject array
+    # @return [NotionRubyMapping::ListObject] List Object for UserObject
     def users
       List.new json: users_request, type: "user_object", value: true
     end

data/lib/notion_ruby_mapping/objects/template_object.rb

@@ -0,0 +1,19 @@
+module NotionRubyMapping
+  class TemplateObject
+    def initialize(json: json)
+      @id = json["id"]
+      @name = json["name"]
+      @is_default = json["is_default"]
+    end
+    attr_reader :id, :name, :is_default
+
+    # @return [Hash{String->String, Boolean}]
+    def property_values_json
+      {
+        "id" => @id,
+        "name" => @name,
+        "is_default" => @is_default
+      }
+    end
+  end
+end

data/lib/notion_ruby_mapping/properties/property.rb

@@ -157,7 +157,7 @@ module NotionRubyMapping
       !instance_of? Property
     end
 
-    # @param [Symbol] key query parameter
+    # @param [String] key query parameter
     # @param [Object] value query value
     # @return [NotionRubyMapping::Query] generated Query object
     def make_filter_query(key, value, condition: nil, another_type: nil)

data/lib/notion_ruby_mapping/properties/verification_property.rb

@@ -30,6 +30,17 @@ module NotionRubyMapping
       @json = json
     end
 
+    ## DataSource only methods
+
+    # @param [String, Number] value Query value
+    # @param [String] condition rollup Rollup name
+    # @param [String] another_type rollup_type Rollup type
+    # @return [NotionRubyMapping::Query] generated Query object
+    # @see https://www.notion.so/hkob/CheckboxProperty-ac1edbdb8e264af5ad1432b522b429fd#5f07c4ebc4744986bfc99a43827349fc
+    def filter_status(value, condition: nil, another_type: nil)
+      make_filter_query "status", value, condition: condition, another_type: another_type
+    end
+
     ## Page property only methods
 
     # @return [Hash]

data/lib/notion_ruby_mapping/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module NotionRubyMapping
-  VERSION = "3.0.5"
+  VERSION = "3.0.6"
   NOTION_VERSION = "2025-09-03"
 end

data/lib/notion_ruby_mapping.rb

@@ -15,7 +15,7 @@ require_relative "notion_ruby_mapping/version"
   controllers: %w[notion_cache payload property_cache query rich_text_array discussion_thread search mermaid
                   mermaid_data_source],
   objects: %w[rich_text_object emoji_object equation_object file_object mention_object text_object user_object
-              comment_object file_upload_object],
+              comment_object file_upload_object template_object],
   properties: %w[property checkbox_property multi_property created_by_property date_base_property created_time_property
                  date_property email_property files_property formula_property last_edited_by_property
                  last_edited_time_property multi_select_property number_property people_property phone_number_property

data/notion_ruby_mapping.gemspec

@@ -38,6 +38,9 @@ Gem::Specification.new do |spec|
   spec.add_dependency "faraday-multipart"
   spec.add_dependency "mime-types"
 
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "pry-byebug"
+  spec.add_development_dependency "rb-readline"
   spec.add_development_dependency "guard"
   spec.add_development_dependency "guard-rspec"
   spec.add_development_dependency "rake"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: notion_ruby_mapping
 version: !ruby/object:Gem::Version
-  version: 3.0.5
+  version: 3.0.6
 platform: ruby
 authors:
 - Hiroyuki KOBAYASHI
@@ -51,6 +51,48 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rb-readline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: guard
   requirement: !ruby/object:Gem::Requirement
@@ -238,6 +280,7 @@ files:
 - lib/notion_ruby_mapping/objects/file_upload_object.rb
 - lib/notion_ruby_mapping/objects/mention_object.rb
 - lib/notion_ruby_mapping/objects/rich_text_object.rb
+- lib/notion_ruby_mapping/objects/template_object.rb
 - lib/notion_ruby_mapping/objects/text_object.rb
 - lib/notion_ruby_mapping/objects/user_object.rb
 - lib/notion_ruby_mapping/properties/button_property.rb
@@ -289,7 +332,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.0
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Notion Ruby mapping tool
 test_files: []