sf_cli 0.0.4 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9416d015ec2952621fe3525a9ed7177a68b98a86d3bced475eacf19d3ad88ce0
-  data.tar.gz: 545bb5c54d345c194c5b62e8599492a45b13ba156b6ce195d3fb1fe38bb0d656
+  metadata.gz: c53d056727e589cb48d79aced7900a9419015ad0840e59b5f4d25361a31468ad
+  data.tar.gz: 491d45e9ce3907f931d07526eb37f9698e8c5b4cd95ffb3f38317244d99ea656
 SHA512:
-  metadata.gz: bf7e32d0d73b0af136d8153b16b05cf837977f37bd2b95c0ab0cecd8fe23bef9cfcb64bda1a1b16dc1ae5ce92fbf239670c4282fd65df28ff0f4bd835f3810cc
-  data.tar.gz: 835a95c35ef507c44d5108b613f7300bd8723428fd897ffc64ce8b0d14d0837929dc416c8259e12b713814903f1e5d59e1832e5d57bb9785f3c9bc397d111f8a
+  metadata.gz: a49220a708a8cab60b8ae22f09b4ac805c6b405c3ae0821809012d0cb4d3b34bfd66f69a3429ae4ed70799a0a6cd793c9edcd52e71b2811aaf7a887bdb8db075
+  data.tar.gz: dc8d5efe8ea8001212d448ca71fe874b61625960a6daea6163d459d9603c0d5ccbbf1b8c4795694495e4b1b963100113dd02e9dba56160322e3ab27ebcada2b3

data/CHANGELOG.md

@@ -1,3 +1,19 @@
+## 0.0.5 - 2024-09-08
+- target CLI version is changed: from 2.54.6 to 2.56.7
+- sf data:
+  - add `--bulk` option to query
+  - add query resume
+  - add upsert bulk
+  - add upsert resume
+  - add delete bulk
+  - add delete resume
+  - add resume
+  - add search
+- sf org:
+  - add list
+  - add login access-token
+  - add `--browser` option to login web
+
 ## 0.0.4 - 2024-09-02
 - breaking change:
   - Sf class doesn't exist anymore. You can not write like `sf = SfCli::Sf.new`. Instead of that,  global `sf` method is introduced. You can directly type like `sf.org.display`, which is as almost same usability as the original command. 
@@ -5,8 +21,8 @@
   - support child-parent relationship
   - support parent-children relationship
   - add `--result-format` option
-- auto generation of Object Model (experimental)
-  - generates SF Object Classes automatically
+- auto generation of \Object Model (experimental)
+  - generates SF \Object Classes automatically
   - relationship is supported
 
 ## 0.0.3 - 2024-08-25

data/README.rdoc

@@ -7,7 +7,7 @@ Currently only *sf* command is the target of development.
 
 == prerequisite
 Salesforce CLI must be installed.<br>
-As of as of August in 2024, ver.2.54.6 is the development target.
+As of as of September in 2024, ver.2.56.7 is the development target.
 
 == install
 === Rubygem
@@ -23,35 +23,15 @@ then,
 == Examples
 === Since 0.0.4
   require 'sf_cli'
-  #
+
   # login to org
-  #
   sf.org.login_web
-  sf.org.login_web target_org: :dev  # if the org you login isn't the default one, you should give it alias name for later use. 
 
-  #
   # get records
-  #
   sf.data.query 'SELECT Id, Name FROM Account LIMIT 1' # => [{Id: "abc", Name: "account name"}]
 
-  Account = Struct.new(:Id, :Name) # you can manually prepare the object model
-  sf.data.query('SELECT Id, Name From Account Limit 3', model_class: Account)  # returns an array of Account
-
-  # child-parent relationship is supported
-  sf.data.query 'SELECT Id, Name, Account.Name From Contact Limit 1'  #  [{Id: "abc", Name: "contact name", Account: {Name: "account name"}}]
-
-  # parent-children relationship is supported
-  sf.data.query 'SELECT Id, Name, (SELECT Name From Contacts) FROM Account Limit 1'  #  [{Id: "abc", Name: "account name", Contacts: [{Name: "contact name"}]}]
-
-  #
-  # get sobject schema
-  #
-  sf.sobject.describe :Case  # get Case Object schema information
-
-  #
-  # generate a Salesforce DX project with manifest generation option
-  #
-  sf.project.generate 'MyProject', manifest: true
+  # generate a Salesforce DX project
+  sf.project.generate 'MyProject'
 
 === Before 0.0.3
   require 'sf_cli/sf'
@@ -60,14 +40,10 @@ then,
 
   # login to org
   sf.org.login_web
-  sf.org.login_web target_org: :dev  # name an alias to the org, which you're going to log in, for later use. This is needed when you don't use the default org.
 
   # get Account records
   sf.data.query 'SELECT Id, Name FROM Account LIMIT 3' # => returns an array containing 3 records
   
-  Account = Struct.new(:Id, :Name)
-  sf.data.query('SELECT Id, Name From Account Limit 3', model_class: Account)  # returns an array of Account struct object
-
   # generate a Salesforce DX project
   sf.project.generate 'MyProject'
 
@@ -75,14 +51,14 @@ then,
   require 'sf_cli'
   require 'sf_cli/sf/model'
 
-  # generates Model Class for Contact and Account, accessing the org aliased as 'dev'
-  SfCli::Sf::Model.generate %w[Contact Account], target_org: :dev
+  # generates Model Class for Contact and Account
+  SfCli::Sf::Model.generate %w[Contact Account]
 
   c = Contact.new(:Name => "John Smith")
   c.Name # => "John Smith"
 
-  rows = sf.data.query 'SELECT Id, Name, Account.Name From Contact Limit 1', model_class: Contact
-  rows.size # => 1
+  rows = sf.data.query 'SELECT Id, Name, Account.Name From Contact Limit 3', model_class: Contact
+  rows.size # => 3
   rows.first.Name # => Name of the Contact
   rows.first.Account.Name # => Name of the Account
 

data/lib/sf_cli/sf/data/bulk_result_v2.rb

@@ -0,0 +1,77 @@
+module SfCli
+  module Sf
+    module Data
+      #
+      # Bulk Job information.
+      #
+      # You can check the job status using the following method:
+      # - opened?
+      # - upload_completed?
+      # - in_progress?
+      # - completed?
+      # ==== example:
+      #   result = sf.data.delete_resume job_id: jobinfo.id
+      #   puts 'yey!' if result.job_info.completed? # the job has completed
+      #
+      # For more details, see {the guide document}[https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/bulk_api_2_job_states.htm]
+      #
+      JobInfo = Struct.new(
+        :id,
+        :operation,
+        :object,
+        :createdById,
+        :createdDate,
+        :systemModstamp,
+        :state,
+        :externalIdFieldName,
+        :concurrencyMode,
+        :contentType,
+        :apiVersion,
+        :jobType,
+        :lineEnding,
+        :columnDelimiter,
+        :numberRecordsProcessed,
+        :numberRecordsFailed,
+        :retries,
+        :totalProcessingTime,
+        :apiActiveProcessingTime,
+        :apexProcessingTime,
+        :isPkChunkingSupported
+      ) do
+        def opened?
+          state == 'Open'
+        end
+
+        def upload_completed?
+          state == 'UploadComplete'
+        end
+
+        def in_progress?
+          state == 'InProgress'
+        end
+
+        def completed?
+          state == 'JobComplete'
+        end
+
+        def failed?
+          state == 'Failed'
+        end
+
+        def aborted?
+          state == 'Aborted'
+        end
+      end
+
+      #
+      # Records processed by Bulk API
+      #
+      BulkRecordsV2 = Struct.new(:successfulResults, :failedResults, :unprocessedRecords)
+
+      #
+      # Bulk Result information that contains JobInfo and BulkRecordsV2
+      #
+      BulkResultV2 = Struct.new(:job_info, :records)
+    end
+  end
+end

data/lib/sf_cli/sf/data/core.rb

@@ -1,5 +1,15 @@
 require_relative '../core/base'
-require_relative './helper_methods'
+require_relative './query'
+require_relative './get_record'
+require_relative './update_record'
+require_relative './create_record'
+require_relative './delete_record'
+require_relative './delete_bulk'
+require_relative './delete_resume'
+require_relative './upsert_bulk'
+require_relative './upsert_resume'
+require_relative './resume'
+require_relative './search'
 
 module SfCli
   module Sf
@@ -12,167 +22,17 @@ module SfCli
       #
       class Core
         include ::SfCli::Sf::Core::Base
-        include ::SfCli::Sf::Data::HelperMethods
-
-        # get object records using SQOL. (eqivalent to *sf* *data* *query*)
-        #
-        # *soql* --- SOQL<br>
-        # *target_org* --- an alias of paticular org, not default one<br>
-        # *model_class* --- the object model class<br>
-        #
-        # == examples
-        #   sf.data.query 'SELECT Id, Name FROM Account LIMIT 1' # => [{Id: "abc", Name: "account name"}]
-        #
-        #   Account = Struct.new(:Id, :Name)
-        #   sf.data.query('SELECT Id, Name From Account Limit 3', model_class: Account)  # returns an array of Account struct object
-        #
-        #   # child-parent relationship is supported
-        #   sf.data.query 'SELECT Id, Name, Account.Name From Contact Limit 1'  #  [{Id: "abc", Name: "contact name", Account: {Name: "account name"}}]
-        #
-        #   # parent-children relationship is supported
-        #   sf.data.query 'SELECT Id, Name, (SELECT Name From Contacts) FROM Account Limit 1'  #  [{Id: "abc", Name: "account name", Contacts: [{Name: "contact name"}]}]
-        #
-        #   Account = Struct.new(:Id, :Name) # you can manually prepare the object model
-        #   sf.data.query('SELECT Id, Name From Account Limit 3', model_class: Account)  # returns an array of Account
-        #
-        # For more command details, see {the command reference}[https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_data_commands_unified.htm#cli_reference_data_query_unified]
-        #
-        # About querying with auto generated object model, see the section {"Object Model support"}[link://files/README_rdoc.html#label-Object+Model+support+-28experimental-2C+since+0.0.4-29] in README.
-        #
-        def query(soql, target_org: nil, format: nil, model_class: nil)
-          flags    = {
-            :"query"    => %("#{soql}"),
-            :"target-org" => target_org,
-            :"result-format" => format,
-          }
-
-          raw_output = format ? true : false
-          format = format || :json
-
-          result = exec(__method__, flags: flags, redirection: :null_stderr, raw_output: raw_output, format: format)
-          return result if raw_output
-
-          result['result']['records'].each_with_object([]) do |h, a|
-            record = prepare_record(h)
-            a << (model_class ? model_class.new(**record) : record)
-          end
-        end
-
-        # get a object record. (eqivalent to *sf* *data* *get* *record*)
-        #
-        # *object_type* --- \Object Type (ex. Account)<br>
-        # *record_id* --- id of the object<br>
-        # *where* --- hash object that is used to identify a record<br>
-        # *target_org* --- an alias of paticular org, not default one<br>
-        # *model_class* --- the object model class<br>
-        #
-        # ==== examples
-        #   sf.data.get_record :Account, record_id: 'xxxxxxx'
-        #   sf.data.get_record :Account, where: {Name: 'Jonny B.Good', Country: 'USA'}
-        #
-        #   CustomObject = Struct.new(:Id, :Name)
-        #   sf.data.get_record :TheCustomObject__c, record_id: 'xxxxx', model_class: CustomObject  # returns a CustomObject struct object
-        #
-        # For more command details, see {the command reference}[https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_data_commands_unified.htm#cli_reference_data_get_record_unified]
-        #
-        def get_record(object_type, record_id: nil, where: nil, target_org: nil, model_class: nil)
-          where_conditions = field_value_pairs(where)
-          flags = {
-            :"sobject"    => object_type,
-            :"record-id"  => record_id,
-            :"where"      => (where_conditions.nil? ? nil : %|"#{where_conditions}"|),
-            :"target-org" => target_org,
-          }
-          action = __method__.to_s.tr('_', ' ')
-          json = exec(action, flags: flags, redirection: :null_stderr)
-
-          result = json['result']
-          result.delete 'attributes'
-
-          model_class ? model_class.new(**result) : result
-        end
-
-        # update a object record. (eqivalent to *sf* *data* *update* *record*)
-        #
-        # *object_type* --- \Object Type (ex. Account)<br>
-        # *record_id* --- id of the object<br>
-        # *where* --- field values that is used to identify a record<br>
-        # *values* --- field values for update<br>
-        # *target_org* --- an alias of paticular org, not default one<br>
-        #
-        # ==== examples
-        #   sf.data.update_record :Account, record_id: 'xxxxxxx', values: {Name: 'New Account Name'}
-        #   sf.data.update_record :Hoge__c, where: {Name: 'Jonny B.Good', Country: 'USA'}, values: {Phone: 'xxxxx', bar: 2000}
-        #
-        # For more command details, see {the command reference}[https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_data_commands_unified.htm#cli_reference_data_update_record_unified]
-        #
-        def update_record(object_type, record_id: nil, where: nil, values: nil, target_org: nil)
-          where_conditions  = field_value_pairs(where)
-          field_values      = field_value_pairs(values)
-          flags = {
-            :"sobject"    => object_type,
-            :"record-id"  => record_id,
-            :"where"      => (where_conditions.nil? ? nil : %|"#{where_conditions}"|),
-            :"values"     => (field_values.nil? ? nil : %|"#{field_values}"|),
-            :"target-org" => target_org,
-          }
-          action = __method__.to_s.tr('_', ' ')
-          json = exec(action, flags: flags, redirection: :null_stderr)
-
-          json['result']['id']
-        end
-
-        # create a object record. (eqivalent to *sf* *data* *create* *record*)
-        #
-        # *object_type* --- \Object Type (ex. Account)<br>
-        # *values* --- field values to be assigned<br>
-        # *target_org* --- an alias of paticular org, not default one<br>
-        #
-        # ==== examples
-        #
-        #   sf.data.create_record :TheCustomObject__c, values: {Name: "John Smith", Age: 33} # creating a TheCustomObject record with name and age
-        #
-        # For more command details, see {the command reference}[https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_data_commands_unified.htm#cli_reference_data_create_record_unified]
-        #
-        def create_record(object_type, values: {}, target_org: nil)
-          field_values = field_value_pairs(values)
-          flags = {
-            :"sobject"    => object_type,
-            :"values"      => (field_values.nil? ? nil : %|"#{field_values}"|),
-            :"target-org" => target_org,
-          }
-          action = __method__.to_s.tr('_', ' ')
-          json = exec(action, flags: flags, redirection: :null_stderr)
-
-          json['result']['id']
-        end
-
-        # delete a object record. (eqivalent to *sf* *data* *delete* *record*)
-        #
-        # *object_type* --- \Object Type (ex. Account)<br>
-        # *record_id* --- id of the object<br>
-        # *where* --- hash object that is used to identify a record<br>
-        # *target_org* --- an alias of paticular org, not default one<br>
-        #
-        # ==== examples
-        #   sf.data.delete_record :Hoge__c, record_id: 'xxxxxxx'
-        #   sf.data.delete_record :Hoge__c, where: {Name: 'Jonny B.Good', Country: 'USA'}
-        #
-        # For more command details, see {the command reference}[https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_data_commands_unified.htm#cli_reference_data_delete_record_unified]
-        #
-        def delete_record(object_type, record_id: nil, where: nil, target_org: nil)
-          where_conditions = field_value_pairs(where)
-          flags = {
-            :"sobject"    => object_type,
-            :"record-id"  => record_id,
-            :"where"      => (where_conditions.nil? ? nil : %|"#{where_conditions}"|),
-            :"target-org" => target_org,
-          }
-          action = __method__.to_s.tr('_', ' ')
-          json = exec(action, flags: flags, redirection: :null_stderr)
-
-          json['result']['id']
-        end
+        include Query
+        include GetRecord
+        include UpdateRecord
+        include CreateRecord
+        include DeleteRecord
+        include DeleteBulk
+        include DeleteResume
+        include UpsertBulk
+        include UpsertResume
+        include Resume
+        include Search
       end
     end
   end

data/lib/sf_cli/sf/data/create_record.rb

@@ -0,0 +1,30 @@
+module SfCli::Sf::Data
+  module CreateRecord
+    # create a object record.
+    #
+    # *object_type* --- \Object Type (ex. Account)<br>
+    #
+    # *values* --- field values to be assigned<br>
+    #
+    # *target_org* --- an alias of paticular org, or username can be used<br>
+    #
+    # ======
+    #   # create a TheCustomObject record with name and age
+    #   sf.data.create_record :TheCustomObject__c, values: {Name: "John Smith", Age: 33}
+    #
+    # For more command details, see {the command reference}[https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_data_commands_unified.htm#cli_reference_data_create_record_unified]
+    #
+    def create_record(object_type, values: {}, target_org: nil)
+      field_values = field_value_pairs(values)
+      flags = {
+        :"sobject"    => object_type,
+        :"values"      => (field_values.nil? ? nil : %|"#{field_values}"|),
+        :"target-org" => target_org,
+      }
+      action = __method__.to_s.tr('_', ' ')
+      json = exec(action, flags: flags, redirection: :null_stderr)
+
+      json['result']['id']
+    end
+  end
+end

data/lib/sf_cli/sf/data/delete_bulk.rb

@@ -0,0 +1,47 @@
+require_relative './bulk_result_v2'
+
+module SfCli::Sf::Data
+  module DeleteBulk
+    # delete records using Bulk API 2.0
+    #
+    # *file* --- a CSV file, which is written record IDs to delete<br>
+    #
+    # *sobject* --- \Object Type (ex. Account)<br>
+    #
+    # *timeout* --- max minutes to wait for the job complete the task.<br>
+    #
+    # *target_org* --- an alias of paticular org, or username can be used<br>
+    #
+    # ======
+    #   # start a delete job
+    #   jobinfo = sf.data.delete_bulk sobject: :TestCustomObject__c, file: 'delete.csv' # this returns immediately
+    #   jobinfo.id  # => "750J4000003g1OaIAI" it's job ID
+    #
+    #   # you can check if the delete job completed
+    #   sf.data.delete_resume job_id: jobinfo.id
+    #
+    #   # Or, you can wait for the job completion with one try.
+    #   result = sf.data.delete_bulk sobject: :TestCustomObject__c, file: 'delete.csv', timeout: 5  # wait within 5 minutes
+    #
+    # For more command details, see {the command reference}[https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_data_commands_unified.htm#cli_reference_data_delete_bulk_unified]
+    #
+    def delete_bulk(file:, sobject:, timeout: nil, target_org: nil)
+      flags = {
+        :"file"    => file,
+        :"sobject"    => sobject,
+        :"wait"      => timeout,
+        :"target-org" => target_org,
+      }
+      action = __method__.to_s.tr('_', ' ')
+      json = exec(action, flags: flags, redirection: :null_stderr)
+
+      job_info =  ::SfCli::Sf::Data::JobInfo.new(**json['result']['jobInfo'])
+      return job_info unless json['result']['records']
+
+      ::SfCli::Sf::Data::BulkResultV2.new(
+        job_info: job_info,
+        records:  ::SfCli::Sf::Data::BulkRecordsV2.new(**json['result']['records'])
+      )
+    end
+  end
+end

data/lib/sf_cli/sf/data/delete_record.rb

@@ -0,0 +1,33 @@
+module SfCli::Sf::Data
+  module DeleteRecord
+    # delete a object record.
+    #
+    # *object_type* --- \Object Type (ex. Account)<br>
+    #
+    # *record_id* --- id of the object<br>
+    #
+    # *where* --- hash object that is used to identify a record<br>
+    #
+    # *target_org* --- an alias of paticular org, or username can be used<br>
+    #
+    # ======
+    #   sf.data.delete_record :Hoge__c, record_id: 'xxxxxxx'
+    #   sf.data.delete_record :Hoge__c, where: {Name: 'Jonny B.Good', Country: 'USA'}
+    #
+    # For more command details, see {the command reference}[https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_data_commands_unified.htm#cli_reference_data_delete_record_unified]
+    #
+    def delete_record(object_type, record_id: nil, where: nil, target_org: nil)
+      where_conditions = field_value_pairs(where)
+      flags = {
+        :"sobject"    => object_type,
+        :"record-id"  => record_id,
+        :"where"      => (where_conditions.nil? ? nil : %|"#{where_conditions}"|),
+        :"target-org" => target_org,
+      }
+      action = __method__.to_s.tr('_', ' ')
+      json = exec(action, flags: flags, redirection: :null_stderr)
+
+      json['result']['id']
+    end
+  end
+end

data/lib/sf_cli/sf/data/delete_resume.rb

@@ -0,0 +1,47 @@
+require_relative './bulk_result_v2'
+
+module SfCli::Sf::Data
+  module DeleteResume
+    # resume a bulk delete job you previously started with Bulk API 2.0 and return a bulk result object.
+    #
+    # *job_id* ---  job ID you want to resume<br>
+    #
+    # *timeout* --- max minutes to wait for the job complete the task.<br>
+    #
+    # *target_org* --- an alias of paticular org, or username can be used<br>
+    #
+    # ======
+    #   # start a delete job
+    #   jobinfo = sf.data.delete_bulk sobject: :TestCustomObject__c, file: 'delete.csv' # this returns immediately
+    #   jobinfo.id  # => "750J4000003g1OaIAI" it's job ID
+    #
+    #   # the job has already started asynchronously.
+    #   # So you should check its progress.
+    #   # if you want to wait for the job complete the task, try 'timeout' option.
+    #   result = sf.data.delete_resume job_id: jobinfo.id
+    #
+    #   puts 'yey!' if result.job_info.completed? # the job has completed
+    #
+    # To know more about a job result, take a look at SfCli::Sf::Data module
+    #
+    # For more command details, see {the command reference}[https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_data_commands_unified.htm#cli_reference_data_delete_resume_unified]
+    #
+    def delete_resume(job_id:, timeout: nil, target_org: nil)
+      flags = {
+        :"job-id"     => job_id,
+        :"wait"       => timeout,
+        :"target-org" => target_org,
+      }
+      action = __method__.to_s.tr('_', ' ')
+      json = exec(action, flags: flags, redirection: :null_stderr)
+
+      job_info =  ::SfCli::Sf::Data::JobInfo.new(**json['result']['jobInfo'])
+      return job_info unless json['result']['records']
+
+      ::SfCli::Sf::Data::BulkResultV2.new(
+        job_info: job_info,
+        records:  ::SfCli::Sf::Data::BulkRecordsV2.new(**json['result']['records'])
+      )
+    end
+  end
+end

data/lib/sf_cli/sf/data/get_record.rb

@@ -0,0 +1,42 @@
+module SfCli::Sf::Data
+  module GetRecord
+
+    # get a object record. (eqivalent to *sf* *data* *get* *record*)
+    #
+    # *object_type* --- \Object Type (ex. Account)<br>
+    #
+    # *record_id* --- id of the object<br>
+    #
+    # *where* --- hash object that is used to identify a record<br>
+    #
+    # *target_org* --- an alias of paticular org, not default one<br>
+    #
+    # *model_class* --- the object model class<br>
+    #
+    # ======
+    #   sf.data.get_record :Account, record_id: 'xxxxxxx'
+    #   sf.data.get_record :Account, where: {Name: 'Jonny B.Good', Country: 'USA'}
+    #
+    #   CustomObject = Struct.new(:Id, :Name)
+    #   sf.data.get_record :TheCustomObject__c, record_id: 'xxxxx', model_class: CustomObject  # returns a CustomObject instance
+    #
+    # For more command details, see {the command reference}[https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_data_commands_unified.htm#cli_reference_data_get_record_unified]
+    #
+    def get_record(object_type, record_id: nil, where: nil, target_org: nil, model_class: nil)
+      where_conditions = field_value_pairs(where)
+      flags = {
+        :"sobject"    => object_type,
+        :"record-id"  => record_id,
+        :"where"      => (where_conditions.nil? ? nil : %|"#{where_conditions}"|),
+        :"target-org" => target_org,
+      }
+      action = __method__.to_s.tr('_', ' ')
+      json = exec(action, flags: flags, redirection: :null_stderr)
+
+      result = json['result']
+      result.delete 'attributes'
+
+      model_class ? model_class.new(**result) : result
+    end
+  end
+end

data/lib/sf_cli/sf/data/helper_methods.rb

@@ -16,6 +16,18 @@ module SfCli
           hash
         end
 
+        def prepare_record_in_bulk_mode(hash) # :doc:
+          hash.keys.each do |k|
+            match_result = /(.*)\.(.*)/.match(k)
+            if match_result
+              hash[match_result[1]] = {match_result[2] => hash[k]}
+              hash.delete k
+            end
+          end
+
+          hash
+        end
+
         def children?(h)
           return false unless h.instance_of?(Hash)