notion 1.0.4 → 1.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b63efe4325f07f105d8c2efb29e5037737651d330723a745d78bdc66bc02e32
-  data.tar.gz: 7e32f2d257d3d58ee3b29f6cbfdc3f901c88985a20e6980927265932afdb6e02
+  metadata.gz: 529d9a75b50731156f263184b27628a2ee6b0b0cd798e3f3b44e5ea3f7106c60
+  data.tar.gz: eb5b69ebe9b9d34215d6da17e8c2999761e9242b2618afaaa6583ee09691c65d
 SHA512:
-  metadata.gz: 970d6921cbe05fc19a5c610c24cd995832adc45c95bb6a1710ad2a22be86a7c6c8ec3078e7d95b6a042cd0e732fc293e70a0cacd97410c1d111ee7c4a3a99880
-  data.tar.gz: 72bc8e752d9f2aad62a9eeb5b91322bb623ee42b21370392285ffaf4ac16c5b8c795584c5dc0682f905a11cdb13b3f9803148ec3f9f784299cb7f004bd95bf30
+  metadata.gz: '09ec6f516f22fac9f2b9c7c2efc3df164f83a745414cb18f092a6df939625435a77883712b86e100d7062536b189ddd8115145a52528cd5cc81767029f3bd250'
+  data.tar.gz: b643a46d9682d2ebb612c0d0c37454344f0f9abb580c1cf258887bc7a242afdc22af155c78b87434a00c38a048b206351ad453477d5c914393b1ff4ac68aeb97

data/README.md

@@ -8,18 +8,23 @@
 - Check out the [Gem](https://rubygems.org/gems/notion)!
 
 ## Table of Contents
-- [Getting Started](#getting-started)
-  * [Installation](#installation)
-- [Retrieving a Page](#retrieving-a-page)
-- [Retrieving a Block within the Page](#retrieving-a-block-within-the-page)
-  * [Get a Block](#get-a-block)
-  * [Get a Collection View - Table](#get-a-collection-view---table)
-- [Creating New Blocks](#creating-new-blocks)
-  * [Create a block whose parent is the page](#create-a-block-whose-parent-is-the-page)
-  * [Create a block whose parent is another block](#create-a-block-whose-parent-is-another-block)
-- [Creating New Collections](#creating-new-collections)
-- [Troubleshooting](#troubleshooting)
-  * [No results returned when attempting to get a page](#no-results-returned-when-attempting-to-get-a-page)
+- [Unofficial Notion Client for Ruby.](#unofficial-notion-client-for-ruby)
+  - [Table of Contents](#table-of-contents)
+  - [Getting Started](#getting-started)
+    - [Installation](#installation)
+  - [Retrieving a Page](#retrieving-a-page)
+  - [Retrieving a CollectionView Page](#retrieving-a-collectionview-page)
+  - [Retrieving a Block within the Page](#retrieving-a-block-within-the-page)
+    - [Get a Block](#get-a-block)
+    - [Get a Collection View](#get-a-collection-view)
+  - [Creating New Blocks](#creating-new-blocks)
+    - [Create a block whose parent is the page](#create-a-block-whose-parent-is-the-page)
+    - [Create a block whose parent is another block](#create-a-block-whose-parent-is-another-block)
+  - [Creating New Collections](#creating-new-collections)
+  - [Updating Collection View Cells](#updating-collection-view-cells)
+  - [Troubleshooting](#troubleshooting)
+    - [No results returned when attempting to get a page](#no-results-returned-when-attempting-to-get-a-page)
+    - [Retrieve a full-page Collection View](#retrieve-a-full-page-collection-view)
 
 ## Getting Started
 ### Installation
@@ -60,6 +65,8 @@ The following attributes can be read from any block class instance:
 To update the title of the page:
 ![Update the title of a page](https://github.com/danmurphy1217/notion-ruby/blob/master/gifs/change_title.gif)
 
+## Retrieving a CollectionView Page
+This is achieved by passing the ID of the Collection View to the `get_page` method. Currently, the full URL of a Collection View Page is not supported (next up on the features list!). Once you retrieve the Collection View Page, all of the methods exposed to a normal Collection View instance are available (such as `.rows`, `.row(<row_id>)`, and all else outlined in [Updating a Collection](#updating-collection-view-cells)).
 ## Retrieving a Block within the Page
 Now that you have retrieved a Notion Page, you have full access to the blocks on that page. You can retrieve a specific block or collection view, retrieve all children IDs (array of children IDs), or retrieve all children (array of children class instances).
 
@@ -268,6 +275,28 @@ The first argument passed to `create_collection` determines which type of collec
 4. timeline
 5. gallery
 
+## Updating Collection View Cells
+When you retrieve a `CollectionViewRow` instance with `.row(<row_id>)` or a list of `CollectionViewRow` instances with `.rows`, a handful of methods are created. Each row instance has access attributes that represent the properties in the Notion Collection View. So, let's say we are working with the following Notion Collection View:
+| emoji | description  | category            | aliases | tags    | unicode_version | ios_version |
+|-------|--------------|---------------------|---------|---------|-----------------|-------------|
+| 😉     | "winking face" | "Smileys & Emotion" | "wink"  | "flirt" | "6.0"           | "6.0"       |
+
+If you wanted to update the unicode and ios versions, you could use the following code:
+```ruby
+>>> collection_view = @page.get_collection("1234567") # the ID of the collection block is 1234567
+>>> rows = collection_view.rows
+>>> row[0].unicode_version = "updated version here!"
+>>> row[0].ios_version = "I was updated too!"
+```
+Now, your Collection View will look like this:
+| emoji | description  | category            | aliases | tags    | unicode_version | ios_version |
+|-------|--------------|---------------------|---------|---------|-----------------|-------------|
+| 😉     |   "winking face"   | "Smileys & Emotion" | "wink"  | "flirt" | "updated version here!"          | "I was updated too!" |
+
+You can also add new rows with the `.add_row({<data!>})` method and add new properties with the `.add_property("name_of_property", "type_of_property")` method.
+
+**One important thing to be aware of:**
+When adding a row with `.add_row`, the hash of data passed must be in the same order as it appears in your Notion Collection View.
 ## Troubleshooting
 ### No results returned when attempting to get a page
 If an empty hash is returned when you attempt to retrieve a Notion page, you'll need to include the `x-notion-active-user-header` when instantiating the Notion Client.
@@ -280,4 +309,9 @@ From here, you can instantiate the Notion Client with the following code:
   "<insert_x_notion_active_user_header_here>"
 )
 ```
-
+### Retrieve a full-page Collection View
+Currently, either a "normal" Page URL or the Page Block ID is accepted to the `get_page` method. Therefore, if you pass the full URL to the CV Table, it will raise an error:
+```text
+the URL or ID passed to the get_page method must be that of a Page Block.
+```
+To avoid this, you must pass only the ID of the full-page collection-view to the `get_page` method. This is next up on the features list, so passing the full URL will be supported soon:smile:

data/lib/notion_api/core.rb

@@ -54,8 +54,14 @@ module NotionAPI
         collection_id = extract_collection_id(block_id, jsonified_record_response)
         block_title = extract_collection_title(clean_id, collection_id, jsonified_record_response)
         view_id = extract_view_ids(block_id, jsonified_record_response)[0]
-
-        CollectionViewPage.new(block_id, block_title, block_parent_id, collection_id, view_id)
+        schema = extract_collection_schema(collection_id, view_id, jsonified_record_response)
+        column_mappings = schema.keys
+        column_names = column_mappings.map { |mapping| schema[mapping]['name']}
+
+        collection_view_page = CollectionViewPage.new(block_id, block_title, block_parent_id, collection_id, view_id)
+        collection_view_page.instance_variable_set(:@column_names, column_names)
+        CollectionView.class_eval{attr_reader :column_names}
+        collection_view_page
       end
     end
 
@@ -244,5 +250,47 @@ module NotionAPI
         raise ArgumentError, 'Expected a Notion page URL or a page ID. Please consult the documentation for further information.'
       end
     end
+
+    def extract_collection_schema(collection_id, view_id, response = {})
+      # ! retrieve the collection scehma. Useful for 'building' the backbone for a table.
+      # ! collection_id -> the collection ID : ``str``
+      # ! view_id -> the view ID : ``str``
+      cookies = Core.options['cookies']
+      headers = Core.options['headers']
+
+      if response.empty?
+        query_collection_hash = Utils::CollectionViewComponents.query_collection(collection_id, view_id, '')
+
+        request_url = URLS[:GET_COLLECTION]
+        response = HTTParty.post(
+          request_url,
+          body: query_collection_hash.to_json,
+          cookies: cookies,
+          headers: headers
+        )
+        response['recordMap']['collection'][collection_id]['value']['schema']
+      else
+        response['collection'][collection_id]['value']['schema']
+      end
+    end
+    
+    def extract_collection_data(collection_id, view_id)
+      # ! retrieve the collection scehma. Useful for 'building' the backbone for a table.
+      # ! collection_id -> the collection ID : ``str``
+      # ! view_id -> the view ID : ``str``
+      cookies = Core.options['cookies']
+      headers = Core.options['headers']
+
+      query_collection_hash = Utils::CollectionViewComponents.query_collection(collection_id, view_id, '')
+
+      request_url = URLS[:GET_COLLECTION]
+      response = HTTParty.post(
+        request_url,
+        body: query_collection_hash.to_json,
+        cookies: cookies,
+        headers: headers
+      )
+      response['recordMap']
+    end
   end
 end

data/lib/notion_api/notion_types/collection_view_blocks.rb

@@ -1,243 +1,315 @@
 module NotionAPI
-    # collection views such as tables and timelines.
-    class CollectionView < Core
-      attr_reader :id, :title, :parent_id, :collection_id, :view_id
-  
-      @notion_type = 'collection_view'
-      @type = 'collection_view'
-  
-      def type
-        NotionAPI::CollectionView.notion_type
-      end
-  
-      class << self
-        attr_reader :notion_type, :type
-      end
-  
-      def initialize(id, title, parent_id, collection_id, view_id)
-        @id = id
-        @title = title
-        @parent_id = parent_id
-        @collection_id = collection_id
-        @view_id = view_id
-      end
-  
-      def add_row(data)
-        # ! add new row to Collection View table.
-        # ! data -> data to add to table : ``hash``
-  
-        cookies = Core.options['cookies']
-        headers = Core.options['headers']
-  
-        request_id = extract_id(SecureRandom.hex(16))
-        transaction_id = extract_id(SecureRandom.hex(16))
-        space_id = extract_id(SecureRandom.hex(16))
-        new_block_id = extract_id(SecureRandom.hex(16))
-        schema = extract_collection_schema(@collection_id, @view_id)
-        keys = schema.keys
-        col_map = {}
-        keys.map { |key| col_map[schema[key]['name']]  = key }
-  
-        request_ids = {
-          request_id: request_id,
-          transaction_id: transaction_id,
-          space_id: space_id
-        }
-  
-        instantiate_row = Utils::CollectionViewComponents.add_new_row(new_block_id)
-        set_block_alive = Utils::CollectionViewComponents.set_collection_blocks_alive(new_block_id, @collection_id)
-        new_block_edited_time = Utils::BlockComponents.last_edited_time(new_block_id)
-        parent_edited_time = Utils::BlockComponents.last_edited_time(@parent_id)
-  
-        operations = [
-          instantiate_row,
-          set_block_alive,
-          new_block_edited_time,
-          parent_edited_time
-        ]
-  
-        data.keys.each_with_index do |col_name, j|
-          child_component = Utils::CollectionViewComponents.insert_data(new_block_id, j.zero? ? 'title' : col_map[col_name], data[col_name], j.zero? ? schema['title']["type"] : schema[col_map[col_name]]['type'])
-          operations.push(child_component)
-        end
-  
-        request_url = URLS[:UPDATE_BLOCK]
-        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
-  
-           NotionAPI::CollectionViewRow.new(new_block_id, @parent_id, @collection_id, @view_id)
-      end
-  
-      def add_property(name, type)
-        # ! add a property (column) to the table.
-        # ! name -> name of the property : ``str``
-        # ! type -> type of the property : ``str``
-        cookies = Core.options['cookies']
-        headers = Core.options['headers']
-  
-        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
-        }
-  
-        # create updated schema
-        schema = extract_collection_schema(@collection_id, @view_id)
-        schema[name] = {
-          name: name,
-          type: type
-        }
-        new_schema = {
-          schema: schema
-        }
-  
-        add_collection_property = Utils::CollectionViewComponents.add_collection_property(@collection_id, new_schema)
-  
-        operations = [
-          add_collection_property
-        ]
-  
-        request_url = URLS[:UPDATE_BLOCK]
-        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
+  # collection views such as tables and timelines.
+  class CollectionView < Core
+    attr_reader :id, :title, :parent_id, :collection_id, :view_id
+
+    @notion_type = "collection_view"
+    @type = "collection_view"
+
+    def type
+      NotionAPI::CollectionView.notion_type
+    end
+
+    class << self
+      attr_reader :notion_type, :type
+    end
+
+    def initialize(id, title, parent_id, collection_id, view_id)
+      @id = id
+      @title = title
+      @parent_id = parent_id
+      @collection_id = collection_id
+      @view_id = view_id
+    end
+
+    def add_row(data)
+      # ! add new row to Collection View table.
+      # ! data -> data to add to table : ``hash``
+
+      cookies = Core.options["cookies"]
+      headers = Core.options["headers"]
+
+      request_id = extract_id(SecureRandom.hex(16))
+      transaction_id = extract_id(SecureRandom.hex(16))
+      space_id = extract_id(SecureRandom.hex(16))
+      new_block_id = extract_id(SecureRandom.hex(16))
+      schema = extract_collection_schema(@collection_id, @view_id)
+      keys = schema.keys
+      col_map = {}
+      keys.map { |key| col_map[schema[key]["name"]] = key }
+
+      request_ids = {
+        request_id: request_id,
+        transaction_id: transaction_id,
+        space_id: space_id,
+      }
+
+      instantiate_row = Utils::CollectionViewComponents.add_new_row(new_block_id)
+      set_block_alive = Utils::CollectionViewComponents.set_collection_blocks_alive(new_block_id, @collection_id)
+      new_block_edited_time = Utils::BlockComponents.last_edited_time(new_block_id)
+      parent_edited_time = Utils::BlockComponents.last_edited_time(@parent_id)
+
+      operations = [
+        instantiate_row,
+        set_block_alive,
+        new_block_edited_time,
+        parent_edited_time,
+      ]
+
+      data.keys.each_with_index do |col_name, j|
+        child_component = Utils::CollectionViewComponents.insert_data(new_block_id, j.zero? ? "title" : col_map[col_name], data[col_name], j.zero? ? schema["title"]["type"] : schema[col_map[col_name]]["type"])
+        operations.push(child_component)
       end
-  
-      def row(row_id)
-        # ! retrieve a row from a CollectionView Table.
-        # ! row_id -> the ID for the row to retrieve: ``str``
-        clean_id = extract_id(row_id)
-  
-        request_body = {
-          pageId: clean_id,
-          chunkNumber: 0,
-          limit: 100,
-          verticalColumns: false
-        }
+
+      request_url = URLS[:UPDATE_BLOCK]
+      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
+
+      NotionAPI::CollectionViewRow.new(new_block_id, @parent_id, @collection_id, @view_id)
+    end
+
+    def add_property(name, type)
+      # ! add a property (column) to the table.
+      # ! name -> name of the property : ``str``
+      # ! type -> type of the property : ``str``
+      cookies = Core.options["cookies"]
+      headers = Core.options["headers"]
+
+      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,
+      }
+
+      # create updated schema
+      schema = extract_collection_schema(@collection_id, @view_id)
+      schema[name] = {
+        name: name,
+        type: type,
+      }
+      new_schema = {
+        schema: schema,
+      }
+
+      add_collection_property = Utils::CollectionViewComponents.add_collection_property(@collection_id, new_schema)
+
+      operations = [
+        add_collection_property,
+      ]
+
+      request_url = URLS[:UPDATE_BLOCK]
+      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
+    end
+
+    def row(row_id)
+      # ! retrieve a row from a CollectionView Table.
+      # ! row_id -> the ID for the row to retrieve: ``str``
+      clean_id = extract_id(row_id)
+
+      request_body = {
+        pageId: clean_id,
+        chunkNumber: 0,
+        limit: 100,
+        verticalColumns: false,
+      }
+      jsonified_record_response = get_all_block_info(clean_id, request_body)
+
+      i = 0
+      while jsonified_record_response.empty? || jsonified_record_response["block"].empty?
+        return {} if i >= 10
+
         jsonified_record_response = get_all_block_info(clean_id, request_body)
-        schema = extract_collection_schema(@collection_id, @view_id)
-        keys = schema.keys
-        column_names = keys.map { |key| schema[key]['name'] }
-        i = 0
-        while jsonified_record_response.empty? || jsonified_record_response['block'].empty?
-          return {} if i >= 10
-  
-          jsonified_record_response = get_all_block_info(clean_id, request_body)
-          i += 1
-        end
-        row_jsonified_response = jsonified_record_response['block'][clean_id]['value']['properties']
-        row_data = {}
-        keys.each_with_index { |key, idx| row_data[column_names[idx]] = row_jsonified_response[key] ? row_jsonified_response[key].flatten : [] }
-        row_data
+        i += 1
       end
-  
-      def row_ids
-        # ! retrieve all Collection View table rows.
-        clean_id = extract_id(@id)
-  
-        request_body = {
-          pageId: clean_id,
-          chunkNumber: 0,
-          limit: 100,
-          verticalColumns: false
-        }
-  
+
+      collection_data = extract_collection_data(@collection_id, @view_id)
+      schema = collection_data["collection"][collection_id]["value"]["schema"]
+      column_mappings = schema.keys
+      column_names = column_mappings.map { |mapping| schema[mapping]["name"] }
+
+      collection_row = CollectionViewRow.new(row_id, @parent_id, @collection_id, @view_id)
+      collection_row.instance_variable_set(:@column_names, column_names)
+      CollectionViewRow.class_eval { attr_reader :column_names }
+
+      row_data = collection_data["block"][collection_row.id]
+      create_singleton_methods_and_instance_variables(collection_row, row_data)
+
+      collection_row
+    end
+
+    def row_ids
+      # ! retrieve all Collection View table rows.
+      clean_id = extract_id(@id)
+
+      request_body = {
+        pageId: clean_id,
+        chunkNumber: 0,
+        limit: 100,
+        verticalColumns: false,
+      }
+
+      jsonified_record_response = get_all_block_info(clean_id, request_body)
+      i = 0
+      while jsonified_record_response.empty? || jsonified_record_response["block"].empty?
+        return {} if i >= 10
+
         jsonified_record_response = get_all_block_info(clean_id, request_body)
-        i = 0
-        while jsonified_record_response.empty? || jsonified_record_response['block'].empty?
-          return {} if i >= 10
-  
-          jsonified_record_response = get_all_block_info(clean_id, request_body)
-          i += 1
-        end
-  
-        jsonified_record_response['collection_view'][@view_id]['value']['page_sort']
-      end
-  
-      def rows
-        # ! returns all rows as instantiated class instances.
-        row_id_array = row_ids
-        parent_id = @parent_id
-        collection_id = @collection_id
-        view_id = @view_id
-  
-        row_id_array.map { |row_id| NotionAPI::CollectionViewRow.new(row_id, parent_id, collection_id, view_id) }
-      end
-  
-      private
-  
-      def extract_collection_schema(collection_id, view_id)
-        # ! retrieve the collection scehma. Useful for 'building' the backbone for a table.
-        # ! collection_id -> the collection ID : ``str``
-        # ! view_id -> the view ID : ``str``
-        cookies = Core.options['cookies']
-        headers = Core.options['headers']
-  
-        query_collection_hash = Utils::CollectionViewComponents.query_collection(collection_id, view_id, '')
-  
-        request_url = URLS[:GET_COLLECTION]
-        response = HTTParty.post(
-          request_url,
-          body: query_collection_hash.to_json,
-          cookies: cookies,
-          headers: headers
-        )
-        response['recordMap']['collection'][collection_id]['value']['schema']
+        i += 1
       end
+
+      jsonified_record_response["collection_view"][@view_id]["value"]["page_sort"]
     end
-    class CollectionViewRow < Core
-      @notion_type = 'table_row'
-      @type = 'table_row'
-  
-      def type
-        NotionAPI::CollectionViewRow.notion_type
-      end
-  
-      class << self
-        attr_reader :notion_type, :type, :parent_id
-      end
-  
-      attr_reader :parent_id, :id
-      def initialize(id, parent_id, collection_id, view_id)
-        @id = id
-        @parent_id = parent_id
-        @collection_id = collection_id
-        @view_id = view_id
+
+    def rows
+      # ! returns all rows as instantiated class instances.
+      row_id_array = row_ids
+      parent_id = @parent_id
+      collection_id = @collection_id
+      view_id = @view_id
+      collection_data = extract_collection_data(@collection_id, @view_id)
+      schema = collection_data["collection"][collection_id]["value"]["schema"]
+      column_mappings = schema.keys
+      column_names = column_mappings.map { |mapping| schema[mapping]["name"] }
+
+      row_instances = row_id_array.map { |row_id| NotionAPI::CollectionViewRow.new(row_id, parent_id, collection_id, view_id) }
+      clean_row_instances = row_instances.filter { |row| collection_data["block"][row.id] }
+      clean_row_instances.each { |row| row.instance_variable_set(:@column_names, column_names) }
+      CollectionViewRow.class_eval { attr_reader :column_names }
+
+      clean_row_instances.each do |collection_row|
+        row_data = collection_data["block"][collection_row.id]
+        create_singleton_methods_and_instance_variables(collection_row, row_data)
       end
+      clean_row_instances
     end
+    def create_singleton_methods_and_instance_variables(row, row_data)
+      # ! creates singleton methods for each property in a CollectionView.
+      # ! row -> the block ID of the 'row' to retrieve: ``str``
+      # ! row_data -> the data corresponding to that row, should be key-value pairs where the keys are the columns: ``hash``
+      collection_data = extract_collection_data(@collection_id, @view_id)
+      schema = collection_data["collection"][collection_id]["value"]["schema"]
+      column_mappings = schema.keys
+      column_hash = {}
+      column_names = column_mappings.map { |mapping| column_hash[mapping] = schema[mapping]["name"].downcase }
+      
+      column_hash.keys.each_with_index do |column, i|
+        # loop over the column names...
+        # set instance variables for each column, allowing the dev to 'read' the column value
+        cleaned_column = column_hash[column].split(" ").join("_").downcase.to_sym
 
-    class CollectionViewPage < CollectionView
-      @notion_type = 'collection_view_page'
-      @type = 'collection_view_page'
-  
-      def type
-        NotionAPI::CollectionViewRow.notion_type
-      end
-  
-      class << self
-        attr_reader :notion_type, :type, :parent_id
+        # p row_data["value"]["properties"][column_mappings[i]], !(row_data["value"]["properties"][column] or row_data["value"]["properties"][column_mappings[i]])
+        if row_data["value"]["properties"].nil? or row_data["value"]["properties"][column].nil?
+          value = ""
+        else
+          value = row_data["value"]["properties"][column][0][0]  
+        end
+
+        row.instance_variable_set("@#{cleaned_column}", value)
+        CollectionViewRow.class_eval { attr_reader cleaned_column }
+        # then, define singleton methods for each column that are used to update the table cell 
+        row.define_singleton_method("#{cleaned_column}=") do |new_value|
+          # neat way to get the name of the currently invoked method...
+          parsed_method = __method__.to_s[0...-1].split("_").join(" ")
+          cookies = Core.options["cookies"]
+          headers = Core.options["headers"]
+
+          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,
+          }
+
+          update_property_value = Utils::CollectionViewComponents.update_property_value(@id, column_hash.key(parsed_method), new_value)
+
+          operations = [
+            update_property_value,
+          ]
+
+          request_url = URLS[:UPDATE_BLOCK]
+          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
+          
+          # set the instance variable to the updated value!
+          _ = row.instance_variable_set("@#{__method__.to_s[0...-1]}", new_value)
+          row
+        end
       end
-  
-      attr_reader :parent_id, :id
     end
-end
+  end
+
+  # class that represents each row in a CollectionView
+  class CollectionViewRow < Core
+    @notion_type = "table_row"
+    @type = "table_row"
+
+    def type
+      NotionAPI::CollectionViewRow.notion_type
+    end
+
+    def inspect
+      "CollectionViewRow - id: #{self.id} - parent id: #{self.parent_id}"
+    end
+
+    class << self
+      attr_reader :notion_type, :type, :parent_id
+    end
+
+    attr_reader :parent_id, :id
+
+    def initialize(id, parent_id, collection_id, view_id)
+      @id = id
+      @parent_id = parent_id
+      @collection_id = collection_id
+      @view_id = view_id
+    end
+  end
+
+  # class that represents a CollectionViewPage, inheriting all properties from CollectionView
+  class CollectionViewPage < CollectionView
+    @notion_type = "collection_view_page"
+    @type = "collection_view_page"
+
+    def type
+      NotionAPI::CollectionViewRow.notion_type
+    end
+
+    class << self
+      attr_reader :notion_type, :type, :parent_id
+    end
+
+    attr_reader :parent_id, :id
+  end
+end

data/lib/notion_api/notion_types/template.rb

@@ -304,7 +304,15 @@ module NotionAPI
             block_collection_id = extract_collection_id(clean_id, jsonified_record_response)
             block_view_id = extract_view_ids(clean_id, jsonified_record_response)
             collection_title = extract_collection_title(clean_id, block_collection_id, jsonified_record_response)
-            block_class.new(clean_id, collection_title, block_parent_id, block_collection_id, block_view_id.join)
+            
+            block = block_class.new(clean_id, collection_title, block_parent_id, block_collection_id, block_view_id.join)
+            schema = extract_collection_schema(block_collection_id, block_view_id[0])
+            column_mappings = schema.keys
+            column_names = column_mappings.map { |mapping| schema[mapping]['name']}
+            block.instance_variable_set(:@column_names, column_names)
+            CollectionView.class_eval{attr_reader :column_names}
+
+            block
           else
             block_title = extract_title(clean_id, jsonified_record_response)
             block_class.new(clean_id, block_title, block_parent_id)

data/lib/notion_api/utils.rb

@@ -554,6 +554,30 @@ module Utils
         args: args,
       }
     end
+
+    def self.update_property_value(page_id, column_name, new_value)
+      # ! 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``
+      table = "block"
+      path = [
+        "properties",
+        column_name
+      ]
+      command = "set"
+      args = [[
+        new_value
+      ]]
+
+      {
+        id: page_id,
+        table: table,
+        path: path,
+        command: command,
+        args: args
+      }
+    end
   end
 
   def build_payload(operations, request_ids)

data/lib/notion_api/version.rb

@@ -1,3 +1,3 @@
 module NotionAPI
-    VERSION = '1.0.4'
+    VERSION = '1.0.5'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: notion
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 1.0.5
 platform: ruby
 authors:
 - Dan Murphy
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-11-30 00:00:00.000000000 Z
+date: 2020-12-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty