Class: Migr8::Application

Inherits:
Object
  • Object
show all
Defined in:
lib/migr8.rb

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.main(args = nil) ⇒ Object 



1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
 
# File 'lib/migr8.rb', line 1908

def self.main(args=nil)
  #; [!cy0yo] uses ARGV when args is not passed.
  args = ARGV if args.nil?
  app = self.new
  begin
    status = app.run(args)
  #; [!maomq] command-option error is cached and not raised.
  rescue Util::CommandOptionError => ex
    script = File.basename($0)
    $stderr << "ERROR[#{script}] #{ex.message}\n"
    status = 1
  #;
  rescue Migr8Error => ex
    script = File.basename($0)
    $stderr << "ERROR[#{script}] #{ex}\n"
    status = 1
  end
  #; [!t0udo] returns status code (0: ok, 1: error).
  return status
end

Instance Method Details

#run(args) ⇒ Object 



1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
 
# File 'lib/migr8.rb', line 1857

def run(args)
  parser = new_cmdopt_parser()
  options = parser.parse(args)   # may raise CommandOptionError
  #; [!dcggy] sets Migr8::DEBUG=true when '-d' or '--debug' specified.
  if options['debug']
    ::Migr8.DEBUG = true
  end
  #; [!ktlay] prints help message and exit when '-h' or '--help' specified.
  if options['help']
    $stdout << self.usage(parser)
    return 0
  end
  #; [!n0ubh] prints version string and exit when '-v' or '--version' specified.
  if options['version']
    $stdout << RELEASE << "\n"
    return 0
  end
  #;
  action_name = args.shift || default_action_name()
  action_class = Actions::Action.find_by_name(action_name)  or
    raise Util::CommandOptionError.new("#{action_name}: unknown action.")
  action_obj = action_class.new
  action_opts = action_obj.parse(args)
  if action_opts['help']
    puts action_obj.usage
  else
    action_obj.run(action_opts, args)
  end
  #; [!saisg] returns 0 as status code when succeeded.
  return 0
end

#usage(parser = nil) ⇒ Object 



1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
 
# File 'lib/migr8.rb', line 1889

def usage(parser=nil)
  parser ||= new_cmdopt_parser()
  script = File.basename($0)
  s = ""
  s << "#{script} -- database schema version management tool\n"
  s << "\n"
  s << "Usage: #{script} [global-options] [action [options] [...]]\n"
  s << parser.usage(20, '  ')
  s << "\n"
  s << "Actions:  (default: #{default_action_name()})\n"
  Migr8::Actions::Action.subclasses.each do |action_class|
    s << action_class.new.short_usage()
  end
  s << "\n"
  s << "(ATTENTION!! Run '#{script} readme' at first if you don't know #{script} well.)\n"
  s << "\n"
  return s
end