RubyGems - mail_autoconfig - Versions diffs - 0.0.1 - Mend

mail_autoconfig 0.0.1

Files changed (254) hide show

data/.yardopts +1 -0
data/Gemfile +4 -0
data/Gemfile.lock +39 -0
data/LICENSE.txt +25 -0
data/README.md +57 -0
data/Rakefile +11 -0
data/doc/MailAutoconfig/ClientConfig.html +1353 -0
data/doc/MailAutoconfig/EmailAddress.html +572 -0
data/doc/MailAutoconfig/IncomingServer.html +154 -0
data/doc/MailAutoconfig/OutgoingServer.html +154 -0
data/doc/MailAutoconfig/Server.html +807 -0
data/doc/MailAutoconfig.html +424 -0
data/doc/_index.html +185 -0
data/doc/class_list.html +54 -0
data/doc/css/common.css +1 -0
data/doc/css/full_list.css +57 -0
data/doc/css/style.css +339 -0
data/doc/file.README.html +135 -0
data/doc/file_list.html +56 -0
data/doc/frames.html +26 -0
data/doc/index.html +135 -0
data/doc/js/app.js +219 -0
data/doc/js/full_list.js +178 -0
data/doc/js/jquery.js +4 -0
data/doc/method_list.html +227 -0
data/doc/top-level-namespace.html +112 -0
data/ispdb_data/1und1.de +65 -0
data/ispdb_data/abc.plala.or.jp +24 -0
data/ispdb_data/agate.plala.or.jp +24 -0
data/ispdb_data/alice.it +30 -0
data/ispdb_data/amail.plala.or.jp +24 -0
data/ispdb_data/amber.plala.or.jp +24 -0
data/ispdb_data/aol.com +45 -0
data/ispdb_data/apost.plala.or.jp +24 -0
data/ispdb_data/aqua.plala.or.jp +24 -0
data/ispdb_data/arcor.de +57 -0
data/ispdb_data/arubapec.it +34 -0
data/ispdb_data/att.net +34 -0
data/ispdb_data/ballade.plala.or.jp +24 -0
data/ispdb_data/bay.wind.ne.jp +28 -0
data/ispdb_data/bb-niigata.jp +22 -0
data/ispdb_data/beige.plala.or.jp +24 -0
data/ispdb_data/biglobe.ne.jp +23 -0
data/ispdb_data/bigpond.com +28 -0
data/ispdb_data/blue.plala.or.jp +24 -0
data/ispdb_data/bluemail.ch +31 -0
data/ispdb_data/bluewin.ch +30 -0
data/ispdb_data/bmail.plala.or.jp +24 -0
data/ispdb_data/bol.com.br +40 -0
data/ispdb_data/bolero.plala.or.jp +24 -0
data/ispdb_data/bpost.plala.or.jp +24 -0
data/ispdb_data/broba.cc +25 -0
data/ispdb_data/brown.plala.or.jp +24 -0
data/ispdb_data/camel.plala.or.jp +24 -0
data/ispdb_data/cameo.plala.or.jp +24 -0
data/ispdb_data/cc9.ne.jp +21 -0
data/ispdb_data/cek.ne.jp +21 -0
data/ispdb_data/cgl.ucsf.edu +22 -0
data/ispdb_data/charter.com +52 -0
data/ispdb_data/clio.ne.jp +22 -0
data/ispdb_data/cmail.plala.or.jp +24 -0
data/ispdb_data/co1.wind.ne.jp +25 -0
data/ispdb_data/co2.wind.ne.jp +25 -0
data/ispdb_data/co3.wind.ne.jp +25 -0
data/ispdb_data/cocoa.plala.or.jp +24 -0
data/ispdb_data/coda.plala.or.jp +24 -0
data/ispdb_data/comcast.net +57 -0
data/ispdb_data/concerto.plala.or.jp +24 -0
data/ispdb_data/coral.plala.or.jp +24 -0
data/ispdb_data/courante.plala.or.jp +24 -0
data/ispdb_data/cox.net +36 -0
data/ispdb_data/cpost.plala.or.jp +24 -0
data/ispdb_data/cream.plala.or.jp +24 -0
data/ispdb_data/dan.wind.ne.jp +28 -0
data/ispdb_data/dance.plala.or.jp +24 -0
data/ispdb_data/dd.iij4u.or.jp +33 -0
data/ispdb_data/df.eu +33 -0
data/ispdb_data/dmail.plala.or.jp +24 -0
data/ispdb_data/earthlink.net +35 -0
data/ispdb_data/ebony.plala.or.jp +24 -0
data/ispdb_data/email.it +33 -0
data/ispdb_data/email.plala.or.jp +24 -0
data/ispdb_data/ewetel.de +23 -0
data/ispdb_data/fantasy.plala.or.jp +24 -0
data/ispdb_data/flamenco.plala.or.jp +24 -0
data/ispdb_data/fmail.plala.or.jp +24 -0
data/ispdb_data/francetelecom.fr +31 -0
data/ispdb_data/free.fr +62 -0
data/ispdb_data/freenet.de +56 -0
data/ispdb_data/fuga.plala.or.jp +24 -0
data/ispdb_data/gandi.net +58 -0
data/ispdb_data/gmail.plala.or.jp +24 -0
data/ispdb_data/gmx.com +72 -0
data/ispdb_data/gmx.net +66 -0
data/ispdb_data/go.tvm.ne.jp +22 -0
data/ispdb_data/goneo.de +56 -0
data/ispdb_data/goo.jp +22 -0
data/ispdb_data/googlemail.com +52 -0
data/ispdb_data/grape.plala.or.jp +24 -0
data/ispdb_data/gray.plala.or.jp +24 -0
data/ispdb_data/hal.ne.jp +22 -0
data/ispdb_data/hana.or.jp +22 -0
data/ispdb_data/hotmail.com +58 -0
data/ispdb_data/i.softbank.jp +22 -0
data/ispdb_data/ic-net.or.jp +22 -0
data/ispdb_data/iijmio-mail.jp +26 -0
data/ispdb_data/iiyama-catv.ne.jp +21 -0
data/ispdb_data/imail.plala.or.jp +24 -0
data/ispdb_data/inbox.lt +26 -0
data/ispdb_data/inbox.lv +26 -0
data/ispdb_data/indigo.plala.or.jp +24 -0
data/ispdb_data/inet-shibata.or.jp +22 -0
data/ispdb_data/internode.on.net +32 -0
data/ispdb_data/ipax.at +28 -0
data/ispdb_data/ivory.plala.or.jp +24 -0
data/ispdb_data/iwafune.ne.jp +22 -0
data/ispdb_data/jade.plala.or.jp +24 -0
data/ispdb_data/janis.or.jp +23 -0
data/ispdb_data/jet.ne.jp +29 -0
data/ispdb_data/ji.jet.ne.jp +22 -0
data/ispdb_data/jmail.plala.or.jp +24 -0
data/ispdb_data/kabelmail.de +31 -0
data/ispdb_data/kelcom.net +21 -0
data/ispdb_data/khaki.plala.or.jp +24 -0
data/ispdb_data/kl.wind.ne.jp +32 -0
data/ispdb_data/kmail.plala.or.jp +24 -0
data/ispdb_data/kokuyou.ne.jp +21 -0
data/ispdb_data/lapis.plala.or.jp +24 -0
data/ispdb_data/laposte.net +37 -0
data/ispdb_data/lemon.plala.or.jp +24 -0
data/ispdb_data/libero.it +34 -0
data/ispdb_data/lilac.plala.or.jp +24 -0
data/ispdb_data/lime.plala.or.jp +24 -0
data/ispdb_data/mahoroba.ne.jp +22 -0
data/ispdb_data/mail.com +248 -0
data/ispdb_data/mail.dk +22 -0
data/ispdb_data/mail.iwafune.ne.jp +22 -0
data/ispdb_data/mail.ru +57 -0
data/ispdb_data/mail.telenor.dk +121 -0
data/ispdb_data/mail.wind.ne.jp +29 -0
data/ispdb_data/maroon.plala.or.jp +24 -0
data/ispdb_data/me.com +31 -0
data/ispdb_data/minuet.plala.or.jp +24 -0
data/ispdb_data/ml.murakami.ne.jp +22 -0
data/ispdb_data/mnet.ne.jp +22 -0
data/ispdb_data/mopera.net +50 -0
data/ispdb_data/mozilla.com +23 -0
data/ispdb_data/mx1.tiki.ne.jp +54 -0
data/ispdb_data/navy.plala.or.jp +24 -0
data/ispdb_data/nifty.com +22 -0
data/ispdb_data/nsat.jp +22 -0
data/ispdb_data/o2.pl +35 -0
data/ispdb_data/olive.plala.or.jp +24 -0
data/ispdb_data/onet.pl +38 -0
data/ispdb_data/opal.plala.or.jp +24 -0
data/ispdb_data/orange.plala.or.jp +24 -0
data/ispdb_data/orchid.plala.or.jp +24 -0
data/ispdb_data/ovh.net +32 -0
data/ispdb_data/pal.kijimadaira.jp +21 -0
data/ispdb_data/palette.plala.or.jp +24 -0
data/ispdb_data/parabox.or.jp +22 -0
data/ispdb_data/pdx.edu +41 -0
data/ispdb_data/peach.plala.or.jp +24 -0
data/ispdb_data/peoplepc.com +29 -0
data/ispdb_data/plum.plala.or.jp +24 -0
data/ispdb_data/po.dcn.ne.jp +21 -0
data/ispdb_data/po.wind.ne.jp +28 -0
data/ispdb_data/pobox.com +53 -0
data/ispdb_data/polka.plala.or.jp +24 -0
data/ispdb_data/pop.shibata.ne.jp +23 -0
data/ispdb_data/posteo.de +25 -0
data/ispdb_data/purple.plala.or.jp +24 -0
data/ispdb_data/rainbow.plala.or.jp +24 -0
data/ispdb_data/rambler.ru +35 -0
data/ispdb_data/red.plala.or.jp +24 -0
data/ispdb_data/rmail.plala.or.jp +24 -0
data/ispdb_data/rondo.plala.or.jp +24 -0
data/ispdb_data/rose.plala.or.jp +24 -0
data/ispdb_data/rouge.plala.or.jp +24 -0
data/ispdb_data/rr.com +25 -0
data/ispdb_data/ruby.plala.or.jp +24 -0
data/ispdb_data/sakunet.ne.jp +21 -0
data/ispdb_data/sea.plala.or.jp +24 -0
data/ispdb_data/sepia.plala.or.jp +24 -0
data/ispdb_data/serenade.plala.or.jp +24 -0
data/ispdb_data/seznam.cz +26 -0
data/ispdb_data/sfr.fr +36 -0
data/ispdb_data/silk.plala.or.jp +24 -0
data/ispdb_data/silver.plala.or.jp +24 -0
data/ispdb_data/sky.plala.or.jp +24 -0
data/ispdb_data/skynet.be +35 -0
data/ispdb_data/smail.plala.or.jp +24 -0
data/ispdb_data/snow.plala.or.jp +24 -0
data/ispdb_data/so.wind.ne.jp +25 -0
data/ispdb_data/sonata.plala.or.jp +24 -0
data/ispdb_data/strato.de +43 -0
data/ispdb_data/studenti.univr.it +22 -0
data/ispdb_data/suite.plala.or.jp +24 -0
data/ispdb_data/sympatico.ca +30 -0
data/ispdb_data/symphony.plala.or.jp +24 -0
data/ispdb_data/t-online.de +37 -0
data/ispdb_data/taupe.plala.or.jp +24 -0
data/ispdb_data/terra.es +29 -0
data/ispdb_data/tiki.ne.jp +24 -0
data/ispdb_data/tiscali.cz +25 -0
data/ispdb_data/tiscali.it +31 -0
data/ispdb_data/tmail.plala.or.jp +24 -0
data/ispdb_data/toccata.plala.or.jp +24 -0
data/ispdb_data/topaz.plala.or.jp +24 -0
data/ispdb_data/trio.plala.or.jp +24 -0
data/ispdb_data/umail.plala.or.jp +24 -0
data/ispdb_data/umich.edu +22 -0
data/ispdb_data/uol.com.br +42 -0
data/ispdb_data/upcmail.nl +23 -0
data/ispdb_data/verizon.net +21 -0
data/ispdb_data/versatel.de +43 -0
data/ispdb_data/violet.plala.or.jp +24 -0
data/ispdb_data/vm.aikis.or.jp +22 -0
data/ispdb_data/vmail.plala.or.jp +24 -0
data/ispdb_data/vp.tiki.ne.jp +24 -0
data/ispdb_data/waltz.plala.or.jp +24 -0
data/ispdb_data/wave.plala.or.jp +24 -0
data/ispdb_data/web.de +55 -0
data/ispdb_data/white.plala.or.jp +24 -0
data/ispdb_data/wildwestdomains.com +37 -0
data/ispdb_data/wine.plala.or.jp +24 -0
data/ispdb_data/wmail.plala.or.jp +24 -0
data/ispdb_data/wp.pl +22 -0
data/ispdb_data/xmail.plala.or.jp +24 -0
data/ispdb_data/xp.wind.jp +24 -0
data/ispdb_data/xpost.plala.or.jp +24 -0
data/ispdb_data/xs4all.nl +22 -0
data/ispdb_data/xtra.co.nz +22 -0
data/ispdb_data/yahoo.co.jp +22 -0
data/ispdb_data/yahoo.com +41 -0
data/ispdb_data/yandex.ru +39 -0
data/ispdb_data/ybb.ne.jp +22 -0
data/ispdb_data/yellow.plala.or.jp +24 -0
data/ispdb_data/ymail.plala.or.jp +24 -0
data/ispdb_data/ypost.plala.or.jp +24 -0
data/ispdb_data/ziggo.nl +25 -0
data/ispdb_data/zmail.plala.or.jp +24 -0
data/ispdb_data/zpost.plala.or.jp +24 -0
data/lib/mail_autoconfig/client_config.rb +118 -0
data/lib/mail_autoconfig/email_address.rb +53 -0
data/lib/mail_autoconfig/server.rb +73 -0
data/lib/mail_autoconfig/version.rb +4 -0
data/lib/mail_autoconfig.rb +35 -0
data/mail_autoconfig.gemspec +27 -0
data/spec/client_config_spec.rb +50 -0
data/spec/email_address_spec.rb +42 -0
data/spec/examples/client_config_yahoo.xml +40 -0
data/spec/server_spec.rb +84 -0
metadata +416 -0

data/doc/file.README.html ADDED Viewed

@@ -0,0 +1,135 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII" />
+<title>
+  File: README
+    &mdash; Documentation by YARD 0.8.7.4
+</title>
+  <link rel="stylesheet" href="css/style.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="css/common.css" type="text/css" charset="utf-8" />
+<script type="text/javascript" charset="utf-8">
+  hasFrames = window.top.frames.main ? true : false;
+  relpath = '';
+  framesUrl = "frames.html#!file.README.html";
+</script>
+  <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
+  <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
+  </head>
+  <body>
+    <div id="header">
+      <div id="menu">
+    <a href="_index.html">Index</a> &raquo;
+    <span class="title">File: README</span>
+  <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
+</div>
+      <div id="search">
+    <a class="full_list_link" id="class_list_link"
+        href="class_list.html">
+      Class List
+    </a>
+    <a class="full_list_link" id="method_list_link"
+        href="method_list.html">
+      Method List
+    </a>
+    <a class="full_list_link" id="file_list_link"
+        href="file_list.html">
+      File List
+    </a>
+</div>
+      <div class="clear"></div>
+    </div>
+    <iframe id="search_frame"></iframe>
+    <div id="content"><div id='filecontents'><h1>Mail Autoconfig</h1>
+<p>A ruby gem to detect and parse any Thunderbird autoconfig file for a domain. Includes a copy of the Mozilla ISPDB.</p>
+<p>For general information about autoconf visit (<a href="https://developer.mozilla.org/en-US/docs/Mozilla/Thunderbird/Autoconfiguration">https://developer.mozilla.org/en-US/docs/Mozilla/Thunderbird/Autoconfiguration</a>),
+for the autoconfig schema you should have a look at (<a href="https://wiki.mozilla.org/Thunderbird:Autoconfiguration:ConfigFileFormat">https://wiki.mozilla.org/Thunderbird:Autoconfiguration:ConfigFileFormat</a>).</p>
+<p>Although I&#39;ve tried to keep parsing as accurate as possible, there may be omissions or errors. Please feel free
+to submit a patch in these cases.</p>
+<h2>Installation</h2>
+<p>Add this line to your application&#39;s Gemfile:</p>
+<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_gem'>gem</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>mail_autoconfig</span><span class='tstring_end'>'</span></span>
+</code></pre>
+<p>And then execute:</p>
+<pre class="code ruby"><code class="ruby">$ bundle
+</code></pre>
+<p>Or install it yourself as:</p>
+<pre class="code ruby"><code class="ruby">$ gem install mail_autoconfig
+</code></pre>
+<h2>Usage</h2>
+<p>Generally, you just want to get any associated configuration for an email address. In this case we&#39;ll use
+&#39;<a href="mailto:example@gmail.com">example@gmail.com</a>&#39;.</p>
+<pre class="code ruby"><code class="ruby">client_config = MailAutoconfig::for_address('example@gmail.com')
+client_config.short_name
+=&gt; &quot;GMail&quot;
+outbound_server = client_config.outgoing_servers.first
+outbound_server.protocol
+=&gt; &quot;smtp&quot;
+outnound_server.hostname
+=&gt; &quot;smtp.googlemail.com&quot;
+</code></pre>
+<p>When searching for a configuration, autoconfig first looks to it&#39;s local database for the domain of the address,
+if this fails it will check <code>http://autoconfig.#{domain}/mail/config-v1.1.xml</code> and then
+<code>http://#{domain}/.well-known/autoconfig/mail/config-v1.1.xml</code>. If both of these fail, Autoconfig will then look up
+the MX records for the address, and perform the same searches on the domain of the primary MX record.</p>
+<h3>Updating the database</h3>
+<p>You may wish to update the database at some point to fetch the latest from Mozilla&#39;s ISPDB,
+just run the rake task <code>rake fetch_ispdb</code>.</p>
+<h2>Contributing</h2>
+<ol>
+<li>Fork it ( <a href="http://github.com/atech/mail_autoconfig/fork">http://github.com/atech/mail_autoconfig/fork</a> )</li>
+<li>Create your feature branch (<code>git checkout -b my-new-feature</code>)</li>
+<li>Run the test suite, check out haven&#39;t broken anything (<code>bundle exec rspec spec</code>)</li>
+<li>Commit your changes (<code>git commit -am &#39;Add some feature&#39;</code>)</li>
+<li>Push to the branch (<code>git push origin my-new-feature</code>)</li>
+<li>Create new Pull Request</li>
+</ol>
+</div></div>
+    <div id="footer">
+  Generated on Tue Apr 22 22:04:36 2014 by
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.8.7.4 (ruby-1.9.3).
+</div>
+  </body>
+</html>

data/doc/file_list.html ADDED Viewed

@@ -0,0 +1,56 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+      <link rel="stylesheet" href="css/full_list.css" type="text/css" media="screen" charset="utf-8" />
+      <link rel="stylesheet" href="css/common.css" type="text/css" media="screen" charset="utf-8" />
+      <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
+      <script type="text/javascript" charset="utf-8" src="js/full_list.js"></script>
+    <title>File List</title>
+    <base id="base_target" target="_parent" />
+  </head>
+  <body>
+    <script type="text/javascript" charset="utf-8">
+      if (window.top.frames.main) {
+        document.getElementById('base_target').target = 'main';
+        document.body.className = 'frames';
+      }
+    </script>
+    <div id="content">
+      <h1 id="full_list_header">File List</h1>
+      <div id="nav">
+          <span><a target="_self" href="class_list.html">
+            Classes
+          </a></span>
+          <span><a target="_self" href="method_list.html">
+            Methods
+          </a></span>
+          <span><a target="_self" href="file_list.html">
+            Files
+          </a></span>
+      </div>
+      <div id="search">Search: <input type="text" /></div>
+      <ul id="full_list" class="file">
+  <li class="r1"><span class="object_link"><a href="index.html" title="README">README</a></a></li>
+      </ul>
+    </div>
+  </body>
+</html>

data/doc/frames.html ADDED Viewed

@@ -0,0 +1,26 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN"
+	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+	<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+	<title>Documentation by YARD 0.8.7.4</title>
+</head>
+<script type="text/javascript" charset="utf-8">
+window.onload = function() {
+  var match = unescape(window.location.hash).match(/^#!(.+)/);
+  var name = match ? match[1] : 'index.html';
+  name = name.replace(/^(\w+):\/\//, '').replace(/^\/\//, '');
+  document.writeln('<frameset cols="20%,*">' +
+    '<frame name="list" src="class_list.html" />' +
+    '<frame name="main" src="' + escape(name) + '" />' +
+    '</frameset>');
+}
+</script>
+<noscript>
+  <frameset cols="20%,*">
+    <frame name="list" src="class_list.html" />
+    <frame name="main" src="index.html" />
+  </frameset>
+</noscript>
+</html>

data/doc/index.html ADDED Viewed

@@ -0,0 +1,135 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII" />
+<title>
+  File: README
+    &mdash; Documentation by YARD 0.8.7.4
+</title>
+  <link rel="stylesheet" href="css/style.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="css/common.css" type="text/css" charset="utf-8" />
+<script type="text/javascript" charset="utf-8">
+  hasFrames = window.top.frames.main ? true : false;
+  relpath = '';
+  framesUrl = "frames.html#!file.README.html";
+</script>
+  <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
+  <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
+  </head>
+  <body>
+    <div id="header">
+      <div id="menu">
+    <a href="_index.html">Index</a> &raquo;
+    <span class="title">File: README</span>
+  <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
+</div>
+      <div id="search">
+    <a class="full_list_link" id="class_list_link"
+        href="class_list.html">
+      Class List
+    </a>
+    <a class="full_list_link" id="method_list_link"
+        href="method_list.html">
+      Method List
+    </a>
+    <a class="full_list_link" id="file_list_link"
+        href="file_list.html">
+      File List
+    </a>
+</div>
+      <div class="clear"></div>
+    </div>
+    <iframe id="search_frame"></iframe>
+    <div id="content"><div id='filecontents'><h1>Mail Autoconfig</h1>
+<p>A ruby gem to detect and parse any Thunderbird autoconfig file for a domain. Includes a copy of the Mozilla ISPDB.</p>
+<p>For general information about autoconf visit (<a href="https://developer.mozilla.org/en-US/docs/Mozilla/Thunderbird/Autoconfiguration">https://developer.mozilla.org/en-US/docs/Mozilla/Thunderbird/Autoconfiguration</a>),
+for the autoconfig schema you should have a look at (<a href="https://wiki.mozilla.org/Thunderbird:Autoconfiguration:ConfigFileFormat">https://wiki.mozilla.org/Thunderbird:Autoconfiguration:ConfigFileFormat</a>).</p>
+<p>Although I&#39;ve tried to keep parsing as accurate as possible, there may be omissions or errors. Please feel free
+to submit a patch in these cases.</p>
+<h2>Installation</h2>
+<p>Add this line to your application&#39;s Gemfile:</p>
+<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_gem'>gem</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>mail_autoconfig</span><span class='tstring_end'>'</span></span>
+</code></pre>
+<p>And then execute:</p>
+<pre class="code ruby"><code class="ruby">$ bundle
+</code></pre>
+<p>Or install it yourself as:</p>
+<pre class="code ruby"><code class="ruby">$ gem install mail_autoconfig
+</code></pre>
+<h2>Usage</h2>
+<p>Generally, you just want to get any associated configuration for an email address. In this case we&#39;ll use
+&#39;<a href="mailto:example@gmail.com">example@gmail.com</a>&#39;.</p>
+<pre class="code ruby"><code class="ruby">client_config = MailAutoconfig::for_address('example@gmail.com')
+client_config.short_name
+=&gt; &quot;GMail&quot;
+outbound_server = client_config.outgoing_servers.first
+outbound_server.protocol
+=&gt; &quot;smtp&quot;
+outnound_server.hostname
+=&gt; &quot;smtp.googlemail.com&quot;
+</code></pre>
+<p>When searching for a configuration, autoconfig first looks to it&#39;s local database for the domain of the address,
+if this fails it will check <code>http://autoconfig.#{domain}/mail/config-v1.1.xml</code> and then
+<code>http://#{domain}/.well-known/autoconfig/mail/config-v1.1.xml</code>. If both of these fail, Autoconfig will then look up
+the MX records for the address, and perform the same searches on the domain of the primary MX record.</p>
+<h3>Updating the database</h3>
+<p>You may wish to update the database at some point to fetch the latest from Mozilla&#39;s ISPDB,
+just run the rake task <code>rake fetch_ispdb</code>.</p>
+<h2>Contributing</h2>
+<ol>
+<li>Fork it ( <a href="http://github.com/atech/mail_autoconfig/fork">http://github.com/atech/mail_autoconfig/fork</a> )</li>
+<li>Create your feature branch (<code>git checkout -b my-new-feature</code>)</li>
+<li>Run the test suite, check out haven&#39;t broken anything (<code>bundle exec rspec spec</code>)</li>
+<li>Commit your changes (<code>git commit -am &#39;Add some feature&#39;</code>)</li>
+<li>Push to the branch (<code>git push origin my-new-feature</code>)</li>
+<li>Create new Pull Request</li>
+</ol>
+</div></div>
+    <div id="footer">
+  Generated on Tue Apr 22 22:04:36 2014 by
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.8.7.4 (ruby-1.9.3).
+</div>
+  </body>
+</html>

data/doc/js/app.js ADDED Viewed

@@ -0,0 +1,219 @@
+function createSourceLinks() {
+    $('.method_details_list .source_code').
+        before("<span class='showSource'>[<a href='#' class='toggleSource'>View source</a>]</span>");
+    $('.toggleSource').toggle(function() {
+       $(this).parent().nextAll('.source_code').slideDown(100);
+       $(this).text("Hide source");
+    },
+    function() {
+        $(this).parent().nextAll('.source_code').slideUp(100);
+        $(this).text("View source");
+    });
+}
+function createDefineLinks() {
+    var tHeight = 0;
+    $('.defines').after(" <a href='#' class='toggleDefines'>more...</a>");
+    $('.toggleDefines').toggle(function() {
+        tHeight = $(this).parent().prev().height();
+        $(this).prev().show();
+        $(this).parent().prev().height($(this).parent().height());
+        $(this).text("(less)");
+    },
+    function() {
+        $(this).prev().hide();
+        $(this).parent().prev().height(tHeight);
+        $(this).text("more...");
+    });
+}
+function createFullTreeLinks() {
+    var tHeight = 0;
+    $('.inheritanceTree').toggle(function() {
+        tHeight = $(this).parent().prev().height();
+        $(this).parent().toggleClass('showAll');
+        $(this).text("(hide)");
+        $(this).parent().prev().height($(this).parent().height());
+    },
+    function() {
+        $(this).parent().toggleClass('showAll');
+        $(this).parent().prev().height(tHeight);
+        $(this).text("show all");
+    });
+}
+function fixBoxInfoHeights() {
+    $('dl.box dd.r1, dl.box dd.r2').each(function() {
+       $(this).prev().height($(this).height());
+    });
+}
+function searchFrameLinks() {
+  $('.full_list_link').click(function() {
+    toggleSearchFrame(this, $(this).attr('href'));
+    return false;
+  });
+}
+function toggleSearchFrame(id, link) {
+  var frame = $('#search_frame');
+  $('#search a').removeClass('active').addClass('inactive');
+  if (frame.attr('src') == link && frame.css('display') != "none") {
+    frame.slideUp(100);
+    $('#search a').removeClass('active inactive');
+  }
+  else {
+    $(id).addClass('active').removeClass('inactive');
+    frame.attr('src', link).slideDown(100);
+  }
+}
+function linkSummaries() {
+  $('.summary_signature').click(function() {
+    document.location = $(this).find('a').attr('href');
+  });
+}
+function framesInit() {
+  if (hasFrames) {
+    document.body.className = 'frames';
+    $('#menu .noframes a').attr('href', document.location);
+    try {
+      window.top.document.title = $('html head title').text();
+    } catch(error) {
+      // some browsers will not allow this when serving from file://
+      // but we don't want to stop the world.
+    }
+  }
+  else {
+    $('#menu .noframes a').text('frames').attr('href', framesUrl);
+  }
+}
+function keyboardShortcuts() {
+  if (window.top.frames.main) return;
+  $(document).keypress(function(evt) {
+    if (evt.altKey || evt.ctrlKey || evt.metaKey || evt.shiftKey) return;
+    if (typeof evt.target !== "undefined" &&
+        (evt.target.nodeName == "INPUT" ||
+        evt.target.nodeName == "TEXTAREA")) return;
+    switch (evt.charCode) {
+      case 67: case 99:  $('#class_list_link').click(); break;  // 'c'
+      case 77: case 109: $('#method_list_link').click(); break; // 'm'
+      case 70: case 102: $('#file_list_link').click(); break;   // 'f'
+      default: break;
+    }
+  });
+}
+function summaryToggle() {
+  $('.summary_toggle').click(function() {
+    if (localStorage) {
+      localStorage.summaryCollapsed = $(this).text();
+    }
+    $('.summary_toggle').each(function() {
+      $(this).text($(this).text() == "collapse" ? "expand" : "collapse");
+      var next = $(this).parent().parent().nextAll('ul.summary').first();
+      if (next.hasClass('compact')) {
+        next.toggle();
+        next.nextAll('ul.summary').first().toggle();
+      }
+      else if (next.hasClass('summary')) {
+        var list = $('<ul class="summary compact" />');
+        list.html(next.html());
+        list.find('.summary_desc, .note').remove();
+        list.find('a').each(function() {
+          $(this).html($(this).find('strong').html());
+          $(this).parent().html($(this)[0].outerHTML);
+        });
+        next.before(list);
+        next.toggle();
+      }
+    });
+    return false;
+  });
+  if (localStorage) {
+    if (localStorage.summaryCollapsed == "collapse") {
+      $('.summary_toggle').first().click();
+    }
+    else localStorage.summaryCollapsed = "expand";
+  }
+}
+function fixOutsideWorldLinks() {
+  $('a').each(function() {
+    if (window.location.host != this.host) this.target = '_parent';
+  });
+}
+function generateTOC() {
+  if ($('#filecontents').length === 0) return;
+  var _toc = $('<ol class="top"></ol>');
+  var show = false;
+  var toc = _toc;
+  var counter = 0;
+  var tags = ['h2', 'h3', 'h4', 'h5', 'h6'];
+  var i;
+  if ($('#filecontents h1').length > 1) tags.unshift('h1');
+  for (i = 0; i < tags.length; i++) { tags[i] = '#filecontents ' + tags[i]; }
+  var lastTag = parseInt(tags[0][1], 10);
+  $(tags.join(', ')).each(function() {
+    if ($(this).parents('.method_details .docstring').length != 0) return;
+    if (this.id == "filecontents") return;
+    show = true;
+    var thisTag = parseInt(this.tagName[1], 10);
+    if (this.id.length === 0) {
+      var proposedId = $(this).attr('toc-id');
+      if (typeof(proposedId) != "undefined") this.id = proposedId;
+      else {
+        var proposedId = $(this).text().replace(/[^a-z0-9-]/ig, '_');
+        if ($('#' + proposedId).length > 0) { proposedId += counter; counter++; }
+        this.id = proposedId;
+      }
+    }
+    if (thisTag > lastTag) {
+      for (i = 0; i < thisTag - lastTag; i++) {
+        var tmp = $('<ol/>'); toc.append(tmp); toc = tmp;
+      }
+    }
+    if (thisTag < lastTag) {
+      for (i = 0; i < lastTag - thisTag; i++) toc = toc.parent();
+    }
+    var title = $(this).attr('toc-title');
+    if (typeof(title) == "undefined") title = $(this).text();
+    toc.append('<li><a href="#' + this.id + '">' + title + '</a></li>');
+    lastTag = thisTag;
+  });
+  if (!show) return;
+  html = '<div id="toc"><p class="title"><a class="hide_toc" href="#"><strong>Table of Contents</strong></a> <small>(<a href="#" class="float_toc">left</a>)</small></p></div>';
+  $('#content').prepend(html);
+  $('#toc').append(_toc);
+  $('#toc .hide_toc').toggle(function() {
+    $('#toc .top').slideUp('fast');
+    $('#toc').toggleClass('hidden');
+    $('#toc .title small').toggle();
+  }, function() {
+    $('#toc .top').slideDown('fast');
+    $('#toc').toggleClass('hidden');
+    $('#toc .title small').toggle();
+  });
+  $('#toc .float_toc').toggle(function() {
+    $(this).text('float');
+    $('#toc').toggleClass('nofloat');
+  }, function() {
+    $(this).text('left');
+    $('#toc').toggleClass('nofloat');
+  });
+}
+$(framesInit);
+$(createSourceLinks);
+$(createDefineLinks);
+$(createFullTreeLinks);
+$(fixBoxInfoHeights);
+$(searchFrameLinks);
+$(linkSummaries);
+$(keyboardShortcuts);
+$(summaryToggle);
+$(fixOutsideWorldLinks);
+$(generateTOC);