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

camping-abingo 1.0.3

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 (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>