yuyi 0.0.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 433f29c3dd527456989fd397c0689ef37be6f26f
+  data.tar.gz: df06a761e812cf8f42ad0b15f4b87e9260088678
+SHA512:
+  metadata.gz: afb1b75d2ba6783ea9b6ae84412a399a1919db287e23eac4300224632243df22a8afe639ef803565a0553169b538b87bf3f257985e5c10a17faed62a430561a4
+  data.tar.gz: a76fb8393af349ea7194cecc18c2d75147d21dc91faeba0611510f41b72f970bfd14f737f1e10d914c831ed8f1023a427f820a6708ec15863e3bc62dc6749e21

data/.gitignore

@@ -0,0 +1 @@
+.ruby-version

data/.new

@@ -0,0 +1,20 @@
+---
+license: MIT
+developer:
+  name: Ryan Brewster
+  email: brewster1134@gmail.com
+tasks:
+  gem:
+    gemspec:
+      summary: Automation for installing/uninstalling/updating your machine environment
+      description: Maintain a menu of applications and services to automate the installation
+        of.
+      homepage: https://github.com/brewster1134/Yuyi
+      executables:
+      - yuyi
+      bindir: bin
+      test_files:
+      - spec/**/*.rb
+project_name: Yuyi
+type: ruby
+version: 0.0.3

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+install: ruby -S bundle install --without development
+script: bundle exec rspec
+rvm:
+- 1.8.7
+- 1.9.3
+- 2.0.0

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+gem 'rspec'
+
+group :development do
+  gem 'new'
+  gem 'guard'
+  gem 'guard-rspec', :require => false
+  gem 'terminal-notifier-guard'
+end

data/Gemfile.lock

@@ -0,0 +1,80 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (4.1.1)
+      i18n (~> 0.6, >= 0.6.9)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.1)
+      tzinfo (~> 1.1)
+    celluloid (0.15.2)
+      timers (~> 1.1.0)
+    coderay (1.1.0)
+    colorize (0.7.3)
+    diff-lcs (1.2.5)
+    ffi (1.9.3)
+    formatador (0.2.5)
+    guard (2.6.1)
+      formatador (>= 0.2.4)
+      listen (~> 2.7)
+      lumberjack (~> 1.0)
+      pry (>= 0.9.12)
+      thor (>= 0.18.1)
+    guard-rspec (4.2.10)
+      guard (~> 2.1)
+      rspec (>= 2.14, < 4.0)
+    i18n (0.6.9)
+    json (1.8.1)
+    listen (2.7.7)
+      celluloid (>= 0.15.2)
+      rb-fsevent (>= 0.9.3)
+      rb-inotify (>= 0.9)
+    lumberjack (1.0.6)
+    method_source (0.8.2)
+    minitest (5.3.4)
+    new (0.0.13)
+      activesupport (~> 4.0)
+      colorize
+      rake
+      recursive-open-struct
+      semantic
+      thor
+    pry (0.10.0)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    rake (10.3.2)
+    rb-fsevent (0.9.4)
+    rb-inotify (0.9.5)
+      ffi (>= 0.5.0)
+    recursive-open-struct (0.4.5)
+    rspec (3.0.0)
+      rspec-core (~> 3.0.0)
+      rspec-expectations (~> 3.0.0)
+      rspec-mocks (~> 3.0.0)
+    rspec-core (3.0.0)
+      rspec-support (~> 3.0.0)
+    rspec-expectations (3.0.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.0.0)
+    rspec-mocks (3.0.1)
+      rspec-support (~> 3.0.0)
+    rspec-support (3.0.0)
+    semantic (1.3.0)
+    slop (3.5.0)
+    terminal-notifier-guard (1.5.3)
+    thor (0.19.1)
+    thread_safe (0.3.4)
+    timers (1.1.0)
+    tzinfo (1.2.1)
+      thread_safe (~> 0.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  guard
+  guard-rspec
+  new
+  rspec
+  terminal-notifier-guard

data/Guardfile

@@ -0,0 +1,5 @@
+guard :rspec do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { 'spec' }
+end

data/README.md

@@ -0,0 +1,122 @@
+![Travis CI](https://travis-ci.org/brewster1134/Yuyi.svg?branch=master)
+# Yuyi
+Opinionated automation for installing/uninstalling/upgrading your machine environment
+
+###### Support
+* Mac OS X
+
+###### Dependencies
+Nothing! Well thats not entirely true... the dependencies are already available by default on OS X
+* Ruby >= 1.8.7
+* Bash >= 3.2
+
+#### Quick Usage
+* Create a `yuyi_menu` file in your home folder _(see below for examples)_
+* Run `ruby -e "$(curl -fsSL https://raw.github.com/brewster1134/Yuyi/master/bin/install)"` in Terminal
+
+#### Example Menu
+
+```yaml
+sources:
+  local: ~/Documents/Rolls
+  yuyi: https://github.com/brewster1134/Yuyi-Rolls.git
+rolls:
+  google_chrome:
+  ruby:
+    versions: ['2.0.0-p353']
+```
+
+Make sure to include a colon (:) at the end of each roll name.
+
+If a roll accepts arguments, indent the key/value pairs below the roll name.  You will be prompted with roll options when Yuyi runs, and the opportunity to change them before anything is installed.
+
+### Development
+
+##### Dependencies
+* ruby
+* bundler
+
+##### Running Tests
+Run tests using rspec through guard
+
+```sh
+bundle exec guard
+```
+
+##### Writing Rolls
+###### _required_
+* `< Yuyu::Roll`  The roll class needs to inherit from Yuyi::Roll
+* `install`       A block to install a roll
+* `uninstall`     A block to uninstall a roll
+* `upgrade`        A block to upgrade a roll
+* `installed?`    A block to tests if your roll is already installed or not
+
+###### _optional_
+* `dependencies`  Declare dependencies (supports multiple arguments) that your roll depends on
+* `options`       A hash of options (and a nested hash of option meta data _* see example below *_)
+
+###### _available methods_
+* `title`             Returns a string of the roll title.
+* `options`           Returns the roll options.
+* `run`               This will run a system command.
+    * `command` A string of the command you wish to run
+    * `verbose` If true, will show formatted output & errors.  This is enabled when running yuyi with the `-V` or `--VERBOSE` flag
+* `command?`          Returns true or false if a command succeeds or fails.  Good for using in the `installed?` block
+* `write_to_file`     Will add lines of text to a file.  Good for using in the `install` block. Accepts multiple string arguments to be written as separate lines.
+* `delete_from_file`  Will remove lines of text to a file.  Good for using in the `uninstall` block. Accepts multiple string arguments to be written as separate lines.
+
+```ruby
+class MyRoll < Yuyi::Roll
+  install do
+    run 'brew install my_roll', :verbose => true
+
+    write_to_file '~/.bash_profile', "# #{title}"
+  end
+
+  uninstall do
+    run 'brew uninstall my_roll'
+
+    delete_from_file '~/.bash_profile', "# #{title}"
+  end
+
+  upgrade do
+    run 'brew upgrade my_roll'
+  end
+
+  installed? do
+    # simply check for a command
+    command? 'brew'
+
+    # or check the output of a command
+    # using `run` will return true or false, so use
+    `brew list` =~ /myroll/
+  end
+
+  dependencies :homebrew, :foo
+  dependencies :hombrew_cask if options[:version] == '2.0' # add dependencies conditionally
+
+  options(
+    :version => {
+      :description => 'The specific version you would like to install',
+      :example => '1.0',  # optional
+      :default => '2.0',  # optional
+      :required => true   # optional - shows option in red
+    }
+  )
+end
+```
+
+### TODO
+* create yuyi gem with new
+* setup (post suite install tasks)
+* write to file checks for existing lines
+* Enforce required options
+* New roll generator (use new!)
+* DOCS!
+* show roll options on -l
+* home brew/home brew cask roll to inherit
+* installation summary
+* abort install if required options arent set
+* post install commands
+
+[.](http://www.comedycentral.com/video-clips/3myds9/upright-citizens-brigade-sushi-chef)

data/bin/install

@@ -0,0 +1,42 @@
+#!/usr/bin/env ruby
+
+# THIS CODE INSPIRED BY (COPIED FROM) HOMEBREW'S INSTALL SCRIPT. THANKS! :)
+
+def download_app
+  Dir.chdir install_dir do
+    # -m to stop tar erroring out if it can't modify the mtime for root owned directories
+    # pipefail to cause the exit status from curl to propogate if it fails
+    # we use -k for curl because Leopard has a bunch of bad SSL certificates
+    curl_flags = 'fsSL'
+    curl_flags << 'k' if macos_version <= '10.5'
+    `/bin/bash -o pipefail -c '/usr/bin/curl -#{curl_flags} https://github.com/brewster1134/Yuyi/tarball/master | /usr/bin/tar xz -m --strip 1'`
+  end
+end
+
+def install
+  system "ruby #{install_dir}/bin/yuyi -V"
+end
+
+def cleanup
+  `rm -rf #{install_dir}`
+end
+
+# Create the directory to download to and install from
+def install_dir
+  dir = "#{ENV['TMPDIR']}Yuyi"
+
+  unless File.directory? dir
+    `/bin/mkdir #{dir}`
+  end
+
+  dir
+end
+
+# Get OSX minor version
+def macos_version
+  @macos_version ||= `/usr/bin/sw_vers -productVersion`.chomp[/10\.\d+/]
+end
+
+download_app
+install
+cleanup

data/bin/yuyi

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+$: << File.dirname(__FILE__) + '/../lib'
+
+require 'yuyi'
+
+Yuyi.init ARGV

data/lib/yuyi/cli.rb

@@ -0,0 +1,355 @@
+require 'open3'
+require 'readline'
+require 'yaml'
+
+module Yuyi::Cli
+  # Configure readline
+  Readline.completion_append_character = '/'
+
+  # Define available command line options
+  # Each key must start with a unique letter
+  # Flags are automatically created based on the first letter (eg. -h, --help)
+  #
+  CLI_OPTIONS = {
+    :help => 'Shows these options.',
+    :list => 'List all rolls available to be included in your menu.',
+    :version => 'Shows the current version of Yuyi.',
+    :VERBOSE => 'Shows the output of all commands being run'
+  }
+
+  # Called by the install script
+  #
+  def init args
+    # get the first argument as the command
+    command, *rest = *args
+
+    # Call options method if valid argument is passed
+    # This checks for the full name or the first letter, proceeded by '--' or '-' respectively
+    CLI_OPTIONS.keys.each do |option|
+      if command == "--#{option}" || command == "-#{option.to_s.chars.first}"
+        begin
+          send option.to_s.downcase, rest
+        rescue
+          send option.to_s.downcase
+        end
+        return
+      end
+    end
+
+    # Show a warning if an invalid argument is passed and then show the help menu
+    if command
+      say 'INVALID ARGUMENT', :type => :fail
+      send :help
+    else
+      start
+    end
+  end
+
+  # Replacement for `puts` that accepts various stylistic arguments
+  # type:     => [symbol]             Preset colors for [:fail, :success, :warn]
+  # color:    => [integer]            See docs for #colorize for color codes
+  # justify:  => [center|ljust|rjust] The type of justification to use
+  # padding:  => [integer]            The maximum string size to justify text in
+  # indent:   => [integer]            The maximum string size to justify text in
+  # newline:  => [boolean]            True if you want a newline after the output
+  #
+  def say text = '', args = {}
+    # defaults
+    args = {
+      :newline => true
+    }.merge args
+
+    # Justify options
+    if args[:justify] && args[:padding]
+      text = text.send args[:justify], args[:padding]
+    end
+
+    # Type options
+    # process last due to the addition of special color codes
+    text = case args[:type]
+    when :fail
+      colorize text, 31
+    when :success
+      colorize text, 32
+    when :warn
+      colorize text, 33
+    else
+      colorize text, args[:color]
+    end
+
+    if args[:indent]
+      text = (' ' * args[:indent]) + text
+    end
+
+    if args[:newline]
+      STDOUT.puts text
+    else
+      STDOUT.print text
+    end
+  end
+
+  # Accepts the same arguments as #say
+  #
+  def ask question, options = {}, &block
+    prompt = '>>> '
+    options = {
+      :readline => false,
+      :color => 1
+    }.merge(options)
+
+    say question, options
+
+    output = if options[:readline]
+      Readline.readline(prompt).chomp('/')
+    else
+      say prompt, :color => 1, :newline => false
+      STDIN.gets
+    end.rstrip
+
+    say
+    yield output
+  end
+
+  # Run a command and output formatting success/errors
+  #
+  def run command, args = {}
+    # check if in verbose mode
+    verbose = args[:verbose] || @verbose
+    output = `echo | #{command} 2>&1`
+    success = $?.success?
+
+    if verbose
+      say "RUNNING: #{command}", :type => (success ? :success : :fail)
+      say output
+    end
+
+    args[:boolean] ? success : output
+  end
+
+  def command? command
+    run command, :verbose => false, :boolean => true
+  end
+
+  # Write several lines to to an existing file
+  #
+  def write_to_file file, *text
+    File.open(File.expand_path(file), 'a') do |file|
+      file.write text * "\n"
+      file.write "\n"
+    end
+  end
+
+  # Delete specific lines from an existing file
+  #
+  def delete_from_file file, *text
+    # get file text
+    new_text = File.read(File.expand_path(file))
+
+    # iterate through text and remove it
+    text.each do |t|
+      regex = /^.*#{Regexp.escape(t)}.*\n/
+      new_text.gsub!(regex, '')
+    end
+
+    # write new text back to file
+    File.open(File.expand_path(file), 'w') { |f| f.write(new_text) }
+  end
+
+  def osx_version
+    run '/usr/bin/sw_vers -productVersion'.chomp[/10\.\d+/].to_f
+  end
+
+private
+
+  def start
+    header
+    get_menu
+    confirm_upgrade
+    confirm_options
+    authenticate
+    Yuyi::Menu.instance.order_rolls
+  end
+
+  def header
+    line_length = 50
+    say
+    say '-' * line_length, :color => 4
+    say
+    say '____    ____  __    __  ____    ____  __  ', :color => 31, :justify => :center, :padding => line_length
+    say '\   \  /   / |  |  |  | \   \  /   / |  | ', :color => 32, :justify => :center, :padding => line_length
+    say ' \   \/   /  |  |  |  |  \   \/   /  |  | ', :color => 33, :justify => :center, :padding => line_length
+    say '  \_    _/   |  |  |  |   \_    _/   |  | ', :color => 34, :justify => :center, :padding => line_length
+    say '    |  |     |  `--\'  |     |  |     |  | ', :color => 35, :justify => :center, :padding => line_length
+    say '    |__|      \______/      |__|     |__| ', :color => 36, :justify => :center, :padding => line_length
+    say
+    say "VERSION #{Yuyi::VERSION}", :justify => :center, :padding => line_length
+    say
+    say '-' * line_length, :color => 4
+    say
+  end
+
+  # Ask the user for a menu file to load
+  #
+  def get_menu
+    menu = nil
+
+    until menu
+      say 'Navigate to a menu file...', :type => :success
+      menu = ask "...or just press enter to load `#{Yuyi::DEFAULT_MENU}`", :readline => true, :color => 36 do |path|
+        path = path.empty? ? Yuyi::DEFAULT_MENU : path
+
+        if Yuyi::Menu.load_from_file path
+          say 'Downloading Sources... Please Wait', :type => :warn
+          say
+
+          Yuyi::Menu.new path
+        else
+          say 'Invalid Path... Please check the location of your menu file', :type => :fail
+          say
+
+          nil
+        end
+      end
+    end
+  end
+
+  # Ask to check for upgrades
+  #
+  def confirm_upgrade
+    ask 'Do you want to check for upgrades for already installed rolls? (Yn)', :type => :warn do |upgrade|
+      Yuyi::Menu.upgrade? upgrade == 'Y'
+    end
+  end
+
+  # If any rolls on the menu have options, confirm the options before continuing
+  #
+  def confirm_options
+    confirm = false
+    Yuyi::Menu.rolls.each do |name, roll|
+
+      unless roll.class.options.empty?
+        present_options roll
+        confirm = true
+      end
+    end
+
+    if confirm
+      ask 'Hit any key when you have your options set correctly in your menu file', :type => :warn do
+        Yuyi::Menu.load_from_file
+      end
+    end
+  end
+
+  def authenticate
+    say 'Please enter the admin password', :type => :warn
+    say 'NOTE: This is passed directly to sudo and is not saved.'
+    say '      This will ensure all your installs run unsupervised.'
+
+    # clear sudo timestamp & run any command as admin to force a password prompt
+    system 'sudo -k; sudo echo >> /dev/null 2>&1'
+    say
+  end
+
+  # Show formatted options
+  #
+  def present_options roll, examples = true
+    indent = 2
+    longest_option = roll.options.keys.map(&:to_s).max_by(&:length).length + indent
+
+    say "Available options for #{roll.title}...", :color => 32
+
+    roll.option_defs.each do |k, v|
+      option_color = v[:required] ? 31 : 36
+
+      say "#{k.to_s.rjust(longest_option)}: ", :color => option_color, :newline => false
+      say v[:description]
+      say (' ' * (longest_option + indent)), :newline => false
+      say 'default: ', :color => 36, :newline => false
+      say v[:default]
+    end
+
+    if examples
+      examples_hash = {}
+      example_indent = longest_option + indent
+      options = roll.options.dup
+
+      # merge examples from roll source in
+      options.each do |option, value|
+        if example = roll.option_defs[option][:example]
+          options[option] = example
+        end
+      end
+
+      examples_hash[roll.file_name.to_s] = options
+
+
+      say
+      say 'Example', :color => 33, :indent => example_indent, :newline => false
+      say examples_hash.deep_stringify_keys!.to_yaml.sub("--- ", '').gsub(/\n(\s*)/, "\n\\1#{' ' * example_indent}")
+    end
+  end
+
+  # Output text with a certain color (or style)
+  # Reference for color codes
+  # https://github.com/flori/term-ansicolor/blob/master/lib/term/ansicolor.rb
+  #
+  def colorize text, color_code
+    return text unless color_code
+    "\e[#{color_code}m#{text}\e[0m"
+  end
+
+  # METHODS FOR FLAGS
+  #
+  def help
+    longest_option = CLI_OPTIONS.keys.map(&:to_s).max.length
+
+    say
+    CLI_OPTIONS.each do |option, description|
+      string = ''
+      string << "-#{option.to_s.chars.first}"
+      string << ', '
+      string << "--#{option.to_s.ljust(longest_option)}"
+      string << '   '
+      string << description
+      say string
+    end
+    say
+  end
+
+  # List all available rolls
+  #
+  def list
+    get_menu
+    Yuyi::Menu.set_sources
+
+    # Collect all rolls from all sources
+    #
+    rolls = []
+    Yuyi::Menu.sources.each do |source|
+      rolls |= source.available_rolls.keys
+    end
+
+    # alphabatize rolls
+    rolls = rolls.map(&:to_s).sort.map(&:to_sym)
+
+    say 'Available Rolls', :type => :success
+    say '---------------', :type => :success
+    rolls.each do |roll|
+      say roll.to_s
+    end
+    say
+  end
+
+  # Return current version
+  #
+  def version
+    say "#{Yuyi::NAME} #{Yuyi::VERSION}"
+  end
+
+  # Return current version
+  #
+  def verbose
+    @verbose = true
+    start
+  end
+end