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/Support/Errors/BadRequestError.html DELETED Viewed

@@ -1,283 +0,0 @@
-<!DOCTYPE html>
-<html>
-  <head>
-    <meta charset="utf-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>
-  Exception: Servus::Support::Errors::BadRequestError
-    &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::Support::Errors::BadRequestError";
-  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 (B)</a> &raquo;
-    <span class='title'><span class='object_link'><a href="../../../Servus.html" title="Servus (module)">Servus</a></span></span> &raquo; <span class='title'><span class='object_link'><a href="../../Support.html" title="Servus::Support (module)">Support</a></span></span> &raquo; <span class='title'><span class='object_link'><a href="../Errors.html" title="Servus::Support::Errors (module)">Errors</a></span></span>
-     &raquo;
-    <span class="title">BadRequestError</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>Exception: Servus::Support::Errors::BadRequestError
-</h1>
-<div class="box_info">
-  <dl>
-    <dt>Inherits:</dt>
-    <dd>
-      <span class="inheritName"><span class='object_link'><a href="ServiceError.html" title="Servus::Support::Errors::ServiceError (class)">ServiceError</a></span></span>
-        <ul class="fullTree">
-          <li>Object</li>
-            <li class="next">StandardError</li>
-            <li class="next"><span class='object_link'><a href="ServiceError.html" title="Servus::Support::Errors::ServiceError (class)">ServiceError</a></span></li>
-            <li class="next">Servus::Support::Errors::BadRequestError</li>
-        </ul>
-        <a href="#" class="inheritanceTree">show all</a>
-    </dd>
-  </dl>
-  <dl>
-    <dt>Defined in:</dt>
-    <dd>lib/servus/support/errors.rb</dd>
-  </dl>
-</div>
-<h2>Overview</h2><div class="docstring">
-  <div class="discussion">
-    <p>Represents a 400 Bad Request error.</p>
-<p>Use this error when the client sends malformed or invalid request data.</p>
-  </div>
-</div>
-<div class="tags">
-  <div class="examples">
-    <h4 class="tag_title">Examples:</h4>
-      <pre class="example code"><code><span class='kw'>def</span> <span class='id identifier rubyid_call'>call</span>
-  <span class='kw'>return</span> <span class='id identifier rubyid_failure'>failure</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Invalid JSON format</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>type:</span> <span class='const'>BadRequestError</span><span class='rparen'>)</span>
-<span class='kw'>end</span></code></pre>
-  </div>
-</div>
-    <h2>
-      Constant Summary
-      <small><a href="#" class="constants_summary_toggle">collapse</a></small>
-    </h2>
-    <dl class="constants">
-        <dt id="DEFAULT_MESSAGE-constant" class="">DEFAULT_MESSAGE =
-        </dt>
-        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>Bad request</span><span class='tstring_end'>&#39;</span></span></pre></dd>
-    </dl>
-  <h2>Instance Attribute Summary</h2>
-  <h3 class="inherited">Attributes inherited from <span class='object_link'><a href="ServiceError.html" title="Servus::Support::Errors::ServiceError (class)">ServiceError</a></span></h3>
-  <p class="inherited"><span class='object_link'><a href="ServiceError.html#message-instance_method" title="Servus::Support::Errors::ServiceError#message (method)">#message</a></span></p>
-    <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="#api_error-instance_method" title="#api_error (instance method)">#<strong>api_error</strong>  &#x21d2; Hash </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>400 error response.</p>
-</div></span>
-</li>
-    </ul>
-  <h3 class="inherited">Methods inherited from <span class='object_link'><a href="ServiceError.html" title="Servus::Support::Errors::ServiceError (class)">ServiceError</a></span></h3>
-  <p class="inherited"><span class='object_link'><a href="ServiceError.html#initialize-instance_method" title="Servus::Support::Errors::ServiceError#initialize (method)">#initialize</a></span></p>
-  <div id="constructor_details" class="method_details_list">
-  <h2>Constructor Details</h2>
-    <p class="notice">This class inherits a constructor from <span class='object_link'><a href="ServiceError.html#initialize-instance_method" title="Servus::Support::Errors::ServiceError#initialize (method)">Servus::Support::Errors::ServiceError</a></span></p>
-</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="api_error-instance_method">
-    #<strong>api_error</strong>  &#x21d2; <tt>Hash</tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>400 error response</p>
-  </div>
-</div>
-<div class="tags">
-<p class="tag_title">Returns:</p>
-<ul class="return">
-    <li>
-        <span class='type'>(<tt>Hash</tt>)</span>
-        &mdash;
-        <div class='inline'><p>The error response</p>
-</div>
-    </li>
-</ul>
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-84
-85
-86</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/servus/support/errors.rb', line 84</span>
-<span class='kw'>def</span> <span class='id identifier rubyid_api_error'>api_error</span>
-  <span class='lbrace'>{</span> <span class='label'>code:</span> <span class='symbol'>:bad_request</span><span class='comma'>,</span> <span class='label'>message:</span> <span class='id identifier rubyid_message'>message</span> <span class='rbrace'>}</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>

data/docs/yard/Servus/Support/Errors/ForbiddenError.html DELETED Viewed

@@ -1,284 +0,0 @@
-<!DOCTYPE html>
-<html>
-  <head>
-    <meta charset="utf-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>
-  Exception: Servus::Support::Errors::ForbiddenError
-    &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::Support::Errors::ForbiddenError";
-  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 (F)</a> &raquo;
-    <span class='title'><span class='object_link'><a href="../../../Servus.html" title="Servus (module)">Servus</a></span></span> &raquo; <span class='title'><span class='object_link'><a href="../../Support.html" title="Servus::Support (module)">Support</a></span></span> &raquo; <span class='title'><span class='object_link'><a href="../Errors.html" title="Servus::Support::Errors (module)">Errors</a></span></span>
-     &raquo;
-    <span class="title">ForbiddenError</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>Exception: Servus::Support::Errors::ForbiddenError
-</h1>
-<div class="box_info">
-  <dl>
-    <dt>Inherits:</dt>
-    <dd>
-      <span class="inheritName"><span class='object_link'><a href="ServiceError.html" title="Servus::Support::Errors::ServiceError (class)">ServiceError</a></span></span>
-        <ul class="fullTree">
-          <li>Object</li>
-            <li class="next">StandardError</li>
-            <li class="next"><span class='object_link'><a href="ServiceError.html" title="Servus::Support::Errors::ServiceError (class)">ServiceError</a></span></li>
-            <li class="next">Servus::Support::Errors::ForbiddenError</li>
-        </ul>
-        <a href="#" class="inheritanceTree">show all</a>
-    </dd>
-  </dl>
-  <dl>
-    <dt>Defined in:</dt>
-    <dd>lib/servus/support/errors.rb</dd>
-  </dl>
-</div>
-<h2>Overview</h2><div class="docstring">
-  <div class="discussion">
-    <p>Represents a 403 Forbidden error.</p>
-<p>Use this error when the user is authenticated but not authorized to perform
-the requested action.</p>
-  </div>
-</div>
-<div class="tags">
-  <div class="examples">
-    <h4 class="tag_title">Examples:</h4>
-      <pre class="example code"><code><span class='kw'>def</span> <span class='id identifier rubyid_call'>call</span>
-  <span class='kw'>return</span> <span class='id identifier rubyid_failure'>failure</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Insufficient permissions</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>type:</span> <span class='const'>ForbiddenError</span><span class='rparen'>)</span> <span class='kw'>unless</span> <span class='id identifier rubyid_can_access?'>can_access?</span>
-<span class='kw'>end</span></code></pre>
-  </div>
-</div>
-    <h2>
-      Constant Summary
-      <small><a href="#" class="constants_summary_toggle">collapse</a></small>
-    </h2>
-    <dl class="constants">
-        <dt id="DEFAULT_MESSAGE-constant" class="">DEFAULT_MESSAGE =
-        </dt>
-        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>Forbidden</span><span class='tstring_end'>&#39;</span></span></pre></dd>
-    </dl>
-  <h2>Instance Attribute Summary</h2>
-  <h3 class="inherited">Attributes inherited from <span class='object_link'><a href="ServiceError.html" title="Servus::Support::Errors::ServiceError (class)">ServiceError</a></span></h3>
-  <p class="inherited"><span class='object_link'><a href="ServiceError.html#message-instance_method" title="Servus::Support::Errors::ServiceError#message (method)">#message</a></span></p>
-    <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="#api_error-instance_method" title="#api_error (instance method)">#<strong>api_error</strong>  &#x21d2; Hash </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>403 error response.</p>
-</div></span>
-</li>
-    </ul>
-  <h3 class="inherited">Methods inherited from <span class='object_link'><a href="ServiceError.html" title="Servus::Support::Errors::ServiceError (class)">ServiceError</a></span></h3>
-  <p class="inherited"><span class='object_link'><a href="ServiceError.html#initialize-instance_method" title="Servus::Support::Errors::ServiceError#initialize (method)">#initialize</a></span></p>
-  <div id="constructor_details" class="method_details_list">
-  <h2>Constructor Details</h2>
-    <p class="notice">This class inherits a constructor from <span class='object_link'><a href="ServiceError.html#initialize-instance_method" title="Servus::Support::Errors::ServiceError#initialize (method)">Servus::Support::Errors::ServiceError</a></span></p>
-</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="api_error-instance_method">
-    #<strong>api_error</strong>  &#x21d2; <tt>Hash</tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>403 error response</p>
-  </div>
-</div>
-<div class="tags">
-<p class="tag_title">Returns:</p>
-<ul class="return">
-    <li>
-        <span class='type'>(<tt>Hash</tt>)</span>
-        &mdash;
-        <div class='inline'><p>The error response</p>
-</div>
-    </li>
-</ul>
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-133
-134
-135</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/servus/support/errors.rb', line 133</span>
-<span class='kw'>def</span> <span class='id identifier rubyid_api_error'>api_error</span>
-  <span class='lbrace'>{</span> <span class='label'>code:</span> <span class='symbol'>:forbidden</span><span class='comma'>,</span> <span class='label'>message:</span> <span class='id identifier rubyid_message'>message</span> <span class='rbrace'>}</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>