shard 0.1.0

data/bin/shard

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+
+$:.unshift 'lib'
+
+require 'thor'
+require 'shard'
+require 'shard/cli'
+
+Shard::CLI.start(ARGV)

data/lib/shard.rb

@@ -0,0 +1,13 @@
+class Shard
+  class << self
+    attr_accessor :current_loader
+  end
+end
+
+require 'shard/shard_directory'
+require 'shard/loader'
+require 'shard/saver'
+require 'shard/lister'
+require 'shard/gist'
+require 'shard/shard_record'
+require 'shard/kernel'

data/lib/shard/cli.rb

@@ -0,0 +1,72 @@
+require 'thor'
+
+class Shard::CLI < Thor
+
+  ########
+  #      #
+  # List #
+  #      #
+  ########
+  
+  desc "list USERNAME", "List all shards for Github user USERNAME"
+  
+  def list(username)
+    lister = Shard::Lister.new(username)
+
+    if lister.shards.any?
+      puts "Shards for Github user #{ username }:"
+      puts
+
+      lister.shard_names.each do |name|
+        shard = lister.shards[name]
+        puts "#{ name }:"
+        puts "  Description | #{ shard.description }"
+        puts "  URL         | #{ shard.url }"
+        puts
+      end
+    else
+      puts "Github user #{ username } does not have any shards."
+      puts "Shards are gists that have a file named shard.rb or <foo>.shard.rb"
+    end
+  end
+
+  ########
+  #      #
+  # Exec #
+  #      #
+  ########
+  
+  desc "exec USERNAME/SHARD", "Runs the shard named SHARD for Github user USERNAME"
+
+  def exec(shard_line)
+    Shard::Loader.load shard_line
+  end
+
+  #########
+  #       #
+  # Fetch #
+  #       #
+  #########
+  
+  desc "fetch USERNAME/SHARD", "Downloads the shard named SHARD for Github user USERNAME"
+
+  def fetch(shard_line)
+    username, shard = shard_line.split '/'
+    shard = Shard::ShardRecord.new(username, shard, 'HEAD')
+
+    Shard::Saver.save(shard, verbose: true)
+  end
+
+  ########
+  #      #
+  # Test #
+  #      #
+  ########
+  
+  desc "test USERNAME/SHARD", "Runs the tests for shard named SHARD for Github user USERNAME"
+
+  def test(shard_line)
+    Shard::Loader.test shard_line
+  end
+
+end

data/lib/shard/gist.rb

@@ -0,0 +1,78 @@
+require 'yaml'
+
+class Shard
+
+  class Gist
+
+    ################
+    #              #
+    # Declarations #
+    #              #
+    ################
+
+    SHARD_FILENAME = /(?:^(\w+)\.)?shard\.rb$/
+
+    ###############
+    #             #
+    # Constructor #
+    #             #
+    ###############
+    
+    def initialize(gist_hash)
+      @gist_hash = gist_hash
+    end
+
+    ####################
+    #                  #
+    # Instance Methods #
+    #                  #
+    ####################
+    
+    def all_files
+      files.values
+    end
+
+    def description
+      @gist_hash.description
+    end
+
+    def id
+      @gist_hash.id
+    end
+    
+    def name
+      match = shard_file.filename.match(SHARD_FILENAME)
+
+      match[1] || id
+    end
+
+    def ruby_files
+      files.select { |filename| filename =~ /\.rb$/ }.values
+    end
+
+    def shard_file
+      files.select { |filename| filename =~ SHARD_FILENAME }.values.first
+    end
+
+    def url
+      @gist_hash.html_url
+    end
+
+    def username
+      @gist_hash.user.login
+    end
+
+    def valid_shard?
+      ! shard_file.nil?
+    end
+
+    private
+
+    def files
+      @gist_hash.files
+    end
+
+
+  end
+
+end

data/lib/shard/kernel.rb

@@ -0,0 +1,7 @@
+module Kernel
+
+  def shard(shard_line)
+    Shard::Loader.load(shard_line)
+  end
+
+end

data/lib/shard/lister.rb

@@ -0,0 +1,60 @@
+require 'octokit'
+
+class Shard
+
+  class Lister
+
+    ################
+    #              #
+    # Declarations #
+    #              #
+    ################
+    
+    attr_reader :username
+
+    ###############
+    #             #
+    # Constructor #
+    #             #
+    ###############
+    
+    def initialize(username)
+      @username = username
+    end
+
+    ####################
+    #                  #
+    # Instance Methods #
+    #                  #
+    ####################
+    
+    def gists
+      @gists ||= fetch_gists.map { |gist| Gist.new(gist) }
+    end
+
+    def shards
+      @shards ||= Hash.new.tap do |hash|
+        valid = gists.select { |gist| gist.valid_shard? }
+        valid.each do |shard|
+          hash[shard.name] = shard
+        end
+      end
+    end
+
+    def shard_names
+      shards.keys.sort
+    end
+
+    private
+
+    def fetch_gists
+      Octokit.gists username
+    end
+
+    def gist_by_id(id)
+      gists.detect { |gist| gist.id == id.to_s }
+    end
+
+  end
+
+end

data/lib/shard/loader.rb

@@ -0,0 +1,115 @@
+class Shard
+
+  class Loader
+
+    ################
+    #              #
+    # Declarations #
+    #              #
+    ################
+    
+    include ShardDirectory
+
+    attr_reader :shard
+
+    SHARD_LINE_REGEX = %r{([a-zA-Z0-9_-]+)/(\w+)(?::(\w+))?}
+
+    ###############
+    #             #
+    # Constructor #
+    #             #
+    ###############
+    
+    def initialize(shard_line)
+      parse_shard_line(shard_line)
+    end
+
+    #################
+    #               #
+    # Class Methods #
+    #               #
+    #################
+    
+    def self.load(shard_line)
+      new(shard_line).load
+    end
+
+    def self.test(shard_line)
+      new(shard_line).test
+    end
+
+    ####################
+    #                  #
+    # Instance Methods #
+    #                  #
+    ####################
+    
+    def load
+      ensure_shard_saved
+
+      Shard.current_loader, previous_loader = self, Shard.current_loader
+      require shard_file_path
+      Shard.current_loader = previous_loader
+    end
+
+    def load_file(filename)
+      path = filename ? ruby_file_path(filename) : shard_file_path
+      require path
+    end
+
+    def test
+      ensure_shard_saved
+
+      Shard.current_loader, previous_loader = self, Shard.current_loader
+      require *shard_test_paths
+      Shard.current_loader = previous_loader
+    end
+
+    private
+
+    def already_loaded?
+      shard_dir_exists?(shard.username, shard.name, shard.version)
+    end
+
+    def ensure_shard_saved
+      unless already_loaded?
+        Shard::Saver.save shard
+      end
+    end
+
+    def parse_shard_line(shard_line)
+      if match = shard_line.match(SHARD_LINE_REGEX)
+        username = match[1]
+        name     = match[2]
+        version  = parse_version match[3]
+
+        @shard = Shard::ShardRecord.new(username, name, version)
+      end
+    end
+
+    def parse_version(raw_version)
+      raw_version || 'HEAD'
+    end
+
+    def ruby_file_path(filename)
+      file_path(shard.username, shard.name, shard.version, filename)
+    end
+
+    def shard_file_path
+      path = file_path(shard.username, shard.name, shard.version, '*shard.rb')
+      Dir[ path ].first
+    end
+
+    def shard_test_paths
+      test_path  = file_path(shard.username, shard.name, shard.version, '*_test.rb')
+      test_files = Dir[ test_path ]
+
+      spec_path  = file_path(shard.username, shard.name, shard.version, '*_spec.rb')
+      spec_files = Dir[ spec_path ]
+
+      test_files + spec_files
+    end
+
+  end
+
+end

data/lib/shard/saver.rb

@@ -0,0 +1,85 @@
+class Shard
+
+  class Saver
+
+    ################
+    #              #
+    # Declarations #
+    #              #
+    ################
+    
+    include ShardDirectory
+
+    attr_reader :shard, :gist, :full_gist, :options
+
+    ###############
+    #             #
+    # Constructor #
+    #             #
+    ###############
+    
+    def initialize(shard, options = {})
+      @shard   = shard
+      @options = options
+    end
+
+    #################
+    #               #
+    # Class Methods #
+    #               #
+    #################
+    
+    def self.save(shard, options = {})
+      new(shard, options).save!
+    end
+
+    ####################
+    #                  #
+    # Instance Methods #
+    #                  #
+    ####################
+    
+    def save!
+      create_shard_dir(shard.username, shard.name, shard.version)
+      fetch_shard_contents
+
+      gist.all_files.each do |file|
+        write_file(file)
+      end
+
+      if options[:verbose]
+        puts "VERSION #{ version(8) }..."
+      end
+    end
+
+    private
+
+    def fetch_shard_contents
+      lister     = Shard::Lister.new(shard.username)
+      @gist      = lister.shards[shard.name]
+      @full_gist = Octokit.gist gist.id
+    end
+
+    def file_contents(filename)
+      full_gist.files[filename].content
+    end
+
+    def write_file(file)
+      path     = file_path(shard.username, shard.name, shard.version, file.filename)
+      contents = file_contents(file.filename)
+
+      if options[:verbose]
+        puts "Saving #{ file.filename }"
+      end
+
+      File.write path, contents
+    end
+    
+    def version(length)
+      full_version = full_gist.history.first.version
+      full_version[0...length]
+    end
+
+  end
+
+end

data/lib/shard/shard_directory.rb

@@ -0,0 +1,45 @@
+class Shard
+
+  module ShardDirectory
+
+    ##################
+    #                #
+    # Module Methods #
+    #                #
+    ##################
+    
+    def create_root
+      unless Dir.exists?(path)
+        Dir.mkdir(path)
+      end
+    end
+
+    def create_shard_dir(username, shard, version)
+      dir = directory(username, shard, version)
+
+      unless shard_dir_exists?(username, shard, version)
+        FileUtils.mkpath(dir)
+      end
+    end
+
+    def shard_dir_exists?(username, shard, version)
+      dir = directory(username, shard, version)
+
+      Dir.exists?(dir)
+    end
+
+    def directory(username, shard, version)
+      File.join(path, username, shard, version)
+    end
+
+    def path
+      File.join(Dir.home, '.shard')
+    end
+
+    def file_path(username, shard, version, filename)
+      File.join( directory(username, shard, version), filename )
+    end
+
+  end
+
+end

data/lib/shard/shard_record.rb

@@ -0,0 +1,29 @@
+class Shard::ShardRecord
+
+  ################
+  #              #
+  # Declarations #
+  #              #
+  ################
+  
+  attr_reader :username, :name, :version
+
+  ###############
+  #             #
+  # Constructor #
+  #             #
+  ###############
+  
+  def initialize(username, name, version = "HEAD")
+    @username = username
+    @name     = name
+    @version  = version
+  end
+
+  ####################
+  #                  #
+  # Instance Methods #
+  #                  #
+  ####################
+
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification
+name: shard
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Mark Josef
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &70120253751200 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70120253751200
+description: ! 'Shard is a light-weight code loading-and-running-and-sharing tool,
+  built on top of http://gist.github.com.
+
+
+  You can load the shard''s code using a Kernel#shard method, and can load, run, and
+  test a shard directly from the command line.
+
+'
+email: mcphage@gmail.com
+executables:
+- shard
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/shard.rb
+- lib/shard/cli.rb
+- lib/shard/gist.rb
+- lib/shard/kernel.rb
+- lib/shard/lister.rb
+- lib/shard/loader.rb
+- lib/shard/saver.rb
+- lib/shard/shard_directory.rb
+- lib/shard/shard_record.rb
+- bin/shard
+homepage: https://github.com/mark/shard
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Very lightweight ruby package manager built on gist.
+test_files: []