Class: Launchy::Browser

Inherits:
Application show all
Defined in:
lib/launchy/browser.rb

Constant Summary collapse

DESKTOP_ENVIRONMENT_BROWSER_LAUNCHERS = 
{
    :kde     => "kfmclient",
    :gnome   => "gnome-open",
    :xfce    => "exo-open",
    :generic => "htmlview"
}
FALLBACK_BROWSERS = 
%w[ firefox seamonkey opera mozilla netscape galeon ]

Constants inherited from Application

Application::KNOWN_OS_FAMILIES

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Application

#app_list, application_classes, #cygwin_app_list, #darwin_app_list, find_application_class_for, find_executable, #find_executable, inherited, #my_os, my_os, my_os_family, #my_os_family, #nix_desktop_environment, #run, #windows_app_list

Constructor Details

#initialize ⇒ Browser

Returns a new instance of Browser.



32
33
34
 
# File 'lib/launchy/browser.rb', line 32

def initialize
    raise "Unable to find browser to launch for os family '#{my_os_family}'." unless browser
end

Class Method Details

.handle?(*args) ⇒ Boolean

return true if this class can handle the given parameter(s)

Returns:

  • (Boolean) 


22
23
24
25
26
27
28
29
 
# File 'lib/launchy/browser.rb', line 22

def handle?(*args)
    begin 
        uri = URI.parse(args[0])
        return [URI::HTTP, URI::HTTPS, URI::FTP].include?(uri.class)
    rescue Exception 
        return false
    end
end

.run(*args) ⇒ Object 



17
18
19
 
# File 'lib/launchy/browser.rb', line 17

def run(*args)
    Browser.new.visit(args[0]) 
end

Instance Method Details

#browser ⇒ Object

return the full command line path to the browser or nil



57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
 
# File 'lib/launchy/browser.rb', line 57

def browser
    if not @browser then
        if ENV['LAUNCHY_BROWSER'] and File.exists?(ENV['LAUNCHY_BROWSER']) then
            Launchy.log "Using LAUNCHY_BROWSER environment variable : #{ENV['LAUNCHY_BROWSER']}"
            @browser = ENV['LAUNCHY_BROWSER']
        elsif ENV['BROWSER'] and File.exists?(ENV['BROWSER']) then
            Launchy.log "Using BROWSER environment variable : #{ENV['BROWSER']}"
            @browser = ENV['BROWSER']
        elsif app_list.size > 0 then
            @browser = app_list.first
            Launchy.log "Using application list : #{@browser}"
        else
            $stderr.puts "Unable to launch. No Browser application found."
        end
    end
    return @browser
end

#nix_app_list ⇒ Object

Find a list of potential browser applications to run on *nix machines.

The order is:

1) What is in ENV['LAUNCHY_BROWSER'] or ENV['BROWSER']
2) xdg-open
3) desktop environment launcher program
4) a list of fallback browsers



42
43
44
45
46
47
48
49
50
51
52
53
54
 
# File 'lib/launchy/browser.rb', line 42

def nix_app_list
    if not @nix_app_list then
        browser_cmds = ['xdg-open']
        browser_cmds << DESKTOP_ENVIRONMENT_BROWSER_LAUNCHERS[nix_desktop_environment]
        browser_cmds << FALLBACK_BROWSERS
        browser_cmds.flatten!
        browser_cmds.delete_if { |b| b.nil? || (b.strip.size == 0) }
        Launchy.log "Initial *Nix Browser List: #{browser_cmds.join(', ')}"
        @nix_app_list = browser_cmds.collect { |bin| find_executable(bin) }.find_all { |x| not x.nil? }
        Launchy.log "Filtered *Nix Browser List: #{@nix_app_list.join(', ')}"
    end
    @nix_app_list
end

#visit(url) ⇒ Object

launch the browser at the appointed url



76
77
78
 
# File 'lib/launchy/browser.rb', line 76

def visit(url)
    run(browser,url)
end