cdnjs-command 0.0.1

data/README.md

@@ -0,0 +1,44 @@
+# cdnjs-command
+#### Command line helper for cdnjs.com.
+
+This makes including JS files in your project easy-peasy. To add a JS libary
+to your project:
+
+    $ cdnjs jquery
+    Created jquery-1.5.1.js.
+
+You probably want to link the online version as well:
+
+    $ cdnjs html jquery
+    <script src='https://ajax.googleapis.com/ajax/libs/jquery/1.5.1/jquery.min.js'></script>
+
+Or you may want just the URL:
+
+    $ cdnjs url underscore
+    http://ajax.cdnjs.com/ajax/libs/underscore.js/1.1.4/underscore-min.js
+
+## Installation
+
+Copy `bin/cdnjs` into your PATH somewhere, or use `gem install cdnjs-command`.
+
+## Usage
+
+    Usage:
+      cdnjs NAME       - Download specific package
+
+    Other commands:
+      cdnjs list       - List available packages
+      cdnjs info NAME  - Show package info
+      cdnjs html NAME  - Show HTML snippet to include given package
+      cdnjs url NAME   - Show the URL for the given package
+      cdnjs update     - Updates the package cache
+
+    You may also use the first letters of each command; e.g., `cdnjs i jquery`.
+    Here are some common examples:
+
+      $ cdnjs jquery
+      $ echo `cdnjs h underscore` >> index.html
+
+## Acknowledgements
+
+ * [www.cdnjs.com](http://cdnjs.com)

data/bin/cdnjs

@@ -0,0 +1,215 @@
+#!/usr/bin/env ruby
+require 'open-uri'
+require 'fileutils'
+require 'json'
+
+CDNJS_VERSION = "0.0.1"
+
+module Params;
+  def extract(what)   i = index(what) and slice!(i, 2)[1] end;
+  def first_is(what)  shift  if what.include?(self.first); end
+  def self.[](*what)  what.extend Params; end
+  def ===(argv)       argv.first_is(self); end
+end
+
+ARGV.extend Params
+
+# ============================================================================
+
+module Fetcher
+  CACHE_PATH = "~/.cache/cdnjs"
+
+  def self.fetch(url)
+    return cache_for(url)  if cached?(url)
+
+    tip "Fetching #{url}..."
+    output = open(url).read
+
+    FileUtils.mkdir_p File.expand_path(CACHE_PATH)
+    File.open(cache_path_for(url), 'w') { |f| f.write output }
+    output
+  rescue => e
+    tip "Unable to fetch (#{e.class.name}: #{e.message})."
+    exit
+  end
+
+  def self.purge
+    FileUtils.rm_rf File.expand_path(CACHE_PATH)
+  end
+
+  def self.cached?(url)
+    File.file? cache_path_for(url)
+  end
+
+  def self.cache_path_for(url)
+    File.expand_path slug(url), CACHE_PATH
+  end
+
+  def self.cache_for(url)
+    File.open(cache_path_for(url)) { |f| f.read }
+  end
+
+  def self.slug(url)
+    url.gsub(/[\/:]/, '_')
+  end
+end
+
+class Package
+  INDEX_URL = 'http://cdnjs.com/packages.json'
+
+  attr_reader :data, :name, :version, :description, :homepage,
+              :maintainers, :repositories
+
+  def initialize(hash)
+    @data = hash
+    @name         = hash['name'].gsub(/\.js$/, '')
+    @version      = hash['version']
+    @description  = hash['description']
+    @homepage     = hash['homepage']
+    @filename     = hash['filename']
+    @maintainers  = hash['maintainers']
+    @repositories = hash['repositories']
+  end
+
+  def basename
+    "#{name}-#{version}.js"
+  end
+
+  def url
+    if @filename =~ /^http/
+      @filename
+    else
+      "http://ajax.cdnjs.com/ajax/libs/#{data['name']}/#{version}/#{@filename}"
+    end
+  end
+
+  # @return Array of {Package}s
+  def self.all
+    packages = JSON.parse(fetch(INDEX_URL))['packages']
+    packages.delete(Hash.new)
+    packages
+      .map { |hash| Package.new(hash) }
+      .sort_by { |pkg| pkg.name }
+  end
+
+  def self.fetch(url)
+    Fetcher.fetch(INDEX_URL).force_encoding('utf-8')
+  end
+
+  def self.[](id)
+    all.detect { |pkg| pkg.name == id } ||
+    all.detect { |pkg| pkg.name[0...id.size] == id }
+  end
+end
+
+# ============================================================================
+# Helpers
+
+def tip(message)
+  $stderr.write "#{message}\n"
+end
+
+def invalid_usage(usage="cdnjs --help")
+  puts "Invalid usage."
+  puts "Try: #{usage.gsub(/^cdnjs/, File.basename($0))}"
+  exit
+end
+
+def get_package(id)
+  Package[id] or begin
+    tip "Package not found."
+    tip "For a list of all packages, see: cdnjs list"
+    exit
+  end
+end
+
+def show_help
+  tip "Usage:"
+  tip "  cdnjs NAME       - Download specific package"
+  tip ""
+  tip "Other commands:"
+  tip "  cdnjs list       - List available packages"
+  tip "  cdnjs info NAME  - Show package info"
+  tip "  cdnjs html NAME  - Show HTML snippet to include given package"
+  tip "  cdnjs url NAME   - Show the URL for the given package"
+  tip "  cdnjs update     - Updates the package cache"
+  tip ""
+  tip "You may also use the first letters of each command; e.g., `cdnjs i jquery`."
+  tip "Here are some common examples:"
+  tip ""
+  tip "  $ cdnjs jquery"
+  tip "  $ echo `cdnjs h underscore` >> index.html"
+  tip ""
+end
+
+# ============================================================================
+# Le controller
+
+if __FILE__ == $0
+  case ARGV
+  when Params['-h', '--help']
+    show_help
+
+  when Params['-v', '--version']
+    puts "cdnjs-command #{CDNJS_VERSION}"
+
+  when Params['list', 'l']
+    Package.all.each { |pkg|
+      puts "%-20s %s" % [ pkg.name + " (" + pkg.version + ")", ""]
+    }
+
+  when Params['html', 'h']
+    name = ARGV.shift  or invalid_usage("cdnjs html NAME")
+    pkg  = get_package(name)
+
+    puts "<script src='#{pkg.url}'></script>"
+
+  when Params['url', 'u']
+    puts pkg.url
+
+  when Params['info', 'i']
+    name = ARGV.shift  or invalid_usage("cdnjs info NAME")
+    pkg  = get_package(name)
+
+    puts "%s (%s)" % [ pkg.name, pkg.version ]
+    puts ""
+    puts "%-10s %s" % [ "URL:", pkg.url ]
+    puts "%-10s %s" % [ "Homepage:", pkg.homepage ]
+    puts ""
+    puts pkg.description
+    puts ""
+    puts "<!-- Include this library in your project with: -->"
+    puts "<script src='#{pkg.url}'></script>"
+
+    if pkg.url =~ /^https/
+      puts ""
+      puts "<!-- (You may need to replace 'https' with 'http'.) -->"
+    end
+
+
+    p pkg  if ARGV.delete('-v')
+
+  when Params['update']
+    Fetcher.purge
+    Package.all
+    tip "Done."
+
+  else
+    name = ARGV.shift  or (show_help; exit)
+    pkg  = Package[name] or begin
+      if ARGV.empty?
+        puts "Invalid package name."
+      else
+        puts "Invalid usage."
+      end
+      puts "For a list of all packages: cdnjs list"
+      puts "For more help: cdnjs --help"
+      exit
+    end
+
+    data = Fetcher.fetch(pkg.url)
+    File.open(pkg.basename, 'w') { |f| f.write data }
+
+    tip "Created #{pkg.basename}."
+  end
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification 
+name: cdnjs-command
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Rico Sta. Cruz
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-27 00:00:00 +08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+description: This package lets you download the popular JavaScript packages with one command, thanks to www.cdnjs.com.
+email: 
+- rico@sinefunc.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- bin/cdnjs
+- README.md
+has_rdoc: true
+homepage: http://github.com/rstacruz/cdnjs-command
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.5.0
+signing_key: 
+specification_version: 3
+summary: Command line helper for cdnjs.com.
+test_files: []
+