stickler 0.1.1 → 2.0.0a

data/lib/stickler/cli.rb

@@ -1,302 +0,0 @@
-#--
-# Copyright (c) 2008 Jeremy Hinegardner
-# All rights reserved.  Licensed under the same terms as Ruby.  No warranty is
-# provided.  See LICENSE and COPYING for details.
-#++
-
-require 'main'
-require 'stickler'
-
-module Stickler
-
-  # 
-  # Convert the Parameters::List that exists as the parameters from Main
-  #
-  def self.params_to_hash( params )
-    h = Hash.new
-    params.each do |p|
-      h [p.names.first ] = p.value
-    end
-    return h
-  end
-
-  #
-  # ::Main.create returns a class that is instantiated with ARGV and ENV as
-  # parameters.  The Cli is then used as:
-  #
-  #   Cli.new( ARGV, ENV ).run
-  #
-  CLI = ::Main.create {
-
-    author  "Copyright (c) 2008 Jeremy Hinegardner <jeremy@copiousfreetime.org>"
-    version Stickler::VERSION
-
-    description <<-txt
-      Stickler is a tool to organize and maintain an internal gem 
-      distribution server.  It synchronizes locally distriubted gems
-      with their upstream version, and locks the local version to a
-      particular version.
-      
-      run 'stickler help modename' for more info.
-    txt
-
-    examples <<-txt
-      . stickler setup 
-      . stickler remove gem rails
-      . stickler add gem ramaze 
-      . stickler add gem keybox --version 1.2.1
-      . stickler sync
-      . stickler info
-      . stickler generate index
-    txt
-
-    option( :quiet, "q" ) {
-      description 'be quiet about logging to stdout'
-      default false
-    }
-    
-    option( :debug ) {
-      description 'be verbose about logging in general'
-      default false
-    }
-
-    run { help! }
-
-    mode( :setup ) {
-      description 'setup a directory as a stickler repository'
-      argument( 'directory' ) { 
-        description "the stickler repository directory"
-        default Stickler::Repository.default_directory
-      }
-
-      examples <<-txt
-        . stickler setup 
-        . stickler setup /tmp/stickler
-      txt
-      
-      mixin :option_force
-
-      run { 
-        Stickler::Repository.new( Stickler.params_to_hash( params ) ).setup 
-      }
-    }
-
-    mode( :info ) {
-      description 'report information about the stickler repository'
-
-      examples <<-txt
-        . stickler info
-      txt
-
-      mixin :option_directory
-      
-      run { Stickler::Repository.new( Stickler.params_to_hash( params ) ).info }
-    }
-
-    mode( :add ) do
-      description <<-desc
-        Add a gem and all dependencies or a source to the repository.  
-      desc
-
-      examples <<-txt
-        . stickler add gem heel 
-        . stickler add gem ramaze -v 0.3.5
-        . stickler add source http://gems.github.com/
-      txt
-
-      mode( :gem ) do
-        description <<-desc
-        Add a gem and all its dependencies to the repository.  Run from
-        within the stickler repository or use the --directory option
-        desc
-
-        examples <<-txt
-          . stickler add gem heel
-          . stickler add gem ramaze -v 2008.06 --directory /var/stickler
-        txt
-
-        argument( 'gem_name' ) { description "The gem to add" }
-        mixin :option_directory
-        mixin :option_version
-
-        option( :requirements ) {
-          desc <<-desc
-          Satisfy dependency requirements using minimum or the maximum version 
-          that satisfies the dependency.  For instance if you had a gem that 
-          dependend on rake >= 0.8.1, if you used --requirements minimum then
-          stickler will download rake-0.8.1.  If you used --requrements maximum
-          then stickler will download the latest version of rake.
-          desc
-          
-          argument( :required )
-          validate { |r| %w[ maximum minimum ].include?( r.downcase ) }
-          default 'maximum'
-        }
-
-        run {
-          p = Stickler.params_to_hash( params )
-          repo = Stickler::Repository.new( p )
-          repo.add_gem( p['gem_name'], p['version'] || :latest )
-        }
-      end
-
-      mode( :source ) do
-        description <<-desc
-          Add a source the repository.  This makes that source available 
-          for use within the repository.  Run from within the stickler 
-          repository or use the --directory option.
-        desc
-
-        examples <<-txt
-          . stickler add source http://gems.github.com/
-        txt
-
-        argument( 'source_uri' ) { description "the source uri to add" }
-
-        mixin :option_directory
-        
-        run {
-          p = Stickler.params_to_hash( params )
-          repo = Stickler::Repository.new( p )
-          repo.add_source( p['source_uri'] )
-        }
-      end
-    end
-
-    mode( :remove ) do
-      description 'remove a gem or source from the repository'
-      example <<-txt
-        . stickler remove gem mongrel 
-        . stickler remove gem rails 
-        . stickler remove source htp://gems.github.com/
-      txt
-
-      mode( :gem ) do
-        description <<-desc
-          Remove a gem and all other gems that depend on it from the repository.
-          Run from within the stickler repository or use the --directory option
-        desc
-
-        example <<-txt
-          . stickler remove gem mongrel 
-          . stickler remove gem rails 
-        txt
-
-        mixin :option_directory
-        mixin :option_version
-
-        argument( 'gem_name' ) { description "The gem to remove" }
-
-        run {
-          p = Stickler.params_to_hash( params )
-          repo = Stickler::Repository.new( p )
-          repo.remove_gem( p['gem_name'], p['version'] || :all )
-        }
-      end
-
-      mode( :source ) do
-        description <<-desc
-          Remove a source and all is gems from the repository.
-          Run from within the stickler repository or use the --directory option
-        desc
-
-        example <<-txt
-          . stickler remove source htp://gems.github.com/
-        txt
-
-        mixin :option_directory
-        argument( 'source_uri' ) { description "The source to remove" }
-      
-        run {
-          p = Stickler.params_to_hash( params )
-          repo = Stickler::Repository.new( p )
-          repo.remove_source( p['source_uri'] )
-        }
-      end
-      
-    end
-
-    mode( 'sync' ) do
-      description <<-desc
-      check and make sure all the gems in the configuration file are available.
-      desc
-
-      example <<-txt
-        . sticker sync --rebuild
-      txt
-
-      mixin :option_directory
-      option( :rebuild ) {
-        description "Rebuild the repository from scratch"
-        default false
-      }
-
-
-      run {
-        p = Stickler.params_to_hash( params )
-        repo = Stickler::Repository.new( p )
-        repo.sync( p['rebuild'] )
-      }
-    end
-
-    mode( 'generate' ) do
-      mode( 'sysconfig' ) do
-        description <<-desc
-        generate the system wide configuration for use by rubygem clients that should use
-        the repository stickler creates.  
-        desc
-
-        example <<-txt
-          . stickler generate sysconfig
-        txt
-
-        mixin :option_directory
-        run {
-          p = Stickler.params_to_hash( params )
-          repo = Stickler::Repository.new( p )
-          repo.generate_sysconfig
-        }
-      end
-
-      mode( 'index' ) do
-        description <<-desc
-        generate the rubygems index of the gems to distribute in this repository.  
-        This is the same as doing a 'gem generate_index' but with a scope limited
-        to just the gems in this repository.
-        desc
-
-        example <<-txt
-          . stickler generate index
-        txt
-
-        mixin :option_directory
-        run {
-          p = Stickler.params_to_hash( params )
-          repo = Stickler::Repository.new( p )
-          repo.generate_index
-        }
-      end
-    end
-
-    ##
-    # common options used by more than one commands
-    #
-    mixin :option_directory do 
-      option( :directory, "d" ) {
-        argument :required
-        default Dir.pwd
-      }
-    end
-
-    mixin :option_force do
-      option( :force )  { default false }
-    end
-
-    mixin :option_version do
-      option( :version, "v" ) { 
-        argument :required 
-      }
-    end
-    
-  }
-end

data/lib/stickler/configuration.rb

@@ -1,74 +0,0 @@
-module Stickler
-  #
-  #
-  #
-  class Configuration
-
-    attr_reader :config_file_name
-
-    def initialize( config_file_name )
-      @config_file_name = config_file_name
-      @hash = YAML.load_file( config_file_name )
-      @hash['sources'] = @hash['sources'].collect do |uri|
-        p = uri.split("/")
-        p.join("/") + "/" # ensure a trailing slash
-      end
-    end
-
-    # the array of sources in this configuration
-    def sources
-      hash['sources']
-    end
-
-    # the downstream source  this repository represents
-    def downstream_source
-      hash['downstream_source']
-    end
-
-    # The gem and version requirements for this repository
-    def gem_dependencies
-      unless @gem_dependencies
-        @gem_dependencies = []
-        if hash['gems'] then
-          hash['gems'].each do |name, reqs|
-            [ reqs ].flatten.each do |req|
-              @gem_dependencies << ::Gem::Dependency.new( name, req )
-            end
-          end
-        end
-      end
-      return @gem_dependencies
-    end
-
-    def write
-      File.open( config_file_name, 'w' ) do |f|
-        g = Hash.new { |h,k| h[k] = [] }
-        gem_dependencies.each do |d|
-          g[d.name] << d.requirement_list
-          g[d.name].flatten!
-        end
-        hash['gems'] = g
-        f.write hash.to_yaml
-      end
-    end
-
-    def keys
-      @hash.keys
-    end
-
-    def []( key )
-      @hash[ key.to_s ]
-    end
-
-    def []=( key, value )
-      @hash[ key.to_s ] = value
-    end
-
-    def ==( other )
-      self.class === other and hash == other.hash
-    end
-
-    protected
-    attr_reader :hash
-  end
-end

data/lib/stickler/console.rb

@@ -1,72 +0,0 @@
-
-module Stickler
-  #
-  # containment for the output that a user should see.  This uses a Logger so
-  # that it can be throttled based on level at some point
-  #
-  class Console
-    class << self
-      #
-      # Items that get logged to stderr for the user to see should use this logger
-      #
-      def logger
-        unless @logger 
-          @logger = ::Logging::Logger['User']
-          @logger.level = :info
-          @logger.add_appenders(::Logging::Appender.stderr)
-          ::Logging::Appender.stderr.layout = Logging::Layouts::Pattern.new( :pattern => "%m\n" )
-          ::Logging::Appender.stderr.level = :info
-        end
-        return @logger
-      end
-
-      # force initialization 
-      Console.logger
-
-      #
-      # default logging leve
-      #
-      def default_level
-        :info
-      end
-
-      #
-      # Quick wrappers around the log levels
-      #
-      ::Logging::LEVELS.keys.each do |l|
-        module_eval <<-code
-          def #{ l }( msg )
-            @logger.#{l} msg
-          end
-        code
-      end
-
-      #
-      # Turn off the logging
-      #
-      def silent!
-        logger.level = :off
-      end
-
-      #
-      # Resume logging
-      #
-      def resume!
-        logger.level = self.default_level
-      end
-
-
-      #
-      # Turn off logging for the execution of a block
-      #
-      def silent( &block )
-        begin
-          silent!
-          block.call
-        ensure
-          resume!
-        end
-      end
-    end
-  end
-end

data/lib/stickler/paths.rb

@@ -1,62 +0,0 @@
-#--
-# Copyright (c) 2008 Jeremy Hinegardner
-# All rights reserved.  Licensed under the same terms as Ruby.  No warranty is
-# provided.  See LICENSE and COPYING for details.
-#++
-
-module Stickler 
-
-  # Paths module used by all the other modules and classes for
-  # determining paths and default values.
-  #
-  module Paths
-
-    #
-    # The root directory of the project is considered to be the parent directory
-    # of the 'lib' directory.  returns the full expanded path of the parent
-    # directory of 'lib' going up the path from the current file.  A trailing
-    # File::SEPARATOR is guaranteed.
-    #
-    def self.root_dir
-      unless @root_dir
-        path_parts = ::File.expand_path(__FILE__).split(::File::SEPARATOR)
-        lib_index  = path_parts.rindex("lib")
-        @root_dir = path_parts[0...lib_index].join(::File::SEPARATOR) + ::File::SEPARATOR
-      end
-      return @root_dir
-    end
-
-    # 
-    # return the full expanded path of the +config+ directory below +root_dir+.
-    # All parameters passed in are joined on to the result. a Trailing
-    # File::SEPARATOR is guaranteed if _args_ are *not* present
-    #
-    def self.config_path(*args)
-      self.sub_path("config", *args)
-    end
-
-    #
-    # return the full expanded path of the +data+ directory below +root_dir+.
-    # All parameters passed in are joined on to the result. a Trailing
-    # File::SEPARATOR is guaranteed if _args_ are *not* present
-    #
-    def self.data_path(*args)
-      self.sub_path("data", *args)
-    end
-   
-    #
-    # return the full expanded path of the +lib+ directory below +root_dir+.
-    # All parameters passed in are joined on to the result. a Trailing
-    # File::SEPARATOR is guaranteed if _args_ are *not* present
-    #
-    def self.lib_path(*args)
-      self.sub_path("lib", *args)
-    end
-
-    private
-    def self.sub_path(sub,*args)
-      sp = ::File.join(root_dir, sub) + File::SEPARATOR
-      sp = ::File.join(sp, *args) if args
-    end
-  end
-end

data/lib/stickler/source.rb

@@ -1,75 +0,0 @@
-require 'uri'
-require 'base64'
-require 'zlib'
-
-module Stickler
-  #
-  # The representation of an upstream source from which stickler pulls gems.
-  # This wraps up the contents of the upstream specs.4.8 file found in a
-  # rubygems 1.2 or greater repository.
-  #
-  class Source
-    class Error < ::StandardError; end
-
-    # the uri of the source
-    attr_reader :uri
-
-    # the source_group this source belongs to
-    attr_accessor :source_group
-
-    def self.normalize_uri( uri )
-      return uri if uri.kind_of?( URI::Generic ) 
-      path_parts = uri.split( "/" )
-      uri = path_parts.join( "/" ) + "/"
-      uri = ::URI.parse( uri )
-    end
-
-    #
-    # Create a new Source for a source_group.
-    # Try and load the source from the cache if it can and if not, 
-    # load it from the uri
-    #
-    def initialize( uri, source_group )
-
-      begin
-        @uri = Source.normalize_uri( uri )
-        @source_group = source_group
-        load_source_specs
-
-      rescue ::URI::Error => e
-        raise Error, "Unable to create source from uri #{uri} : #{e}"
-      end
-    end
-
-    #
-    # find all matching gems and return their SpecLite
-    #
-    def search( dependency )
-      found = source_specs.select do | spec |
-        dependency =~ Gem::Dependency.new( spec.name, spec.version )
-      end
-    end
-
-    #
-    # load the upstream or cached specs.marshalversion file for the source.
-    #
-    def source_specs
-      unless @source_specs
-        Console.info " * loading #{uri}" 
-        @source_specs = []
-        ::Gem::SpecFetcher.fetcher.load_specs( uri, 'specs' ).each do |name, version, platform|
-          @source_specs << SpecLite.new( name, version, platform )
-        end
-      end
-      return @source_specs
-    end
-
-    #
-    # force a load of the source_specs
-    #
-    def load_source_specs
-      @source_specs = nil
-      return source_specs
-    end
-  end
-end