mrhyde-tools 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2e557f30beeedfc546a63f1cae76cf2ae293073a
-  data.tar.gz: 0cfd40a76e76745d8b107db1435f9484e16ad54f
+  metadata.gz: aae57c42c231ddd4cbf85848a18d5f43c98ece4f
+  data.tar.gz: b90daa336b9b14f682fbbaed03b5199d14ac8ade
 SHA512:
-  metadata.gz: 4dc3215a4b822754dcc71b7777cf8acd76cf7d0e01973e8c617ea8d33269c2d9bc485ebfdf1040b855ac4f47ecf532d907c161ab848f921c5d25c395bac033fa
-  data.tar.gz: 7467bd07855fcbabdd1c72e4087e339e2e6c3d058ccfd622d389401fa23b77dd73db1eec1acec0ab9d598fa0225b13647748084376ad95aa6e21de4f8ca57da1
+  metadata.gz: 80d28406f03ea41d492fb025a98eb1490a8fe665f4d0c3e88f2adbf99880b55074f1e2eb6770b308b798153d9d89cdf260594eb1424440581944963de05363b6
+  data.tar.gz: b170832289088da0ad4af8176ce6c589a645fbefc27e40e536536b7c2cb09ea245e40c73039f1d9d62b03d9b6dfd02cdcd610215df373f09b9a7e2f502d5b130

data/Manifest.txt

@@ -2,6 +2,21 @@ HISTORY.md
 Manifest.txt
 README.md
 Rakefile
+bin/mrh
+bin/mrhyde
 lib/mrhyde.rb
+lib/mrhyde/builder.rb
+lib/mrhyde/cli/main.rb
+lib/mrhyde/cli/opts.rb
+lib/mrhyde/config.rb
 lib/mrhyde/tools.rb
 lib/mrhyde/version.rb
+lib/mrhyde/wizard.rb
+test/helper.rb
+test/scripts/starter.rb
+test/scripts/starterii.rb
+test/test_builder.rb
+test/test_config.rb
+test/test_install_theme.rb
+test/test_url.rb
+test/test_wizard.rb

data/README.md

@@ -1,18 +1,113 @@
-# mrhyde
+# mrh/mrhyde - static site quick starter script wizard
 
-static site quick starter scripts
+jekyll command line tool
 
 * home  :: [github.com/mrhydescripts/mrhyde](https://github.com/mrhydescripts/mrhyde)
 * bugs  :: [github.com/mrhydescripts/mrhyde/issues](https://github.com/mrhydescripts/mrhyde/issues)
-* gem   :: [rubygems.org/gems/mrhyde](https://rubygems.org/gems/mrhyde)
-* rdoc  :: [rubydoc.info/gems/mrhyde](http://rubydoc.info/gems/mrhyde)
+* gem   :: [rubygems.org/gems/mrhyde-tools](https://rubygems.org/gems/mrhyde-tools)
+* rdoc  :: [rubydoc.info/gems/mrhyde-tools](http://rubydoc.info/gems/mrhyde-tools)
 * forum :: [wwwmake](http://groups.google.com/group/wwwmake)
 
 
 ## Usage
 
-to be done
+The mrhyde-tools gem includes a command line tool that lets you
+run static site quick starter scripts. Try:
 
+```
+$ mrhyde --help      # or
+$ mrh -h
+```
+
+Resulting in:
+
+```
+NAME
+    mrh/mrhyde - jekyll command line tool .:. the static site quick starter script wizard
+
+SYNOPSIS
+    mrhyde [global options] command [command options] [arguments...]
+
+VERSION
+    0.1.0
+
+GLOBAL OPTIONS
+    --help            - Show this message
+    --test, --dry_run - (Debug) Dry run; run script in simulation for testing
+    --verbose         - (Debug) Show debug messages
+    --version         - Display the program version
+
+COMMANDS
+    new, n - Run static site quick starter script
+
+    help   - Shows a list of commands or help for one command
+    test   - (Debug) Test command suite
+```
+
+
+### Commands
+
+[New Wizard](#new-wizard-command---new-n)
+
+#### New Wizard Command - `new`, `n`
+
+To run a static site quick starter wizard script
+to download and install (unzip/unpack) a theme archive and configure
+a static site ready-to-use. Try:
+
+
+```
+$ mrhyde new starter    # or
+$ mrhyde n starter      # or
+$ mrh n starter
+```
+
+This will download the `starter.rb` wizard script
+from the [Mr. Hyde's Scripts](https://github.com/mrhydescripts/scripts) repo
+and run through all steps e.g.:
+
+```
+Welcome, before setting up your site Mr. Hyde will ask you some questions.
+
+Q: What's your site's title? [Your Site Title]:  Another Beautiful Static Site
+Q: What's your name? [Henry Jekyll]: Edward Hyde
+Q: Select your theme:
+     1 - Starter
+     2 - Bootstrap
+     3 - Minimal
+   Your choice (1-3)? [1]: 2 
+
+Thanks! Ready-to-go. Stand back.
+
+  Downloading Dr. Jekyll's Bootstrap Theme...
+  Setting up Dr. Jeykll's Bootstrap Theme..
+  ...
+  Updating settings in _config.yml...
+    title: "Another Beautiful Static Site"
+    author.name: "Edward Hyde"
+  ...
+Done.
+```
+
+That's it. Now use:
+
+```
+$ cd starter
+$ jekyll serve
+```
+
+And open up your new static site in your browser.
+
+
+
+**More Quick Starter Wizard Scripts**
+
+See the [Mr. Hyde's Scripts](https://github.com/mrhydescripts/scripts) library.
+
+
+**More Themes**
+
+See the [Dr. Jekyll's Themes](https://drjekyllthemes.github.io) directory.
 
 
 

data/Rakefile

@@ -5,7 +5,7 @@ Hoe.spec 'mrhyde-tools' do
 
   self.version = MrHyde::VERSION
 
-  self.summary = "mrhyde - static site quick starter scripts"
+  self.summary = "mrhyde - jekyll command line tool .:. static site quick starter script wizard"
   self.description = summary
 
   self.urls    = ['https://github.com/mrhydescripts/mrhyde']
@@ -18,6 +18,8 @@ Hoe.spec 'mrhyde-tools' do
   self.history_file = 'HISTORY.md'
 
   self.extra_deps = [
+    ['logutils'],
+    ['textutils'],
     ['drjekyll'],
   ]
 

data/bin/mrh

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'mrhyde/tools'
+
+MrHyde.main

data/bin/mrhyde

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'mrhyde/tools'
+
+MrHyde.main

data/lib/mrhyde.rb

@@ -1,12 +1,30 @@
 # encoding: utf-8
 
+## stdlibs
 require 'pp'
+require 'yaml'
+require 'uri'
 
 
+## 3rd party libs
+require 'textutils'      ## used for File.read_utf8
+require 'drjekyll'     
+
 ## our own code
 require 'mrhyde/version'    # note: let version always go first
+require 'mrhyde/wizard'
+require 'mrhyde/builder'
+require 'mrhyde/config'
+
+require 'mrhyde/cli/opts'
+require 'mrhyde/cli/main'
+
 
+module MrHyde
+  def self.main
+    exit Tool.new.run( ARGV )
+  end
+end # module MrHyde
 
-pp MrHyde.banner
-pp MrHyde.root
 
+MrHyde.main if __FILE__ == $0

data/lib/mrhyde/builder.rb

@@ -0,0 +1,123 @@
+#encoding: utf-8
+
+module MrHyde
+
+class Builder
+
+  def self.load_file( path, opts={} )
+    code = File.read_utf8( path )
+    self.load( code, opts )
+  end
+
+  def self.load( code, opts={} )
+    builder = Builder.new( opts )
+    builder.instance_eval( code )
+    builder
+  end
+
+
+  include Wizard   ## mixin helpers for say, ask, yes?, no?, select, etc.
+
+  def initialize( opts={} )
+    puts "starting new MrHyde script (sitefile) #{opts.inspect}; lets go"
+    
+    @test       = opts[:dry_run] || opts[:test] || false
+    @output_dir = opts[:o] || '.'
+  end
+
+  ## "global" builder options
+  def test?()      @test;       end   ## dry_run option (defaults to false)
+  def output_dir() @output_dir; end   ## ouptput (root) dir (defaults to . e.g. working folder)
+
+
+  def install_theme( name, opts= {} )
+    puts "  handle install_theme #{name}, #{opts.inspect}"
+
+    ## note for now assume name is key
+    ##   e.g. always downcase (e.g. Starter => starter)
+    @theme_key = key = name.downcase
+
+    ## themes_dir = "#{DrJekyll.root}/test/data"
+    ## catalog = Catalog.new( "#{themes_dir}/themes.yml" )
+    url = "https://github.com/drjekyllthemes/themes/raw/master/o/themes.yml"
+
+    if test?
+      # do nothing; dry run
+    else
+      catalog = DrJekyll::Catalog.from_url( url )
+      theme = catalog.find( key )
+      if theme
+        pak = DrJekyll::Package.new( key, theme )
+        pak.download
+        pak.unzip( "#{@output_dir}/#{key}" )
+      else
+        ## todo: issue warning - why, why not??
+        fail "*** theme '#{key}' not found; sorry"
+      end
+    end
+  end
+
+
+  def config( opts={} )
+    puts "  handle config block"
+    c = OpenConfig.new
+    yield( c )
+    ## pp c
+    h = c.to_h
+
+    ##
+    # check for site.url  if present also
+    #  add site.baseurl|path
+
+    site_url = h['url']
+
+    if site_url.nil? || site_url.empty?        ## special case site_url is empty string ""
+      ## note: always add site url for now
+      ## todo/fix: warn if we overwrite "empty" site.url - why? why not?
+      h['url']     = 'http://example.com'   # note: no trailing slash (/) e.g. example.com/
+      h['baseurl'] = ''                     # note: no trailing slash (/) e.g. /
+      h['path']    = ''                     # (better) alias for baseurl
+    else
+      ## site_baseurl = h['baseurl']
+      ## site_path    = h['path']
+
+      ### calculate path/baseurl
+      url = URI.parse( site_url )
+      path = url.path.sub(/\/$/, '' )  ## note: cut off trailing slash if present e.g. '/' becomes ''
+
+      h['baseurl'] = path
+      h['path']    = path
+      ## todo/fix: warn if we overwrite baseurl/path we new values - why? why not?
+    end
+
+    pp h
+
+
+    if test?
+      ## do nothing; dry run
+    else
+      org = YAML.load_file( "#{@output_dir}/#{@theme_key}/_config.yml" )
+      pp org
+
+      ## for now always add props at the end
+      ##   improve later (patch using regex etc. - why? why not?)
+
+      new_settings = YAML.dump( h )
+      ## note: cut off leading --- if present
+      new_settings = new_settings.sub( /^-{3}\s*/, '')
+
+      File.open( "#{@output_dir}/#{@theme_key}/_config.yml", "a" ) do |f|
+        f.puts
+        f.puts "######################################"
+        f.puts "### Mr Hyde's Settings"
+        f.puts
+        f.puts new_settings
+      end
+    end
+
+  end # method config
+
+end # class Builder
+
+end # module MrHyde
+

data/lib/mrhyde/cli/main.rb

@@ -0,0 +1,149 @@
+# encoding: utf-8
+
+### NOTE: wrap gli config into a class
+##  see github.com/davetron5000/gli/issues/153
+
+module MrHyde
+
+class Tool
+  def initialize
+    LogUtils::Logger.root.level = :info   # set logging level to info 
+  end
+
+  def run( args )
+    puts MrHyde.banner
+    Toolii.run( args )
+  end
+end
+
+## NOTE: gli added function are class methods (thus, wrap class Toolii in Tool for now)
+
+class Toolii
+  extend GLI::App
+
+  def self.logger=(value) @@logger=value; end
+  def self.logger()       @@logger; end
+
+  ## todo: find a better name e.g. change to settings? config? safe_opts? why? why not?
+  def self.opts=(value)  @@opts = value; end
+  def self.opts()        @@opts; end
+
+
+logger = LogUtils::Logger.root
+opts   = Opts.new 
+
+
+program_desc 'jekyll command line tool .:. the static site quick starter script wizard'
+version VERSION
+
+
+## desc 'Use only local (offline) cached data; no (online) remote network access'
+## switch [:l, :local], negatable: false
+
+desc '(Debug) Show debug messages'
+switch [:verbose], negatable: false    ## todo: use -w for short form? check ruby interpreter if in use too?
+
+desc '(Debug) Dry run; run script in simulation for testing'
+switch [:test, :dry_run], negatable: false
+
+
+def self.fetch_script( name )
+
+  ## first try local version in working folder
+
+  text = ''
+  local_script = "./#{name}.rb"
+  if File.exist?( local_script )
+    text = File.read_utf8( local_script )
+  else  ## fetch remote script
+    url = "https://github.com/mrhydescripts/scripts/raw/master/#{name}.rb"
+    ## assume utf8 text encoding for now
+    worker = Fetcher::Worker.new
+    text = worker.read_utf8!( url )
+  end
+
+  text
+end
+
+
+desc "Run static site quick starter script"
+arg_name 'NAME'   # required theme name
+command [:new,:n] do |c|
+
+  c.action do |g,o,args|
+
+    name = args[0] || 'starter'
+
+    script = fetch_script( name )
+    if opts.test?
+      puts "dry (test) run:"
+      Builder.load( script, test: true )
+    else
+      Builder.load( script )
+    end
+
+    puts 'Done.'
+  end # action
+end  # command setup
+
+
+
+desc '(Debug) Test command suite'
+command :test do |c|
+  c.action do |g,o,args|
+
+    puts "hello from test command"
+    puts "args (#{args.class.name}):"
+    pp args
+    puts "o (#{o.class.name}):"
+    pp o
+    puts "g (#{g.class.name}):"
+    pp g
+    
+    LogUtils::Logger.root.debug 'test debug msg'
+    LogUtils::Logger.root.info 'test info msg'
+    LogUtils::Logger.root.warn 'test warn msg'
+    
+    puts 'Done.'
+  end
+end
+
+
+
+pre do |g,c,o,args|
+  opts.merge_gli_options!( g )
+  opts.merge_gli_options!( o )
+
+  puts MrHyde.banner
+
+  if opts.verbose?
+    LogUtils::Logger.root.level = :debug
+  end
+
+  logger.debug "Executing #{c.name}"   
+  true
+end
+
+post do |global,c,o,args|
+  logger.debug "Executed #{c.name}"
+  true
+end
+
+
+on_error do |e|
+  puts
+  puts "*** error: #{e.message}"
+
+  if opts.verbose?
+    puts e.backtrace
+  end
+
+  false # skip default error handling
+end
+
+
+### exit run(ARGV)  ## note: use Toolii.run( ARGV ) outside of class
+
+end  # class Toolii
+
+end # module MrHyde

data/lib/mrhyde/cli/opts.rb

@@ -0,0 +1,33 @@
+# encoding: utf-8
+
+module MrHyde
+
+class Opts
+
+  def merge_gli_options!( options = {} )
+    @test    = true     if options[:test]    == true
+    @verbose = true     if options[:verbose] == true
+  end
+
+
+  def verbose=(boolean)   # add: alias for debug ??
+    @verbose = boolean
+  end
+
+  def verbose?
+    return false if @verbose.nil?   # default verbose/debug flag is false
+    @verbose == true
+  end
+
+  def test=(boolean)
+    @test = boolean
+  end
+
+  def test?
+    return false if @test.nil?   # default test/dry-run flag is false
+    @test == true
+  end
+
+end # class Opts
+
+end # module MrHyde

data/lib/mrhyde/config.rb

@@ -0,0 +1,60 @@
+#encoding: utf-8
+
+module MrHyde
+
+##
+# used for config block
+#   lets you access props (even nested) that don't yet exist
+#    and all props get stored in a hash
+#
+#  e.g
+#  c = OpenConfig.new
+#  c.title        = 'title'
+#  c.author.name  = 'name'
+
+#  c.mrhyde.last_updated = Time.now
+#  c.mrhyde.title        = 'title'
+#  c.mrhyde.name         = 'name'
+#  c.mrhyde.theme        = 'theme'
+
+class OpenConfig
+
+  def initialize
+    @h = {}
+  end
+
+  def to_h
+    h = {}
+    @h.each do |k,v|
+      if v.is_a? OpenConfig
+        h[ k ] = v.to_h
+      else
+        h[ k ] = v  ## just pass along as is
+      end
+    end
+    h
+  end
+
+  def method_missing( m, *args, &block)
+    if m.to_s =~ /^(.*)=$/   ## setter
+      puts "config lookup (setter) >#{m}< #{m.class.name}, #{args.inspect}"
+      key = m[0..-2].to_s  ## cut off trailing =
+      @h[ key ] = args[0].to_s    # note: assume first arg is value for setter
+                                # note: for now all values are strings (always use to_s)
+    else       ## assume getter
+      ## fix: add check for args??  must be 0 for getters??
+      ##       use else super to delegate non-getters??
+      puts "config lookup (getter) >#{m}< #{m.class.name}"
+      key = m.to_s
+      value = @h[ key ]
+      if value.nil?
+        puts "  config add (nested) hash"
+        value = @h[ key ] = OpenConfig.new
+      end
+      value
+    end  
+  end # method_missing
+
+end # class OpenConfig
+   
+end  # module MrHyde

data/lib/mrhyde/version.rb

@@ -4,8 +4,8 @@
 module MrHyde
 
   MAJOR = 0
-  MINOR = 0
-  PATCH = 1
+  MINOR = 1
+  PATCH = 0
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 
   def self.version

data/lib/mrhyde/wizard.rb

@@ -0,0 +1,88 @@
+# encoding: utf-8
+
+
+## note:
+##  use global $MRHYDE_WIZARD_STDIN
+##    lets you redirect stdin for testing  e.g $MRHYDE_WIZARD_STDIN = StringIO.new( 'test/n' )
+$MRHYDE_WIZARD_IN = $stdin
+
+
+module MrHyde
+
+module Wizard   ## use a different name e.g. WizardHelpers, FormHelpers, InputHelper, etc - why, why not??
+
+def getstr  ## use getstr to avoid conflict w/ gets (use better name? read_string, readline (already exists too), etc.?)
+  ## note: gets will include trailing newline (user hits return to enter data)
+  ##   - use strip for now (remove leading and traling whitspaces) - might later just use chomp ? (jsut removes newlines)
+  $MRHYDE_WIZARD_IN.gets.strip
+end
+
+def say( text )
+  puts text
+end
+
+
+YES_REGEX = /y|yes|on|t|true/i      ## support YAML true values - double check (YAML does NOT support t/f)
+NO_REGEX  = /n|no|off|f|false/i
+
+def yes?( question )   ## defaults to yes - why, why not??
+  ## todo: strip trailing question mark (?) if present (gets auto-included)
+  print( "Q: #{question} (y/n)? [y]: " )
+  str = getstr
+  if str.empty? || str =~ YES_REGEX
+    true
+  elsif str =~ NO_REGEX
+    false
+  else    ## warn: unknown value??
+    true
+  end
+end
+
+def no?( question )   ## defaults to yes - why, why not??
+  ## todo: strip trailing question mark (?) if present (gets auto-included)
+  print( "Q: #{question} (y/n)? [n]: " )
+  str = getstr
+  if str.empty? || str =~ NO_REGEX
+    true
+  elsif str =~ YES_REGEX
+    false
+  else    ## warn: unknown value??
+    true
+  end
+end
+
+
+def ask( question, default=nil )
+  ## todo: strip trailing question mark (?) if present (gets auto-included)
+  if default
+    print( "Q: #{question}? [#{default}]: " )
+  else
+    print( "Q: #{question}?: " )
+  end
+
+  str = getstr
+  if default && str.empty?   ## todo: best way to check for empty string?
+    str = default
+  end
+  str  
+end
+
+
+def select( title, options )
+  puts( "Q: #{title}: " )
+  options.each_with_index do |opt,i|
+    puts "    #{i+1} - #{opt}"
+  end
+  print( "   Your choice (1-#{options.size})? [1]: " )
+  str = getstr
+  if str.empty?   ## todo: best way to check for empty string?
+    num = 0   ## default to first option for now
+  else
+    num = str.to_i   ## note: defaults to 0 if cannot convert?
+    num -= 1   if num > 0    ## note: "convert" from 1-based to 0-based for ary; if invalid entry; default to 0
+  end
+  options[ num ]
+end
+
+end # module Wizard
+end # module MrHyde

data/test/helper.rb

@@ -0,0 +1,22 @@
+# encoding: utf-8
+
+## minitest setup
+
+require 'minitest/autorun'
+
+
+class EchoIO
+  def initialize( buf )
+    @io = StringIO.new( buf )
+  end
+  
+  def gets
+    str = @io.gets
+    puts "|>#{str.chomp}<|"   ## remove newline (w/ chomp) in debug/echo output 
+    str
+  end
+end
+
+
+## our own code
+require 'mrhyde'

data/test/scripts/starter.rb

@@ -0,0 +1,36 @@
+# encoding: utf-8
+
+
+puts "[debug] self.class.name #{self.class.name}"
+
+name = "check setting local variable name"
+puts "[debug] #{name}"
+
+puts "pp self:"
+pp self
+
+
+###############################################
+# Mr. Hyde's Quick Start Static Site Script
+
+say "Welcome, before setting up your site Mr. Hyde will ask you some questions."
+
+title = ask "What's your site's title", "Your Site Title"
+
+name  = ask "What's your name", "Henry Jekyll"
+
+say "Thanks! Ready-to-go. Stand back."
+
+install_theme "Starter"
+
+config do |c|
+  c.title        = title
+  c.author.name  = name
+
+  c.mrhyde.last_updated = Time.now
+  c.mrhyde.title        = title
+  c.mrhyde.name         = name
+end
+
+say "Done."
+

data/test/scripts/starterii.rb

@@ -0,0 +1,39 @@
+# encoding: utf-8
+
+
+puts "[debug] self.class.name #{self.class.name}"
+
+puts "pp self:"
+pp self
+
+
+###############################################
+# Mr. Hyde's Quick Start Static Site Script
+
+say "Welcome, before setting up your site Mr. Hyde will ask you some questions."
+
+title = ask "What's your site's title", "Your Site Title"
+
+url   = ask "What's your site's address (url)", "http://yoursite.com"
+
+name  = ask "What's your name", "Henry Jekyll"
+
+theme = select "Select your theme", ["Starter", "Bootstrap", "Minimal"]
+
+say "Thanks! Ready-to-go. Stand back."
+
+install_theme theme
+
+config do |c|
+  c.title        = title
+  c.url          = url
+  c.author.name  = name
+
+  c.mrhyde.last_updated = Time.now
+  c.mrhyde.title        = title
+  c.mrhyde.name         = name
+  c.mrhyde.theme        = theme
+  c.mrhyde.url          = url
+end
+
+say "Done."

data/test/test_builder.rb

@@ -0,0 +1,40 @@
+# encoding: utf-8
+
+###
+# to run use
+#   ruby -I ./lib -I ./test test/test_builder.rb
+
+
+require 'helper'
+
+
+class TestBuilder < MiniTest::Test
+
+  def test_starter
+
+    $MRHYDE_WIZARD_IN = EchoIO.new( <<EOS )
+Another Beautiful Static Site
+H. J.
+EOS
+
+    _ = MrHyde::Builder.load_file( "#{MrHyde.root}/test/scripts/starter.rb", test: true )
+
+    assert true  ## if we get here; everything is ok
+  end
+
+  def test_starterii
+
+    $MRHYDE_WIZARD_IN = EchoIO.new( <<EOS )
+Another Beautiful Static Site
+http://example.github.io/repo
+H. J.
+1
+EOS
+
+    _ = MrHyde::Builder.load_file( "#{MrHyde.root}/test/scripts/starterii.rb", test: true )
+
+    assert true  ## if we get here; everything is ok
+  end
+
+
+end # class TestBuilder

data/test/test_config.rb

@@ -0,0 +1,31 @@
+# encoding: utf-8
+
+###
+# to run use
+#   ruby -I ./lib -I ./test test/test_config.rb
+
+
+require 'helper'
+
+
+class TestConfig < MiniTest::Test
+
+  def test_config
+
+    c = MrHyde::OpenConfig.new
+    c.title        = 'title'
+    c.author.name  = 'name'
+
+    c.mrhyde.last_updated = Time.now
+    c.mrhyde.title        = 'title'
+    c.mrhyde.name         = 'name'
+    c.mrhyde.theme        = 'theme'
+    c.mrhyde.meta.info    = 'test nested nested value'
+
+    pp c.to_h
+
+    assert true  ## if we get here; everything is ok
+  end
+
+
+end # class TestConfig

data/test/test_install_theme.rb

@@ -0,0 +1,25 @@
+# encoding: utf-8
+
+###
+# to run use
+#   ruby -I ./lib -I ./test test/test_install_theme.rb
+
+
+require 'helper'
+
+
+class TestInstallTheme < MiniTest::Test
+
+  def test_starter
+
+    $MRHYDE_WIZARD_IN = EchoIO.new( <<EOS )
+Another Beautiful Static Site
+H. J.
+EOS
+
+    _ = MrHyde::Builder.load_file( "#{MrHyde.root}/test/scripts/starter.rb", o: './o')
+
+    assert true  ## if we get here; everything is ok
+  end
+
+end # class TestInstallTheme

data/test/test_url.rb

@@ -0,0 +1,40 @@
+# encoding: utf-8
+
+###
+# to run use
+#   ruby -I ./lib -I ./test test/test_url.rb
+
+
+require 'helper'
+
+
+class TestUrl < MiniTest::Test
+
+  def test_clean_path
+    path = '/'
+    path = path.sub( /\/$/, '' )
+    assert_equal '', path
+
+    path = ''
+    path = path.sub( /\/$/, '' )
+    assert_equal '', path
+
+    path = '/test/'
+    path = path.sub( /\/$/, '' )
+    assert_equal '/test', path
+  end
+
+
+  def test_site_url
+
+    str = 'http://example.com'
+    
+    url = URI.parse( str )
+
+    pp url
+    
+    assert_equal 'example.com', url.host
+    assert_equal '', url.path
+  end
+
+end # class TestUrl

data/test/test_wizard.rb

@@ -0,0 +1,50 @@
+# encoding: utf-8
+
+###
+# to run use
+#   ruby -I ./lib -I ./test test/test_wizard.rb
+
+
+require 'helper'
+
+
+class TestWizard < MiniTest::Test
+
+  include MrHyde::Wizard   ## lets you use ask etc.
+
+  def test_ask
+
+    $MRHYDE_WIZARD_IN = EchoIO.new( <<EOS )
+Another Beautiful Static Site
+
+H. J.
+
+2
+n
+y
+EOS
+
+    say "Hello, Wizard!"
+
+    title = ask "What's your site's title", "Your Site Title"
+    assert_equal 'Another Beautiful Static Site', title
+
+    title = ask "What's your site's title", "Your Site Title"
+    assert_equal 'Your Site Title', title
+
+    name = ask "Your Name"
+    assert_equal 'H. J.', name
+
+    theme = select "Select your theme", ["Starter", "Bootstrap", "Minimal"]
+    assert_equal 'Starter', theme
+
+    theme = select "Select your theme", ["Starter", "Bootstrap", "Minimal"]
+    assert_equal 'Bootstrap', theme
+
+    assert_equal false, yes?( "Add to GitHub" )
+    assert_equal false, no?( "Add to GitHub" )
+
+    assert true  ## if we get here; everything is ok
+  end
+
+end # class TestWizard

metadata

@@ -1,15 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: mrhyde-tools
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-08-12 00:00:00.000000000 Z
+date: 2015-08-16 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: logutils
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: textutils
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: drjekyll
   requirement: !ruby/object:Gem::Requirement
@@ -52,22 +80,41 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.13'
-description: mrhyde - static site quick starter scripts
+description: mrhyde - jekyll command line tool .:. static site quick starter script
+  wizard
 email: wwwmake@googlegroups.com
-executables: []
+executables:
+- mrh
+- mrhyde
 extensions: []
 extra_rdoc_files:
 - HISTORY.md
 - Manifest.txt
 - README.md
 files:
+- ".gemtest"
 - HISTORY.md
 - Manifest.txt
 - README.md
 - Rakefile
+- bin/mrh
+- bin/mrhyde
 - lib/mrhyde.rb
+- lib/mrhyde/builder.rb
+- lib/mrhyde/cli/main.rb
+- lib/mrhyde/cli/opts.rb
+- lib/mrhyde/config.rb
 - lib/mrhyde/tools.rb
 - lib/mrhyde/version.rb
+- lib/mrhyde/wizard.rb
+- test/helper.rb
+- test/scripts/starter.rb
+- test/scripts/starterii.rb
+- test/test_builder.rb
+- test/test_config.rb
+- test/test_install_theme.rb
+- test/test_url.rb
+- test/test_wizard.rb
 homepage: https://github.com/mrhydescripts/mrhyde
 licenses:
 - Public Domain
@@ -93,5 +140,10 @@ rubyforge_project:
 rubygems_version: 2.4.2
 signing_key: 
 specification_version: 4
-summary: mrhyde - static site quick starter scripts
-test_files: []
+summary: mrhyde - jekyll command line tool .:. static site quick starter script wizard
+test_files:
+- test/test_wizard.rb
+- test/test_install_theme.rb
+- test/test_builder.rb
+- test/test_config.rb
+- test/test_url.rb