coherent 0.3.0 → 0.4.0

data/lib/distilery/coherent-asset-filter.rb

@@ -23,7 +23,7 @@ class CoherentAssetFilter < FileReferenceFilter
         import_file= File.expand_path(File.join(file.parent_folder, $1))
 
         if (!File.exists?(import_file))
-          file.error "Missing import file: #{$1}", line_num
+          file.warning "Missing asset: #{$1}", line_num
           "NIB.asset('#{$1}')"
         else
           asset= SourceFile.from_path(import_file)
@@ -42,7 +42,7 @@ class CoherentAssetFilter < FileReferenceFilter
         import_file= File.expand_path(File.join(file.parent_folder, $1))
 
         if (!File.exists?(import_file))
-          file.error "Missing import file: #{$1}", line_num
+          file.warning "Missing import file: #{$1}", line_num
           "INC('#{$1}')"
         else
           asset= SourceFile.from_path(import_file)

data/lib/distilery/nib-file.rb

@@ -10,4 +10,4 @@ class NibFile < JavascriptFile
     "js"
   end
 
-end
+end

data/lib/plugin.rb

@@ -0,0 +1,83 @@
+# This is the coherent plugin manager and was adapted from the Rails plugin
+# manager by Ryan Tomayko (rtomayko@gmail.com).
+# 
+# Listing available plugins:
+#
+#   $ ./script/plugin list
+#   continuous_builder            http://dev.rubyonrails.com/svn/rails/plugins/continuous_builder
+#   asset_timestamping            http://svn.aviditybytes.com/rails/plugins/asset_timestamping
+#   enumerations_mixin            http://svn.protocool.com/rails/plugins/enumerations_mixin/trunk
+#   calculations                  http://techno-weenie.net/svn/projects/calculations/
+#   ...
+#
+# Installing plugins:
+#
+#   $ ./script/plugin install continuous_builder asset_timestamping
+#
+# Finding Repositories:
+#
+#   $ ./script/plugin discover
+# 
+# Adding Repositories:
+#
+#   $ ./script/plugin source http://svn.protocool.com/rails/plugins/
+#
+# How it works:
+# 
+#   * Maintains a list of subversion repositories that are assumed to have
+#     a plugin directory structure. Manage them with the (source, unsource,
+#     and sources commands)
+#     
+#   * The discover command scrapes the following page for things that
+#     look like subversion repositories with plugins:
+#     http://wiki.rubyonrails.org/rails/pages/Plugins
+# 
+#   * Unless you specify that you want to use svn, script/plugin uses plain old
+#     HTTP for downloads.  The following bullets are true if you specify
+#     that you want to use svn.
+#
+#   * If `vendor/plugins` is under subversion control, the script will
+#     modify the svn:externals property and perform an update. You can
+#     use normal subversion commands to keep the plugins up to date.
+# 
+#   * Or, if `vendor/plugins` is not under subversion control, the
+#     plugin is pulled via `svn checkout` or `svn export` but looks
+#     exactly the same.
+# 
+# Specifying revisions:
+#
+#   * Subversion revision is a single integer.
+#
+#   * Git revision format:
+#     - full - 'refs/tags/1.8.0' or 'refs/heads/experimental'
+#     - short: 'experimental' (equivalent to 'refs/heads/experimental')
+#              'tag 1.8.0' (equivalent to 'refs/tags/1.8.0')
+#
+#
+# This is Free Software, copyright 2005 by Ryan Tomayko (rtomayko@gmail.com) 
+# and is licensed MIT: (http://www.opensource.org/licenses/mit-license.php)
+
+
+
+
+require 'open-uri'
+require 'fileutils'
+require 'tempfile'
+
+include FileUtils
+
+LIB_DIR = File.dirname(__FILE__)
+$:.unshift(LIB_DIR)
+
+$verbose = false
+
+require 'plugin/commands'
+require 'plugin/environment'
+require 'plugin/plugin'
+require 'plugin/recursive-http-fetcher'
+require 'plugin/repositories'
+require 'plugin/repository'
+
+require 'plugin/commands'
+
+

data/lib/plugin/commands.rb

@@ -0,0 +1,12 @@
+require 'optparse'
+
+require 'plugin/commands/plugin'
+require 'plugin/commands/discover'
+require 'plugin/commands/info'
+require 'plugin/commands/install'
+require 'plugin/commands/list'
+require 'plugin/commands/remove'
+require 'plugin/commands/source'
+require 'plugin/commands/sources'
+require 'plugin/commands/unsource'
+require 'plugin/commands/update'

data/lib/plugin/commands/discover.rb

@@ -0,0 +1,78 @@
+module Coherent
+  module Commands
+    
+    class Discover
+      def initialize(base_command)
+        @base_command = base_command
+        @list = false
+        @prompt = true
+      end
+    
+      def options
+        OptionParser.new do |o|
+          o.set_summary_indent('  ')
+          o.banner =    "Usage: #{@base_command.script_name} discover URI [URI [URI]...]"
+          o.define_head "Discover repositories referenced on a page."
+          o.separator   ""        
+          o.separator   "Options:"
+          o.separator   ""
+          o.on(         "-l", "--list", 
+                        "List but don't prompt or add discovered repositories.") { |list| @list, @prompt = list, !@list }
+          o.on(         "-n", "--no-prompt", 
+                        "Add all new repositories without prompting.") { |v| @prompt = !v }
+        end
+      end
+
+      def parse!(args)
+        options.parse!(args)
+        args = ['http://wiki.rubyonrails.org/rails/pages/Plugins'] if args.empty?
+        args.each do |uri|
+          scrape(uri) do |repo_uri|
+            catch(:next_uri) do
+              if @prompt
+                begin
+                  $stdout.print "Add #{repo_uri}? [Y/n] "
+                  throw :next_uri if $stdin.gets !~ /^y?$/i
+                rescue Interrupt
+                  $stdout.puts
+                  exit 1
+                end
+              elsif @list
+                puts repo_uri
+                throw :next_uri
+              end
+              Repositories.instance.add(repo_uri)
+              puts "discovered: #{repo_uri}" if $verbose or !@prompt
+            end
+          end
+        end
+        Repositories.instance.save
+      end
+    
+      def scrape(uri)
+        require 'open-uri'
+        puts "Scraping #{uri}" if $verbose
+        dupes = []
+        content = open(uri).each do |line|
+          begin
+            if line =~ /<a[^>]*href=['"]([^'"]*)['"]/ || line =~ /(svn:\/\/[^<|\n]*)/
+              uri = $1
+              if uri =~ /^\w+:\/\// && uri =~ /\/plugins\// && uri !~ /\/browser\// && uri !~ /^http:\/\/wiki\.rubyonrails/ && uri !~ /http:\/\/instiki/
+                uri = extract_repository_uri(uri)
+                yield uri unless dupes.include?(uri) || Repositories.instance.exist?(uri)
+                dupes << uri
+              end
+            end
+          rescue
+            puts "Problems scraping '#{uri}': #{$!.to_s}"
+          end
+        end
+      end
+    
+      def extract_repository_uri(uri)
+        uri.match(/(svn|https?):.*\/plugins\//i)[0]
+      end 
+    end
+
+  end
+end

data/lib/plugin/commands/info.rb

@@ -0,0 +1,29 @@
+module Coherent
+  module Commands
+    
+
+    class Info
+      def initialize(base_command)
+        @base_command = base_command
+      end
+
+      def options
+        OptionParser.new do |o|
+          o.set_summary_indent('  ')
+          o.banner =    "Usage: #{@base_command.script_name} info name [name]..."
+          o.define_head "Shows plugin info at {url}/about.yml."
+        end
+      end
+
+      def parse!(args)
+        options.parse!(args)
+        args.each do |name|
+          puts ::Plugin.find(name).info
+          puts
+        end
+      end
+    end
+
+
+  end
+end

data/lib/plugin/commands/install.rb

@@ -0,0 +1,76 @@
+module Coherent
+  module Commands
+    
+    
+    class Install
+      def initialize(base_command)
+        @base_command = base_command
+        @method = :http
+        @options = { :quiet => false, :revision => nil, :force => false }
+      end
+    
+      def options
+        OptionParser.new do |o|
+          o.set_summary_indent('  ')
+          o.banner =    "Usage: #{@base_command.script_name} install PLUGIN [PLUGIN [PLUGIN] ...]"
+          o.define_head "Install one or more plugins."
+          o.separator   ""
+          o.separator   "Options:"
+          o.on(         "-x", "--externals", 
+                        "Use svn:externals to grab the plugin.", 
+                        "Enables plugin updates and plugin versioning.") { |v| @method = :externals }
+          o.on(         "-o", "--checkout",
+                        "Use svn checkout to grab the plugin.",
+                        "Enables updating but does not add a svn:externals entry.") { |v| @method = :checkout }
+          o.on(         "-e", "--export",
+                        "Use svn export to grab the plugin.",
+                        "Exports the plugin, allowing you to check it into your local repository. Does not enable updates, or add an svn:externals entry.") { |v| @method = :export }
+          o.on(         "-q", "--quiet",
+                        "Suppresses the output from installation.",
+                        "Ignored if -v is passed (./script/plugin -v install ...)") { |v| @options[:quiet] = true }
+          o.on(         "-r REVISION", "--revision REVISION",
+                        "Checks out the given revision from subversion or git.",
+                        "Ignored if subversion/git is not used.") { |v| @options[:revision] = v }
+          o.on(         "-f", "--force",
+                        "Reinstalls a plugin if it's already installed.") { |v| @options[:force] = true }
+          o.separator   ""
+          o.separator   "You can specify plugin names as given in 'plugin list' output or absolute URLs to "
+          o.separator   "a plugin repository."
+        end
+      end
+    
+      def determine_install_method
+        best = @base_command.environment.best_install_method
+        @method = :http if best == :http and @method == :export
+        case
+        when (best == :http and @method != :http)
+          msg = "Cannot install using subversion because `svn' cannot be found in your PATH"
+        when (best == :export and (@method != :export and @method != :http))
+          msg = "Cannot install using #{@method} because this project is not under subversion."
+        when (best != :externals and @method == :externals)
+          msg = "Cannot install using externals because vendor/plugins is not under subversion."
+        end
+        if msg
+          puts msg
+          exit 1
+        end
+        @method
+      end
+    
+      def parse!(args)
+        options.parse!(args)
+        environment = @base_command.environment
+        install_method = determine_install_method
+        puts "Plugins will be installed using #{install_method}" if $verbose
+        args.each do |name|
+          Coherent::Plugin.find(name).install(install_method, @options)
+        end
+      rescue StandardError => e
+        puts "Plugin not found: #{args.inspect}"
+        puts e.inspect if $verbose
+        exit 1
+      end
+    end
+
+  end
+end

data/lib/plugin/commands/list.rb

@@ -0,0 +1,55 @@
+module Coherent
+  module Commands  
+  
+    class List
+      def initialize(base_command)
+        @base_command = base_command
+        @sources = []
+        @local = false
+        @remote = true
+      end
+    
+      def options
+        OptionParser.new do |o|
+          o.set_summary_indent('  ')
+          o.banner =    "Usage: #{@base_command.script_name} list [OPTIONS] [PATTERN]"
+          o.define_head "List available plugins."
+          o.separator   ""        
+          o.separator   "Options:"
+          o.separator   ""
+          o.on(         "-s", "--source=URL1,URL2", Array,
+                        "Use the specified plugin repositories.") {|sources| @sources = sources}
+          o.on(         "--local", 
+                        "List locally installed plugins.") {|local| @local, @remote = local, false}
+          o.on(         "--remote",
+                        "List remotely available plugins. This is the default behavior",
+                        "unless --local is provided.") {|remote| @remote = remote}
+        end
+      end
+    
+      def parse!(args)
+        options.order!(args)
+        unless @sources.empty?
+          @sources.map!{ |uri| Repository.new(uri) }
+        else
+          @sources = Repositories.instance.all
+        end
+        if @remote
+          @sources.map{|r| r.plugins}.flatten.each do |plugin| 
+            if @local or !plugin.installed?
+              puts plugin.to_s
+            end
+          end
+        else
+          cd "#{@base_command.environment.root}/vendor/plugins"
+          Dir["*"].select{|p| File.directory?(p)}.each do |name| 
+            puts name
+          end
+        end
+      end
+    end
+
+
+
+  end
+end

data/lib/plugin/commands/plugin.rb

@@ -0,0 +1,105 @@
+# load default environment and parse arguments
+module Coherent
+  module Commands
+
+    class Plugin
+      attr_reader :environment, :script_name, :sources
+      def initialize
+        @environment = Coherent::Environment.default
+        @root = Coherent::Environment.default.root
+        @script_name = File.basename($0) 
+        @sources = []
+      end
+    
+      def environment=(value)
+        @environment = value
+        Coherent::Environment.default = value
+      end
+    
+      def options
+        OptionParser.new do |o|
+          o.set_summary_indent('  ')
+          o.banner =    "Usage: #{@script_name} [OPTIONS] command"
+          o.define_head "Rails plugin manager."
+        
+          o.separator ""        
+          o.separator "GENERAL OPTIONS"
+        
+          o.on("-r", "--root=DIR", String,
+               "Set an explicit rails app directory.",
+               "Default: #{@root}") { |root| @root = root; self.environment = Coherent::Environment.new(@root) }
+          o.on("-s", "--source=URL1,URL2", Array,
+               "Use the specified plugin repositories instead of the defaults.") { |sources| @sources = sources}
+        
+          o.on("-v", "--verbose", "Turn on verbose output.") { |verbose| $verbose = verbose }
+          o.on("-h", "--help", "Show this help message.") { puts o; exit }
+        
+          o.separator ""
+          o.separator "COMMANDS"
+        
+          o.separator "  discover   Discover plugin repositories."
+          o.separator "  list       List available plugins."
+          o.separator "  install    Install plugin(s) from known repositories or URLs."
+          o.separator "  update     Update installed plugins."
+          o.separator "  remove     Uninstall plugins."
+          o.separator "  source     Add a plugin source repository."
+          o.separator "  unsource   Remove a plugin repository."
+          o.separator "  sources    List currently configured plugin repositories."
+        
+          o.separator ""
+          o.separator "EXAMPLES"
+          o.separator "  Install a plugin:"
+          o.separator "    #{@script_name} install continuous_builder\n"
+          o.separator "  Install a plugin from a subversion URL:"
+          o.separator "    #{@script_name} install http://dev.rubyonrails.com/svn/rails/plugins/continuous_builder\n"
+          o.separator "  Install a plugin from a git URL:"
+          o.separator "    #{@script_name} install git://github.com/SomeGuy/my_awesome_plugin.git\n"
+          o.separator "  Install a plugin and add a svn:externals entry to vendor/plugins"
+          o.separator "    #{@script_name} install -x continuous_builder\n"
+          o.separator "  List all available plugins:"
+          o.separator "    #{@script_name} list\n"
+          o.separator "  List plugins in the specified repository:"
+          o.separator "    #{@script_name} list --source=http://dev.rubyonrails.com/svn/rails/plugins/\n"
+          o.separator "  Discover and prompt to add new repositories:"
+          o.separator "    #{@script_name} discover\n"
+          o.separator "  Discover new repositories but just list them, don't add anything:"
+          o.separator "    #{@script_name} discover -l\n"
+          o.separator "  Add a new repository to the source list:"
+          o.separator "    #{@script_name} source http://dev.rubyonrails.com/svn/rails/plugins/\n"
+          o.separator "  Remove a repository from the source list:"
+          o.separator "    #{@script_name} unsource http://dev.rubyonrails.com/svn/rails/plugins/\n"
+          o.separator "  Show currently configured repositories:"
+          o.separator "    #{@script_name} sources\n"        
+        end
+      end
+    
+      def parse!(args=ARGV)
+        general, sub = split_args(args)
+        options.parse!(general)
+      
+        command = general.shift
+        if command =~ /^(list|discover|install|source|unsource|sources|remove|update|info)$/
+          command = Commands.const_get(command.capitalize).new(self)
+          command.parse!(sub)
+        else
+          puts "Unknown command: #{command}"
+          puts options
+          exit 1
+        end
+      end
+    
+      def split_args(args)
+        left = []
+        left << args.shift while args[0] and args[0] =~ /^-/
+        left << args.shift if args[0]
+        return [left, args]
+      end
+    
+      def self.parse!(args=ARGV)
+        Plugin.new.parse!(args)
+      end
+    end
+    
+
+  end
+end