rockt 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: fd1f6f157960196d011e4712742e5d831043a85d
+  data.tar.gz: 69d4875d087cb65a5262bdd226cd076c1d8780fa
+SHA512:
+  metadata.gz: 91717d8af6cc8bf6afdccf3e75f31af3706d108078ad0bd0ca34018f48fc939d74b88fab7eb28fd0a44a6b2f0a03f0b2522bb6ed9133b05176c1060756e229fc
+  data.tar.gz: 7bc161a4619720f1668d37713fe1745a25fa864d697ec6465a557c67964f4fe9e41a12fbf1a50ade116e4e5f30288a5e55955142936aff19a25bc28053d73ebb

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/

data/.rspec

@@ -0,0 +1 @@
+--color --fail-fast --format documentation

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - jruby-19mode
+  - rbx-19mode
+  - ruby-head
+  - jruby-head

data/CONTRIBUTING.md

@@ -0,0 +1 @@
+fork it, branch it, commit, push it, pull-request it

data/Gemfile

@@ -0,0 +1,5 @@
+# encoding: utf-8
+
+source 'http://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,26 @@
+PATH
+  remote: .
+  specs:
+    rockt (0.1.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.2.4)
+    rake (10.1.0)
+    rspec (2.14.0)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.0)
+    rspec-expectations (2.14.0)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  rake
+  rockt!
+  rspec

data/LICENSE.md

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Fuad Saud
+
+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,19 @@
+Rockt
+=====
+
+A stupid application launcher for Ruby.
+
+## Usage
+
+Just give it and URI, deadly simple:
+  ```Rockt.launch('http://github.com') ```
+
+This is going to open the system default web browser at "http://github.com"
+
+## BEWARE: tested on OSX 10.8 only; (may not work in other OS's)
+
+## TODO
+
+- JRuby support
+- Handle popular desktop environments (KDE, Gnome, Xfce, etc.)
+- Test it on Windows/Cygwin

data/Rakefile

@@ -0,0 +1,21 @@
+# encoding: utf-8
+
+require 'rake'
+require 'rspec/core/rake_task'
+
+task default: [:spec, :rubocop]
+
+RSpec::Core::RakeTask.new
+
+desc 'Run RuboCop static analyzer'
+task :rubocop do
+  system 'bin/rubocop lib/ spec/ Gemfile Rakefile *.gemspec'
+end
+
+desc 'Start an irb session with cape-cod loaded'
+task :console do
+  # Do we have pry available?
+  repl = system('pry -v &> /dev/null') ? 'pry' : 'irb'
+
+  system "#{repl} --require ./lib/cape-cod.rb"
+end

data/bin/autospec

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'autospec' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('rspec-core', 'autospec')

data/bin/htmldiff

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'htmldiff' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('diff-lcs', 'htmldiff')

data/bin/ldiff

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'ldiff' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('diff-lcs', 'ldiff')

data/bin/rake

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'rake' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('rake', 'rake')

data/bin/rspec

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'rspec' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('rspec-core', 'rspec')

data/lib/rockt.rb

@@ -0,0 +1,65 @@
+# encoding: utf-8
+
+require 'English'
+
+#
+# Main Rockt API.
+#
+# It defines only on public method: launch.
+#
+module Rockt
+  # Raised when the launcher helper fails.
+  ApplicationLauncherFailed = Class.new(Exception)
+
+  # Raised when no launcher helper is found.
+  ApplicationLauncherNotFound = Class.new(Exception)
+
+  require 'rockt/version'
+  require 'rockt/environment'
+
+  #
+  # This is the method for launching applications.
+  #
+  # Valid options are:
+  # - dry_run: doesn't launch the application.
+  #
+  def self.launch(uri, options = {})
+    command = detect_environment.commands.find { |cmd| which cmd } or
+      fail ApplicationLauncherNotFound
+
+    unless options[:dry_run]
+      _spawn command, uri
+
+      fail ApplicationLauncherError unless $CHILD_STATUS.success?
+    end
+
+    command
+  end
+
+  #
+  # Returns the module representing the current environment.
+  #
+  def self.detect_environment
+    Environment.detect
+  end
+
+  private
+
+  def self._spawn(command, *params)
+    Process.wait spawn(command, *uri)
+  end
+
+  #
+  # Locate an executable file in the path
+  #
+  def self.which(cmd)
+    exts = ENV['PATHEXT'] ? ENV['PATHEXT'].split(';') : ['']
+
+    ENV['PATH'].split(File::PATH_SEPARATOR).each do |path|
+      exts.each do |ext|
+        exe = File.join(path, "#{cmd}#{ext}")
+        exe if File.executable? exe
+      end
+    end
+  end
+end

data/lib/rockt/environment.rb

@@ -0,0 +1,47 @@
+# encoding: utf-8
+
+module Rockt
+  #
+  # This modules is responsible for detecting the current underlying
+  # environment.
+  #
+  # It is meant to be extended by any module that represents an
+  # environment; these must implement a _regex_ method, which should match the
+  # environment name returned by the _host_os_ property from RbConfig, and a
+  # _commands_ method, which returns a list of the commands that could be ran
+  # to launch the application.
+  #
+  module Environment
+    # Raised when cannot recognize the environment.
+    UnknownEnvironment = Class.new(Exception)
+
+    # List containing all modules extending Rockt::Environment.
+    KNOWN_ENVIRONMENTS = []
+
+    # Keep tack of defined environments.
+    def self.extended(env)
+      KNOWN_ENVIRONMENTS << env
+
+      env_name = "#{env.to_s.split('::').last}?"
+
+      # Define a #{environment_name}? method for each of the known.
+      # environments.
+      self.singleton_class.send(:define_method, env_name.downcase.to_sym) do
+        detect == env
+      end
+    end
+
+    # Detect current environment.
+    def self.detect
+      host_os = RbConfig::CONFIG['host_os']
+
+      KNOWN_ENVIRONMENTS.find { |env| env.regex =~ host_os } or
+        fail UnknownEnvironment
+    end
+  end
+end
+
+# Require bundled environemnts.
+Dir[File.join(File.dirname(__FILE__), 'environment', '*.rb')].each do |env|
+  require env
+end

data/lib/rockt/environment/cygwin.rb

@@ -0,0 +1,19 @@
+# encoding: utf-8
+
+module Rockt
+  module Environment
+
+    # Represents Cygwin enironments
+    module Cygwin
+      extend Rockt::Environment
+
+      def self.commands
+        ['cmd /C start /b']
+      end
+
+      def self.regex
+        /cygwin/i
+      end
+    end
+  end
+end

data/lib/rockt/environment/darwin.rb

@@ -0,0 +1,19 @@
+# encoding: utf-8
+
+module Rockt
+  module Environment
+
+    # Represents Darwin and Apple OS X environments.
+    module Darwin
+      extend Rockt::Environment
+
+      def self.commands
+        %w( open )
+      end
+
+      def self.regex
+        /(darwin|mac os)/i
+      end
+    end
+  end
+end

data/lib/rockt/environment/unix.rb

@@ -0,0 +1,20 @@
+# encoding: utf-8
+
+module Rockt
+  module Environment
+
+    # Represents general Unix environments - Linux, BSD, Solaris.
+    # It basically depends on X's xdg-open.
+    module Unix
+      extend Rockt::Environment
+
+      def self.commands
+        %w( xdg-open )
+      end
+
+      def self.regex
+        /(linux|bsd|aix|solaris)/i
+      end
+    end
+  end
+end

data/lib/rockt/environment/windows.rb

@@ -0,0 +1,19 @@
+# encoding: utf-8
+
+module Rockt
+  module Environment
+
+    # Represents Microsoft Windows NT environments.
+    module Windows
+      extend Rockt::Environment
+
+      def self.open
+        ['start']
+      end
+
+      def self.regex
+        /(mingw|mswin|windows)/i
+      end
+    end
+  end
+end

data/lib/rockt/version.rb

@@ -0,0 +1,5 @@
+# encoding: utf-8
+
+module Rockt
+  VERSION = '0.1.0'
+end

data/rockt.gemspec

@@ -0,0 +1,27 @@
+# encoding: utf-8
+
+$LOAD_PATH.unshift File.expand_path('../lib', __FILE__)
+
+require 'rockt/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'rockt'
+  s.version     = Rockt::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.author      = 'Fuad Saud'
+  s.email       = 'fuadksd@gmail.com'
+  s.homepage    = 'http://github.com/fuadsaud/rockt'
+
+  s.summary     = 'Stupid application launcher for ruby'
+  s.license     = 'MIT'
+  s.description = 'Rockt helps you to launch the right application to handle' +
+                  'some file or webpage.'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {spec}/*`.split("\n")
+  s.require_paths = %w( lib )
+
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'rake'
+end
+

data/spec/rockt/environment_spec.rb

@@ -0,0 +1,9 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Rockt::Environment do
+  it 'should know at least one environment' do
+    expect(Rockt::Environment::KNOWN_ENVIRONMENTS).not_to be_empty
+  end
+end

data/spec/rockt_spec.rb

@@ -0,0 +1,26 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Rockt do
+  it 'has a version' do
+    expect(Rockt::VERSION).to be_a String
+  end
+
+  describe '.launch' do
+    let(:uri) { 'http://github.com/fuadsaud' }
+
+    it 'returns one of the commands for the current environment' do
+      command = Rockt.launch(uri, dry_run: true)
+
+      expect(Rockt.detect_environment.commands).to include(command)
+    end
+  end
+
+  describe '.detect_environment' do
+    it 'correctly detects the current environment' do
+      expect(
+        Rockt.detect_environment.regex).to match RbConfig::CONFIG['host_os']
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+# encoding: utf-8
+
+$LOAD_PATH << 'lib'
+
+require 'rspec'
+require 'rockt'

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification
+name: rockt
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Fuad Saud
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Rockt helps you to launch the right application to handlesome file or
+  webpage.
+email: fuadksd@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- CONTRIBUTING.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.md
+- README.md
+- Rakefile
+- bin/autospec
+- bin/htmldiff
+- bin/ldiff
+- bin/rake
+- bin/rspec
+- lib/rockt.rb
+- lib/rockt/environment.rb
+- lib/rockt/environment/cygwin.rb
+- lib/rockt/environment/darwin.rb
+- lib/rockt/environment/unix.rb
+- lib/rockt/environment/windows.rb
+- lib/rockt/version.rb
+- rockt.gemspec
+- spec/rockt/environment_spec.rb
+- spec/rockt_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/fuadsaud/rockt
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Stupid application launcher for ruby
+test_files: []
+has_rdoc: