RubyGems - camping-abingo - Versions diffs - 1.0.3 - Mend

camping-abingo 1.0.3

Files changed (143) hide show

data/doc/classes/Abingo.src/M000001.html ADDED

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>cache (Abingo)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/camping-abingo.rb, line 262</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">cache</span>
+    <span class="ruby-ivar">@@cache</span> <span class="ruby-operator">||</span> <span class="ruby-constant">ActiveSupport</span><span class="ruby-operator">::</span><span class="ruby-constant">Cache</span>.<span class="ruby-identifier">lookup_store</span>(<span class="ruby-identifier">:memory_store</span>) <span class="ruby-comment cmt"># Camping-specific change to explicitly request a cache store</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Abingo.src/M000002.html ADDED

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>identity= (Abingo)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/camping-abingo.rb, line 273</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">identity=</span>(<span class="ruby-identifier">new_identity</span>)
+    <span class="ruby-ivar">@@identity</span> = <span class="ruby-identifier">new_identity</span>.<span class="ruby-identifier">to_s</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Abingo.src/M000003.html ADDED

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>identity (Abingo)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/camping-abingo.rb, line 277</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">identity</span>
+    <span class="ruby-ivar">@@identity</span> <span class="ruby-operator">||=</span> <span class="ruby-identifier">rand</span>(<span class="ruby-value">10</span> <span class="ruby-operator">**</span> <span class="ruby-value">10</span>).<span class="ruby-identifier">to_i</span>.<span class="ruby-identifier">to_s</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Abingo.src/M000004.html ADDED

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>flip (Abingo)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/camping-abingo.rb, line 283</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">flip</span>(<span class="ruby-identifier">test_name</span>)
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
+      <span class="ruby-keyword kw">yield</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">test</span>(<span class="ruby-identifier">test_name</span>, [<span class="ruby-keyword kw">true</span>, <span class="ruby-keyword kw">false</span>]))
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">test</span>(<span class="ruby-identifier">test_name</span>, [<span class="ruby-keyword kw">true</span>, <span class="ruby-keyword kw">false</span>])
+    <span class="ruby-keyword kw">end</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Abingo.src/M000005.html ADDED

@@ -0,0 +1,69 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>test (Abingo)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/camping-abingo.rb, line 295</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">test</span>(<span class="ruby-identifier">test_name</span>, <span class="ruby-identifier">alternatives</span>, <span class="ruby-identifier">options</span> = {})
+        <span class="ruby-constant">ABingoCampingPlugin</span>.<span class="ruby-identifier">logger</span>.<span class="ruby-identifier">debug</span> <span class="ruby-node">&quot;test #{test_name} alternatives: #{alternatives.inspect} options:#{options.inspect} for #{Abingo.identity}&quot;</span>
+    <span class="ruby-identifier">short_circuit</span> = <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">read</span>(<span class="ruby-node">&quot;Abingo::Experiment::short_circuit(#{test_name})&quot;</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-value str">&quot; &quot;</span>, <span class="ruby-value str">&quot;_&quot;</span>))
+    <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">short_circuit</span>.<span class="ruby-identifier">nil?</span>
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">short_circuit</span>  <span class="ruby-comment cmt">#Test has been stopped, pick canonical alternative.</span>
+    <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">unless</span> <span class="ruby-constant">ABingoCampingPlugin</span><span class="ruby-operator">::</span><span class="ruby-constant">Models</span><span class="ruby-operator">::</span><span class="ruby-constant">Experiment</span>.<span class="ruby-identifier">exists?</span>(<span class="ruby-identifier">test_name</span>) <span class="ruby-comment cmt"># Camping-specific</span>
+      <span class="ruby-identifier">lock_key</span> = <span class="ruby-node">&quot;Abingo::lock_for_creation(#{test_name.gsub(&quot; &quot;, &quot;_&quot;)})&quot;</span>
+      <span class="ruby-identifier">creation_required</span> = <span class="ruby-keyword kw">true</span>
+      <span class="ruby-comment cmt">#this prevents (most) repeated creations of experiments in high concurrency environments.</span>
+      <span class="ruby-keyword kw">if</span> <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">exist?</span>(<span class="ruby-identifier">lock_key</span>)
+        <span class="ruby-identifier">creation_required</span> = <span class="ruby-keyword kw">false</span>
+        <span class="ruby-keyword kw">while</span> <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">exist?</span>(<span class="ruby-identifier">lock_key</span>)
+          <span class="ruby-identifier">sleep</span>(<span class="ruby-value">0</span><span class="ruby-value">.1</span>)
+        <span class="ruby-keyword kw">end</span>
+        <span class="ruby-identifier">creation_required</span> = <span class="ruby-constant">ABingoCampingPlugin</span><span class="ruby-operator">::</span><span class="ruby-constant">Models</span><span class="ruby-operator">::</span><span class="ruby-constant">Experiment</span>.<span class="ruby-identifier">exists?</span>(<span class="ruby-identifier">test_name</span>)  <span class="ruby-comment cmt"># Camping-specific</span>
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">creation_required</span>
+        <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">lock_key</span>, <span class="ruby-value">1</span>, <span class="ruby-identifier">:expires_in</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">5</span>.<span class="ruby-identifier">seconds</span>)
+        <span class="ruby-identifier">conversion_name</span> = <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:conversion</span>] <span class="ruby-operator">||</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:conversion_name</span>]
+        <span class="ruby-constant">ABingoCampingPlugin</span><span class="ruby-operator">::</span><span class="ruby-constant">Models</span><span class="ruby-operator">::</span><span class="ruby-constant">Experiment</span>.<span class="ruby-identifier">start_experiment!</span>(<span class="ruby-identifier">test_name</span>, <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">parse_alternatives</span>(<span class="ruby-identifier">alternatives</span>), <span class="ruby-identifier">conversion_name</span>) <span class="ruby-comment cmt"># Camping-specific</span>
+        <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">lock_key</span>)
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+    <span class="ruby-identifier">choice</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">find_alternative_for_user</span>(<span class="ruby-identifier">test_name</span>, <span class="ruby-identifier">alternatives</span>)
+    <span class="ruby-identifier">participating_tests</span> = <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">read</span>(<span class="ruby-node">&quot;Abingo::participating_tests::#{Abingo.identity}&quot;</span>) <span class="ruby-operator">||</span> []
+    <span class="ruby-comment cmt">#Set this user to participate in this experiment, and increment participants count.</span>
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:multiple_participation</span>] <span class="ruby-operator">||</span> <span class="ruby-operator">!</span>(<span class="ruby-identifier">participating_tests</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">test_name</span>))
+      <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">participating_tests</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">test_name</span>)
+        <span class="ruby-identifier">participating_tests</span> = <span class="ruby-identifier">participating_tests</span> <span class="ruby-operator">+</span> [<span class="ruby-identifier">test_name</span>]
+        <span class="ruby-identifier">expires_in</span> = <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">expires_in</span>
+        <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">expires_in</span>
+          <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">write</span>(<span class="ruby-node">&quot;Abingo::participating_tests::#{Abingo.identity}&quot;</span>, <span class="ruby-identifier">participating_tests</span>, {<span class="ruby-identifier">:expires_in</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">expires_in</span>})
+        <span class="ruby-keyword kw">else</span>
+          <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">write</span>(<span class="ruby-node">&quot;Abingo::participating_tests::#{Abingo.identity}&quot;</span>, <span class="ruby-identifier">participating_tests</span>)
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-comment cmt">#If we're only counting known humans, then postpone scoring participation until after we know the user is human.</span>
+      <span class="ruby-keyword kw">if</span> (<span class="ruby-operator">!</span><span class="ruby-ivar">@@options</span>[<span class="ruby-identifier">:count_humans_only</span>] <span class="ruby-operator">||</span> <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">is_human?</span>)
+        <span class="ruby-constant">ABingoCampingPlugin</span><span class="ruby-operator">::</span><span class="ruby-constant">Models</span><span class="ruby-operator">::</span><span class="ruby-constant">Alternative</span>.<span class="ruby-identifier">score_participation</span>(<span class="ruby-identifier">test_name</span>) <span class="ruby-comment cmt"># Camping-specific</span>
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
+      <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">choice</span>)
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-identifier">choice</span>
+    <span class="ruby-keyword kw">end</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Abingo.src/M000006.html ADDED

@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>bingo! (Abingo)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/camping-abingo.rb, line 361</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">bingo!</span>(<span class="ruby-identifier">name</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">options</span> = {})
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">name</span>.<span class="ruby-identifier">kind_of?</span> <span class="ruby-constant">Array</span>
+      <span class="ruby-identifier">name</span>.<span class="ruby-identifier">map</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">single_test</span><span class="ruby-operator">|</span>
+        <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">bingo!</span>(<span class="ruby-identifier">single_test</span>, <span class="ruby-identifier">options</span>)
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">name</span>.<span class="ruby-identifier">nil?</span>
+        <span class="ruby-comment cmt">#Score all participating tests</span>
+        <span class="ruby-identifier">participating_tests</span> = <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">read</span>(<span class="ruby-node">&quot;Abingo::participating_tests::#{Abingo.identity}&quot;</span>) <span class="ruby-operator">||</span> []
+        <span class="ruby-identifier">participating_tests</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">participating_test</span><span class="ruby-operator">|</span>
+          <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">bingo!</span>(<span class="ruby-identifier">participating_test</span>, <span class="ruby-identifier">options</span>)
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">else</span> <span class="ruby-comment cmt">#Could be a test name or conversion name.</span>
+        <span class="ruby-identifier">conversion_name</span> = <span class="ruby-identifier">name</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-value str">&quot; &quot;</span>, <span class="ruby-value str">&quot;_&quot;</span>)
+        <span class="ruby-identifier">tests_listening_to_conversion</span> = <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">read</span>(<span class="ruby-node">&quot;Abingo::tests_listening_to_conversion#{conversion_name}&quot;</span>)
+        <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">tests_listening_to_conversion</span>
+          <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">tests_listening_to_conversion</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">1</span>
+            <span class="ruby-identifier">tests_listening_to_conversion</span>.<span class="ruby-identifier">map</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">individual_test</span><span class="ruby-operator">|</span>
+              <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">score_conversion!</span>(<span class="ruby-identifier">individual_test</span>.<span class="ruby-identifier">to_s</span>)
+            <span class="ruby-keyword kw">end</span>
+          <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">tests_listening_to_conversion</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">==</span> <span class="ruby-value">1</span>
+            <span class="ruby-identifier">test_name_str</span> = <span class="ruby-identifier">tests_listening_to_conversion</span>.<span class="ruby-identifier">first</span>.<span class="ruby-identifier">to_s</span>
+            <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">score_conversion!</span>(<span class="ruby-identifier">test_name_str</span>)
+          <span class="ruby-keyword kw">end</span>
+        <span class="ruby-keyword kw">else</span>
+          <span class="ruby-comment cmt">#No tests listening for this conversion.  Assume it is just a test name.</span>
+          <span class="ruby-identifier">test_name_str</span> = <span class="ruby-identifier">name</span>.<span class="ruby-identifier">to_s</span>
+          <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">score_conversion!</span>(<span class="ruby-identifier">test_name_str</span>)
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Abingo.src/M000007.html ADDED

@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>participating_tests (Abingo)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/camping-abingo.rb, line 394</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">participating_tests</span>(<span class="ruby-identifier">only_current</span> = <span class="ruby-keyword kw">true</span>)
+    <span class="ruby-identifier">identity</span> = <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">identity</span>
+    <span class="ruby-identifier">participating_tests</span> = <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">read</span>(<span class="ruby-node">&quot;Abingo::participating_tests::#{identity}&quot;</span>) <span class="ruby-operator">||</span> []
+    <span class="ruby-identifier">tests_and_alternatives</span> = <span class="ruby-identifier">participating_tests</span>.<span class="ruby-identifier">inject</span>({}) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">acc</span>, <span class="ruby-identifier">test_name</span><span class="ruby-operator">|</span>
+      <span class="ruby-identifier">alternatives_key</span> = <span class="ruby-node">&quot;Abingo::Experiment::#{test_name}::alternatives&quot;</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-value str">&quot; &quot;</span>,<span class="ruby-value str">&quot;_&quot;</span>)
+      <span class="ruby-identifier">alternatives</span> = <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">alternatives_key</span>)
+      <span class="ruby-identifier">acc</span>[<span class="ruby-identifier">test_name</span>] = <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">find_alternative_for_user</span>(<span class="ruby-identifier">test_name</span>, <span class="ruby-identifier">alternatives</span>)
+      <span class="ruby-identifier">acc</span>
+    <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">only_current</span>)
+      <span class="ruby-identifier">tests_and_alternatives</span>.<span class="ruby-identifier">reject!</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
+        <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">read</span>(<span class="ruby-node">&quot;Abingo::Experiment::short_circuit(#{key})&quot;</span>)
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+    <span class="ruby-identifier">tests_and_alternatives</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Abingo.src/M000008.html ADDED

@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>human! (Abingo)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/camping-abingo.rb, line 412</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">human!</span>
+    <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">fetch</span>(<span class="ruby-node">&quot;Abingo::is_human(#{Abingo.identity})&quot;</span>,  {<span class="ruby-identifier">:expires_in</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">expires_in</span>(<span class="ruby-keyword kw">true</span>)}) <span class="ruby-keyword kw">do</span>
+      <span class="ruby-comment cmt">#Now that we know the user is human, score participation for all their tests.  (Further participation will *not* be lazy evaluated.)</span>
+      <span class="ruby-comment cmt">#Score all tests which have been deferred.</span>
+      <span class="ruby-identifier">participating_tests</span> = <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">read</span>(<span class="ruby-node">&quot;Abingo::participating_tests::#{Abingo.identity}&quot;</span>) <span class="ruby-operator">||</span> []
+      <span class="ruby-comment cmt">#Refresh cache expiry for this user to match that of known humans.</span>
+      <span class="ruby-keyword kw">if</span> (<span class="ruby-ivar">@@options</span>[<span class="ruby-identifier">:expires_in_for_bots</span>] <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span><span class="ruby-identifier">participating_tests</span>.<span class="ruby-identifier">blank?</span>)
+        <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">write</span>(<span class="ruby-node">&quot;Abingo::participating_tests::#{Abingo.identity}&quot;</span>, <span class="ruby-identifier">participating_tests</span>, {<span class="ruby-identifier">:expires_in</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">expires_in</span>(<span class="ruby-keyword kw">true</span>)})
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-identifier">participating_tests</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">test_name</span><span class="ruby-operator">|</span>
+        <span class="ruby-constant">Alternative</span>.<span class="ruby-identifier">score_participation</span>(<span class="ruby-identifier">test_name</span>)
+        <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">conversions</span> = <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">read</span>(<span class="ruby-node">&quot;Abingo::conversions(#{Abingo.identity},#{test_name}&quot;</span>)
+          <span class="ruby-identifier">conversions</span>.<span class="ruby-identifier">times</span> { <span class="ruby-constant">Alternative</span>.<span class="ruby-identifier">score_conversion</span>(<span class="ruby-identifier">test_name</span>) }
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">true</span> <span class="ruby-comment cmt">#Marks this user as human in the cache.</span>
+    <span class="ruby-keyword kw">end</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Abingo.src/M000009.html ADDED

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>is_human? (Abingo)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/camping-abingo.rb, line 436</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">is_human?</span>
+    <span class="ruby-operator">!</span><span class="ruby-operator">!</span><span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">read</span>(<span class="ruby-node">&quot;Abingo::is_human(#{Abingo.identity})&quot;</span>)
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Abingo.src/M000010.html ADDED

@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>parse_alternatives (Abingo)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/camping-abingo.rb, line 452</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">parse_alternatives</span>(<span class="ruby-identifier">alternatives</span>)
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">alternatives</span>.<span class="ruby-identifier">kind_of?</span> <span class="ruby-constant">Array</span>
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">alternatives</span>
+    <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">alternatives</span>.<span class="ruby-identifier">kind_of?</span> <span class="ruby-constant">Integer</span>
+      <span class="ruby-keyword kw">return</span> (<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-identifier">alternatives</span>).<span class="ruby-identifier">to_a</span>
+    <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">alternatives</span>.<span class="ruby-identifier">kind_of?</span> <span class="ruby-constant">Range</span>
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">alternatives</span>.<span class="ruby-identifier">to_a</span>
+    <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">alternatives</span>.<span class="ruby-identifier">kind_of?</span> <span class="ruby-constant">Hash</span>
+      <span class="ruby-identifier">alternatives_array</span> = []
+      <span class="ruby-identifier">alternatives</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
+        <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">kind_of?</span> <span class="ruby-constant">Integer</span>
+          <span class="ruby-identifier">alternatives_array</span> <span class="ruby-operator">+=</span> [<span class="ruby-identifier">key</span>] <span class="ruby-operator">*</span> <span class="ruby-identifier">value</span>
+        <span class="ruby-keyword kw">else</span>
+          <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;You gave a hash with #{key} =&gt; #{value} as an element.  The value must be an integral weight.&quot;</span>
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">alternatives_array</span>
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;I don't know how to turn [#{alternatives}] into an array of alternatives.&quot;</span>
+    <span class="ruby-keyword kw">end</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Abingo.src/M000011.html ADDED

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>retrieve_alternatives (Abingo)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/camping-abingo.rb, line 474</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">retrieve_alternatives</span>(<span class="ruby-identifier">test_name</span>, <span class="ruby-identifier">alternatives</span>)
+    <span class="ruby-identifier">cache_key</span> = <span class="ruby-node">&quot;Abingo::Experiment::#{test_name}::alternatives&quot;</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-value str">&quot; &quot;</span>,<span class="ruby-value str">&quot;_&quot;</span>)
+    <span class="ruby-identifier">alternative_array</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">fetch</span>(<span class="ruby-identifier">cache_key</span>) <span class="ruby-keyword kw">do</span>
+      <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">parse_alternatives</span>(<span class="ruby-identifier">alternatives</span>)
+    <span class="ruby-keyword kw">end</span>
+    <span class="ruby-identifier">alternative_array</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Abingo.src/M000012.html ADDED

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>find_alternative_for_user (Abingo)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/camping-abingo.rb, line 482</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">find_alternative_for_user</span>(<span class="ruby-identifier">test_name</span>, <span class="ruby-identifier">alternatives</span>)
+    <span class="ruby-identifier">alternatives_array</span> = <span class="ruby-identifier">retrieve_alternatives</span>(<span class="ruby-identifier">test_name</span>, <span class="ruby-identifier">alternatives</span>)
+    <span class="ruby-identifier">selected_alternative</span> = <span class="ruby-identifier">alternatives_array</span>[<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">modulo_choice</span>(<span class="ruby-identifier">test_name</span>, <span class="ruby-identifier">alternatives_array</span>.<span class="ruby-identifier">size</span>)]
+        <span class="ruby-constant">ABingoCampingPlugin</span>.<span class="ruby-identifier">logger</span>.<span class="ruby-identifier">debug</span> <span class="ruby-node">&quot;find_alternative_for_user(#{test_name}, #{alternatives}, #{self.identity}) &gt; #{selected_alternative}&quot;</span>
+        <span class="ruby-identifier">selected_alternative</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Abingo.src/M000013.html ADDED

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>modulo_choice (Abingo)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/camping-abingo.rb, line 492</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">modulo_choice</span>(<span class="ruby-identifier">test_name</span>, <span class="ruby-identifier">choices_count</span>)
+    <span class="ruby-constant">Digest</span><span class="ruby-operator">::</span><span class="ruby-constant">MD5</span>.<span class="ruby-identifier">hexdigest</span>(<span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">salt</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">test_name</span> <span class="ruby-operator">+</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">identity</span>.<span class="ruby-identifier">to_s</span>).<span class="ruby-identifier">to_i</span>(<span class="ruby-value">16</span>) <span class="ruby-operator">%</span> <span class="ruby-identifier">choices_count</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Abingo.src/M000014.html ADDED

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>score_conversion! (Abingo)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/camping-abingo.rb, line 496</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">score_conversion!</span>(<span class="ruby-identifier">test_name</span>)
+    <span class="ruby-identifier">test_name</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-value str">&quot; &quot;</span>, <span class="ruby-value str">&quot;_&quot;</span>)
+    <span class="ruby-identifier">participating_tests</span> = <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">read</span>(<span class="ruby-node">&quot;Abingo::participating_tests::#{Abingo.identity}&quot;</span>) <span class="ruby-operator">||</span> []
+        <span class="ruby-constant">ABingoCampingPlugin</span>.<span class="ruby-identifier">logger</span>.<span class="ruby-identifier">debug</span> <span class="ruby-node">&quot;score_conversion (#{test_name}) participating_tests=#{participating_tests.inspect} flag=#{participating_tests.include?(test_name)} options=#{options.inspect}&quot;</span>
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:assume_participation</span>] <span class="ruby-operator">||</span> <span class="ruby-identifier">participating_tests</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">test_name</span>)
+      <span class="ruby-identifier">cache_key</span> = <span class="ruby-node">&quot;Abingo::conversions(#{Abingo.identity},#{test_name}&quot;</span>
+          <span class="ruby-constant">ABingoCampingPlugin</span>.<span class="ruby-identifier">logger</span>.<span class="ruby-identifier">debug</span> <span class="ruby-node">&quot;score_conversion cache_key=#{cache_key}&quot;</span>
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:multiple_conversions</span>] <span class="ruby-operator">||</span> <span class="ruby-operator">!</span><span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">cache_key</span>)
+            <span class="ruby-constant">ABingoCampingPlugin</span>.<span class="ruby-identifier">logger</span>.<span class="ruby-identifier">debug</span> <span class="ruby-node">&quot;score_conversion is human=#{!options[:count_humans_only] || Abingo.is_human?}&quot;</span>
+        <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">options</span>[<span class="ruby-identifier">:count_humans_only</span>] <span class="ruby-operator">||</span> <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">is_human?</span>
+          <span class="ruby-constant">ABingoCampingPlugin</span><span class="ruby-operator">::</span><span class="ruby-constant">Models</span><span class="ruby-operator">::</span><span class="ruby-constant">Alternative</span>.<span class="ruby-identifier">score_conversion</span>(<span class="ruby-identifier">test_name</span>) <span class="ruby-comment cmt"># Camping-specific</span>
+        <span class="ruby-keyword kw">end</span>
+        <span class="ruby-keyword kw">if</span> <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">exist?</span>(<span class="ruby-identifier">cache_key</span>)
+                  <span class="ruby-constant">ABingoCampingPlugin</span>.<span class="ruby-identifier">logger</span>.<span class="ruby-identifier">debug</span> <span class="ruby-node">&quot;score_conversion increment #{cache_key}&quot;</span>
+          <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">increment</span>(<span class="ruby-identifier">cache_key</span>)
+        <span class="ruby-keyword kw">else</span>
+                  <span class="ruby-constant">ABingoCampingPlugin</span>.<span class="ruby-identifier">logger</span>.<span class="ruby-identifier">debug</span> <span class="ruby-node">&quot;score_conversion write #{cache_key}&quot;</span>
+          <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">cache</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">cache_key</span>, <span class="ruby-value">1</span>)
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Abingo.src/M000015.html ADDED

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>expires_in (Abingo)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/camping-abingo.rb, line 521</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">expires_in</span>(<span class="ruby-identifier">known_human</span> = <span class="ruby-keyword kw">false</span>)
+    <span class="ruby-identifier">expires_in</span> = <span class="ruby-keyword kw">nil</span>
+    <span class="ruby-keyword kw">if</span> (<span class="ruby-ivar">@@options</span>[<span class="ruby-identifier">:expires_in</span>])
+      <span class="ruby-identifier">expires_in</span> = <span class="ruby-ivar">@@options</span>[<span class="ruby-identifier">:expires_in</span>]
+    <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">if</span> (<span class="ruby-ivar">@@options</span>[<span class="ruby-identifier">:count_humans_only</span>] <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-ivar">@@options</span>[<span class="ruby-identifier">:expires_in_for_bots</span>] <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span>(<span class="ruby-identifier">known_human</span> <span class="ruby-operator">||</span> <span class="ruby-constant">Abingo</span>.<span class="ruby-identifier">is_human?</span>))
+      <span class="ruby-identifier">expires_in</span> = <span class="ruby-ivar">@@options</span>[<span class="ruby-identifier">:expires_in_for_bots</span>]
+    <span class="ruby-keyword kw">end</span>
+    <span class="ruby-identifier">expires_in</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>