RubyGems - servus - Versions diffs - 0.2.1 → 0.4.0 - Mend

servus 0.2.1 → 0.4.0

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 (138) hide show

checksums.yaml +4 -4
data/lib/generators/servus/event_handler/event_handler_generator.rb +1 -1
data/lib/generators/servus/guard/guard_generator.rb +1 -1
data/lib/generators/servus/guard/templates/guard.rb.erb +5 -3
data/lib/generators/servus/service/service_generator.rb +1 -1
data/lib/servus/base.rb +67 -9
data/lib/servus/config.rb +71 -3
data/lib/servus/events/bus.rb +29 -0
data/lib/servus/events/emitter.rb +15 -0
data/lib/servus/extensions/lazily/call.rb +82 -0
data/lib/servus/extensions/lazily/errors.rb +37 -0
data/lib/servus/extensions/lazily/ext.rb +23 -0
data/lib/servus/extensions/lazily/resolver.rb +32 -0
data/lib/servus/guard.rb +7 -6
data/lib/servus/guards/falsey_guard.rb +3 -3
data/lib/servus/guards/presence_guard.rb +4 -4
data/lib/servus/guards/state_guard.rb +4 -5
data/lib/servus/guards/truthy_guard.rb +3 -3
data/lib/servus/helpers/controller_helpers.rb +40 -0
data/lib/servus/railtie.rb +7 -1
data/lib/servus/support/data_object.rb +80 -0
data/lib/servus/support/errors.rb +16 -0
data/lib/servus/support/lockdown.rb +94 -0
data/lib/servus/support/logger.rb +16 -0
data/lib/servus/support/response.rb +12 -1
data/lib/servus/support/validator.rb +79 -34
data/lib/servus/testing/example_builders.rb +74 -0
data/lib/servus/testing/matchers.rb +99 -0
data/lib/servus/version.rb +1 -1
data/lib/servus.rb +2 -0
metadata +16 -114
data/.claude/commands/check-docs.md +0 -1
data/.claude/commands/consistency-check.md +0 -1
data/.claude/commands/fine-tooth-comb.md +0 -1
data/.claude/commands/red-green-refactor.md +0 -5
data/.claude/settings.json +0 -24
data/.rspec +0 -3
data/.rubocop.yml +0 -27
data/.yardopts +0 -6
data/CHANGELOG.md +0 -122
data/CLAUDE.md +0 -10
data/IDEAS.md +0 -5
data/LICENSE.txt +0 -21
data/READme.md +0 -856
data/Rakefile +0 -45
data/docs/core/1_overview.md +0 -77
data/docs/core/2_architecture.md +0 -120
data/docs/core/3_service_objects.md +0 -121
data/docs/features/1_schema_validation.md +0 -119
data/docs/features/2_error_handling.md +0 -121
data/docs/features/3_async_execution.md +0 -81
data/docs/features/4_logging.md +0 -64
data/docs/features/5_event_bus.md +0 -244
data/docs/features/6_guards.md +0 -356
data/docs/features/guards_naming_convention.md +0 -540
data/docs/guides/1_common_patterns.md +0 -90
data/docs/guides/2_migration_guide.md +0 -175
data/docs/integration/1_configuration.md +0 -154
data/docs/integration/2_testing.md +0 -287
data/docs/integration/3_rails_integration.md +0 -99
data/docs/yard/Servus/Base.html +0 -1645
data/docs/yard/Servus/Config.html +0 -582
data/docs/yard/Servus/Extensions/Async/Call.html +0 -400
data/docs/yard/Servus/Extensions/Async/Errors/AsyncError.html +0 -140
data/docs/yard/Servus/Extensions/Async/Errors/JobEnqueueError.html +0 -154
data/docs/yard/Servus/Extensions/Async/Errors/ServiceNotFoundError.html +0 -154
data/docs/yard/Servus/Extensions/Async/Errors.html +0 -128
data/docs/yard/Servus/Extensions/Async/Ext.html +0 -119
data/docs/yard/Servus/Extensions/Async/Job.html +0 -310
data/docs/yard/Servus/Extensions/Async.html +0 -141
data/docs/yard/Servus/Extensions.html +0 -117
data/docs/yard/Servus/Generators/ServiceGenerator.html +0 -261
data/docs/yard/Servus/Generators.html +0 -115
data/docs/yard/Servus/Helpers/ControllerHelpers.html +0 -457
data/docs/yard/Servus/Helpers.html +0 -115
data/docs/yard/Servus/Railtie.html +0 -134
data/docs/yard/Servus/Support/Errors/AuthenticationError.html +0 -287
data/docs/yard/Servus/Support/Errors/BadRequestError.html +0 -283
data/docs/yard/Servus/Support/Errors/ForbiddenError.html +0 -284
data/docs/yard/Servus/Support/Errors/InternalServerError.html +0 -283
data/docs/yard/Servus/Support/Errors/NotFoundError.html +0 -284
data/docs/yard/Servus/Support/Errors/ServiceError.html +0 -489
data/docs/yard/Servus/Support/Errors/ServiceUnavailableError.html +0 -290
data/docs/yard/Servus/Support/Errors/UnauthorizedError.html +0 -200
data/docs/yard/Servus/Support/Errors/UnprocessableEntityError.html +0 -288
data/docs/yard/Servus/Support/Errors/ValidationError.html +0 -200
data/docs/yard/Servus/Support/Errors.html +0 -140
data/docs/yard/Servus/Support/Logger.html +0 -856
data/docs/yard/Servus/Support/Rescuer/BlockContext.html +0 -585
data/docs/yard/Servus/Support/Rescuer/CallOverride.html +0 -257
data/docs/yard/Servus/Support/Rescuer/ClassMethods.html +0 -343
data/docs/yard/Servus/Support/Rescuer.html +0 -267
data/docs/yard/Servus/Support/Response.html +0 -574
data/docs/yard/Servus/Support/Validator.html +0 -1150
data/docs/yard/Servus/Support.html +0 -119
data/docs/yard/Servus/Testing/ExampleBuilders.html +0 -523
data/docs/yard/Servus/Testing/ExampleExtractor.html +0 -578
data/docs/yard/Servus/Testing.html +0 -142
data/docs/yard/Servus.html +0 -343
data/docs/yard/_index.html +0 -535
data/docs/yard/class_list.html +0 -54
data/docs/yard/css/common.css +0 -1
data/docs/yard/css/full_list.css +0 -58
data/docs/yard/css/style.css +0 -503
data/docs/yard/file.1_common_patterns.html +0 -154
data/docs/yard/file.1_configuration.html +0 -115
data/docs/yard/file.1_overview.html +0 -142
data/docs/yard/file.1_schema_validation.html +0 -188
data/docs/yard/file.2_architecture.html +0 -157
data/docs/yard/file.2_error_handling.html +0 -190
data/docs/yard/file.2_migration_guide.html +0 -242
data/docs/yard/file.2_testing.html +0 -227
data/docs/yard/file.3_async_execution.html +0 -145
data/docs/yard/file.3_rails_integration.html +0 -160
data/docs/yard/file.3_service_objects.html +0 -191
data/docs/yard/file.4_logging.html +0 -135
data/docs/yard/file.ErrorHandling.html +0 -190
data/docs/yard/file.READme.html +0 -674
data/docs/yard/file.architecture.html +0 -157
data/docs/yard/file.async_execution.html +0 -145
data/docs/yard/file.common_patterns.html +0 -154
data/docs/yard/file.configuration.html +0 -115
data/docs/yard/file.error_handling.html +0 -190
data/docs/yard/file.logging.html +0 -135
data/docs/yard/file.migration_guide.html +0 -242
data/docs/yard/file.overview.html +0 -142
data/docs/yard/file.rails_integration.html +0 -160
data/docs/yard/file.schema_validation.html +0 -188
data/docs/yard/file.service_objects.html +0 -191
data/docs/yard/file.testing.html +0 -227
data/docs/yard/file_list.html +0 -119
data/docs/yard/frames.html +0 -22
data/docs/yard/index.html +0 -674
data/docs/yard/js/app.js +0 -344
data/docs/yard/js/full_list.js +0 -242
data/docs/yard/js/jquery.js +0 -4
data/docs/yard/method_list.html +0 -542
data/docs/yard/top-level-namespace.html +0 -110

data/docs/yard/Servus/Config.html DELETED Viewed

@@ -1,582 +0,0 @@
-<!DOCTYPE html>
-<html>
-  <head>
-    <meta charset="utf-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>
-  Class: Servus::Config
-    &mdash; Servus | Service Object Framework
-</title>
-  <link rel="stylesheet" href="../css/style.css" type="text/css" />
-  <link rel="stylesheet" href="../css/common.css" type="text/css" />
-<script type="text/javascript">
-  pathId = "Servus::Config";
-  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>
-    <div class="nav_wrap">
-      <iframe id="nav" src="../class_list.html?1"></iframe>
-      <div id="resizer"></div>
-    </div>
-    <div id="main" tabindex="-1">
-      <div id="header">
-        <div id="menu">
-    <a href="../_index.html">Index (C)</a> &raquo;
-    <span class='title'><span class='object_link'><a href="../Servus.html" title="Servus (module)">Servus</a></span></span>
-     &raquo;
-    <span class="title">Config</span>
-</div>
-        <div id="search">
-    <a class="full_list_link" id="class_list_link"
-        href="../class_list.html">
-        <svg width="24" height="24">
-          <rect x="0" y="4" width="24" height="4" rx="1" ry="1"></rect>
-          <rect x="0" y="12" width="24" height="4" rx="1" ry="1"></rect>
-          <rect x="0" y="20" width="24" height="4" rx="1" ry="1"></rect>
-        </svg>
-    </a>
-</div>
-        <div class="clear"></div>
-      </div>
-      <div id="content"><h1>Class: Servus::Config
-</h1>
-<div class="box_info">
-  <dl>
-    <dt>Inherits:</dt>
-    <dd>
-      <span class="inheritName">Object</span>
-        <ul class="fullTree">
-          <li>Object</li>
-            <li class="next">Servus::Config</li>
-        </ul>
-        <a href="#" class="inheritanceTree">show all</a>
-    </dd>
-  </dl>
-  <dl>
-    <dt>Defined in:</dt>
-    <dd>lib/servus/config.rb</dd>
-  </dl>
-</div>
-<h2>Overview</h2><div class="docstring">
-  <div class="discussion">
-    <p>Configuration settings for the Servus gem.</p>
-<p>Manages global configuration options including schema file locations.
-Access the configuration via <span class='object_link'><a href="../Servus.html#config-class_method" title="Servus.config (method)">config</a></span> or modify via <span class='object_link'><a href="../Servus.html#configure-class_method" title="Servus.configure (method)">configure</a></span>.</p>
-  </div>
-</div>
-<div class="tags">
-  <div class="examples">
-    <h4 class="tag_title">Examples:</h4>
-        <h5 class="example_title"><div class='inline'><p>Customizing schema location</p>
-</div></h5>
-      <pre class="example code"><code><span class='const'><span class='object_link'><a href="../Servus.html" title="Servus (module)">Servus</a></span></span><span class='period'>.</span><span class='id identifier rubyid_configure'><span class='object_link'><a href="../Servus.html#configure-class_method" title="Servus.configure (method)">configure</a></span></span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_config'>config</span><span class='op'>|</span>
-  <span class='id identifier rubyid_config'>config</span><span class='period'>.</span><span class='id identifier rubyid_schema_root'>schema_root</span> <span class='op'>=</span> <span class='const'>Rails</span><span class='period'>.</span><span class='id identifier rubyid_root'>root</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>lib/schemas</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
-<span class='kw'>end</span></code></pre>
-  </div>
-  <p class="tag_title">See Also:</p>
-  <ul class="see">
-      <li><span class='object_link'><a href="../Servus.html#config-class_method" title="Servus.config (method)">config</a></span></li>
-      <li><span class='object_link'><a href="../Servus.html#configure-class_method" title="Servus.configure (method)">configure</a></span></li>
-  </ul>
-</div>
-  <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="#schema_root-instance_method" title="#schema_root (instance method)">#<strong>schema_root</strong>  &#x21d2; String </a>
-  </span>
-      <span class="note title readonly">readonly</span>
-    <span class="summary_desc"><div class='inline'><p>The root directory where schema files are located.</p>
-</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="#initialize-instance_method" title="#initialize (instance method)">#<strong>initialize</strong>  &#x21d2; Config </a>
-  </span>
-    <span class="note title constructor">constructor</span>
-  <span class="private note title">private</span>
-    <span class="summary_desc"><div class='inline'><p>Initializes a new configuration with default values.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#schema_dir_for-instance_method" title="#schema_dir_for (instance method)">#<strong>schema_dir_for</strong>(service_namespace)  &#x21d2; String </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>Returns the directory containing a service&#39;s schema files.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#schema_path_for-instance_method" title="#schema_path_for (instance method)">#<strong>schema_path_for</strong>(service_namespace, type)  &#x21d2; String </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>Returns the full path to a service&#39;s schema file.</p>
-</div></span>
-</li>
-    </ul>
-<div id="constructor_details" class="method_details_list">
-  <h2>Constructor Details</h2>
-    <div class="method_details first">
-  <h3 class="signature first" id="initialize-instance_method">
-    #<strong>initialize</strong>  &#x21d2; <tt><span class='object_link'><a href="" title="Servus::Config (class)">Config</a></span></tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p class="note private">
-  <strong>This method is part of a private API.</strong>
-  You should avoid using this method if possible, as it may be removed or be changed in the future.
-</p>
-<p>Initializes a new configuration with default values.</p>
-  </div>
-</div>
-<div class="tags">
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-29
-30
-31
-32</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/servus/config.rb', line 29</span>
-<span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span>
-  <span class='comment'># Default to Rails.root if available, otherwise use current working directory
-</span>  <span class='ivar'>@schema_root</span> <span class='op'>=</span> <span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span><span class='id identifier rubyid_root_path'>root_path</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>app/schemas/services</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-</div>
-  <div id="instance_attr_details" class="attr_details">
-    <h2>Instance Attribute Details</h2>
-      <span id=""></span>
-      <div class="method_details first">
-  <h3 class="signature first" id="schema_root-instance_method">
-    #<strong>schema_root</strong>  &#x21d2; <tt>String</tt>  <span class="extras">(readonly)</span>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>The root directory where schema files are located.</p>
-<p>Defaults to <code>Rails.root/app/schemas/services</code> in Rails applications,
-or a relative path from the gem installation otherwise.</p>
-  </div>
-</div>
-<div class="tags">
-<p class="tag_title">Returns:</p>
-<ul class="return">
-    <li>
-        <span class='type'>(<tt>String</tt>)</span>
-        &mdash;
-        <div class='inline'><p>the schema root directory path</p>
-</div>
-    </li>
-</ul>
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-24
-25
-26</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/servus/config.rb', line 24</span>
-<span class='kw'>def</span> <span class='id identifier rubyid_schema_root'>schema_root</span>
-  <span class='ivar'>@schema_root</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">
-  <h3 class="signature first" id="schema_dir_for-instance_method">
-    #<strong>schema_dir_for</strong>(service_namespace)  &#x21d2; <tt>String</tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Returns the directory containing a service&#39;s schema files.</p>
-  </div>
-</div>
-<div class="tags">
-  <div class="examples">
-    <h4 class="tag_title">Examples:</h4>
-      <pre class="example code"><code><span class='id identifier rubyid_config'>config</span><span class='period'>.</span><span class='id identifier rubyid_schema_dir_for'>schema_dir_for</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>process_payment</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
-<span class='comment'># =&gt; &quot;/app/app/schemas/services/process_payment&quot;</span></code></pre>
-  </div>
-<p class="tag_title">Parameters:</p>
-<ul class="param">
-    <li>
-        <span class='name'>service_namespace</span>
-        <span class='type'>(<tt>String</tt>)</span>
-        &mdash;
-        <div class='inline'><p>underscored service namespace</p>
-</div>
-    </li>
-</ul>
-<p class="tag_title">Returns:</p>
-<ul class="return">
-    <li>
-        <span class='type'>(<tt>String</tt>)</span>
-        &mdash;
-        <div class='inline'><p>directory path for the service&#39;s schemas</p>
-</div>
-    </li>
-</ul>
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-58
-59
-60</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/servus/config.rb', line 58</span>
-<span class='kw'>def</span> <span class='id identifier rubyid_schema_dir_for'>schema_dir_for</span><span class='lparen'>(</span><span class='id identifier rubyid_service_namespace'>service_namespace</span><span class='rparen'>)</span>
-  <span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span><span class='id identifier rubyid_schema_root'>schema_root</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='comma'>,</span> <span class='id identifier rubyid_service_namespace'>service_namespace</span><span class='rparen'>)</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <h3 class="signature " id="schema_path_for-instance_method">
-    #<strong>schema_path_for</strong>(service_namespace, type)  &#x21d2; <tt>String</tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Returns the full path to a service&#39;s schema file.</p>
-<p>Constructs the path by combining <span class='object_link'><a href="#schema_root-instance_method" title="Servus::Config#schema_root (method)">#schema_root</a></span> with the service namespace
-and schema type.</p>
-  </div>
-</div>
-<div class="tags">
-  <div class="examples">
-    <h4 class="tag_title">Examples:</h4>
-      <pre class="example code"><code><span class='id identifier rubyid_config'>config</span><span class='period'>.</span><span class='id identifier rubyid_schema_path_for'>schema_path_for</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>process_payment</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>arguments</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
-<span class='comment'># =&gt; &quot;/app/app/schemas/services/process_payment/arguments.json&quot;</span></code></pre>
-  </div>
-<p class="tag_title">Parameters:</p>
-<ul class="param">
-    <li>
-        <span class='name'>service_namespace</span>
-        <span class='type'>(<tt>String</tt>)</span>
-        &mdash;
-        <div class='inline'><p>underscored service namespace (e.g., &quot;process_payment&quot;)</p>
-</div>
-    </li>
-    <li>
-        <span class='name'>type</span>
-        <span class='type'>(<tt>String</tt>)</span>
-        &mdash;
-        <div class='inline'><p>schema type (&quot;arguments&quot; or &quot;result&quot;)</p>
-</div>
-    </li>
-</ul>
-<p class="tag_title">Returns:</p>
-<ul class="return">
-    <li>
-        <span class='type'>(<tt>String</tt>)</span>
-        &mdash;
-        <div class='inline'><p>full path to the schema JSON file</p>
-</div>
-    </li>
-</ul>
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-46
-47
-48</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/servus/config.rb', line 46</span>
-<span class='kw'>def</span> <span class='id identifier rubyid_schema_path_for'>schema_path_for</span><span class='lparen'>(</span><span class='id identifier rubyid_service_namespace'>service_namespace</span><span class='comma'>,</span> <span class='id identifier rubyid_type'>type</span><span class='rparen'>)</span>
-  <span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span><span class='id identifier rubyid_schema_root'>schema_root</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='comma'>,</span> <span class='id identifier rubyid_service_namespace'>service_namespace</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_type'>type</span><span class='embexpr_end'>}</span><span class='tstring_content'>.json</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-  </div>
-</div>
-      <div id="footer">
-  Generated on Fri Nov 21 00:33:24 2025 by
-  <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.37 (ruby-3.4.4).
-</div>
-    </div>
-  </body>
-</html>