RubyGems - lims-core - Versions diffs - 3.2.3 - Mend

lims-core 3.2.3

Files changed (177) hide show

checksums.yaml +15 -0
data/.gitignore +5 -0
data/.rspec +1 -0
data/.rvmrc +2 -0
data/.travis.yml +2 -0
data/.vimrc +27 -0
data/.yard_templates/default/layout/html/footer.erb +0 -0
data/.yardopts +1 -0
data/Gemfile +54 -0
data/Gemfile.lock +197 -0
data/Guardfile +21 -0
data/Guardfile.tmux +28 -0
data/README.markdown +67 -0
data/Rakefile +16 -0
data/config/database.yml +16 -0
data/doc/Array.html +116 -0
data/doc/Array/ArrayLoggerPersistor.html +152 -0
data/doc/Lims.html +114 -0
data/doc/Lims/Core.html +178 -0
data/doc/Lims/Core/Action.html +91 -0
data/doc/Lims/Core/Actions.html +116 -0
data/doc/Lims/Core/Actions/Action.html +216 -0
data/doc/Lims/Core/Actions/Action/AfterEval.html +853 -0
data/doc/Lims/Core/Actions/Action/InvalidParameters.html +268 -0
data/doc/Lims/Core/Actions/ActionGroup.html +196 -0
data/doc/Lims/Core/Actions/ActionGroup/AfterEval.html +315 -0
data/doc/Lims/Core/Actions/BulkAction.html +224 -0
data/doc/Lims/Core/Actions/BulkAction/AfterEval.html +253 -0
data/doc/Lims/Core/Actions/TestActionGroup.html +101 -0
data/doc/Lims/Core/Actions/TestActionGroup/Action.html +133 -0
data/doc/Lims/Core/Actions/TestActionGroup/ActionGroup.html +127 -0
data/doc/Lims/Core/Base.html +287 -0
data/doc/Lims/Core/Base/AccessibleViaSuper.html +252 -0
data/doc/Lims/Core/Base/ClassMethod.html +177 -0
data/doc/Lims/Core/Base/HashString.html +177 -0
data/doc/Lims/Core/Base/IsArrayOf.html +606 -0
data/doc/Lims/Core/Base/State.html +130 -0
data/doc/Lims/Core/Organization.html +113 -0
data/doc/Lims/Core/Organization/Batch.html +106 -0
data/doc/Lims/Core/Persistence.html +267 -0
data/doc/Lims/Core/Persistence/ComparisonFilter.html +318 -0
data/doc/Lims/Core/Persistence/Filter.html +252 -0
data/doc/Lims/Core/Persistence/IdentityMap.html +409 -0
data/doc/Lims/Core/Persistence/IdentityMap/Class.html +144 -0
data/doc/Lims/Core/Persistence/IdentityMap/DuplicateError.html +126 -0
data/doc/Lims/Core/Persistence/IdentityMap/DuplicateIdError.html +136 -0
data/doc/Lims/Core/Persistence/IdentityMap/DuplicateObjectError.html +136 -0
data/doc/Lims/Core/Persistence/IdentityMapClass.html +133 -0
data/doc/Lims/Core/Persistence/Logger.html +105 -0
data/doc/Lims/Core/Persistence/Logger/Persistor.html +334 -0
data/doc/Lims/Core/Persistence/Logger/Session.html +452 -0
data/doc/Lims/Core/Persistence/Logger/Store.html +470 -0
data/doc/Lims/Core/Persistence/MessageBus.html +871 -0
data/doc/Lims/Core/Persistence/MessageBus/ConnectionError.html +123 -0
data/doc/Lims/Core/Persistence/MessageBus/InvalidSettingsError.html +122 -0
data/doc/Lims/Core/Persistence/MultiCriteriaFilter.html +293 -0
data/doc/Lims/Core/Persistence/PersistAssociationTrait.html +91 -0
data/doc/Lims/Core/Persistence/PersistableTrait.html +91 -0
data/doc/Lims/Core/Persistence/Persistor.html +3072 -0
data/doc/Lims/Core/Persistence/Persistor/DuplicateError.html +205 -0
data/doc/Lims/Core/Persistence/Persistor/DuplicateIdError.html +147 -0
data/doc/Lims/Core/Persistence/Persistor/DuplicateObjectError.html +147 -0
data/doc/Lims/Core/Persistence/PersistorTrait.html +91 -0
data/doc/Lims/Core/Persistence/ResourceState.html +1738 -0
data/doc/Lims/Core/Persistence/Search.html +269 -0
data/doc/Lims/Core/Persistence/Search/CreateSearch.html +251 -0
data/doc/Lims/Core/Persistence/Search/SearchPersistor.html +240 -0
data/doc/Lims/Core/Persistence/Search/SearchSequelPersistor.html +396 -0
data/doc/Lims/Core/Persistence/Sequel.html +117 -0
data/doc/Lims/Core/Persistence/Sequel/Filters.html +462 -0
data/doc/Lims/Core/Persistence/Sequel/ForTest.html +101 -0
data/doc/Lims/Core/Persistence/Sequel/ForTest/Name.html +137 -0
data/doc/Lims/Core/Persistence/Sequel/ForTest/Name/NamePersitor.html +143 -0
data/doc/Lims/Core/Persistence/Sequel/Migrations.html +266 -0
data/doc/Lims/Core/Persistence/Sequel/Persistor.html +665 -0
data/doc/Lims/Core/Persistence/Sequel/Session.html +501 -0
data/doc/Lims/Core/Persistence/Sequel/Store.html +417 -0
data/doc/Lims/Core/Persistence/Session.html +2751 -0
data/doc/Lims/Core/Persistence/Session/UnmanagedObjectError.html +111 -0
data/doc/Lims/Core/Persistence/StateGroup.html +696 -0
data/doc/Lims/Core/Persistence/StateList.html +498 -0
data/doc/Lims/Core/Persistence/Store.html +695 -0
data/doc/Lims/Core/Persistence/UuidResource.html +1044 -0
data/doc/Lims/Core/Persistence/UuidResource/InvalidUuidError.html +111 -0
data/doc/Lims/Core/Persistence/UuidResource/UuidResourcePersistor.html +337 -0
data/doc/Lims/Core/Persistence/Uuidable.html +799 -0
data/doc/Lims/Core/Persistor.html +320 -0
data/doc/Lims/Core/Resource.html +165 -0
data/doc/Object.html +228 -0
data/doc/SessionSpec.html +101 -0
data/doc/SessionSpec/Model.html +279 -0
data/doc/SessionSpec/Model/ModelPersistor.html +327 -0
data/doc/_index.html +732 -0
data/doc/class_list.html +47 -0
data/doc/css/common.css +1 -0
data/doc/css/full_list.css +55 -0
data/doc/css/style.css +322 -0
data/doc/file.README.html +127 -0
data/doc/file_list.html +49 -0
data/doc/frames.html +13 -0
data/doc/index.html +127 -0
data/doc/js/app.js +205 -0
data/doc/js/full_list.js +167 -0
data/doc/js/jquery.js +16 -0
data/doc/method_list.html +1894 -0
data/doc/top-level-namespace.html +100 -0
data/lib/common.rb +18 -0
data/lib/lims-core.rb +29 -0
data/lib/lims-core/actions.rb +10 -0
data/lib/lims-core/actions/action.rb +185 -0
data/lib/lims-core/actions/action_group.rb +54 -0
data/lib/lims-core/actions/bulk_action.rb +65 -0
data/lib/lims-core/base.rb +132 -0
data/lib/lims-core/helpers.rb +41 -0
data/lib/lims-core/persistence.rb +15 -0
data/lib/lims-core/persistence/comparison_filter.rb +54 -0
data/lib/lims-core/persistence/filter.rb +23 -0
data/lib/lims-core/persistence/identity_map.rb +55 -0
data/lib/lims-core/persistence/logger/all.rb +5 -0
data/lib/lims-core/persistence/logger/persistor.rb +35 -0
data/lib/lims-core/persistence/logger/session.rb +30 -0
data/lib/lims-core/persistence/logger/store.rb +37 -0
data/lib/lims-core/persistence/message_bus.rb +131 -0
data/lib/lims-core/persistence/multi_criteria_filter.rb +50 -0
data/lib/lims-core/persistence/persist_association_trait.rb +96 -0
data/lib/lims-core/persistence/persistable_trait.rb +150 -0
data/lib/lims-core/persistence/persistor.rb +495 -0
data/lib/lims-core/persistence/resource_state.rb +157 -0
data/lib/lims-core/persistence/search.rb +3 -0
data/lib/lims-core/persistence/search/all.rb +3 -0
data/lib/lims-core/persistence/search/create_search.rb +55 -0
data/lib/lims-core/persistence/search/search_persistor.rb +45 -0
data/lib/lims-core/persistence/search/search_sequel_persistor.rb +40 -0
data/lib/lims-core/persistence/sequel.rb +14 -0
data/lib/lims-core/persistence/sequel/filters.rb +106 -0
data/lib/lims-core/persistence/sequel/migrations.rb +14 -0
data/lib/lims-core/persistence/sequel/migrations/add_audit_tables.rb +147 -0
data/lib/lims-core/persistence/sequel/migrations/initial.rb +156 -0
data/lib/lims-core/persistence/sequel/persistor.rb +200 -0
data/lib/lims-core/persistence/sequel/session.rb +136 -0
data/lib/lims-core/persistence/sequel/store.rb +37 -0
data/lib/lims-core/persistence/session.rb +409 -0
data/lib/lims-core/persistence/state_group.rb +97 -0
data/lib/lims-core/persistence/state_list.rb +56 -0
data/lib/lims-core/persistence/store.rb +73 -0
data/lib/lims-core/persistence/uuid_resource.rb +115 -0
data/lib/lims-core/persistence/uuid_resource_persistor.rb +43 -0
data/lib/lims-core/persistence/uuidable.rb +107 -0
data/lib/lims-core/resource.rb +21 -0
data/lib/lims-core/subclass_tracker.rb +30 -0
data/lib/lims-core/version.rb +5 -0
data/lims-core.gemspec +40 -0
data/makefile +52 -0
data/showoff/core-2012-06-11/core/01_slide.md +237 -0
data/showoff/core-2012-06-11/core/02_slide.md +110 -0
data/showoff/core-2012-06-11/custom.css +44 -0
data/showoff/core-2012-06-11/main/01_slide.md +53 -0
data/showoff/core-2012-06-11/showoff.json +10 -0
data/showoff/core-2012-06-11/tp1.tpl +1 -0
data/spec/actions/action_group_spec.rb +39 -0
data/spec/actions/spec_helper.rb +1 -0
data/spec/persistence/identity_map_spec.rb +55 -0
data/spec/persistence/logger/spec_helper.rb +7 -0
data/spec/persistence/logger/store_spec.rb +48 -0
data/spec/persistence/message_bus_spec.rb +76 -0
data/spec/persistence/sequel/session_spec.rb +125 -0
data/spec/persistence/sequel/spec_helper.rb +39 -0
data/spec/persistence/sequel/store_shared.rb +25 -0
data/spec/persistence/sequel/store_spec.rb +22 -0
data/spec/persistence/session_spec.rb +199 -0
data/spec/persistence/spec_helper.rb +2 -0
data/spec/persistence/uuid_resource_spec.rb +80 -0
data/spec/spec_helper.rb +10 -0
data/spec/subclass_tracker_sperc.rb +62 -0
data/utils/constant_tree.rb +29 -0
data/utils/stack.rb +48 -0
metadata +402 -0

data/doc/Lims/Core/Persistence/Store.html ADDED Viewed

@@ -0,0 +1,695 @@
+<!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=utf-8" />
+<title>
+  Class: Lims::Core::Persistence::Store
+    &mdash; Documentation by YARD 0.7.3
+</title>
+  <link rel="stylesheet" href="../../../css/style.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">
+  relpath = '../../..';
+  if (relpath != '') relpath += '/';
+</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>
+    <script type="text/javascript" charset="utf-8">
+      if (window.top.frames.main) document.body.className = 'frames';
+    </script>
+    <div id="header">
+      <div id="menu">
+    <a href="../../../_index.html">Index (S)</a> &raquo;
+    <span class='title'><span class='object_link'><a href="../../../Lims.html" title="Lims (module)">Lims</a></span></span> &raquo; <span class='title'><span class='object_link'><a href="../../Core.html" title="Lims::Core (module)">Core</a></span></span> &raquo; <span class='title'><span class='object_link'><a href="../Persistence.html" title="Lims::Core::Persistence (module)">Persistence</a></span></span>
+     &raquo;
+    <span class="title">Store</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 id="class_list_link" href="#">Class List</a>
+    <a id="method_list_link" href="#">Method List</a>
+    <a id="file_list_link" href="#">File List</a>
+</div>
+      <div class="clear"></div>
+    </div>
+    <iframe id="search_frame"></iframe>
+    <div id="content"><h1>Class: Lims::Core::Persistence::Store
+</h1>
+<dl class="box">
+    <dt class="r1">Inherits:</dt>
+    <dd class="r1">
+      <span class="inheritName"><span class='object_link'><a href="../../../Object.html" title="Object (class)">Object</a></span></span>
+        <ul class="fullTree">
+          <li><span class='object_link'><a href="../../../Object.html" title="Object (class)">Object</a></span></li>
+            <li class="next">Lims::Core::Persistence::Store</li>
+        </ul>
+        <a href="#" class="inheritanceTree">show all</a>
+      </dd>
+    <dt class="r2 last">Defined in:</dt>
+    <dd class="r2 last">lib/lims-core/persistence/store.rb</dd>
+</dl>
+<div class="clear"></div>
+<h2>Overview</h2><div class="docstring">
+  <div class="discussion">
+<p>A store represents a persistent datastore, where object can be saved and
+restored. A connection to a database, for example.</p>
+  </div>
+</div>
+<div class="tags">
+</div><div id="subclasses">
+  <h2>Direct Known Subclasses</h2>
+  <p class="children"><span class='object_link'><a href="Logger/Store.html" title="Lims::Core::Persistence::Logger::Store (class)">Logger::Store</a></span>, <span class='object_link'><a href="Sequel/Store.html" title="Lims::Core::Persistence::Sequel::Store (class)">Lims::Core::Persistence::Sequel::Store</a></span></p>
+</div>
+  <h2>Constant Summary</h2>
+    <dl class="constants">
+        <dt id="DIRTY_ATTRIBUTE_STRATEGY_DEEP_COPY-constant" class="">DIRTY_ATTRIBUTE_STRATEGY_DEEP_COPY =
+        </dt>
+        <dd><pre class="code"><span class='int'>1</span></pre></dd>
+        <dt id="DIRTY_ATTRIBUTE_STRATEGY_SHA1-constant" class="">DIRTY_ATTRIBUTE_STRATEGY_SHA1 =
+        </dt>
+        <dd><pre class="code"><span class='int'>2</span></pre></dd>
+        <dt id="DIRTY_ATTRIBUTE_STRATEGY_MD5-constant" class="">DIRTY_ATTRIBUTE_STRATEGY_MD5 =
+        </dt>
+        <dd><pre class="code"><span class='int'>3</span></pre></dd>
+        <dt id="DIRTY_ATTRIBUTE_STRATEGY_QUICK_HASH-constant" class="">DIRTY_ATTRIBUTE_STRATEGY_QUICK_HASH =
+        </dt>
+        <dd><pre class="code"><span class='int'>4</span></pre></dd>
+    </dl>
+  <h2>Instance Attribute Summary <small>(<a href="#" class="summary_toggle">collapse</a>)</small></h2>
+  <ul class="summary">
+      <li class="public ">
+  <span class="summary_signature">
+      <a href="#dirty_attribute_strategy-instance_method" title="#dirty_attribute_strategy (instance method)">- (Object) <strong>dirty_attribute_strategy</strong> </a>
+  </span>
+    <span class="summary_desc"><div class='inline'>
+<p>Returns the value of attribute dirty_attribute_strategy.</p>
+</div></span>
+</li>
+  </ul>
+    <h2>
+      Class Method Summary
+      <small>(<a href="#" class="summary_toggle">collapse</a>)</small>
+    </h2>
+    <ul class="summary">
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#base_module-class_method" title="base_module (class method)">+ (Module) <strong>base_module</strong> </a>
+  </span>
+    <span class="summary_desc"><div class='inline'>
+<p>Retrieves the effective module of a class Useful to call "sibling" classes.</p>
+</div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#const_missing-class_method" title="const_missing (class method)">+ (Object) <strong>const_missing</strong>(name) </a>
+  </span>
+    <span class="summary_desc"><div class='inline'></div></span>
+</li>
+    </ul>
+    <h2>
+      Instance Method Summary
+      <small>(<a href="#" class="summary_toggle">collapse</a>)</small>
+    </h2>
+    <ul class="summary">
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#base_module-instance_method" title="#base_module (instance method)">- (Object) <strong>base_module</strong> </a>
+  </span>
+    <span class="summary_desc"><div class='inline'></div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#create_session-instance_method" title="#create_session (instance method)">- (Object) <strong>create_session</strong>(*params) </a>
+  </span>
+    <span class="summary_desc"><div class='inline'>
+<p>Create a session If a session is given a parameter return in instead of
+creating a new one.</p>
+</div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#transaction-instance_method" title="#transaction (instance method)">- (Object) <strong>transaction</strong> </a>
+  </span>
+    <span class="summary_desc"><div class='inline'>
+<p>Execute given block within a transaction If it make sense.</p>
+</div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#with_session-instance_method" title="#with_session (instance method)">- (Object) <strong>with_session</strong>(*params) {|session| ... }</a>
+  </span>
+    <span class="summary_desc"><div class='inline'>
+<p>Create a session and pass it to the block.</p>
+</div></span>
+</li>
+    </ul>
+  <div id="instance_attr_details" class="attr_details">
+    <h2>Instance Attribute Details</h2>
+      <span id="dirty_attribute_strategy=-instance_method"></span>
+      <span id="dirty_attribute_strategy-instance_method"></span>
+      <div class="method_details first">
+  <p class="signature first" id="dirty_attribute_strategy-instance_method">
+    - (<tt><span class='object_link'><a href="../../../Object.html" title="Object (class)">Object</a></span></tt>) <strong>dirty_attribute_strategy</strong>
+</p><div class="docstring">
+  <div class="discussion">
+<p>Returns the value of attribute dirty_attribute_strategy</p>
+  </div>
+</div>
+<div class="tags">
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+19
+20
+21</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/lims-core/persistence/store.rb', line 19</span>
+<span class='kw'>def</span> <span class='id dirty_attribute_strategy'>dirty_attribute_strategy</span>
+  <span class='ivar'>@dirty_attribute_strategy</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+  </div>
+  <div id="class_method_details" class="method_details_list">
+    <h2>Class Method Details</h2>
+      <div class="method_details first">
+  <p class="signature first" id="base_module-class_method">
+    + (<tt>Module</tt>) <strong>base_module</strong>
+</p><div class="docstring">
+  <div class="discussion">
+<p>Retrieves the effective module of a class Useful to call "sibling" classes.</p>
+  </div>
+</div>
+<div class="tags">
+  <div class="examples">
+    <h3>Examples:</h3>
+      <h4><div class='inline'></div></h4>
+      <pre class="example code">class Sequel::Store &lt; Store
+  def session
+     base_module::Session
+end
+session will return a Sequel::Session instead of a ::Session.</pre>
+  </div>
+<h3>Returns:</h3>
+<ul class="return">
+    <li>
+        <span class='type'>(<tt>Module</tt>)</span>
+    </li>
+</ul>
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+37
+38
+39
+40
+41
+42</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/lims-core/persistence/store.rb', line 37</span>
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id base_module'>base_module</span>
+  <span class='ivar'>@base_module</span> <span class='op'>||=</span> <span class='kw'>begin</span>
+                    <span class='id base_name'>base_name</span> <span class='op'>=</span> <span class='id name'>name</span><span class='period'>.</span><span class='id sub'>sub</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>::\w+$</span><span class='regexp_end'>/</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span>
+                    <span class='id constant'>constant</span><span class='lparen'>(</span><span class='id base_name'>base_name</span><span class='rparen'>)</span>
+                  <span class='kw'>end</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <p class="signature " id="const_missing-class_method">
+    + (<tt><span class='object_link'><a href="../../../Object.html" title="Object (class)">Object</a></span></tt>) <strong>const_missing</strong>(name)
+</p><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+12
+13
+14</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/lims-core/persistence/store.rb', line 12</span>
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id const_missing'>const_missing</span><span class='lparen'>(</span><span class='id name'>name</span><span class='rparen'>)</span>
+  <span class='kw'>super</span><span class='lparen'>(</span><span class='id name'>name</span><span class='rparen'>)</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+  </div>
+  <div id="instance_method_details" class="method_details_list">
+    <h2>Instance Method Details</h2>
+      <div class="method_details first">
+  <p class="signature first" id="base_module-instance_method">
+    - (<tt><span class='object_link'><a href="../../../Object.html" title="Object (class)">Object</a></span></tt>) <strong>base_module</strong>
+</p><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+43
+44
+45</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/lims-core/persistence/store.rb', line 43</span>
+<span class='kw'>def</span> <span class='id base_module'>base_module</span>
+  <span class='kw'>self</span><span class='period'>.</span><span class='id class'>class</span><span class='period'>.</span><span class='id base_module'>base_module</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <p class="signature " id="create_session-instance_method">
+    - (<tt><span class='object_link'><a href="../../../Object.html" title="Object (class)">Object</a></span></tt>) <strong>create_session</strong>(*params)
+</p><div class="docstring">
+  <div class="discussion">
+<p>Create a session If a session is given a parameter return in instead of
+creating a new one.</p>
+  </div>
+</div>
+<div class="tags">
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+60
+61
+62
+63</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/lims-core/persistence/store.rb', line 60</span>
+<span class='kw'>def</span> <span class='id create_session'>create_session</span><span class='lparen'>(</span><span class='op'>*</span><span class='id params'>params</span><span class='rparen'>)</span>
+  <span class='kw'>return</span> <span class='id params'>params</span><span class='period'>.</span><span class='id first'>first</span> <span class='kw'>if</span><span class='lparen'>(</span><span class='id params'>params</span><span class='period'>.</span><span class='id size'>size</span> <span class='op'>&gt;=</span> <span class='int'>1</span> <span class='op'>&amp;&amp;</span> <span class='id params'>params</span><span class='period'>.</span><span class='id first'>first</span><span class='period'>.</span><span class='id is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>Session</span><span class='rparen'>)</span><span class='rparen'>)</span>
+  <span class='id base_module'>base_module</span><span class='op'>::</span><span class='const'>Session</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='kw'>self</span><span class='comma'>,</span> <span class='op'>*</span><span class='id params'>params</span><span class='rparen'>)</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <p class="signature " id="transaction-instance_method">
+    - (<tt><span class='object_link'><a href="../../../Object.html" title="Object (class)">Object</a></span></tt>) <strong>transaction</strong>
+</p><div class="docstring">
+  <div class="discussion">
+<p>Execute given block within a transaction If it make sense.</p>
+  </div>
+</div>
+<div class="tags">
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+67
+68
+69</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/lims-core/persistence/store.rb', line 67</span>
+<span class='kw'>def</span> <span class='id transaction'>transaction</span>
+  <span class='kw'>yield</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <p class="signature " id="with_session-instance_method">
+    - (<tt><span class='object_link'><a href="../../../Object.html" title="Object (class)">Object</a></span></tt>) <strong>with_session</strong>(*params) {|session| ... }
+</p><div class="docstring">
+  <div class="discussion">
+<p>Create a session and pass it to the block. This is the only way to get a
+session.</p>
+  </div>
+</div>
+<div class="tags">
+  <h3>Parameters:</h3>
+<ul class="param">
+    <li>
+        <span class='name'></span>
+        <span class='type'>(<tt><span class='object_link'><a href="../../../Array.html" title="Array (class)">Array</a></span></tt>)</span>
+    </li>
+</ul>
+<h3>Yield Parameters:</h3>
+<ul class="yieldparam">
+    <li>
+        <span class='name'>session</span>
+        <span class='type'>(<tt><span class='object_link'><a href="Session.html" title="Lims::Core::Persistence::Session (class)">Session</a></span></tt>)</span>
+        &mdash;
+        <div class='inline'>
+<p>the created session.</p>
+</div>
+    </li>
+</ul>
+<h3>Returns:</h3>
+<ul class="return">
+    <li>
+        <span class='type'></span>
+        <div class='inline'>
+<p>the value of the block</p>
+</div>
+    </li>
+</ul>
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+52
+53
+54</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/lims-core/persistence/store.rb', line 52</span>
+<span class='kw'>def</span> <span class='id with_session'>with_session</span><span class='lparen'>(</span><span class='op'>*</span><span class='id params'>params</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id block'>block</span><span class='rparen'>)</span>
+  <span class='id create_session'>create_session</span><span class='lparen'>(</span><span class='op'>*</span><span class='id params'>params</span><span class='rparen'>)</span><span class='period'>.</span><span class='id with_session'>with_session</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id block'>block</span><span class='rparen'>)</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+  </div>
+</div>
+  </body>
+</html>