ghcurl 0.8.1 → 0.9.1

data/bin/ghcurl

@@ -1,525 +1,584 @@
-#!/usr/bin/env ruby
-# ------------------------------------------------------
-# File          : ghcurl.rb
-# Authors       : ccmywish <ccmywish@qq.com>
-# Created on    : <2022-04-12>
-# Last modified : <2022-04-30>
-#
-# ghcurl:
-#
-#   Download files and install from Github releases
-#
-# ------------------------------------------------------
-
-require 'ghcurl'
-require 'highline'
-require 'cliswitch'
-require 'fileutils'
-
-module Ghcurl
-
-  WAREHOUSE = File.expand_path("~/.cache/ghcurl")
-  BIN_PATH  = ENV['GHCURL_BIN_PATH'].chomp('/') || "/usr/local/bin"
-  HL = HighLine.new
-
-  class Error < StandardError; end
-
-
-  def bold(str)       "\e[1m#{str}\e[0m" end
-  def green(str)      "\e[32m#{str}\e[0m" end
-  def blue(str)       "\e[34m#{str}\e[0m" end
-
-  
-  def log(msg)
-    puts blue(bold("ghcurl: #{msg}"))
-  end
-  
-
-  #
-  # @return absolute download path
-  #
-  def curl(url, name, to)
-    if to == nil
-      to = WAREHOUSE + '/' + name
-    elsif test 'd', to
-      to = to.chomp('/')  + '/' + name
-    elsif to.include?('/')
-      # noop
-    else
-      # just a rename in WAREHOUSE
-      to = WAREHOUSE + '/' + name
-    end
-
-    cmd = "curl -L #{url} --create-dirs -o #{to}"
-    status = system cmd
-    if status == false || status.nil?
-      log "Download error!"
-      exit
-    end
-    log "Downloaded to #{to}"
-    return to
-  end
-
-
-  def get_filters
-
-    arches = [ 
-                ['amd64', 'x86_64', 'x64'], 
-                ['386',   'i686'],
-                ['arm64', 'aarch64'], 
-                ['armv6', 'arm'],
-             ]
-    
-    oses = [
-             ['linux'],
-             ['freebsd'],
-             ['mac', 'apple', 'darwin'],
-             ['windows']
-           ]
-
-    fs = RUBY_PLATFORM.split('-')
-    os = ""
-    arch = ""
-    fs.each do |f|
-      case f
-      when 'linux'  then os = 'linux'
-      when 'mac','macOS' then os = 'mac'
-      when 'ucrt', 'mingw', 'windows' then os = 'windows' 
-      when 'x86_64' then arch = 'x86_64'
-      when 'x86'    then arch = 'x86'
-      when 'amd64'  then arch = 'amd64'  
-      when 'arm64'  then arch = 'arm64' 
-      when 'armv6'  then arch = 'armv6' 
-      end
-    end
-
-    approval, refuse  = [], []
-    # [os, arch].each { approval << _1 unless _1.nil? }
-
-    if os 
-      i = oses.each_with_index do |type, index|
-        break index if type.include? os
-      end
-      if !i.nil?
-        tmp = oses.dup
-        tmp.delete_at(i)
-        refuse.concat tmp.flatten
-      end
-    end
-
-
-    if arch
-      i = arches.each_with_index do |type, index|
-        break index if type.include? arch
-      end
-      if !i.nil?
-        tmp = arches.dup
-        tmp.delete_at(i)
-        refuse.concat tmp.flatten
-      end
-    end
-
-    # Debug
-    # puts "=> Approval and refuse"
-    # p [os, arch]
-    # p refuse
-    
-    # Now we only refuse others
-    return refuse
-  
-  end
-
-
-  def download(repo, regexp, version: nil, download_to: nil)
-
-    require 'octokit'
-
-    # adjust repo name : user/repo
-    if repo =~ /^https:\/\/github.com/
-      require 'uri'
-      uri = URI(repo)
-      # index 1, take 2
-      repo = uri.path.split('/')[1,2].join('/')
-    elsif !repo.include?('/')
-      got_repo = DEFAULT_WARES[repo.to_sym]
-      if not got_repo
-        user = HL.ask "Who developed the awesome #{repo}? "
-        repo = user + '/' + repo
-      else
-        repo = got_repo
-        log "Use the popular repo #{repo}"
-      end
-    end
-
-    log "checking..."
-    begin
-      unless version
-        doc = Octokit::Client.new.latest_release(repo)
-      else
-        doc = Octokit::Client.new.release_for_tag(repo, 'v' + version)
-      end
-    rescue Octokit::NotFound
-      log "Not found #{repo} v#{version} !"
-      exit
-    rescue StandardError => e
-      log e
-      exit
-    end
-
-    links = doc.to_hash[:assets]
-    if links.empty?
-      log <<~EOE
-      The search result is empty, check the args!
-              repo:    #{repo}
-              version: #{version ? version:'nil'}
-      
-      Maybe there's no assets in this release
-      EOE
-      exit 0
-    end
-
-    links = links.map { _1[:browser_download_url] }
-
-
-    if regexp 
-      filtered = links.select do
-        _1 =~ /#{regexp}/
-      end
-    else
-      refuse = get_filters()    
-      filtered = links.select do |l|
-        refuse.all? do |f|
-          l !~ /#{f}/
-        end
-      end
-    end
-
-
-    if filtered.size == 1
-      link = filtered[0].split('/').last 
-    else 
-      if filtered.size == 0
-        links_for_user = links.map { _1.split('/').last }
-      else
-        links_for_user = filtered.map { _1.split('/').last }
-      end
-      link = HL.choose do |menu|
-        menu.index_color  = :rgb_77bbff
-        menu.prompt = "Which one do you want to download? "
-        menu.choices( *links_for_user )
-      end
-    end
-
-    url = links[0].split('/')[0..-2].join('/') + '/' + link
-
-    log "Downloading #{url}"
-    
-    dl_name = link.split('/').last
-
-    return curl(url, dl_name, download_to)
-  end
-
-
-  #
-  # This function is a little confusing
-  #
-  # target: The absolute path to a downloaded file
-  # name  : The software name
-  #
-  def install(target, rename_as: nil,  install_to: nil)
-
-    if target.end_with?('.deb')
-      log "Install the deb package"
-      system "sudo dpkg -i #{target}"
-      return
-    end
-
-    if target.end_with?('.rpm')
-      log "Install the rpm package"
-      system "sudo rpm -i #{target}"
-      return
-    end
-
-
-    if install_to.nil?
-      install_to = BIN_PATH
-    end
-
-
-    #
-    # Handle zip situation
-    #
-    zip_flag = false
-
-    if target.match?(/\.zip$/) or target.match?(/\.tar\.(\w){1,3}/)
-
-      zip_flag = true
-
-      # unzipped to dir
-      unzip_dir = ""
-      # unzipped files
-      files = ""
-      # the target unzipped file name (this includes the path prefix)
-      unzip_name = ""
-
-    # unzip 
-    if target.match? /\.zip$/
-      log "Unzip zip file"
-      unzip_dir = target.chomp('.zip')
-      system "unzip -q #{target} -d #{unzip_dir}"
-    end
-    
-    # .gz, .bz2, .xz
-    if target.match? /\.tar\.(\w){1,3}/
-      log "Unzip tar file"
-      unzip_dir = target.split('.')[0..-3].join('.')
-      FileUtils.mkdir_p(unzip_dir)
-      system "tar xf #{target} --directory=#{unzip_dir}"
-    end
-    
-
-    #
-    # @return [Array] file names in the dir
-    #
-    def _iterate_dir(dir)
-      result = []
-      chd = Dir.children(dir)
-      chd_files = chd.select{|f| File.file? "#{dir}/#{f}"}
-      
-      chd_files.each { result << "#{dir}/#{_1}"[2..] }
-
-      chd_dirs  = chd.select{|d| File.directory?("#{dir}/#{d}") && ( d != '.git')}
-      chd_dirs.each do |d|
-        sub_dir = "#{dir}/#{d}"
-        result.concat _iterate_dir(sub_dir)
-      end
-      result
-    end
-    
-
-    Dir.chdir unzip_dir do
-      files = _iterate_dir('.')
-    end
-
-    
-    if files.size > 1
-      unzip_name = HL.choose do |menu|
-        menu.index_color  = :rgb_77bbff
-        menu.prompt = "Which one do you want to install? "
-        menu.choices( *files )
-      end
-    else
-      unzip_name = files[0]
-    end
-
-    end # end of zipped file handle
-
-
-    # Get software real name
-    if zip_flag
-      name = unzip_name.split('/').last
-    else
-      name = target.split('/').last
-    end
-
-
-    if (name.size > 10     ||
-        name.include?('.') ||
-        name.include?('-') ||
-        name.include?('_')) && (not rename_as)
-      log "Do you want to rename the '#{name}'?"
-      re = HL.ask "Input new name, or leave it blank to not rename."
-      if !re.empty? 
-        rename_as = re
-      end
-    end
-
-
-    if zip_flag
-      # Now: 
-      #   target     is /home/xx/xx.zip
-      #   unzip_dir  is /home/xx/xx
-      #   unzip_file is            abc/cde/file (new target)
-      target = unzip_dir + '/' + unzip_name
-    end
-
-    log "Renamed as '#{rename_as}'" if rename_as 
-
-
-    case RUBY_PLATFORM
-    when /ucrt/i, /mingw/i
-      install_on_windows(target, name, install_to, rename_as)
-    else
-      install_on_nix(target, name, install_to, rename_as)
-    end
-  end
-
-
-  #
-  # @param target [String] the absulute path of to be installed software 
-  # @param name   [String] the name of the software
-  #
-  def install_on_nix(target, name, install_to, rename_as)
-    install_to = install_to.chomp('/')  
-
-    if test 'd', install_to
-      log "Ready to install #{name}"
-      if rename_as
-        dest = "#{install_to}/#{rename_as}"
-        system "sudo cp #{target} " + dest
-        system "sudo chmod +x " + dest
-        log "Installed as " + dest
-      else
-        cmd = "sudo install -Dt #{install_to} -m 755 #{target} "
-        system cmd
-        log "Install #{name} to " + install_to
-      end
-      log "Install finish!"
-    else
-      log "#{install_to} is not a directory!"
-    end
-
-  end
-
-
-  def install_on_windows(target, name, install_to, rename_as)
-    log "Sorry, not implemented yet on Windows! Can you help?"
-  end
-
-
-  #
-  # For -l option
-  #
-  def list_wares
-    FileUtils.mkdir_p(WAREHOUSE)
-    puts blue("ghcurl: #{WAREHOUSE}")
-    Dir.children(WAREHOUSE).each_with_index do |dict,i|
-      puts "#{blue(i+1)}. #{bold(green(dict))}"
-    end
-  end
-
-
-  #
-  # For -d option
-  #
-  def delete_wares(name)
-    begin 
-
-    if name.nil? 
-      re = HL.ask "Do you want to delete all downloaded files? [Y/n]"
-      case re.downcase
-      when '','y','ye','yes','true'
-        FileUtils.rm_rf WAREHOUSE
-        log "Delete all done"
-      end
-    else
-      FileUtils.rm WAREHOUSE + '/' + name
-      log "Delete #{name} done"
-    end
-
-    rescue Exception => e
-      puts bold(red("ghcurl: #{e}"))
-      list_wares
-    end
-
-  end # end def delete_wares
-
-
-  def help
-    puts <<~EOC
-    ghcurl (v#{VERSION}): Download files and install from Github releases
-
-    Default install to env 'GHCURL_BIN_PATH' or /usr/local/bin
-
-    usage:
-      ghcurl [user]/repo [regexp]   => Search latest version with regexp to download
-      ghcurl repo [re] -v tag       => Download a specific tag version
-      ghcurl repo [re] -o [path]    => Download into path or rename
-      ghcurl repo [re] -i [path]    => Download and install to path
-      ghcurl repo [re] -o [path] -i => Download into path and install
-      ghcurl repo [re] -i -r name   => Download and install as 'name'
-      ghcurl -l                     => List downloaded files
-      ghcurl -d [name]              => Delete a downloaded file or all
-      ghcurl -h                     => Print this help
-
-    example:
-      ghcurl bat         => Search sharkdp/bat the latest
-      ghcurl cli deb -i  => Search cli/cli /deb/
-      ghcurl rbspy/rbspy 'x86_64.*linux' -v0.11.1
-      ghcurl dlvhdr/gh-dash linux-amd64 -i -r 'gd'
-
-    EOC
-  end
-
-end
-
-
-
-####################
-# main: CLI Handling
-####################
-extend Ghcurl
-
-class Ghcurl::CLI < CliSwitch
-  option name: 'install', short: '-i', arg_required: 'optional'
-  option name: 'output',  short: '-o', long: '--output', arg_required: 'required'
-  option name: 'rename',  short: '-r', arg_required: 'required'
-  option name: 'version', short: '-v', arg_required: 'required'
-  option name: 'help',    short: '-h', long: '--help', arg_required: 'noarg'
-  option name: 'list',    short: '-l', arg_required: 'noarg'
-  option name: 'delete',  short: '-d', arg_required: 'optional'
-end
-
-args, opts = Ghcurl::CLI.new.parse(ARGV)
-
-if args.empty? and opts.empty?
-  help
-  exit 
-end
-
-
-repo_or_name, regexp = args[0], args[1]
-version = nil
-need_install = false
-download_to = nil
-install_to = nil
-rename_as  = nil
-
-opts.each do 
-  case _1.name 
-  when 'help'
-    help
-    exit
-  when 'list'
-    list_wares
-    exit
-  when 'delete'
-    delete_wares(_1.next_arg)
-    exit
-  when 'version'
-    version = _1.next_arg
-  when 'output'
-    download_to = _1.next_arg
-  when 'install'
-    need_install = true
-    install_to = _1.next_arg
-  when 'rename'
-    rename_as = _1.next_arg
-  end
-end
-
-# Debug
-# p repo_or_name
-# p regexp
-# p need_install
-# p download_to
-# p install_to
-# p rename_as
-
-begin
-ware = download(repo_or_name, regexp, version: version, download_to: download_to)
-if need_install
-  install(ware, rename_as: rename_as, install_to: install_to)
-end
-rescue Interrupt
-end
+#!/usr/bin/env ruby
+# ------------------------------------------------------
+# File          : ghcurl.rb
+# Authors       : ccmywish <ccmywish@qq.com>
+# Created on    : <2022-04-12>
+# Last modified : <2022-11-13>
+#
+# ghcurl:
+#
+#   Download files and install from Github releases
+#
+# ------------------------------------------------------
+
+require 'ghcurl'
+require 'highline'
+require 'cliswitch'
+require 'fileutils'
+
+module Ghcurl
+
+  WAREHOUSE = File.expand_path("~/.cache/ghcurl")
+  if  ENV['GHCURL_BIN_PATH'] 
+    BIN_PATH = ENV['GHCURL_BIN_PATH'].chomp('/')
+  else
+    BIN_PATH = "/usr/local/bin"
+  end
+  HL = HighLine.new
+
+  class Error < StandardError; end
+
+
+  def bold(str)       "\e[1m#{str}\e[0m" end
+  def green(str)      "\e[32m#{str}\e[0m" end
+  def blue(str)       "\e[34m#{str}\e[0m" end
+
+  
+  def log(msg)
+    puts blue(bold("ghcurl: #{msg}"))
+  end
+  
+
+  #
+  # @return absolute download path
+  #
+  def curl(url, name, to)
+    if to == nil
+      to = WAREHOUSE + '/' + name
+    elsif test 'd', to
+      to = to.chomp('/')  + '/' + name
+    elsif to.include?('/')
+      # noop
+    else
+      # just a rename in WAREHOUSE
+      to = WAREHOUSE + '/' + name
+    end
+
+    cmd = "curl -L #{url} --create-dirs -o #{to}"
+    status = system cmd
+    if status == false || status.nil?
+      log "Download error!"
+      exit
+    end
+    log "Downloaded to #{to}"
+    return to
+  end
+
+
+  def get_filters
+
+    arches = [ 
+              # NOTE: Here we can't add 'x86' to the first group!
+              # Because we finally use simple "string compare" to filter out 
+              # the improper links. 
+              # If added, when we filter out the 'x86'(first group), 
+              # the leading 'x86' will remove 'x86_64'(the second group) too!!!
+                ['i386', 'i686'           ],
+                ['x64',  'x86_64', 'amd64'], 
+                
+                ['armv6', 'arm'           ],
+                ['armv7'                  ],
+                ['armv8', 'arm64', 'aarch64'], 
+             ]
+    
+    oses = [
+             ['linux'],
+             ['freebsd'],
+             ['mac', 'apple', 'darwin'],
+             ['windows']
+           ]
+
+    # OS and Arch filters
+    fs = RUBY_PLATFORM.split('-')
+    os = ""
+    arch = ""
+    fs.each do |f|
+      case f
+      when 'linux'         then os = 'linux'
+      when 'mac',  'macOS' then os = 'mac'
+      when 'freebsd'       then os = 'freebsd'
+      when 'ucrt', 'mingw', 'windows' then os = 'windows' 
+      end
+    end
+
+    # Why we choose to REFUSE filters rather than APPROVE filters?
+    # The answer is here, you may notice, different developers decide to
+    # name their distribution differently according to the same arch. 
+    #
+    # For example, if a bin file is called "ruby_analyse.exe"
+    # The developer may call it (ONLY ONE of below):
+    #   1. ruby_analyse-windows-x64.exe
+    #   2. ruby_analyse-windows-x86_64.exe
+    #   3. ruby_analyse-windows-amd64.exe
+    # 
+    # Think of the situation: 
+    #   When we decide the native arch is "x86-64", and the developer gives 
+    #   the name 'xxx-amd64', we will filter the link out wrongly ....
+    #
+    # So, we can't target the download link via arch. However, we can 
+    # see them a group of possible names, then REFUSE other name of 
+    # other arches.
+    #
+    fs.each do |f|
+      case f
+      when 'x64',  'x86_64', 'amd64'    then arch = 'x86_64'        
+      when 'x86',  'i386',   'i686'     then arch = 'x86'
+      
+      when 'arm64', 'armv8',  'aarch64' then arch = 'arm64' 
+      when 'armv6', 'arm'               then arch = 'armv6' 
+      when 'armv7'                      then arch = 'armv7' 
+      end
+    end
+
+    approval, refuse  = [], []
+    # [os, arch].each { approval << _1 unless _1.nil? }
+
+    if os 
+      i = oses.each_with_index do |type, index|
+        break index if type.include? os
+      end
+      if !i.nil?
+        tmp = oses.dup
+        tmp.delete_at(i)
+        refuse.concat tmp.flatten
+      end
+    end
+
+
+    if arch
+      i = arches.each_with_index do |type, index|
+        break index if type.include? arch
+      end
+      if !i.nil?
+        tmp = arches.dup
+        tmp.delete_at(i)
+        refuse.concat tmp.flatten
+      end
+    end
+
+    # DEBUG
+    # puts "=> Approval and refuse"
+    # p [os, arch]
+    # p refuse
+    
+    # Now we only refuse others
+    return refuse
+  
+  end
+
+
+  def download(repo, regexp, version: nil, download_to: nil)
+
+    require 'octokit'
+
+    # adjust repo name : user/repo
+    if repo =~ /^https:\/\/github.com/
+      require 'uri'
+      uri = URI(repo)
+      # index 1, take 2
+      repo = uri.path.split('/')[1,2].join('/')
+    elsif !repo.include?('/')
+      got_repo = DEFAULT_WARES[repo.to_sym]
+      if not got_repo
+        user = HL.ask "Who developed the awesome #{repo}? "
+        repo = user + '/' + repo
+      else
+        repo = got_repo
+        log "Use the popular repo #{repo}"
+      end
+    end
+
+    log "checking..."
+    begin
+      unless version
+        doc = Octokit::Client.new.latest_release(repo)
+      else
+        doc = Octokit::Client.new.release_for_tag(repo, 'v' + version)
+      end
+    rescue Octokit::NotFound
+      log "Not found #{repo} v#{version} !"
+      exit
+    rescue StandardError => e
+      log e
+      exit
+    end
+
+    links = doc.to_hash[:assets]
+    if links.empty?
+      log <<~EOE
+      The search result is empty, check the args!
+              repo:    #{repo}
+              version: #{version ? version:'nil'}
+      
+      Maybe there's no assets in this release
+      EOE
+      exit 0
+    end
+
+    links = links.map { _1[:browser_download_url] }
+
+
+    if regexp 
+      filtered = links.select do
+        _1 =~ /#{regexp}/
+      end
+    else
+      refuse = get_filters()    
+      filtered = links.select do |l|
+        refuse.all? do |f|
+          l !~ /#{f}/
+        end
+      end
+    end
+
+
+    if filtered.size == 1
+      link = filtered[0].split('/').last 
+    else 
+      if filtered.size == 0
+        links_for_user = links.map { _1.split('/').last }
+      else
+        links_for_user = filtered.map { _1.split('/').last }
+      end
+      link = HL.choose do |menu|
+        menu.index_color  = :rgb_77bbff
+        menu.prompt = "Which one do you want to download? "
+        menu.choices( *links_for_user )
+      end
+    end
+
+    url = links[0].split('/')[0..-2].join('/') + '/' + link
+
+    log "Downloading #{url}"
+    
+    dl_name = link.split('/').last
+
+    return curl(url, dl_name, download_to)
+  end
+
+
+  #
+  # This function is a little confusing
+  #
+  # target: The absolute path to a downloaded file
+  # name  : The software name
+  #
+  def install(target, rename_as: nil,  install_to: nil)
+
+    if target.end_with?('.deb')
+      log "Install the deb package"
+      system "sudo dpkg -i #{target}"
+      return
+    end
+
+    if target.end_with?('.rpm')
+      log "Install the rpm package"
+      system "sudo rpm -i #{target}"
+      return
+    end
+
+
+    if install_to.nil?
+      install_to = BIN_PATH
+    end
+
+
+    #
+    # Handle zip situation
+    #
+    zip_flag = false
+
+    if target.match?(/\.zip$/) or target.match?(/\.tar\.(\w){1,3}/)
+
+      zip_flag = true
+
+      # unzipped to dir
+      unzip_dir = ""
+      # unzipped files
+      files = ""
+      # the target unzipped file name (this includes the path prefix)
+      unzip_name = ""
+
+    # unzip 
+    if target.match? /\.zip$/
+      log "Unzip zip file"
+      unzip_dir = target.chomp('.zip')
+      system "unzip -q #{target} -d #{unzip_dir}"
+    end
+    
+    # .gz, .bz2, .xz
+    if target.match? /\.tar\.(\w){1,3}/
+      log "Unzip tar file"
+      unzip_dir = target.split('.')[0..-3].join('.')
+      FileUtils.mkdir_p(unzip_dir)
+      system "tar xf #{target} --directory=#{unzip_dir}"
+    end
+    
+
+    #
+    # @return [Array] file names in the dir
+    #
+    def _iterate_dir(dir)
+      result = []
+      chd = Dir.children(dir)
+      chd_files = chd.select{|f| File.file? "#{dir}/#{f}"}
+      
+      chd_files.each { result << "#{dir}/#{_1}"[2..] }
+
+      chd_dirs  = chd.select{|d| File.directory?("#{dir}/#{d}") && ( d != '.git')}
+      chd_dirs.each do |d|
+        sub_dir = "#{dir}/#{d}"
+        result.concat _iterate_dir(sub_dir)
+      end
+      result
+    end
+    
+
+    Dir.chdir unzip_dir do
+      files = _iterate_dir('.')
+    end
+
+    
+    if files.size > 1
+      unzip_name = HL.choose do |menu|
+        menu.index_color  = :rgb_77bbff
+        menu.prompt = "Which one do you want to install? "
+        menu.choices( *files )
+      end
+    else
+      unzip_name = files[0]
+    end
+
+    end # end of zipped file handle
+
+
+    # Get software real name
+    if zip_flag
+      name = unzip_name.split('/').last
+    else
+      name = target.split('/').last
+    end
+
+
+    if (name.size > 10     ||
+        name.include?('.') ||
+        name.include?('-') ||
+        name.include?('_')) && (not rename_as)
+      log "Do you want to rename the '#{name}'?"
+      re = HL.ask "Input new name, or leave it blank to not rename."
+      if !re.empty? 
+        rename_as = re
+      end
+    end
+
+
+    if zip_flag
+      # Now: 
+      #   target     is /home/xx/xx.zip
+      #   unzip_dir  is /home/xx/xx
+      #   unzip_file is            abc/cde/file (new target)
+      target = unzip_dir + '/' + unzip_name
+    end
+
+    log "Renamed as '#{rename_as}'" if rename_as 
+
+
+    case RUBY_PLATFORM
+    when /ucrt/i, /mingw/i
+      install_on_windows(target, name, install_to, rename_as)
+    else
+      install_on_nix(target, name, install_to, rename_as)
+    end
+  end
+
+
+  #
+  # @param target [String] the absulute path of to be installed software 
+  # @param name   [String] the name of the software
+  #
+  def install_on_nix(target, name, install_to, rename_as)
+    install_to = install_to.chomp('/')  
+
+    if test 'd', install_to
+      log "Ready to install #{name}"
+      if rename_as
+        dest = "#{install_to}/#{rename_as}"
+        system "sudo cp #{target} " + dest
+        system "sudo chmod +x " + dest
+        log "Installed as " + dest
+      else
+        cmd = "sudo install -Dt #{install_to} -m 755 #{target} "
+        system cmd
+        log "Install #{name} to " + install_to
+      end
+      log "Install finish!"
+    else
+      log "#{install_to} is not a directory!"
+    end
+
+  end
+
+
+  def install_on_windows(target, name, install_to, rename_as)
+    if !ENV['GHCURL_BIN_PATH']
+      log "Sorry, you must specify 'GHCURL_BIN_PATH' environment variable to install on Windows!"
+      return 
+    end
+
+    install_to = install_to.chomp('/')  
+
+    if test 'd', install_to
+      log "Ready to install #{name}"
+      if rename_as
+        rename_as = rename_as + '.exe' unless rename_as.end_with?('.exe')
+        dest = "#{install_to}/#{rename_as}"
+        FileUtils.cp(target, dest)
+        log "Installed as " + dest
+      else      
+        FileUtils.cp(target, install_to)
+        log "Install #{name} to " + install_to
+      end
+      log "Install finish!"
+    else
+      log "#{install_to} is not a directory!"
+    end
+    
+  end
+
+
+  #
+  # For -l option
+  #
+  def list_wares
+    FileUtils.mkdir_p(WAREHOUSE)
+    puts blue("ghcurl: #{WAREHOUSE}")
+    Dir.children(WAREHOUSE).each_with_index do |dict,i|
+      puts "#{blue(i+1)}. #{bold(green(dict))}"
+    end
+  end
+
+
+  #
+  # For -d option
+  #
+  def delete_wares(name)
+    begin 
+
+    if name.nil? 
+      re = HL.ask "Do you want to delete all downloaded files? [Y/n]"
+      case re.downcase
+      when '','y','ye','yes','true'
+        FileUtils.rm_rf WAREHOUSE
+        log "Delete all done"
+      end
+    else
+      FileUtils.rm WAREHOUSE + '/' + name
+      log "Delete #{name} done"
+    end
+
+    rescue Exception => e
+      puts bold(red("ghcurl: #{e}"))
+      list_wares
+    end
+
+  end # end def delete_wares
+
+
+  def help
+    puts <<~EOC
+    ghcurl (v#{VERSION}): Download files and install from Github releases
+
+    Default install to env 'GHCURL_BIN_PATH' or /usr/local/bin
+
+    usage:
+      ghcurl [user]/repo [regexp]   => Search latest version with regexp to download
+      ghcurl repo [re] -v tag       => Download a specific tag version
+      ghcurl repo [re] -o [path]    => Download into path or rename
+      ghcurl repo [re] -i [path]    => Download and install to path
+      ghcurl repo [re] -o [path] -i => Download into path and install
+      ghcurl repo [re] -i -r name   => Download and install as 'name'
+      ghcurl -l                     => List downloaded files
+      ghcurl -d [name]              => Delete a downloaded file or all
+      ghcurl -h                     => Print this help
+
+    example:
+      ghcurl bat         => Search sharkdp/bat the latest
+      ghcurl cli deb -i  => Search cli/cli /deb/
+      ghcurl rbspy/rbspy 'x86_64.*linux' -v0.11.1
+      ghcurl dlvhdr/gh-dash linux-amd64 -i -r 'gd'
+
+    EOC
+  end
+
+end
+
+
+
+####################
+# main: CLI Handling
+####################
+extend Ghcurl
+
+class Ghcurl::CLI < CliSwitch
+  option name: 'install', short: '-i', arg_required: 'optional'
+  option name: 'output',  short: '-o', long: '--output', arg_required: 'required'
+  option name: 'rename',  short: '-r', arg_required: 'required'
+  option name: 'version', short: '-v', arg_required: 'required'
+  option name: 'help',    short: '-h', long: '--help', arg_required: 'noarg'
+  option name: 'list',    short: '-l', arg_required: 'noarg'
+  option name: 'delete',  short: '-d', arg_required: 'optional'
+end
+
+args, opts = Ghcurl::CLI.new.parse(ARGV)
+
+if args.empty? and opts.empty?
+  help
+  exit 
+end
+
+
+repo_or_name, regexp = args[0], args[1]
+version = nil
+need_install = false
+download_to = nil
+install_to = nil
+rename_as  = nil
+
+opts.each do 
+  case _1.name 
+  when 'help'
+    help
+    exit
+  when 'list'
+    list_wares
+    exit
+  when 'delete'
+    delete_wares(_1.next_arg)
+    exit
+  when 'version'
+    version = _1.next_arg
+  when 'output'
+    download_to = _1.next_arg
+  when 'install'
+    need_install = true
+    install_to = _1.next_arg
+  when 'rename'
+    rename_as = _1.next_arg
+  end
+end
+
+# Debug
+# p repo_or_name
+# p regexp
+# p need_install
+# p download_to
+# p install_to
+# p rename_as
+
+begin
+ware = download(repo_or_name, regexp, version: version, download_to: download_to)
+if need_install
+  install(ware, rename_as: rename_as, install_to: install_to)
+end
+rescue Interrupt
+end