samuelkadolph/ruby-pac

pac is a gem to parse proxy auto-config files.

pac

pac is a gem to parse proxy auto-config files. pac uses a JavaScript runtime to evaulate a proxy auto-config file the same way a browser does to determine what proxy (if any at all) should a program use to connect to a server. You must install on of the supported JavaScript runtimes: therubyracer, therubyrhino, johnson or mustang.

Big thanks to sstephenson's execjs for the runtime wrapper code.

Installing

Recommended

gem install pac

Edge

git clone https://github.com/samuelkadolph/ruby-pac
cd ruby-pac && rake install

Requirements

After installing the pac gem you must install a JavaScript runtime. Compatible runtimes include:

• therubyracer Google V8 embedded within Ruby
• therubyrhino Mozilla Rhino embedded within JRuby
• johnson Mozilla SpiderMonkey embedded within Ruby 1.8
• mustang Mustang V8 embedded within Ruby

Usage

Command Line

parsepac http://cloud.github.com/downloads/samuelkadolph/ruby-pac/sample.pac https://github.com
parsepac http://cloud.github.com/downloads/samuelkadolph/ruby-pac/sample.pac http://ruby-lang.com
parsepac http://cloud.github.com/downloads/samuelkadolph/ruby-pac/sample.pac http://samuel.kadolph.com

Ruby

require "rubygems"
require "pac"

pac = PAC.load("http://cloud.github.com/downloads/samuelkadolph/ruby-pac/sample.pac")
pac.find("https://github.com") # => "PROXY proxy:8080"
pac.find("http://ruby-lang.com") # => "PROXY proxy:8080; DIRECT"
pac.find("http://samuel.kadolph.com") # => "DIRECT"

pac = PAC.read("sample.pac")

pac = PAC.source <<-JS
  function FindProxyForURL(url, host) {
    return "DIRECT";
  }
JS
pac.find("http://localhost") # => "DIRECT"

Available JavaScript Functions

• isPlainHostName(host)
• dnsDomainIs(host, domain)
• localHostOrDomainIs(host, hostdom)
• isResolvable(host)
• isInNet(host, pattern, mask)
• dnsResolve(host)
• myIpAddress()
• dnsDomainLevels(host)
• shExpMatch(str, shexp)
• weekdayRange(wd1, wd2, gmt)
• dateRange(*args)
• timeRange(*args)

Developers

Contributing

If you want to contribute: fork, branch & pull request.

Running Tests

bundle install
rake test
rake test:rubyracer