fvm 0.1.4

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in fvm.gemspec
+gemspec

data/README.md

@@ -0,0 +1,65 @@
+Flex SDK Version Manager
+========================
+
+**FVM is a work in progress! It DOES NOT WORK RIGHT NOW. I'll remove this notice when we're good to go.**
+
+**fvm** is a ruby gem and executable for managing versions of the [Adobe Open Source Flex SDK][flex-sdk].
+
+*It has only been tested on Mac OSX 10.6.4 and is likely to not work on many other configurations.* If you
+have any success stories, however, please let me know and I'll add them here.
+
+The manager provides a command-line installation process for any available Flex SDK versions and the 
+ability to symlink to the SDK's executables from `/usr/local/bin` (The same place [Homebrew][homebrew] suggests). 
+This allows programs like `mxmlc`, `asdoc`, and `compc` to be available from the command line easily. 
+The manager uses the symlink approach to make it easy to switch the symlinks immediately between 
+installed versions of the SDK if you need to.
+
+Installation
+------------
+
+First, install the **fvm** gem:
+
+  gem install fvm
+
+Next, add the following to your bash initialization script (bashrc, bash_init, /etc/profile, whatever you prefer):
+
+  [[ -s $(fvm restart) ]] && source $(fvm restart)
+  # This loads FVM into a shell session.
+
+*Note: If you also have **rvm** installed, make sure these lines go **AFTER** the **rvm** initialization.*
+
+Restart your shell and you're good to go.
+
+Caveats
+-------
+
+- As of v0.1.1, I've only included `mxmlc`, `asdoc`, and `compc` to the list of executables to link. I'll
+  be adding more as fast as I can test them out, but if you want some programs before others, hit me up.
+
+- I'm still trying to find a clean way to reset $FLEX_HOME after installing/using a new Flex SDK version.
+  Currently, the environment variable cannot be set in the ruby process, so there is a helper script,
+  `fvm-restart` that you'll need to run after either of those commands. Also, `fvm-restart` will be run
+  for any new shells (if you followed the installation instructions) so you could just re-start Terminal.
+
+Usage
+-----
+
+`fvm install` installs a specific Flex SDK version.
+
+`fvm list` lists installed Flex SDK versions.
+
+`fvm use` can switch symlinks to a specific installed Flex SDK version.
+
+`fvm unlink` removes any symlinks installed by **fvm**.
+
+`fvm which` prints the currently-linked Flex SDK version.
+
+`fvm-restart` re-sets the $FLEX_HOME environment variable.
+
+Wish-List
+---------
+
+- `fvm langref` to install (or build) the language reference for this flex version
+
+[flex-sdk]: http://opensource.adobe.com/wiki/display/flexsdk/Flex+SDK "Adobe Open Source Flex SDK"
+[homebrew]: https://github.com/mxcl/homebrew "Homebrew GitHub Repo"

data/Rakefile

@@ -0,0 +1,39 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+$: << File.join( File.dirname( __FILE__ ), 'test' )
+
+require 'open-uri'
+
+namespace :fixtures do
+  
+  desc "Pulls down the target Flex SDK download pages"
+  task :parser do
+    [ '4', '3', 'Hero' ].each do |sdk|
+      open( "http://opensource.adobe.com/wiki/display/flexsdk/Download+Flex+#{sdk}" ) do |response|
+        File.open( "test/fixtures/parser/Flex_SDK_#{sdk}.html", "w" ) do |f|
+          f << response.read
+        end
+      end
+    end
+  end
+  
+  desc "Pulls down an example license confirmation page"
+  task :confirmer do
+    open( 'http://opensource.adobe.com/wiki/display/flexsdk/download?build=4.1.0.16076&pkgtype=2&release=4' ) do |response|
+      File.open( "test/fixtures/confirmer/Confirmation.html", 'w' ) do |f|
+        f << response.read
+      end
+    end
+  end
+  
+  desc "Pulls down all fixture pages"
+  task :all => [ :parser, :confirmer ]
+end
+
+
+
+desc "Runs the test suite"
+task :test do
+  require 'test_helper'
+end

data/bin/fvm

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+
+require 'fvm'
+Fvm::CLI::Thor.start

data/fvm.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+
+$: << File.join( File.dirname( __FILE__ ), 'lib' )
+
+require 'fvm/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'fvm'
+  s.version     = Fvm::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = [ 'Jeremy Ruppel' ]
+  s.email       = [ 'jeremy.ruppel@gmail.com' ]
+  s.homepage    = 'https://github.com/SFCRD/fvm'
+  s.summary     = 'Flex SDK version manager'
+  s.description = 'Flex SDK version manager'
+
+  s.add_dependency 'thor',           '0.14.3'
+  s.add_dependency 'highline',       '~> 1.6'
+  s.add_dependency 'nokogiri',       '~> 1.4.4'
+  s.add_dependency 'activeresource', '~> 3.0.4'
+  s.add_dependency 'geoffrey',       '~> 1.1.3'
+  s.add_dependency 'versionomy',     '~> 0.4.0'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename( f ) }
+  s.require_paths = [ 'lib' ]
+end

data/lib/fvm.rb

@@ -0,0 +1,39 @@
+module Fvm
+  
+  module CLI
+    autoload :Build,        'fvm/cli/build'
+    autoload :Installer,    'fvm/cli/installer'
+    autoload :Installation, 'fvm/cli/installation'
+    autoload :Linker,       'fvm/cli/linker'
+    autoload :Shell,        'fvm/cli/shell'
+    autoload :Driver,       'fvm/cli/driver'
+    autoload :Thor,         'fvm/cli/thor'
+  end
+  
+  # TODO move into module
+  autoload :Manipulator, 'fvm/manipulator'
+  
+  autoload :Parser, 'fvm/parser'
+
+  module System
+    def self.active_version?
+      active_version.nil? == false
+    end
+    
+    def self.active_version
+      @@active_version ||= find_active_version
+    end
+    
+    def self.active?( build )
+      active_version? ? active_version.version.eql?( build.version ) : false
+    end
+    
+    protected
+    
+    def self.find_active_version
+      mxmlc = `which mxmlc`
+      mxmlc.empty? ? nil : CLI::Installation.new( Pathname.new( `readlink #{mxmlc}` ).join( '..', '..' ) )
+    end
+  end
+
+end

data/lib/fvm/cli/build.rb

@@ -0,0 +1,41 @@
+require 'active_resource'
+require 'versionomy'
+
+module Fvm
+  module CLI
+    class Build < ActiveResource::Base
+      
+      include Comparable
+      
+      self.site = 'http://fvm.heroku.com'
+      self.format = :json
+
+      def self.sdk( name )
+        all( :params => { :sdk => name } )
+      end
+
+      def self.version( name )
+        all( :params => { :version => name } )
+      end
+
+      def zip_url
+        "http://fpdownload.adobe.com/pub/flex/sdk/builds/flex#{sdk.to_s.downcase}/flex_sdk_#{version}_mpl.zip"
+      end
+      
+      def active?
+        Fvm::System.active?( self )
+      end
+      
+      def to_menu
+        out = [ version, milestone ]
+        out.unshift '*' if active?
+        out.join ' '
+      end
+      
+      def <=>( other )
+        Versionomy.parse( version ) <=> Versionomy.parse( other.version )
+      end
+      
+    end
+  end
+end

data/lib/fvm/cli/driver.rb

@@ -0,0 +1,161 @@
+module Fvm
+  module CLI
+    class Driver
+=begin rdoc
+  Installs a version of the Flex SDK and creates symlinks to the included binaries.
+  
+  If no options are provided, FVM will fetch all available builds and present them to
+  the user as an interactive menu.
+  
+  Because we're trying to stay honest, the user will be prompted to agree to the MPL
+  license no matter what.
+  
+  OPTIONS
+  
+    -v, --version Specify a version of the Flex SDK to install
+    
+    -s, --sdk Only present a menu containing builds from the given SDK name
+    
+=end
+      def install( options )
+
+        if options.version?
+          
+          begin
+            builds = Fvm::CLI::Build.version( options.version )
+          rescue
+            shell.exit 'There was a problem connecting to the FVM API. Please try again.'
+          end
+          
+          shell.exit "No Flex SDK build found with version #{options.version}" if builds.empty?
+          build = builds.first
+          
+        elsif options.sdk?
+          
+          begin
+            builds = Fvm::CLI::Build.sdk( options.sdk )
+          rescue
+            shell.exit 'There was a problem connecting to the FVM API. Please try again.'
+          end
+          
+          shell.exit "No Flex SDK build found in SDK #{options.sdk}" if builds.empty?
+          build = shell.choose builds
+          
+        else
+          
+          begin
+            builds = Fvm::CLI::Build.all
+          rescue
+            shell.exit 'There was a problem connecting to the FVM API. Please try again.'
+          end
+          
+          build = shell.choose builds
+          
+        end
+        
+        shell.exit "You must agree to the MPL terms before installing the Flex SDK." unless shell.mpl?
+          
+        installed = installer.install build.zip_url, build.version
+
+        linker.link File.join( installed, 'bin' )
+
+        shell.props "Flex SDK version #{build.version} successfully installed to #{installed}"
+        
+        shell.warn_restart!
+        
+      end
+=begin rdoc
+  Select an installed version of the Flex SDK to link to.  
+=end
+      def use
+        
+        installations = installer.installations
+        
+        shell.exit "No Flex SDK versions installed. Run 'fvm install' to install some!" if installations.empty?
+        
+        installation = shell.choose installations
+        
+        linker.link File.join( installation.dir, 'bin' )
+        
+        shell.props "Now using Flex SDK version #{installation.version}"
+        
+        shell.warn_restart!
+        
+      end
+=begin rdoc
+  List Flex SDK builds installed locally. Will also show which build is currently linked.
+  
+  OPTIONS
+  
+  -r, --remote List available remote builds.
+  
+=end
+      def list( options )
+        if options.remote?
+          begin
+            builds = Build.all
+          rescue
+            shell.exit 'There was a problem connecting to the FVM API. Please try again.'
+          end
+          
+          shell.list builds
+        else
+          installations = installer.installations
+          
+          shell.exit "No Flex SDK versions installed. Run 'fvm install' to install some!" if installations.empty?
+          
+          shell.list installations
+        end
+      end
+=begin rdoc
+  Removes all symlinks created by FVM.
+=end
+      def unlink
+        linker.unlink!
+        shell.props "All Flex SDK symlinks successfully removed."
+      end
+=begin rdoc
+  Prints the active Flex SDK version number
+=end
+      def which
+        puts Fvm::System.active_version? ? Fvm::System.active_version.version : ''
+      end
+=begin rdoc
+  Prints the active Flex SDK home directory
+=end
+      def home
+        installations = installer.installations.select( &:active? )
+        puts installations.any? ? installations.first.dir : ''
+      end
+=begin rdoc
+  Prints the location of the fvm-restart script
+=end
+      def restart
+        puts restart_script_path
+      end
+
+      protected
+      
+      def executables
+        %w| asdoc compc mxmlc |
+      end
+
+      def installer
+        @installer ||= Installer.new( '~/Developer/SDKs', executables )
+      end
+      
+      def linker
+        @linker ||= Linker.new( '/usr/local/bin', executables )
+      end
+
+      def shell
+        @shell ||= Shell.new
+      end
+      
+      def restart_script_path
+        File.expand_path( File.join( `gem which fvm`.chomp, '..', '..', 'scripts', 'fvm' ) )
+      end
+
+    end
+  end
+end

data/lib/fvm/cli/installation.rb

@@ -0,0 +1,34 @@
+require 'pathname'
+require 'versionomy'
+
+module Fvm
+  module CLI
+    class Installation
+      include Comparable
+      
+      attr_reader :dir
+      def initialize( dir )
+        @dir = Pathname.new( dir ).expand_path
+      end
+      
+      def version
+        @dir.basename.to_s.sub( /^flex_sdk_/, '' )
+      end
+      
+      def active?
+        Fvm::System.active?( self )
+      end
+      
+      def to_menu
+        out = [ version ]
+        out.unshift '*' if active?
+        out.join ' '
+      end
+      
+      def <=> ( other )
+        Versionomy.parse( version ) <=> Versionomy.parse( other.version )
+      end
+      
+    end
+  end
+end

data/lib/fvm/cli/installer.rb

@@ -0,0 +1,54 @@
+require 'geoffrey'
+require 'fileutils'
+require 'pathname'
+
+module Fvm
+  module CLI
+    class Installer
+
+      attr_reader :dir, :executables
+      def initialize( dir, executables )
+        @dir = Pathname.new( dir ).expand_path
+        @executables = executables
+      end
+      
+      def install( zip_url, version )
+        # download the zip and unzip it
+        temp = download zip_url
+        # create the destination directory name for this sdk version
+        dest = File.join( dir, "flex_sdk_#{version}" )
+        # move the unzipped directory to the destination
+        move = FileUtils.mv temp, dest
+        # make all executables in bin actually executable
+        make_executables_executable! dest
+        # return the destination
+        dest
+      end
+      
+      def installations
+        Dir[ File.join( dir, 'flex_sdk_*' ) ].map { |d| Installation.new( d ) }
+      end
+      
+      protected
+
+      def download( zip_url )
+        Geoffrey.package do
+          url zip_url
+          def install
+            puts
+            File.dirname file_to_install
+          end
+        end
+      end
+      
+      def make_executables_executable!( dir )
+        executables_in( dir ).each { |name| `chmod 755 #{name}` }
+      end
+      
+      def executables_in( dir )
+        Dir[ File.join( dir, 'bin', '*' ) ].select { |name| executables.include? File.basename( name ) }
+      end
+      
+    end
+  end
+end