ana 0.9.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: cd8798e8dc1b5f9cafcd02c3c90d65271d432460
+  data.tar.gz: a9f1e9fd4335b522314822e09b6c3f518085ad82
+SHA512:
+  metadata.gz: 359d326b8bf0b9651cb5b28dafbeb5632e136243196b2bcf11fe9f69448d2d29a385f2718a671b4475cae1fe0e30379eb2252dd941941d8d5e700601be3ab3c8
+  data.tar.gz: 34d4741eadf16b74748feeeb2b1ee989fee1f0a643d4e92bb40e0443dea28a0eee9c2968e5795ff8687e1630ac8e1c34f8f36db9d88fb00aa1398b6115660cd3

data/.gitignore

@@ -0,0 +1,19 @@
+.ruby-version
+.ruby-gemset
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Juanito Fatas
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,139 @@
+# Ana
+
+Ana knows a lot of things about RubyGems.
+
+Yet another Ruby wrapper for the [RubyGems.org][1] API.
+
+## Installation
+
+    $ gem install ana
+
+## Usage
+
+Type `ana` to get some help:
+
+    $ ana
+
+Type `ana help COMMANDS` to get help for specific command:
+
+    $ ana help version
+
+### Available commands of Ana
+
+#### List infomation of Given Gem
+
+```
+$ ana info rails
+Ruby on Rails is a full-stack web framework optimized for programmer happiness and sustainable productivity. It encourages beautiful code by favoring convention over configuration.
+Has been downloaded for 29911559 times!
+The Latest version is 4.0.1.
+Respectful Author(s): David Heinemeier Hansson.
+LICENSE under MIT
+```
+
+#### List Runtime or Development Dependencies of Given Gem
+
+```bash
+$ ana deps rails runtime
+actionmailer         = 4.0.1
+actionpack           = 4.0.1
+activerecord         = 4.0.1
+activesupport        = 4.0.1
+bundler              < 2.0, >= 1.3.0
+railties             = 4.0.1
+sprockets-rails      ~> 2.0.0
+```
+
+#### Get latest version of a Given Gem
+
+```bash
+$ ana lv rails
+Latest version is 4.0.1.
+```
+
+
+#### Get latest version of a Given Gem
+
+```bash
+ana vs rails
+Last 10 versions of rails are...
+2013-11-01 : 4.0.1
+2013-10-30 : 4.0.1.rc4
+2013-10-23 : 4.0.1.rc3
+2013-10-21 : 4.0.1.rc2
+2013-10-17 : 4.0.1.rc1
+2013-10-16 : 3.2.15
+2013-10-11 : 3.2.15.rc3
+2013-10-04 : 3.2.15.rc2
+2013-10-03 : 3.2.15.rc1
+2013-07-22 : 3.2.14
+```
+
+#### Find specific version of a given gem
+
+```bash
+$ ana fv rails 4.1
+This version could not be found.
+```
+
+#### (Exact) Search of a given gem name
+
+```bash
+$ ana s rails
+Latest version is 4.0.1.
+```
+
+#### (Fuzzy) Search of a given gem name
+
+```bash
+$ ana fs rails
+
+*** REMOTE GEMS ***
+...
+zurui-sass-rails (0.0.4)
+```
+
+Via `gem search -r`.
+
+#### Open a Gem's URI page
+
+Available URI: Project Page, Homepage, Wiki, Documentation, Mailing List,
+               Source Code, Bug Tracker.
+
+```bash
+$ ana o rails doc
+will open the documentation of rails in your default browser.
+```
+
+via [launchy][2] gem.
+
+#### Download a Gem
+
+Available URI: Project Page, Homepage, Wiki, Documentation, Mailing List,
+               Source Code, Bug Tracker.
+
+```bash
+$ ana dl rails
+will open the browser and download rails gem.
+```
+
+## Requirements
+
+Ruby >= 2.0
+
+## TODO
+
+* Add tests.
+* Download via wget/curl.
+* Download gem and its runtime dependencies in a zip/tar or in batch.
+
+## Contributing
+
+1. Fork it ( http://github.com/<my-github-username>/ana/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+[1]: https://rubygems.org/
+[2]: https://github.com/copiousfreetime/launchy

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+task default: :test
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.pattern = "test/**/*_test.rb"
+end

data/ana.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'ana/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'ana'
+  spec.version       = Ana::VERSION::STRING
+  spec.authors       = ['Juanito Fatas']
+  spec.email         = ['katehuang0320@gmail.com']
+  spec.summary       = %q{Ana knows a lot about RubyGems.}
+  spec.description   = %q{Yet another RubyGems.org API wrapper in Ruby.}
+  spec.homepage      = 'https://github.com/JuanitoFatas/Ana'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.required_ruby_version = '>= 2.0.0'
+
+  spec.add_dependency 'thor',    '~> 0.18.1'
+  spec.add_dependency 'launchy', '~> 2.4.2'
+
+  spec.add_development_dependency 'bundler', '>= 1.4'
+  spec.add_development_dependency 'rake',    '>= 10.1.0'
+end

data/bin/ana

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+
+require __dir__ + "/../lib/ana"
+Ana::Command.start

data/lib/ana.rb

@@ -0,0 +1,7 @@
+require_relative "ana/version"
+require_relative "ana/core_ext"
+require_relative "ana/constants"
+require_relative "ana/command"
+
+module Ana
+end

data/lib/ana/command.rb

@@ -0,0 +1,214 @@
+require 'thor'
+require 'net/http'
+require 'json'
+require 'launchy'
+
+module Ana
+  class Command < Thor
+    include Ana::Scalars
+    include Thor::Actions
+
+    # Command Mapping
+    map '-v'        => :version
+    map '--version' => :version
+    # Meta
+    map 'info'      => :gem_infos
+    map 'deps'      => :gem_dependencies
+    # Version
+    map 'lv'        => :latest_version
+    map 'vs'        => :versions
+    map 'fv'        => :find_version
+    # Search
+    map 's'         => :search
+    map 'fs'        => :fuzzy_search
+    # Open URI
+    map 'o'         => :open
+    map 'dl'        => :download
+
+    # Create an empty diretory at ~/.gemjsons
+    # All later queried JSON files will be saved here.
+    desc 'init', 'Ana needs to setup some stuff in your home directory.'
+    def init
+      empty_directory full_path('~/.gemjsons')
+    end
+
+    desc 'version (-v, --version)', 'Display version of Ana.'
+    def version
+      say "#{Ana::VERSION::STRING}"
+    end
+
+    # Print Given Gem's Short description, download counts, latest version,
+    # author(s), and license information.
+    desc 'gem_infos (info)', 'Print Gem Informations'
+    def gem_infos(gem)
+      gem_hash = check_if_gem_exist_and_get_json!(gem, type: 'gems')
+      say gem_hash['info']
+      say "Has been downloaded for #{colorize(gem_hash['downloads'], RED)} times!"
+      say "The Latest version is #{colorize(gem_hash['version'], BLUE)}."
+      say "Respectful Author(s): #{colorize(gem_hash['authors'], YELLOW)}."
+      if gem_hash['licenses'][0].nil?
+        say "NO LICENSE :P"
+      else
+        say "LICENSE under #{colorize(gem_hash['licenses'][0], MAGENTA)}"
+      end
+    end
+
+    # List dependencies of a given Gem.
+    # You could pass 'runtime' / 'development' to see different dependencies.
+    # type: 'runtime', 'development'
+    desc 'gem_dependencies (deps)', 'Print Gem Dependencies (runtime / development).'
+    def gem_dependencies(gem, type='runtime')
+      gem_hash = check_if_gem_exist_and_get_json!(gem, type: 'gems')
+      gem_hash['dependencies'][type].each do |arr|
+        puts "#{arr['name'].ljust(20)} #{arr['requirements']}"
+      end
+    end
+
+    # Return latest version of given gem.
+    desc 'latest_version (v)', 'latest version of a gem.'
+    def latest_version(gem)
+      gem_hash = check_if_gem_exist_and_get_json!(gem, type: 'gems')
+      say("Latest version is #{gem_hash['version']}.", :blue)
+    end
+
+    # List versions of a given Gem, default will only list last 10 versions.
+    # You can pass all or a fairly large number to display all versions.
+    desc 'versions (vs)', 'List versions of a gem.'
+    def versions(gem, count=10)
+      gem_hash = check_if_gem_exist_and_get_json!(gem, type: 'versions')
+      if count == 'all' || count.to_i > gem_hash.count
+        count = gem_hash.count
+      end
+      say("Last #{count} versions of #{gem} are...")
+      [*0..count-1].each do |n|
+        say("#{gem_hash[n]['built_at'][0..9]} : #{gem_hash[n]['number']}")
+      end
+    end
+
+    # Find if a given version of Gem exists.
+    desc 'version exist?', 'Find if a given version exists.'
+    def find_version(gem, ver)
+      gem_hash = check_if_gem_exist_and_get_json!(gem, type: 'versions')
+      versions = gem_hash.collect { |x| x['number'] }
+      if versions.include? ver
+        gem_infos gem
+      else
+        print_gem_version_not_found!
+      end
+    end
+
+    # Search if a given Gem exists? If exists, return the latest version of it.
+    desc 'search (s)', '(Exact) Search for a gem.'
+    def search(gem)
+      latest_version(gem) if gem_exist?(gem)
+    end
+
+    # Invoke system `gem search -r`
+    desc 'fuzzy_search (fs)', 'Fuzzy search for a Gem'
+    def fuzzy_search(gem)
+      system("gem search -r #{Shellwords.escape gem}")
+    end
+
+    # Open the URIs of a given Gem.
+    # Available URI types could be found in Ana::Scalars::URI_TYPE.
+    desc 'open (o)', 'Open gem doc directly via open command.'
+    def open(gem, open_type='doc')
+      gem_hash = check_if_gem_exist_and_get_json!(gem, type: 'gems')
+      url = if URI_TYPE.keys.include? open_type
+              skip = false
+              gem_hash[URI_TYPE[open_type]]
+            else
+              say "#{open_type} is not a valid type :( \n"
+              print_valid_uri_open_types!
+              skip = true
+              gem_hash[URI_TYPE['doc']]
+            end
+      Launchy.open(url) if url.present? && skip == false
+    end
+
+    # Download a given Gem.
+    desc 'download (dl)', 'Download a Gem'
+    def download(gem)
+      open gem, 'lib'
+    end
+
+    private
+
+      # Add color to terminal text.
+      # Available colors could be found in Ana::Scalars.
+      # \033 is 100% POSIX compatible. Use \e is also fine.
+      def colorize(text, color_code)
+        "\033[#{color_code}m#{text}\033[0m"
+      end
+
+      # Print all valid URI types.
+      def print_valid_uri_open_types!
+        say "Available types are: "
+        URI_TYPE.keys.each do |key|
+          next if key == 'lib'
+          print "#{key} "
+        end
+        print "\n"
+      end
+
+      # Check if a Gem exists, if exists load the json and return.
+      # The real load will execute every TTL (900) seconds.
+      # type: 'versions', 'gems'
+      # @return [Hash]
+      def check_if_gem_exist_and_get_json!(gem, type: 'versions')
+        if gem_exist?(gem)
+          gem_uri = URI("https://rubygems.org/api/v1/#{type}/#{gem}.json")
+          gem_json_file_path = full_path("~/.gemjsons/#{gem}/#{type}.json")
+          unless File.exist?(gem_json_file_path) && fresh?(gem_json_file_path)
+            remove_and_create_file!(gem_json_file_path, Net::HTTP.get(gem_uri))
+          end
+        else
+          print_gem_not_found!
+        end
+        return JSON.parse(IO.read(gem_json_file_path))
+      end
+
+      # Check if a given gem exists?
+      def gem_exist?(gem)
+        uri = URI "https://rubygems.org/api/v1/gems/#{gem}.json"
+        return false if GEM_NOT_FOUND == Net::HTTP.get(uri)
+        return true
+      end
+
+      # Print Gem version not found message.
+      def print_gem_version_not_found!
+        say(GEM_VER_NOT_FOUND, :red)
+      end
+
+      # Print Gem not found message.
+      def print_gem_not_found!
+        say(GEM_NOT_FOUND, :red)
+      end
+
+      # Remove and create (update) a file.
+      def remove_and_create_file!(file_path, data)
+        if File.exist? file_path
+          remove_file(file_path, verbose: false)
+          create_file(file_path, data, verbose: false)
+          say_status(:update, file_path)
+        else
+          create_file(file_path, data)
+        end
+      end
+
+      # Expand the full path of given relative path.
+      def full_path(relative_path)
+        File.expand_path(relative_path)
+      end
+
+      # Check if a file is has been changed within 900s?
+      def fresh?(file_path)
+        access_time(file_path) < TTL
+      end
+
+      # Return a file's change time with respect to current time.
+      def access_time(file_path)
+        Time.now - File.ctime(file_path)
+      end
+  end
+end

data/lib/ana/constants.rb

@@ -0,0 +1,24 @@
+module Ana
+  module Scalars
+    TTL = 900 # Every 900s updates the json.
+    GEM_NOT_FOUND     = 'This rubygem could not be found.'
+    GEM_VER_NOT_FOUND = 'This version could not be found.'
+
+    # Terminal Colour Codes
+    # http://en.wikipedia.org/wiki/ANSI_escape_code
+    BLACK, RED, GREEN, YELLOW, BLUE, MAGENTA, CYAN, WHITE = [*30..37]
+
+    # $ curl https://rubygems.org/api/v1/gems/rails.json
+    # uris of above json
+    URI_TYPE = {
+      'proj' =>  'project_uri',
+      'lib'  =>  'gem_uri',
+      'home' =>  'homepage_uri',
+      'wiki' =>  'wiki_uri',
+      'doc'  =>  'documentation_uri',
+      'mail' =>  'mailing_list_uri',
+      'src'  =>  'source_code_uri',
+      'bug'  =>  'bug_tracker_uri',
+    }
+  end
+end

data/lib/ana/core_ext.rb

@@ -0,0 +1,15 @@
+class String
+  def present?
+    !blank?
+  end
+
+  # A string is blank if it's empty or contains whitespaces only:
+  #
+  #   ''.blank?                 # => true
+  #   '   '.blank?              # => true
+  #   '　'.blank?               # => true
+  #   ' something here '.blank? # => false
+  def blank?
+    self =~ /\A[[:space:]]*\z/
+  end
+end

data/lib/ana/version.rb

@@ -0,0 +1,10 @@
+module Ana
+  module VERSION
+    MAJOR = 0
+    MINOR = 9
+    TINY  = 0
+    PRE   = nil
+
+    STRING = [MAJOR, MINOR, TINY, PRE].compact.join(".")
+  end
+end

data/test/ana/ana_test.rb

@@ -0,0 +1,5 @@
+require 'test_helper'
+
+class AnaTest < Minitest::Unit::TestCase
+
+end

data/test/test_helper.rb

@@ -0,0 +1,5 @@
+require 'bundler/setup'
+Bundler.require(:default)
+require 'minitest/autorun'
+require 'minitest/pride'
+require_relative '../lib/ana'

metadata

@@ -0,0 +1,117 @@
+--- !ruby/object:Gem::Specification
+name: ana
+version: !ruby/object:Gem::Version
+  version: 0.9.0
+platform: ruby
+authors:
+- Juanito Fatas
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-12-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.18.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.18.1
+- !ruby/object:Gem::Dependency
+  name: launchy
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.4.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.4.2
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 10.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 10.1.0
+description: Yet another RubyGems.org API wrapper in Ruby.
+email:
+- katehuang0320@gmail.com
+executables:
+- ana
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- ana.gemspec
+- bin/ana
+- lib/ana.rb
+- lib/ana/command.rb
+- lib/ana/constants.rb
+- lib/ana/core_ext.rb
+- lib/ana/version.rb
+- test/ana/ana_test.rb
+- test/test_helper.rb
+homepage: https://github.com/JuanitoFatas/Ana
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: 2.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.1.11
+signing_key: 
+specification_version: 4
+summary: Ana knows a lot about RubyGems.
+test_files:
+- test/ana/ana_test.rb
+- test/test_helper.rb