sf_cli 0.0.3 → 0.0.5

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

@@ -0,0 +1,23 @@
+require_relative '../core/base'
+require_relative './login'
+require_relative './display'
+require_relative './list'
+
+module SfCli
+  module Sf
+    module Org
+      #
+      # ==== description
+      # The class representing *sf* *org*.
+      #
+      # https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_org_commands_unified.htm
+      #
+      class Core
+        include ::SfCli::Sf::Core::Base
+        include Login
+        include Display
+        include List
+      end
+    end
+  end
+end

data/lib/sf_cli/sf/org/display.rb

@@ -0,0 +1,41 @@
+module SfCli::Sf::Org
+  module Display
+    ConnectionInfo = Struct.new(:id, :access_token, :alias, :instance_url, :user_name, :api_version, :status)
+
+    #
+    # returns the org's connection information. (equivalent to *sf* *org* *display*)
+    #
+    # *target_org* --- an alias of paticular org, or username can be used<br>
+    #
+    # ======
+    #  # example (in irb):
+    #
+    #  > sf.org.display
+    #  =>
+    #  #<struct SfCli::Sf::Org::Display::ConnectionInfo
+    #   id="00D5j00000DiuxmEAB",
+    #   access_token="<some access token>",
+    #   alias="dev",
+    #   instance_url="https://hoge-bar-baz.abc.my.salesforce.com.example",
+    #   user_name="user@example.sandbox",
+    #   api_version="61.0",
+    #   status="Connected">
+    #
+    # 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_org_commands_unified.htm#cli_reference_org_display_unified]
+    #
+    def display(target_org: nil)
+      flags    = {:"target-org" => target_org}
+      json = exec(__method__, flags: flags, redirection: :null_stderr)
+
+      ConnectionInfo.new(
+        id:           json['result']['id'],
+        access_token: json['result']['accessToken'],
+        alias:        json['result']['alias'],
+        instance_url: json['result']['instanceUrl'],
+        user_name:    json['result']['username'],
+        api_version:  json['result']['apiVersion'],
+        status:       json['result']['connectedStatus']
+      )
+    end
+  end
+end

data/lib/sf_cli/sf/org/list.rb

@@ -0,0 +1,67 @@
+module SfCli::Sf::Org
+  module List
+    OrgConfig = Struct.new( :accessToken, :instanceUrl, :orgId, :username, :loginUrl,
+      :clientId, :isDevHub, :instanceApiVersion, :instanceApiVersionLastRetrieved, :name,
+      :instanceName, :namespacePrefix, :isSandbox, :isScratch, :trailExpirationDate, :tracksSource,
+      :alias, :isDefaultDevHubUsername, :isDefaultUsername, :lastUsed, :connectedStatus) do
+      def devhub?
+        isDevHub
+      end
+
+      def sandbox?
+        isSandbox
+      end
+
+      def scratch?
+        isScratch
+      end
+
+      def default?
+        isDefaultUsername
+      end
+
+      def default_devhub?
+        isDefaultDevHubUsername
+      end
+
+      def connected?
+        connectedStatus == 'Connected'
+      end
+    end
+
+    # \List orgs you’ve created or authenticated to
+    #
+    # ======
+    #   org_config_list = sf.org.list # returns a list of OrgConfig
+    #
+    # \OrgConfig object has a org information including security sensitive things such as access token, username and so on.
+    #
+    # It also has some methods to identify its org type:
+    # - devhub?
+    # - sandbox?
+    # - scratch?
+    # - default?
+    # - default_devhub?
+    #
+    # and you can check the org connected like this:
+    #   org_config_list = sf.org.list # returns a list of OrgConfig
+    #   org_config.first.conncected?
+    #
+    # 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_org_commands_unified.htm#cli_reference_org_list_unified]
+    #
+    def list
+      flags = {
+        # reserved for later option addition
+      }
+      json = exec(__method__, flags: flags, redirection: :null_stderr)
+
+      others = json['result']['other'].map{|config| OrgConfig.new(**config)}
+      sandboxes = json['result']['sandboxes'].map{|config| OrgConfig.new(**config)}
+      non_scratch_orgs = json['result']['nonScratchOrgs'].map{|config| OrgConfig.new(**config)}
+      devhubs = json['result']['devHubs'].map{|config| OrgConfig.new(**config)}
+      scratch_orgs = json['result']['scratchOrgs'].map{|config| OrgConfig.new(**config)}
+      
+      (others + sandboxes + non_scratch_orgs + devhubs + scratch_orgs).uniq{|config| config.alias}
+    end
+  end
+end

data/lib/sf_cli/sf/org/login.rb

@@ -0,0 +1,64 @@
+module SfCli::Sf::Org
+  module Login
+    # login to the org by the browser.
+    #
+    # *target_org* --- an alias of paticular org, or username can be used<br>
+    #
+    # *instance_url* --- URL of the instance that the org lives on.
+    #
+    # *browser* --- browser in which to open the org.
+    #
+    # == examples:
+    #   sf.org.login_web
+    #   sf.org.login_web target_org: :dev
+    #
+    # 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_org_commands_unified.htm#cli_reference_org_login_web_unified]
+    #
+    def login_web(target_org: nil, instance_url: nil, browser: nil)
+      flags = {
+        :"alias"        => target_org,
+        :"instance-url" => instance_url,
+        :"browser"      => browser,
+      }
+      action = __method__.to_s.tr('_', ' ')
+      exec(action, flags: flags)
+    end
+
+    # login to the org by access token.
+    #
+    # NOTE: this method doesn't support user interactive mode, so *SF_ACCESS_TOKEN* environment variable must be set before call this method.
+    #
+    # *instance_url* --- URL of the instance that the org lives on.
+    #
+    # *target_org* --- an alias of paticular org, or username can be used<br>
+    #
+    # ======
+    #  ENV['SF_ACCESS_TOKEN'] = 'xxxxxxxxxx'
+    #  sf.org.login_access_token instance_url: https://hoge.bar.baz.salesforce.com
+    #
+    # == how to set env variable outside of ruby
+    # In Unix/mac:
+    #   $ SF_ACCESS_TOKEN='xxxxxxxxxx'
+    #   $ ruby app_using_sfcli.rb
+    # or
+    #   $ SF_ACCESS_TOKEN='xxxxxxxxxx' ruby app_using_sfcli.rb
+    #
+    # In Windows:
+    #   $ set SF_ACCESS_TOKEN=xxxxxxxxxx
+    #   $ ruby app_using_sfcli.rb
+    #
+    # 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_org_commands_unified.htm#cli_reference_org_login_access-token_unified]
+    #
+    def login_access_token(instance_url:, target_org: nil)
+      flags = {
+        :"instance-url" => instance_url,
+        :"alias"        => target_org,
+      }
+      switches = {
+        :"no-prompt" => true,
+      }
+      action = __method__.to_s.tr('_', '-').sub('-', ' ')
+      exec action, flags: flags, switches: switches, redirection: :null_stderr
+    end
+  end
+end

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

@@ -0,0 +1,83 @@
+require_relative '../core/base'
+
+module SfCli
+  module Sf
+    module Project
+      # ==== description
+      # The class representing *sf* *project*
+      #
+      # command reference: https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_project_commands_unified.htm
+      #
+      class Core
+        include ::SfCli::Sf::Core::Base
+
+        GenerateResult = Struct.new(:output_dir, :files, :raw_output, :warnings)
+
+        #
+        # generate a Salesforce project
+        #
+        # *name*        --- project name<br>
+        #
+        # *template*    --- project template name<br>
+        #
+        # *output_dir*  --- output directory<br>
+        #
+        # *manifest*    --- switch to create manifest file in the project directory (manifest/package.xml). default: false
+        #
+        # For more command details, see the {reference document}[https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_project_commands_unified.htm#cli_reference_project_generate_unified]
+        #
+        def generate(name, manifest: false, template: nil, output_dir: nil)
+          flags    = {
+            :name         => name,
+            :template     => template,
+            :"output-dir" => output_dir,
+          }
+          switches = {
+            manifest: manifest,
+          }
+          json = exec(__method__, flags: flags, switches: switches, redirection: :null_stderr)
+
+          GenerateResult.new(
+            output_dir: json['result']['outputDir'],
+            files:      json['result']['created'],
+            raw_output: json['result']['rawOutput'],
+            warnings:   json['warnings']
+          )
+        end
+
+        # generate the manifest file of a Salesforce project
+        #
+        # *metadata*    --- an array that consists of metadata type like CustomObject, Layout and so on.  (default: [])<br>
+        #
+        # *api_verson*  --- api version (default: nil)<br>
+        #
+        # *output_dir*  --- manifest's output directory in the project directory. You can use relative path from the project root (default: nil)<br>
+        #
+        # *from_org*    --- username or alias of the org that contains the metadata components from which to build a manifest (default: nil)<br>
+        #
+        # *source_dir*  --- paths to the local source files to include in the manifest (default: nil)
+        #
+        # ======
+        #  sf.project.generate_manifest metadata: %w[CustomObject Layout]  # creates a package.xml, which is initialized with CustomObject and Layout
+        #  sf.project.generate_manifest from_org: <org_name>               # creates a package.xml, which is initialized with all metadata types in the org
+        #
+        # For more command details, see the {reference document}[https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_project_commands_unified.htm#cli_reference_project_generate_manifest_unified]
+        #
+        def generate_manifest(name: nil, output_dir: nil, api_version: nil, metadata: [], from_org: nil, source_dir: nil)
+          flags    = {
+            :name           => name,
+            :"metadata"     => (metadata.empty? ? nil : metadata.join(' ')),
+            :"from-org"     => from_org,
+            :"source-dir"   => source_dir,
+            :"output-dir"   => output_dir,
+            :"api-version"  => api_version,
+          }
+          action = __method__.to_s.tr('_', ' ')
+          json = exec(action, flags: flags, redirection: :null_stderr)
+
+          json['result']['path']
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,50 @@
+require_relative '../core/base'
+
+module SfCli
+  module Sf
+    module Sobject
+      # ==== description
+      # The class representing *sf* *sobject*
+      #
+      # command reference: https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_sobject_commands_unified.htm
+      #
+      class Core
+        include ::SfCli::Sf::Core::Base
+
+        # returns a hash object containing the Salesforce object schema
+        #
+        # *objectType* --- object type (ex: Account)<br>
+        #
+        # *target_org* --- an alias of paticular org, or username can be used<br>
+        #
+        # 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_sobject_commands_unified.htm#cli_reference_sobject_describe_unified]
+        #
+        def describe(object_type, target_org: nil)
+          flags    = {
+            :"sobject"    => object_type,
+            :"target-org" => target_org,
+          }
+          json = exec(__method__, flags: flags, redirection: :null_stderr)
+          json['result']
+        end
+
+        # returns a list of Salesforce object name
+        #
+        # *object_type* --- all or custom<br>
+        #
+        # *target_org* --- an alias of paticular org, or username can be used<br>
+        #
+        # 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_sobject_commands_unified.htm#cli_reference_sobject_list_unified]
+        #
+        def list(object_type, target_org: nil)
+          flags    = {
+            :"sobject"    => (object_type.to_sym == :custom ? :custom : :all),
+            :"target-org" => target_org,
+          }
+          json = exec(__method__, flags: flags, redirection: :null_stderr)
+          json['result']
+        end
+      end
+    end
+  end
+end

data/lib/sf_cli.rb

@@ -1 +1,19 @@
-require 'sf_cli/sf'
+require 'sf_cli/sf/main'
+#
+# the global method that represents *sf* command.
+#
+# With method chaining, you can use similar syntax as original command.
+#
+# == examples
+#
+# ======
+#   sf.org.display # => returns the org information object
+#
+# ======
+#   sf.data.query "SELECT Name FROM Account" # => [{"Name"=>"Aethna Home Products"}]
+#
+# For details of sf command, see the {reference guide}[https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_unified.htm]
+#
+def sf
+  SfCli::Sf::Main.instance
+end

metadata

@@ -1,37 +1,60 @@
 --- !ruby/object:Gem::Specification
 name: sf_cli
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.5
 platform: ruby
 authors:
 - Takanobu Maekawa
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-08-25 00:00:00.000000000 Z
+date: 2024-09-08 00:00:00.000000000 Z
 dependencies: []
-description: This is a class library for introducing Salesforce CLI.Currenty only
-  sf command is the target of development.
-email: 
+description: This is a class library for introducing Salesforce CLI to Ruby scripting.
+  Currenty only sf command is the target of development.
+email:
 executables: []
 extensions: []
 extra_rdoc_files:
 - README.rdoc
+- CHANGELOG.md
 files:
+- CHANGELOG.md
 - README.rdoc
 - lib/sf_cli.rb
-- lib/sf_cli/sf.rb
-- lib/sf_cli/sf/base.rb
-- lib/sf_cli/sf/data.rb
-- lib/sf_cli/sf/org.rb
-- lib/sf_cli/sf/project.rb
-- lib/sf_cli/sf/sobject.rb
+- lib/sf_cli/sf/core/base.rb
+- lib/sf_cli/sf/data/bulk_result_v2.rb
+- lib/sf_cli/sf/data/core.rb
+- lib/sf_cli/sf/data/create_record.rb
+- lib/sf_cli/sf/data/delete_bulk.rb
+- lib/sf_cli/sf/data/delete_record.rb
+- lib/sf_cli/sf/data/delete_resume.rb
+- lib/sf_cli/sf/data/get_record.rb
+- lib/sf_cli/sf/data/helper_methods.rb
+- lib/sf_cli/sf/data/query.rb
+- lib/sf_cli/sf/data/query_helper.rb
+- lib/sf_cli/sf/data/resume.rb
+- lib/sf_cli/sf/data/search.rb
+- lib/sf_cli/sf/data/update_record.rb
+- lib/sf_cli/sf/data/upsert_bulk.rb
+- lib/sf_cli/sf/data/upsert_resume.rb
+- lib/sf_cli/sf/main.rb
+- lib/sf_cli/sf/model.rb
+- lib/sf_cli/sf/model/class_definition.rb
+- lib/sf_cli/sf/model/generator.rb
+- lib/sf_cli/sf/model/schema.rb
+- lib/sf_cli/sf/org/core.rb
+- lib/sf_cli/sf/org/display.rb
+- lib/sf_cli/sf/org/list.rb
+- lib/sf_cli/sf/org/login.rb
+- lib/sf_cli/sf/project/core.rb
+- lib/sf_cli/sf/sobject/core.rb
 homepage: https://github.com/tmkw/sf_cli
 licenses:
 - MIT
 metadata:
   homepage_url: https://github.com/tmkw/sf_cli
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -46,9 +69,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements:
-- 'Salesforce CLI ( >= 2.54.0): https://developer.salesforce.com/tools/salesforcecli'
+- 'Salesforce CLI ( >= 2.56.7): https://developer.salesforce.com/tools/salesforcecli'
 rubygems_version: 3.5.11
-signing_key: 
+signing_key:
 specification_version: 4
 summary: A library for using Salesforce CLI in Ruby
 test_files: []

data/lib/sf_cli/sf/base.rb

@@ -1,34 +0,0 @@
-module SfCli
-  class Sf
-    class Base
-      def initialize(_sf)
-        @sf  = _sf
-      end
-
-      private
-
-      def exec(action, flags: {}, switches: {}, redirection: nil)
-        sf.exec(category, action, flags: flags, switches: switches, redirection: redirection)
-      end
-
-      def category
-        self.class.name.split('::').last.downcase
-      end
-
-      def field_value_pairs(hash)
-        return nil if hash.nil?
-        return nil if hash.empty?
-
-        hash.each_with_object([]) do|(k,v), arr|
-          value = v.instance_of?(String) ? %|'#{v}'| : v
-          arr << %(#{k}=#{value})
-        end
-        .join(' ')
-      end
-
-      def sf
-        @sf
-      end
-    end
-  end
-end

data/lib/sf_cli/sf/data.rb

@@ -1,148 +0,0 @@
-require_relative './base'
-
-module SfCli
-  class Sf
-    #
-    # ==== description
-    # The class representing *sf* *data*
-    #
-    # https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_data_commands_unified.htm
-    #
-    class Data < Base
-
-      # 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 data model class representing the record object.<br> 
-      #
-      # ==== examples
-      #   sf.data.query('SELECT Id, Name From Account Limit 3') # returns an array of Hash object
-      #
-      #   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
-      #
-      def query(soql, target_org: nil, model_class: nil)
-        flags    = {
-          :"query"    => %("#{soql}"),
-          :"target-org" => target_org,
-        }
-        json = exec(__method__, flags: flags, redirection: :null_stderr)
-
-        json['result']['records'].each_with_object([]) do |h, a|
-          h.delete "attributes"
-          a << (model_class ? model_class.new(**h) : h)
-        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 data model class representing the record object.<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
-      #
-      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}
-      #
-      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
-      #
-      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'}
-      #
-      #
-      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
-end

data/lib/sf_cli/sf/org.rb

@@ -1,49 +0,0 @@
-require_relative './base'
-
-module SfCli
-  class Sf
-    #
-    # ==== description
-    # The class representing *sf* *org*.
-    #
-    # https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_org_commands_unified.htm
-    #
-    class Org < Base
-      ConnectionInfo = Struct.new(:id, :access_token, :alias, :instance_url, :user_name, :api_version, :status)
-
-      # login to the org by the browser. (equivalent to *sf* *org* *login* *web*)
-      #
-      # *target_org* --- an alias of paticular org, not default one<br>
-      # *instance_url* --- custom login url.
-      #
-      def login_web(target_org: nil, instance_url: nil)
-        flags    = {
-          :"alias"        => target_org,
-          :"instance-url" => instance_url,
-        }
-        action = __method__.to_s.tr('_', ' ')
-        exec(action, flags: flags)
-      end
-
-      #
-      # returns the org's connection information. (equivalent to *sf* *org* *display*)
-      #
-      # *target_org* --- an alias of paticular org, not default one<br>
-      #
-      def display(target_org: nil)
-        flags    = {:"target-org" => target_org}
-        json = exec(__method__, flags: flags, redirection: :null_stderr)
-
-        ConnectionInfo.new(
-          id:           json['result']['id'],
-          access_token: json['result']['accessToken'],
-          alias:        json['result']['alias'],
-          instance_url: json['result']['instanceUrl'],
-          user_name:    json['result']['username'],
-          api_version:  json['result']['apiVersion'],
-          status:       json['result']['connectedStatus']
-        )
-      end
-    end
-  end
-end