RubyGems - mail_autoconfig - Versions diffs - 0.0.1 - Mend

mail_autoconfig 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

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);