sf_cli 0.0.4 → 0.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9416d015ec2952621fe3525a9ed7177a68b98a86d3bced475eacf19d3ad88ce0
-  data.tar.gz: 545bb5c54d345c194c5b62e8599492a45b13ba156b6ce195d3fb1fe38bb0d656
+  metadata.gz: 1996a0f93b6d2f48ea8762961526eab00df5601c902f2ec81f21331382973e56
+  data.tar.gz: da4da9fe6855d6f44f7995d932e6f658565b6e41091bd4c908e651a8286ece95
 SHA512:
-  metadata.gz: bf7e32d0d73b0af136d8153b16b05cf837977f37bd2b95c0ab0cecd8fe23bef9cfcb64bda1a1b16dc1ae5ce92fbf239670c4282fd65df28ff0f4bd835f3810cc
-  data.tar.gz: 835a95c35ef507c44d5108b613f7300bd8723428fd897ffc64ce8b0d14d0837929dc416c8259e12b713814903f1e5d59e1832e5d57bb9785f3c9bc397d111f8a
+  metadata.gz: 36743c7b02fbdf21626a4dcf7ce299bdce68d99e0281bac62b08180ac48792b112b130402e3b75d589f13e57acdf33b33d139db00237818b784b6ab1cd37aef4
+  data.tar.gz: d4008513bbbf74b24de5c94f0cfc868367b37c9d2d876806e8eb2f546669768db94c5c1f981dbad732214c16ca26ee969eeb7027c59abda23d49a6e7b8e038fa

data/CHANGELOG.md

@@ -1,3 +1,25 @@
+## 0.0.6 - 2024-09-16
+- NEW: Object Model Support renewal;
+  - `SfCli::Sf::Model.connection` represents the connection to Salesforce. It can be set by `set_connection` class method in the module. As of now there is only `SfCommandConnection`, which is based on sf command, as connection adapter. After the connection is set by `set_connection`, it is also automatically set to classes when `SfCli::Sf::Model.generate` method is called.
+  - Each object model class has `create` class method for creating a new record.
+  - Each object model has `#save` and `#delete` instance methods to create, update and delete the record it represents.
+  - Each object class has query interface such as `where`, `select`, `limit` and `order` methods that can be chainable.
+  - Each object class has query interface such as `find`, `all`, `take` and `pluck`.
+- CHANGE: `sf.sobject.describe` changed to return `schema` object.
+## 0.0.5 - 2024-09-08
+- CHANGE: target CLI version is changed: from 2.54.6 to 2.56.7
+- NEW: new command features are added;
+  - `--bulk` option to `sf.data.query`
+  - `sf.data.query_resume`
+  - `sf.data.upsert_bulk`
+  - `sf.data.upsert_resume`
+  - `sf.data.delete_bulk`
+  - `sf.data.delete_resume`
+  - `sf.data.resume`
+  - `sf.data.search`
+  - `sf.org.list`
+  - `sf.login_access_token`
+  - `--browser` option to `sf.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 +27,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

@@ -1,4 +1,4 @@
-= Salesforce CLI library
+= Salesforce CLI library for Ruby
 https://badge.fury.io/rb/sf_cli.png
 
 This is a class library for introducing {Salesforce CLI}[https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_top.htm] to Ruby scripting.<br>
@@ -7,13 +7,13 @@ 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
+==== Rubygem
   $ gem install sf_cli
 
-=== Bundler
+==== Bundler
 in Gemfile:
   gem 'sf_cli'
 
@@ -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,31 +40,96 @@ 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'
 
 == \Object Model support (experimental, since 0.0.4)
-  require 'sf_cli'
+=== generate Models
   require 'sf_cli/sf/model'
+  require 'sf_cli/sf/model/sf_command_connection'
 
-  # generates Model Class for Contact and Account, accessing the org aliased as 'dev'
-  SfCli::Sf::Model.generate %w[Contact Account], target_org: :dev
+  # first, you must prepare the connection
+  conn = SfCli::Sf::Model::SfCommandConnection.new target_org: your_org, instance_url: your_org_url
 
-  c = Contact.new(:Name => "John Smith")
-  c.Name # => "John Smith"
+  # then set it to Model module
+  SfCli::Sf::Model.set_connection conn
 
-  rows = sf.data.query 'SELECT Id, Name, Account.Name From Contact Limit 1', model_class: Contact
-  rows.size # => 1
-  rows.first.Name # => Name of the Contact
-  rows.first.Account.Name # => Name of the Account
+  # generates some model classes (for example, Account and Contact)
+  SfCli::Sf::Model.generate %w[Account Contact]
+=== apply to sf command
+  rows = sf.data.query "SELECT Id, Name FROM Contact WHERE Name = 'Akin Kristen'", model_class: Contact
+
+  # the array object contains Contact object instances
+  rows.size  # 1
+  rows.first # <Contact: @Id="0035j00001RW3xbAAD", @Name="Akin Kristen">
+  rows.first.Name # Akin Kristen
+
+=== using models Independently
+==== initialize and save a record
+  c = Contact.new(:Name => "John Smith")
+  c.Name # "John Smith"
+  c.save
+
+==== find and update a record
+  # find by record ID and update
+  c2 = Contact.find(c.id)
+  c2.Name = "Johnny Smith"
+  c2.save # update
+
+==== delete a record
+  c2 = Contact.find(c.id)
+  c2.delete
+
+==== query and get a record
+  contact = Contact.select(:Id, :Name).where(Name: 'Akin Kristen').take
+  contact # => #<Contact: @Id="0035j00001RW3xbAAD", @Name="Akin Kristen">
+  contact.Name # Akin Kristen
+
+==== query and get records
+  contacts = Contact.select(:Id, :Name).where(LastModifiedDate: :Yesterday).all # get all records that is modified yesterday
+
+  # these 2 example are the same meaning
+  Contact.select(Name).where(Name: 'John Smith', LastModifiedDate: :Yesterday).take
+  Contact.select(Name).where(Name: 'John Smith').where(LastModifiedDate: :Yesterday).take
+
+==== child-parent relationship
+  contact = Contact.select(:Id, :Name, "Account.Name").where(Name: 'Akin Kristen').take
+  contact # <Contact: @Id="0035j00001RW3xbAAD", @Name="Akin Kristen", @Account= #<Account @Name="Aethna Home Products">>
+  contact.Account.Name # Aethna Home Products
+
+==== parent-children relationship
+  account = Account.select(:Id, :Name, "(SELECT Name FROM Contacts)").take
+  account # <Account @Contacts=[#<Contact @Name="Akin Kristen">], @Id="0015j00001dsDuhAAE", @Name="Aethna Home Products">
+  account.Name             # Aethna Home Products
+  rows.Contacts            # [#<Contact @Name="Akin Kristen">]
+  rows.Contacts.first.Name # Akin Kristen
+
+==== get all fields in a record
+  # just by not using 'select' method
+  contact = Contact.find(record_id) # <Contact @Id="...", @Name="...", other fields...>
+
+==== time keywords such as 'yesterday' or 'LAST_N_DAYS:N' with symbol style
+  Contact.select(:Name).where(LastModifiedDate: :Yesterday).take       # "SELECT Id, Name FROM Contact WHERE LastModifiedDate = Yesterday"
+  Contact.select(:Name).where(LastModifiedDate: :"LAST_N_DAYS:5").take # "SELECT Id, Name FROM Contact WHERE LastModifiedDate = LAST_N_DAYS:5"
+
+==== array for 'IN' keyword
+  Contact.select(:Name).where(Name: ['Jonny Good', 'John Smith']).all # same as "SELECT Name FROM Contact WHERE Name IN ('Jonny Good', 'John Smith')"
+
+==== using partial soql directly
+  Contact.select("Id, Name").where("LastModifiedDate = LAST_N_DAYS:5").all
+
+==== ternary style
+  Contact.select(:Id, :Name).where(:LastModifiedDate, :>=, :"LAST_N_DAYS:5").all # SELECT Id, Name FROM Contact WHERE LastModifiedDate >= LAST_N_DAYS:5
+  Account.select(:Id, :Name).where(:Name, :LIKE, "%OIL%").all                    # SELECT Id, Name FROM Account WHERE Name LIKE '%OIL%'
+
+==== get schema
+  schema = Account.describe
+  schema.name # Account
+  schema.field_names # [Id, Name, ....]
 
 == Documents
 The following steps generate *doc* directory, which all documents are generated in.

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

@@ -1,3 +1,5 @@
+require 'json'
+
 module SfCli
   module Sf
     module Core

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