pluto 1.2.3 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2a1333bbf4d46791b54f5b77b96d86dbaffcf3a4
-  data.tar.gz: 09d431c970583c027818e707f0f9a24791276fc5
+  metadata.gz: 12c68dae2b3404d2b6bfb5e90d65988a817e05f0
+  data.tar.gz: 63865f5cb4df9d9fa5a6757bc68cdcb895efc732
 SHA512:
-  metadata.gz: c08d13ddf9fe2255d639353319687e3d8cc50df12b8d74dee0a162811775acc744929025bbb861f3606234c532e08baa333650cbd2ffd681a429bc3ae73420b9
-  data.tar.gz: 4ea0263e98596344b7a66d5c7c9d47e659f79b656c4a474d021c0af826ef8360239a4c56091f67c9c09a487ca1e559ade1115ecb9534d630f34fdf9f8d53701f
+  metadata.gz: a2c924baf3e216458ccf3ce8f4234a91a791d3c58f6759fff098681671da13ad07fa93011f7c3fa9c50c6688ce33e5054770f09075ad53df654d5767c023a366
+  data.tar.gz: 9bbb372a6a0804b804d4eebe3e12e71915d5a9d6d3d244c1fa4674b3c7bffcb05dd05c5ef5cb382b977c1c2f67a816b0c49fca72f4363e75435a8c281f45e6e0

data/Manifest.txt

@@ -1,11 +1,11 @@
-HISTORY.md
-Manifest.txt
-README.md
-Rakefile
-bin/pluto
-lib/pluto.rb
-lib/pluto/cli/main.rb
-lib/pluto/cli/opts.rb
-lib/pluto/cli/sysinfo.rb
-lib/pluto/cli/updater.rb
-lib/pluto/cli/version.rb
+HISTORY.md
+Manifest.txt
+README.md
+Rakefile
+bin/pluto
+lib/pluto.rb
+lib/pluto/cli/main.rb
+lib/pluto/cli/opts.rb
+lib/pluto/cli/sysinfo.rb
+lib/pluto/cli/updater.rb
+lib/pluto/cli/version.rb

data/README.md

@@ -8,12 +8,12 @@ from published web feeds.
 * gem       :: [rubygems.org/gems/pluto](https://rubygems.org/gems/pluto)
 * rdoc      :: [rubydoc.info/gems/pluto](http://rubydoc.info/gems/pluto)
 * templates :: [github.com/planet-templates](https://github.com/planet-templates)
-* forum     :: [groups.google.com/group/feedreader](http://groups.google.com/group/feedreader)
+* forum     :: [groups.google.com/group/wwwmake](http://groups.google.com/group/wwwmake)
 
 
 ## Usage
 
-~~~~
+```
 NAME
     pluto - another planet generator - lets you build web pages from published web feeds
 
@@ -35,12 +35,12 @@ COMMANDS
     merge, m      - Merge planet template pack
     about, a      - (Debug) Show more version info
     help          - Shows a list of commands or help for one command
-~~~~
+```
 
 
 #### `build` Command
 
-~~~
+```
 NAME
     build - Build planet
 
@@ -51,20 +51,20 @@ COMMAND OPTIONS
     -o, --output=PATH       - Output Path (default: .)
     -t, --template=MANIFEST - Template Manifest (default: blank)
     -d, --dbpath=PATH       - Database path (default: .)
-    -n, --dbname=NAME       - Database name (default: <PLANET>.db e.g. ruby.db)
+    -n, --dbname=NAME       - Database name (default: planet.db)
 
 EXAMPLE
     pluto build ruby.ini
     pluto build ruby.ini --template news
-    pluto b ruby
-    pluto b ruby -t news
-    pluto b            # will use pluto.ini|pluto.yml|planet.ini|planet.yml if present
-~~~
+    pluto b ruby.ini
+    pluto b ruby.ini -t news
+    pluto b            # will use planet.ini if present
+```
 
 
 #### `list` Command
 
-~~~
+```
 NAME
     list - List installed template packs
 
@@ -74,12 +74,12 @@ SYNOPSIS
 EXAMPLE
    pluto list
    pluto ls
-~~~
+```
 
 
 #### `install` Command
 
-~~~
+```
 NAME
     install - Install template pack
 
@@ -88,31 +88,31 @@ SYNOPSIS
 
 EXAMPLE
    pluto install news      # install "river of news" template pack
-~~~
+```
 
 
 #### `update` Command
 
-~~~
+```
 NAME
     update - Update planet feeds
 
 COMMAND OPTIONS
     -d, --dbpath=PATH       - Database path (default: .)
-    -n, --dbname=NAME       - Database name (default: <PLANET>.db e.g. ruby.db)
+    -n, --dbname=NAME       - Database name (default: planet.db)
 
 SYNOPSIS
     pluto [global options] update FILE
 
 EXAMPLE
     pluto update ruby.ini
-    pluto u ruby
-~~~
+    pluto u ruby.ini
+```
 
 
 #### `merge` Command
 
-~~~
+```
 NAME
     merge - Merge planet template pack
 
@@ -123,14 +123,14 @@ COMMAND OPTIONS
     -o, --output=PATH       - Output Path (default: .)
     -t, --template=MANIFEST - Template Manifest (default: blank)
     -d, --dbpath=PATH       - Database path (default: .)
-    -n, --dbname=NAME       - Database name (default: <PLANET>.db e.g. ruby.db)
+    -n, --dbname=NAME       - Database name (default: planet.db)
 
 EXAMPLE
     pluto merge ruby.ini
     pluto merge ruby.ini --template news
-    pluto m ruby
-    pluto m ruby -t news
-~~~
+    pluto m ruby.ini
+    pluto m ruby.ini -t news
+```
 
 
 ## Install
@@ -142,10 +142,12 @@ Just install the gem:
 
 ## License
 
+![](https://publicdomainworks.github.io/buttons/zero88x31.png)
+
 The `pluto` scripts are dedicated to the public domain.
 Use it as you please with no restrictions whatsoever.
 
 ## Questions? Comments?
 
-Send them along to the [Planet Pluto and Friends Forum/Mailing List](http://groups.google.com/group/feedreader).
+Send them along to the [wwwmake Forum/Mailing List](http://groups.google.com/group/wwwmake).
 Thanks!

data/Rakefile

@@ -11,7 +11,7 @@ Hoe.spec 'pluto' do
   self.urls    = ['https://github.com/feedreader/pluto']
 
   self.author  = 'Gerald Bauer'
-  self.email   = 'feedreader@googlegroups.com'
+  self.email   = 'wwwmake@googlegroups.com'
 
   # switch extension to .markdown for gihub formatting
   self.readme_file  = 'README.md'

data/lib/pluto/cli/main.rb

@@ -1,411 +1,381 @@
-# encoding: utf-8
-
-require 'gli'
-
-
-include GLI::App
-
-program_desc 'another planet generator (lets you build web pages from published web feeds)'
-version PlutoCli::VERSION
-
-
-## some setup code 
-
-LogUtils::Logger.root.level = :info   # set logging level to info 
-
-logger = LogUtils::Logger.root
-
-
-opts    = Pluto::Opts.new
-
-
-
-######
-# begin
-#  move to pluto for reuse (e.g. in rakefile)
-
-def load_config( name )
-  config = INI.load_file( name )
-
-  puts "dump >#{name}<:"
-  pp config
-
-  config
-end
-
-
-def find_default_config_path
-  candidates =  [ 'pluto.ini',
-                  'planet.ini'
-                   ]
-
-  candidates.each do |candidate|
-    return candidate  if File.exists?( candidate )   ## todo: use ./candidate -- why? why not??
-  end
-
-  puts "*** note: no default planet configuration found, that is, no #{candidates.join('|')} found in working folder"
-  nil  # return nil; no conifg existing candidate found/present; sorry
-end
-
-
-def find_config_path( name )
-  extname    = File.extname( name )   # return '' or '.ini' or '.conf' or '.cfg' or '.txt -???' etc.
-
-  return name  if extname.present?    # nothing to do; extension already present
-
-  candidates = [ '.ini' ]
-
-  candidates.each do |candidate|
-    return "#{name}#{candidate}"  if File.exists?( "#{name}#{candidate}" )
-  end
-
-  # no extensions matching; sorry
-  puts "*** note: no configuration found w/ extensions #{candidates.join('|')} for '#{name}'"
-  # todo/check/fix - ?? -skip; remove from arg  - or just pass through ???
-  nil  # return nil; no config found/present; sorry
-end
-
-# end
-#  move to pluto for reuse (e.g. in rakefile)
-###########################
-
-
-
-def expand_config_args( args )
-
-  # 1) no args - try to find default config e.g. pluto.ini etc.
-  if args.length == 0
-    new_arg = find_default_config_path
-
-    return [] if new_arg.nil?
-    return [new_arg] # create a new args w/ one item e.g. ['pluto.yml']
-  end
-
-  # 2) expand extname if no extname and config present
-
-  new_args = []
-  args.each do |arg|
-    new_arg = find_config_path( arg )
-    if new_arg.nil?
-      # skip for now
-    else
-      new_args << new_arg
-    end
-  end
-  new_args
-  
-end # method expand_config_args
-
-
-
-## "global" options (switches/flags)
-
-desc '(Debug) Show debug messages'
-switch [:verbose], negatable: false    ## todo: use -w for short form? check ruby interpreter if in use too?
-
-desc 'Only show warnings, errors and fatal messages'
-switch [:q, :quiet], negatable: false
-
-
-desc 'Configuration Path'
-arg_name 'PATH'
-default_value opts.config_path
-flag [:c, :config] 
-
-
-### note: mostly for debugging lets you fetch individual feeds
-desc 'Fetch feeds'
-arg_name 'FEED', multiple: true   ## todo/fix: check multiple will not print typeo???
-command [:fetch, :f] do |c|
-
-  c.desc 'Database path'
-  c.arg_name 'PATH'
-  c.default_value opts.db_path
-  c.flag [:d, :dbpath]
-
-  c.desc 'Database name'
-  c.arg_name 'NAME'
-  c.default_value opts.db_name
-  c.flag [:n, :dbname]
-
-  c.action do |g,o,args|
-    logger.debug 'hello from fetch command'
-
-    ##  turn on debug flag by default; no need to passing --verbose
-    LogUtils::Logger.root.level = :debug
-    opts.verbose = true
-
-    # add dbname as opts property
-
-    #####
-    # todo: add into method for reuse for build/merge/fetch
-    #   all use the same code
-
-    db_config = {
-      adapter:  'sqlite3',
-      database: "#{opts.db_path}/#{opts.db_name}"
-    }
-
-    Pluto.connect( db_config )
-
-    args.each do |arg|
-      feed_rec = Pluto::Model::Feed.find_by_key!( arg )
-
-      puts "feed_rec:"
-      pp feed_rec
-
-      fetcher = Pluto::FeedFetcherBasic.new
-      fetcher.debug = true  # by default debug is true (only used for debuggin! - save feed to file, etc.)
-
-      feed = fetcher.fetch( feed_rec )
-      ## pp feed
-    end
-
-    puts 'Done.'
-  end
-end # command fetch
-
-
-
-## note: same as build (but without step 1) fetch)
-desc 'Merge planet template pack'
-arg_name 'FILE', multiple: true   ## todo/fix: check multiple will not print typeo???
-command [:merge, :m] do |c|
-
-  c.desc 'Output Path'
-  c.arg_name 'PATH'
-  c.default_value opts.output_path
-  c.flag [:o,:output]
-
-  c.desc 'Template Manifest'
-  c.arg_name 'MANIFEST'
-  c.default_value opts.manifest
-  c.flag [:t, :template]
-
-  c.desc 'Database path'
-  c.arg_name 'PATH'
-  c.default_value opts.db_path
-  c.flag [:d, :dbpath]
-
-  c.desc 'Database name'
-  c.arg_name 'NAME'
-  c.flag [:n, :dbname]
-
-
-  c.action do |g,o,args|
-    logger.debug 'hello from merge command'
-
-    args = expand_config_args( args )   # add missing .ini|.yml extension if missing or add default config (e.g. pluto.ini)
-
-    args.each do |arg|
-      name    = File.basename( arg, '.*' )
-
-      #####
-      # todo: add into method for reuse for build/merge/fetch
-      #   all use the same code
-
-      db_name = opts.db_name? ? opts.db_name : "#{name}.db"
- 
-      db_config = {
-        adapter:  'sqlite3',
-        database: "#{opts.db_path}/#{db_name}"
-      }
-
-      Pluto.connect( db_config )
-
-      config = load_config( arg )
-    
-      Pluto::Formatter.new( opts, config ).run( name )
-    end
-    
-    puts 'Done.'
-  end
-end # command merge
-
-
-## note: same as build (but without step 2) merge)
-desc 'Update planet feeds'
-arg_name 'FILE', multiple: true   ## todo/fix: check multiple will not print typeo???
-command [:update, :up, :u] do |c|
-
-  c.desc 'Database path'
-  c.arg_name 'PATH'
-  c.default_value opts.db_path
-  c.flag [:d, :dbpath]
-
-  c.desc 'Database name'
-  c.arg_name 'NAME'
-  c.flag [:n, :dbname]
-
-
-  c.action do |g,o,args|
-    logger.debug 'hello from update command'
-
-    args = expand_config_args( args )   # add missing .ini|.yml extension if missing or add default config (e.g. pluto.ini)
-
-    args.each do |arg|
-      name    = File.basename( arg, '.*' )
-
-      #####
-      # todo: add into method for reuse for build/merge/fetch
-      #   all use the same code
-
-      db_name = opts.db_name? ? opts.db_name : "#{name}.db"
- 
-      db_config = {
-        adapter:  'sqlite3',
-        database: "#{opts.db_path}/#{db_name}"
-      }
-
-      # Note: use ! version w/ auto-migrate!  - why? why not??
-      ## just use regular connect??
-      Pluto.connect!( db_config )
-
-      config = load_config( arg )
-
-      Pluto::Updater.new( opts, config ).run( name )
-    end
-
-    puts 'Done.'
-  end
-end # command fetch
-
-
-
-desc 'Build planet'
-arg_name 'FILE', multiple: true   ## todo/fix: check multiple will not print typeo???
-command [:build, :b] do |c|
-
-  c.desc 'Output Path'
-  c.arg_name 'PATH'
-  c.default_value opts.output_path
-  c.flag [:o,:output]
-
-  c.desc 'Template Manifest'
-  c.arg_name 'MANIFEST'
-  c.default_value opts.manifest
-  c.flag [:t, :template]
-
-  c.desc 'Database path'
-  c.arg_name 'PATH'
-  c.default_value opts.db_path
-  c.flag [:d, :dbpath]
-
-  c.desc 'Database name'
-  c.arg_name 'NAME'
-  c.flag [:n, :dbname]
-
-
-  c.action do |g,o,args|
-    logger.debug 'hello from build command'
-
-    args = expand_config_args( args )   # add missing .ini|.yml extension if missing or add default config (e.g. pluto.ini)
-
-    args.each do |arg|
-      name    = File.basename( arg, '.*' )
-
-      db_name = opts.db_name? ? opts.db_name : "#{name}.db"
-
-      db_config = {
-        adapter:  'sqlite3',
-        database: "#{opts.db_path}/#{db_name}"
-      }
-
-      # Note: use ! version w/ auto-migrate!
-      Pluto.connect!( db_config )
-
-      config = load_config( arg )
-
-      Pluto::Updater.new( opts, config ).run( name )
-      Pluto::Formatter.new( opts, config ).run( name )
-    end
-    
-    puts 'Done.'
-  end
-end # command build
-
-
-desc 'List installed template packs'
-command [:list,:ls,:l] do |c|
-
-  c.action do |g,o,args|
-    logger.debug 'hello from list command'
-
-    Pluto::Lister.new( opts ).list
-  end
-end
-
-
-desc 'Install template pack'
-arg_name 'MANIFEST', multiple: true
-command [:install,:i] do |c|
-
-  c.action do |g,o,args|
-    logger.debug 'hello from install command'
-        
-    args.each do |arg|
-      Pluto::Installer.new( opts ).install( arg )  ## todo: remove opts merge into config
-    end
-  end
-end
-
-
-desc '(Debug) Show more version info'
-skips_pre
-command [:about,:a] do |c|
-  c.action do
-    logger.debug 'hello from about command'
-
-    Pluto::SysInfo.new( opts ).dump
-  end
-end
-
-
-desc '(Debug) Show global options, options, arguments for test command'
-command :test do |c|
-  c.action do |g,o,args|
-    puts 'hello from test command'
-    puts 'g/global_options:'
-    pp g
-    puts 'o/options:'
-    pp o
-    puts 'args:'
-    pp args
-  end
-end
-
-
-
-pre do |g,c,o,args|
-  opts.merge_gli_options!( g )
-  opts.merge_gli_options!( o )
-
-  puts PlutoCli.banner
-
-  LogUtils::Logger.root.level = :debug    if opts.verbose?
-
-  logger.debug "   executing command #{c.name}"
-  true
-end
-
-
-post do |global,c,o,args|
-  logger.debug "   executed command #{c.name}"
-  true
-end
-
-
-on_error do |e|
-  puts
-  puts "*** error: #{e.message}"
-  puts
-
-  ## todo/fix: find a better way to print; just raise exception e.g. raise e  - why? why not??
-  ## puts e.backtrace.inspect  if opts.verbose?
-  raise e   if opts.verbose?
-
-  false # skip default error handling
-end
-
-
-exit run(ARGV)
+# encoding: utf-8
+
+require 'gli'
+
+
+include GLI::App
+
+program_desc 'another planet generator (lets you build web pages from published web feeds)'
+version PlutoCli::VERSION
+
+
+## some setup code
+
+LogUtils::Logger.root.level = :info   # set logging level to info
+
+logger = LogUtils::Logger.root
+
+
+opts    = Pluto::Opts.new
+
+
+
+######
+# begin
+#  move to pluto for reuse (e.g. in rakefile)
+
+def load_config( name )
+  config = INI.load_file( name )
+  config
+end
+
+# end
+#  move to pluto for reuse (e.g. in rakefile)
+###########################
+
+
+
+
+## "global" options (switches/flags)
+
+desc '(Debug) Show debug messages'
+switch [:verbose, :debug], negatable: false
+
+
+##  todo/check:
+## use quiet (warn) and quieter (error) - why? why not?
+##  use quiet for warn level (not error) as default - why? why not?
+
+desc 'Only show errors and fatal messages'
+switch [:q, :quiet, :err, :error], negatable: false
+
+desc 'Only show warnings, errors and fatal messages'
+switch [:w, :warn], negatable: false
+
+
+
+desc 'Configuration Path'
+arg_name 'PATH'
+default_value opts.config_path
+flag [:c, :config]
+
+
+### note: mostly for debugging lets you fetch individual feeds
+desc 'Fetch feeds'
+arg_name 'FEED', multiple: true   ## todo/fix: check multiple will not print typeo???
+command [:fetch, :f] do |c|
+
+  c.desc 'Database path'
+  c.arg_name 'PATH'
+  c.default_value opts.db_path
+  c.flag [:d, :dbpath]
+
+  c.desc 'Database name'
+  c.arg_name 'NAME'
+  c.default_value opts.db_name
+  c.flag [:n, :dbname]
+
+  c.action do |g,o,args|
+    logger.debug 'hello from fetch command'
+
+    ##  turn on debug flag by default; no need to passing --verbose
+    LogUtils::Logger.root.level = :debug
+    opts.verbose = true
+
+    # add dbname as opts property
+
+    #####
+    # todo: add into method for reuse for build/merge/fetch
+    #   all use the same code
+
+    db_config = {
+      adapter:  'sqlite3',
+      database: "#{opts.db_path}/#{opts.db_name}"
+    }
+
+    Pluto.connect( db_config )
+
+    args.each do |arg|
+      feed_rec = Pluto::Model::Feed.find_by_key!( arg )
+
+      puts "feed_rec:"
+      pp feed_rec
+
+      fetcher = Pluto::FeedFetcherBasic.new
+      fetcher.debug = true  # by default debug is true (only used for debuggin! - save feed to file, etc.)
+
+      feed = fetcher.fetch( feed_rec )
+      ## pp feed
+    end
+
+    puts 'Done.'
+  end
+end # command fetch
+
+
+
+## note: same as build (but without step 1) fetch)
+desc 'Merge planet template pack'
+arg_name 'FILE', multiple: true   ## todo/fix: check multiple will not print typeo???
+command [:merge, :m] do |c|
+
+  c.desc 'Output Path'
+  c.arg_name 'PATH'
+  c.default_value opts.output_path
+  c.flag [:o,:output]
+
+  c.desc 'Template Manifest'
+  c.arg_name 'MANIFEST'
+  c.default_value opts.manifest
+  c.flag [:t, :template]
+
+  c.desc 'Database path'
+  c.arg_name 'PATH'
+  c.default_value opts.db_path
+  c.flag [:d, :dbpath]
+
+  c.desc 'Database name'
+  c.arg_name 'NAME'
+  c.flag [:n, :dbname]
+
+
+  c.action do |g,o,args|
+    logger.debug 'hello from merge command'
+
+    ## note: no more "magic" - remove expand_config_args!! - always pass in planet.ini or similar
+    ## args = expand_config_args( args )   # add missing .ini|.yml extension if missing or add default config (e.g. pluto.ini)
+
+    args.each do |arg|
+      name    = File.basename( arg, '.*' )
+
+      #####
+      # todo: add into method for reuse for build/merge/fetch
+      #   all use the same code
+
+      db_name = opts.db_name? ? opts.db_name : "#{name}.db"
+
+      db_config = {
+        adapter:  'sqlite3',
+        database: "#{opts.db_path}/#{db_name}"
+      }
+
+      Pluto.connect( db_config )
+
+      config = load_config( arg )
+      if opts.verbose?
+        puts "dump >#{name}<:"
+        pp config
+      end
+
+      Pluto::Formatter.new( opts, config ).run( name )
+    end
+
+    puts 'Done.'
+  end
+end # command merge
+
+
+## note: same as build (but without step 2) merge)
+desc 'Update planet feeds'
+arg_name 'FILE', multiple: true   ## todo/fix: check multiple will not print typeo???
+command [:update, :up, :u] do |c|
+
+  c.desc 'Database path'
+  c.arg_name 'PATH'
+  c.default_value opts.db_path
+  c.flag [:d, :dbpath]
+
+  c.desc 'Database name'
+  c.arg_name 'NAME'
+  c.flag [:n, :dbname]
+
+
+  c.action do |g,o,args|
+    logger.debug 'hello from update command'
+
+    ## note: no more "magic" - remove expand_config_args!! - always pass in planet.ini or similar
+    ## args = expand_config_args( args )   # add missing .ini|.yml extension if missing or add default config (e.g. pluto.ini)
+
+    args.each do |arg|
+      name    = File.basename( arg, '.*' )
+
+      #####
+      # todo: add into method for reuse for build/merge/fetch
+      #   all use the same code
+
+      db_name = opts.db_name? ? opts.db_name : "#{name}.db"
+
+      db_config = {
+        adapter:  'sqlite3',
+        database: "#{opts.db_path}/#{db_name}"
+      }
+
+      # Note: use ! version w/ auto-migrate!  - why? why not??
+      ## just use regular connect??
+      Pluto.connect!( db_config )
+
+      config = load_config( arg )
+      if opts.verbose?
+        puts "dump >#{name}<:"
+        pp config
+      end
+
+      Pluto::Updater.new( opts, config ).run( name )
+    end
+
+    puts 'Done.'
+  end
+end # command fetch
+
+
+
+desc 'Build planet'
+arg_name 'FILE', multiple: true   ## todo/fix: check multiple will not print typeo???
+command [:build, :b] do |c|
+
+  c.desc 'Output Path'
+  c.arg_name 'PATH'
+  c.default_value opts.output_path
+  c.flag [:o,:output]
+
+  c.desc 'Template Manifest'
+  c.arg_name 'MANIFEST'
+  c.default_value opts.manifest
+  c.flag [:t, :template]
+
+  c.desc 'Database path'
+  c.arg_name 'PATH'
+  c.default_value opts.db_path
+  c.flag [:d, :dbpath]
+
+  c.desc 'Database name'
+  c.arg_name 'NAME'
+  c.flag [:n, :dbname]
+
+
+  c.action do |g,o,args|
+    logger.debug 'hello from build command'
+
+    ## note: no more "magic" - remove expand_config_args!! - always pass in planet.ini or similar
+    ## args = expand_config_args( args )   # add missing .ini|.yml extension if missing or add default config (e.g. pluto.ini)
+
+    args.each do |arg|
+      name    = File.basename( arg, '.*' )
+
+      db_name = opts.db_name? ? opts.db_name : "#{name}.db"
+
+      db_config = {
+        adapter:  'sqlite3',
+        database: "#{opts.db_path}/#{db_name}"
+      }
+
+      # Note: use ! version w/ auto-migrate!
+      Pluto.connect!( db_config )
+
+      config = load_config( arg )
+      if opts.verbose?
+        puts "dump >#{name}<:"
+        pp config
+      end
+
+      Pluto::Updater.new( opts, config ).run( name )
+      Pluto::Formatter.new( opts, config ).run( name )
+    end
+
+    puts 'Done.'
+  end
+end # command build
+
+
+desc 'List installed template packs'
+command [:list,:ls,:l] do |c|
+
+  c.action do |g,o,args|
+    logger.debug 'hello from list command'
+
+    Pluto::Lister.new( opts ).list
+  end
+end
+
+
+desc 'Install template pack'
+arg_name 'MANIFEST', multiple: true
+command [:install,:i] do |c|
+
+  c.action do |g,o,args|
+    logger.debug 'hello from install command'
+
+    args.each do |arg|
+      Pluto::Installer.new( opts ).install( arg )  ## todo: remove opts merge into config
+    end
+  end
+end
+
+
+desc '(Debug) Show more version info'
+skips_pre
+command [:about,:a] do |c|
+  c.action do
+    logger.debug 'hello from about command'
+
+    Pluto::SysInfo.new( opts ).dump
+  end
+end
+
+
+desc '(Debug) Show global options, options, arguments for test command'
+command :test do |c|
+  c.action do |g,o,args|
+    puts 'hello from test command'
+    puts 'g/global_options:'
+    pp g
+    puts 'o/options:'
+    pp o
+    puts 'args:'
+    pp args
+  end
+end
+
+
+
+pre do |g,c,o,args|
+  opts.merge_gli_options!( g )
+  opts.merge_gli_options!( o )
+
+  puts PlutoCli.banner
+
+  if opts.verbose?
+    LogUtils::Logger.root.level = :debug
+  elsif opts.warn?
+    LogUtils::Logger.root.level = :warn
+  elsif opts.quiet?
+    LogUtils::Logger.root.level = :error
+  else
+    ## do nothing; keep :info level (default)
+  end
+
+  logger.debug "   executing command #{c.name}"
+  true
+end
+
+
+post do |global,c,o,args|
+  logger.debug "   executed command #{c.name}"
+  true
+end
+
+
+on_error do |e|
+  puts
+  puts "*** error: #{e.message}"
+  puts
+
+  ## todo/fix: find a better way to print; just raise exception e.g. raise e  - why? why not??
+  ## puts e.backtrace.inspect  if opts.verbose?
+  raise e   if opts.verbose?
+
+  false # skip default error handling
+end
+
+
+exit run(ARGV)

data/lib/pluto/cli/opts.rb

@@ -10,10 +10,27 @@ class Opts
 
 
   def merge_gli_options!( options={} )
-    @verbose = true     if options[:verbose] == true
+    ###
+    #  todo/check: renamve verbose to debug and quiet to error - why? why not?
+    #    use a single (internal) variable for log level - why? why not?
+
+    if options[:verbose] == true   ## debug level
+      @verbose = @warn = @quiet = true
+    end
+
+    if options[:warn]    == true   ## warn level
+      @warn = @quiet = true
+      @verbose = false
+    end
+
+    if options[:quiet]   == true   ## error level (for now) - why? why not?
+      @quiet = true
+      @verbose = @warn = false
+    end
+
 
     @db_path   = options[:dbpath]  if options[:dbpath].present?
-    
+
     if options[:dbname].present?
       ##########
       # note: c.default_value '<PLANET>.db e.g. ruby.db'
@@ -41,20 +58,28 @@ class Opts
   def manifest=(value)   @manifest = value;  end
   def manifest()         @manifest || 'blank' ;  end
 
-  def verbose=(value)
-    @verbose = true  # note: always assumes true for now; default is false
-  end
 
-  def verbose?
-    @verbose || false
-  end
+  ##  # note: always assumes true for now for verbose/quiet/warn; default is false
+  def verbose=(value)   @verbose = true;   end
+  def verbose?()        @verbose || false; end
+  def debug?()          @verbose || false; end   ## add debug? alias for verbose
+
+  def warn=(value)      @warn = true;     end
+  def warn?()           @warn || false;   end
+
+  def quiet=(value)     @quiet = true;    end   ## use error/error? - why? why not?
+  def quiet?()          @quiet || false;  end
+  def error?()          @quiet || false;  end   ## add error? alias for quiet
+
+
+
 
   def config_path=(value)
     @config_path = value
   end
-  
+
   def config_path
-    ## @config_path || '~/.pluto'   --- old code
+    ## note: defaults to  ~/.pluto
     @config_path || File.join( Env.home, '.pluto' )
   end
 
@@ -62,7 +87,7 @@ class Opts
   def output_path=(value)
     @output_path = value
   end
-  
+
   def output_path
     @output_path || '.'
   end
@@ -75,10 +100,10 @@ class Opts
   def map_fetch_shortcut( key )
     # NB: always returns an array!!!  0,1 or more entries
     # - no value - return empty ary
-    
+
     ## todo: normalize key???
     value = @shortcuts.fetch( key, nil )
-    
+
     if value.nil?
       []
     elsif value.kind_of?( String )

data/lib/pluto/cli/sysinfo.rb

@@ -10,7 +10,7 @@ class SysInfo
   def initialize( opts )
     @opts = opts
   end
-  
+
   attr_reader :opts
 
 
@@ -44,7 +44,7 @@ EOS
   # dump Pluto settings
   # config.dump
   # puts
-      
+
 
   ## todo: add more gem version info
   # todo: add  logutils version

data/lib/pluto/cli/version.rb

@@ -3,8 +3,8 @@
 module PlutoCli
 
   MAJOR = 1
-  MINOR = 2
-  PATCH = 3
+  MINOR = 3
+  PATCH = 0
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 
   def self.version
@@ -21,4 +21,3 @@ module PlutoCli
   end
 
 end # module PlutoCli
-

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pluto
 version: !ruby/object:Gem::Version
-  version: 1.2.3
+  version: 1.3.0
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-01-18 00:00:00.000000000 Z
+date: 2017-11-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pluto-models
@@ -114,17 +114,17 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.13'
+        version: '3.16'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.13'
+        version: '3.16'
 description: pluto - Another Planet Generator (Lets You Build Web Pages from Published
   Web Feeds)
-email: feedreader@googlegroups.com
+email: wwwmake@googlegroups.com
 executables:
 - pluto
 extensions: []
@@ -166,7 +166,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.2
+rubygems_version: 2.5.2
 signing_key: 
 specification_version: 4
 summary: pluto - Another Planet Generator