notion 1.0.7 → 1.1.4

data/lib/notion_api/notion_types/text_block.rb

@@ -1,16 +1,16 @@
 module NotionAPI
 
-    # good for just about anything (-:
-    class TextBlock < BlockTemplate
-      @notion_type = 'text'
-      @type = 'text'
-  
-      def type
-        NotionAPI::TextBlock.notion_type
-      end
-  
-      class << self
-        attr_reader :notion_type, :type
-      end
+  # good for just about anything (-:
+  class TextBlock < BlockTemplate
+    @notion_type = "text"
+    @type = "text"
+
+    def type
+      NotionAPI::TextBlock.notion_type
+    end
+
+    class << self
+      attr_reader :notion_type, :type
     end
-end
+  end
+end

data/lib/notion_api/notion_types/todo_block.rb

@@ -1,60 +1,60 @@
 module NotionAPI
 
-    # To-Do block: best for checklists and tracking to-dos.
-    class TodoBlock < BlockTemplate
-      @notion_type = 'to_do'
-      @type = 'to_do'
-  
-      def type
-        NotionAPI::TodoBlock.notion_type
-      end
-  
-      class << self
-        attr_reader :notion_type, :type
-      end
-  
-      def checked=(checked_value)
-        # ! change the checked property of the Todo Block.
-        # ! checked_value -> boolean value used to determine whether the block should be checked [yes] or not [no] : ``str``
-        # set static variables for request
-        cookies = Core.options['cookies']
-        headers = Core.options['headers']
-        request_url = URLS[:UPDATE_BLOCK]
-  
-        # set unique values for request
-        request_id = extract_id(SecureRandom.hex(16))
-        transaction_id = extract_id(SecureRandom.hex(16))
-        space_id = extract_id(SecureRandom.hex(16))
-        request_ids = {
-          request_id: request_id,
-          transaction_id: transaction_id,
-          space_id: space_id
-        }
-  
-        if %w[yes no].include?(checked_value.downcase)
-          checked_hash = Utils::BlockComponents.checked_todo(@id, checked_value.downcase)
-          last_edited_time_parent_hash = Utils::BlockComponents.last_edited_time(@parent_id)
-          last_edited_time_child_hash = Utils::BlockComponents.last_edited_time(@id)
-  
-          operations = [
-            checked_hash,
-            last_edited_time_parent_hash,
-            last_edited_time_child_hash
-          ]
-          request_body = build_payload(operations, request_ids)
-          response = HTTParty.post(
-            request_url,
-            body: request_body.to_json,
-            cookies: cookies,
-            headers: headers
-          )
-          unless response.code == 200; raise "There was an issue completing your request. Here is the response from Notion: #{response.body}, and here is the payload that was sent: #{operations}.
-             Please try again, and if issues persist open an issue in GitHub."; end
-  
-          true
-        else
-          false
-        end
+  # To-Do block: best for checklists and tracking to-dos.
+  class TodoBlock < BlockTemplate
+    @notion_type = "to_do"
+    @type = "to_do"
+
+    def type
+      NotionAPI::TodoBlock.notion_type
+    end
+
+    class << self
+      attr_reader :notion_type, :type
+    end
+
+    def checked=(checked_value)
+      # ! change the checked property of the Todo Block.
+      # ! checked_value -> boolean value used to determine whether the block should be checked [yes] or not [no] : ``str``
+      # set static variables for request
+      cookies = Core.options["cookies"]
+      headers = Core.options["headers"]
+      request_url = URLS[:UPDATE_BLOCK]
+
+      # set unique values for request
+      request_id = extract_id(SecureRandom.hex(16))
+      transaction_id = extract_id(SecureRandom.hex(16))
+      space_id = extract_id(SecureRandom.hex(16))
+      request_ids = {
+        request_id: request_id,
+        transaction_id: transaction_id,
+        space_id: space_id,
+      }
+
+      if %w[yes no].include?(checked_value.downcase)
+        checked_hash = Utils::BlockComponents.checked_todo(@id, checked_value.downcase)
+        last_edited_time_parent_hash = Utils::BlockComponents.last_edited_time(@parent_id)
+        last_edited_time_child_hash = Utils::BlockComponents.last_edited_time(@id)
+
+        operations = [
+          checked_hash,
+          last_edited_time_parent_hash,
+          last_edited_time_child_hash,
+        ]
+        request_body = build_payload(operations, request_ids)
+        response = HTTParty.post(
+          request_url,
+          body: request_body.to_json,
+          cookies: cookies,
+          headers: headers,
+        )
+        unless response.code == 200; raise "There was an issue completing your request. Here is the response from Notion: #{response.body}, and here is the payload that was sent: #{operations}.
+             Please try again, and if issues persist open an issue in GitHub.";         end
+
+        true
+      else
+        false
       end
     end
-end
+  end
+end

data/lib/notion_api/notion_types/toggle_block.rb

@@ -1,16 +1,16 @@
 module NotionAPI
 
-    # Toggle block: best for storing children blocks
-    class ToggleBlock < BlockTemplate
-      @notion_type = 'toggle'
-      @type = 'toggle'
-  
-      def type
-        NotionAPI::ToggleBlock.notion_type
-      end
-  
-      class << self
-        attr_reader :notion_type, :type
-      end
+  # Toggle block: best for storing children blocks
+  class ToggleBlock < BlockTemplate
+    @notion_type = "toggle"
+    @type = "toggle"
+
+    def type
+      NotionAPI::ToggleBlock.notion_type
+    end
+
+    class << self
+      attr_reader :notion_type, :type
     end
-end
+  end
+end

data/lib/notion_api/utils.rb

@@ -11,6 +11,27 @@ module Utils
   class BlockComponents
     # ! Each function defined here builds one component that is included in each request sent to Notions backend.
     # ! Each request sent will contain multiple components.
+
+    def self.build_payload(operations, request_ids)
+      # ! properly formats the payload for Notions backend.
+      # ! operations -> an array of hashes that define the operations to perform : ``Array[Hash]``
+      # ! request_ids -> the unique IDs for the request : ``str``
+      request_id = request_ids[:request_id]
+      transaction_id = request_ids[:transaction_id]
+      space_id = request_ids[:space_id]
+      payload = {
+        requestId: request_id,
+        transactions: [
+          {
+            id: transaction_id,
+            shardId: 955_090,
+            spaceId: space_id,
+            operations: operations,
+          },
+        ],
+      }
+      payload
+    end
     def self.create(block_id, block_type)
       # ! payload for creating a block.
       # ! block_id -> id of the new block : ``str``
@@ -220,18 +241,22 @@ module Utils
     end
 
     def self.row_location_add(last_row_id, block_id, view_id)
+      # ! add a new row to a Collection View table
+      # ! last_row_id -> ID of the last row in the CV : ``str``
+      # ! block_id -> ID of the blow : ``str``
+      # ! view_id -> ID of the View : ``str``
       {
         "table": "collection_view",
         "id": view_id,
         "path": [
-            "page_sort"
+          "page_sort",
         ],
         "command": "listAfter",
         "args": {
-            "after": last_row_id,
-            "id": block_id
-        }
-    }
+          "after": last_row_id,
+          "id": block_id,
+        },
+      }
     end
 
     def self.block_location_remove(block_parent_id, block_id)
@@ -289,6 +314,9 @@ module Utils
       }
     end
     def self.add_emoji_icon(block_id, icon)
+      # ! add an emoji icon for either a page or callout block
+      # ! block_id -> the ID of the block : ``str``
+      # ! icon -> the icon for the block. This is currently randomly chosen. : ``str``
       {
         id: block_id,
         table: "block",
@@ -296,6 +324,44 @@ module Utils
         command: "set", "args": icon,
       }
     end
+
+    def self.source(new_block_id, url)
+      # ! set the source for the ImageBlock
+      # ! new_block_id -> the ID of the new ImageBlock: ``str``
+      # ! url -> the URL for the image
+      table = "block"
+      path = ["properties"]
+      command = "update"
+
+      {
+        id: new_block_id,
+        table: table,
+        path: path,
+        command: command,
+        args: {
+          source: [[
+            url,
+          ]],
+        },
+      }
+    end
+
+    def self.display_source(new_block_id, block_url)
+      # ! set the display source for the ImageBlock
+      # ! new_block_id -> the ID of the new ImageBlock: ``str``
+      # ! block_url -> the URL of the ImageBlock: ``str``
+      {
+        id: new_block_id,
+        table: "block",
+        path: [
+          "format",
+        ],
+        command: "update",
+        args: {
+          display_source: block_url,
+        },
+      }
+    end
   end
 
   class CollectionViewComponents
@@ -459,6 +525,7 @@ module Utils
       datetime_mappings = ["date"]
       media_mappings = ["file"]
       person_mappings = ["person"]
+      page_mappings = ["relation"]
 
       table = "block"
       path = [
@@ -475,10 +542,12 @@ module Utils
         args = [["‣", [["d", { "type": "date", "start_date": value }]]]]
       elsif person_mappings.include?(mapping)
         args = [["‣",
-          [["u", value]]
-        ]]
-        else 
-          raise SchemaTypeError, "Invalid property type: #{mapping}"
+                 [["u", value]]]]
+      elsif page_mappings.include?(mapping)
+        args = [["‣",
+                 [["p", value]]]]
+      else
+        raise SchemaTypeError, "Invalid property type: #{mapping}"
       end
 
       {
@@ -494,12 +563,15 @@ module Utils
       table = "collection"
       path = ["schema", column, "options"]
       command = "keyedObjectListAfter"
+      colors = ["default", "gray", "brown", "orange", "yellow", "green", "blue", "purple", "pink", "red"]
+      random_color = colors[rand(0...colors.length)]
+
       args = {
         "value": {
-            "id": SecureRandom.hex(16),
-            "value": value,
-            "color": "green"
-        }
+          "id": SecureRandom.hex(16),
+          "value": value,
+          "color": random_color,
+        },
       }
 
       {
@@ -557,50 +629,7 @@ module Utils
       # ! payload for adding a column to the table.
       # ! collection_id -> the collection ID : ``str``
       # ! args -> the definition of the column : ``str``
-      args["format"] = {
-        "table_properties" => [
-          {
-            "property" => "title",
-            "visible" => true,
-            "width" => 280,
-          },
-          {
-            "property" => "aliases",
-            "visible" => true,
-            "width" => 200,
-          },
-          {
-            "property" => "category",
-            "visible" => true,
-            "width" => 200,
-          },
-          {
-            "property" => "description",
-            "visible" => true,
-            "width" => 200,
-          },
-          {
-            "property" => "ios_version",
-            "visible" => true,
-            "width" => 200,
-          },
-          {
-            "property" => "tags",
-            "visible" => true,
-            "width" => 200,
-          },
-          {
-                  "property" => "phone",
-                  "visible" => true,
-                  "width" => 200,
-                },
-          {
-            "property" => "unicode_version",
-            "visible" => true,
-            "width" => 200,
-          },
-        ],
-      }
+
       {
         id: collection_id,
         table: "collection",
@@ -610,20 +639,28 @@ module Utils
       }
     end
 
-    def self.update_property_value(page_id, column_name, new_value)
+    def self.update_property_value(page_id, column_name, new_value, column_type)
       # ! update the specified column_name to new_value
       # ! page_id -> the ID of the page: ``str``
       # ! column_name -> the name of the column ["property"] to update: ``str``
       # ! new_value -> the new value to assign to that column ["property"]: ``str``
+      # ! column_type -> the type of the property: ``str``
       table = "block"
       path = [
         "properties",
         column_name,
       ]
       command = "set"
-      args = [[
-        new_value,
-      ]]
+
+      if column_type == "relation"
+        args = [["‣", [[
+          "p", new_value,
+        ]]]]
+      else
+        args = [[
+          new_value,
+        ]]
+      end
 
       {
         id: page_id,
@@ -636,7 +673,7 @@ module Utils
   end
 
   class SchemaTypeError < StandardError
-    def initialize(msg="Custom exception that is raised when an invalid property type is passed as a mapping.", exception_type="schema_type")
+    def initialize(msg = "Custom exception that is raised when an invalid property type is passed as a mapping.", exception_type = "schema_type")
       @exception_type = exception_type
       super(msg)
     end
@@ -662,4 +699,4 @@ module Utils
     }
     payload
   end
-end
+end

data/lib/notion_api/version.rb

@@ -1,3 +1,3 @@
 module NotionAPI
-    VERSION = '1.0.7'
+    VERSION = '1.1.4'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: notion
 version: !ruby/object:Gem::Version
-  version: 1.0.7
+  version: 1.1.4
 platform: ruby
 authors:
 - Dan Murphy
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-12-06 00:00:00.000000000 Z
+date: 2021-01-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -42,16 +42,16 @@ dependencies:
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 2.1.0
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 2.1.0
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -122,6 +122,7 @@ files:
 - lib/notion_api/notion_types/header_block.rb
 - lib/notion_api/notion_types/image_block.rb
 - lib/notion_api/notion_types/latex_block.rb
+- lib/notion_api/notion_types/link_block.rb
 - lib/notion_api/notion_types/numbered_block.rb
 - lib/notion_api/notion_types/page_block.rb
 - lib/notion_api/notion_types/quote_block.rb
@@ -139,7 +140,7 @@ licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -154,8 +155,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key:
+rubygems_version: 3.0.3
+signing_key: 
 specification_version: 4
 summary: A lightweight gem that allows you to easily read, write, and update Notion
   data with Ruby