RubyGems - rbcli - Versions diffs - 0.2.12 → 0.3.0 - Mend

rbcli 0.2.12 → 0.3.0

Files changed (113) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +15 -0
data/Gemfile.lock +39 -38
data/docs-src/content/development/changelog.md +16 -1
data/docs-src/themes/hugo-theme-learn/CHANGELOG.md +74 -2
data/docs-src/themes/hugo-theme-learn/README.md +42 -5
data/docs-src/themes/hugo-theme-learn/exampleSite/config.toml +27 -0
data/docs-src/themes/hugo-theme-learn/exampleSite/content/basics/_index.zh.md +12 -0
data/docs-src/themes/hugo-theme-learn/exampleSite/content/basics/configuration/_index.en.md +6 -4
data/docs-src/themes/hugo-theme-learn/exampleSite/content/basics/configuration/_index.fr.md +7 -5
data/docs-src/themes/hugo-theme-learn/exampleSite/content/basics/installation/_index.en.md +1 -1
data/docs-src/themes/hugo-theme-learn/exampleSite/content/cont/markdown.en.md +88 -61
data/docs-src/themes/hugo-theme-learn/exampleSite/content/cont/pages/_index.fr.md +3 -3
data/docs-src/themes/hugo-theme-learn/exampleSite/content/cont/syntaxhighlight.en.md +89 -0
data/docs-src/themes/hugo-theme-learn/exampleSite/content/shortcodes/children/_index.en.md +2 -2
data/docs-src/themes/hugo-theme-learn/exampleSite/content/shortcodes/notice.en.md +2 -2
data/docs-src/themes/hugo-theme-learn/exampleSite/content/showcase.en.md +4 -1
data/docs-src/themes/hugo-theme-learn/exampleSite/content/showcase.fr.md +4 -1
data/docs-src/themes/hugo-theme-learn/exampleSite/static/fonts/monogramos-webfont.svg +1 -237
data/docs-src/themes/hugo-theme-learn/exampleSite/static/images/showcase/inteliver_docs.png +0 -0
data/docs-src/themes/hugo-theme-learn/exampleSite/static/images/showcase/tshark_dev.png +0 -0
data/docs-src/themes/hugo-theme-learn/i18n/ar.toml +26 -0
data/docs-src/themes/hugo-theme-learn/i18n/de.toml +26 -0
data/docs-src/themes/hugo-theme-learn/i18n/hi.toml +26 -0
data/docs-src/themes/hugo-theme-learn/i18n/ja.toml +26 -0
data/docs-src/themes/hugo-theme-learn/i18n/ru.toml +26 -0
data/docs-src/themes/hugo-theme-learn/i18n/zh-cn.toml +26 -0
data/docs-src/themes/hugo-theme-learn/layouts/_default/list.html +1 -1
data/docs-src/themes/hugo-theme-learn/layouts/_default/single.html +1 -2
data/docs-src/themes/hugo-theme-learn/layouts/partials/footer.html +3 -4
data/docs-src/themes/hugo-theme-learn/layouts/partials/header.html +8 -6
data/docs-src/themes/hugo-theme-learn/layouts/partials/menu.html +6 -5
data/docs-src/themes/hugo-theme-learn/layouts/shortcodes/children.html +2 -2
data/docs-src/themes/hugo-theme-learn/layouts/shortcodes/ref.html +1 -1
data/docs-src/themes/hugo-theme-learn/layouts/shortcodes/relref.html +1 -1
data/docs-src/themes/hugo-theme-learn/netlify.toml +1 -2
data/docs-src/themes/hugo-theme-learn/static/css/theme.css +4 -0
data/docs-src/themes/hugo-theme-learn/static/fonts/Inconsolata.svg +1 -359
data/docs-src/themes/hugo-theme-learn/static/fonts/Novecentosanswide-Normal-webfont.svg +1 -1019
data/docs-src/themes/hugo-theme-learn/static/fonts/Novecentosanswide-UltraLight-webfont.svg +1 -918
data/docs-src/themes/hugo-theme-learn/static/fonts/Work_Sans_200.svg +1 -332
data/docs-src/themes/hugo-theme-learn/static/fonts/Work_Sans_300.svg +1 -331
data/docs-src/themes/hugo-theme-learn/static/fonts/Work_Sans_500.svg +1 -333
data/docs-src/themes/hugo-theme-learn/static/images/clippy.svg +1 -1
data/docs-src/themes/hugo-theme-learn/static/js/auto-complete.js +3 -223
data/docs-src/themes/hugo-theme-learn/static/js/highlight.pack.js +6 -3
data/docs-src/themes/hugo-theme-learn/static/js/hugo-learn.js +8 -5
data/docs-src/themes/hugo-theme-learn/static/webfonts/fa-brands-400.svg +1 -1260
data/docs-src/themes/hugo-theme-learn/static/webfonts/fa-regular-400.svg +1 -471
data/docs-src/themes/hugo-theme-learn/static/webfonts/fa-solid-900.svg +1 -2763
data/docs/404.html +8 -8
data/docs/advanced/automatic_updates/index.html +85 -65
data/docs/advanced/command_types/index.html +139 -144
data/docs/advanced/distributed_state_locking/index.html +83 -55
data/docs/advanced/hooks/index.html +94 -81
data/docs/advanced/index.html +75 -34
data/docs/advanced/index.xml +8 -8
data/docs/advanced/interactive_commands/index.html +90 -66
data/docs/advanced/logging/index.html +94 -67
data/docs/advanced/remote_execution/index.html +94 -75
data/docs/advanced/state_storage/index.html +122 -119
data/docs/advanced/user_config_files/index.html +94 -71
data/docs/categories/index.html +82 -30
data/docs/categories/index.xml +1 -1
data/docs/css/theme.css +4 -0
data/docs/development/changelog/index.html +185 -177
data/docs/development/code_of_conduct/index.html +85 -64
data/docs/development/contributing/index.html +96 -96
data/docs/development/index.html +75 -34
data/docs/development/index.xml +2 -2
data/docs/development/license/index.html +80 -46
data/docs/fonts/Inconsolata.svg +1 -359
data/docs/fonts/Novecentosanswide-Normal-webfont.svg +1 -1019
data/docs/fonts/Novecentosanswide-UltraLight-webfont.svg +1 -918
data/docs/fonts/Work_Sans_200.svg +1 -332
data/docs/fonts/Work_Sans_300.svg +1 -331
data/docs/fonts/Work_Sans_500.svg +1 -333
data/docs/images/clippy.svg +1 -1
data/docs/index.html +112 -61
data/docs/index.json +24 -24
data/docs/index.xml +13 -13
data/docs/js/auto-complete.js +3 -223
data/docs/js/highlight.pack.js +6 -3
data/docs/js/hugo-learn.js +8 -5
data/docs/quick_reference/index.html +126 -159
data/docs/quick_reference/index.xml +1 -1
data/docs/sitemap.xml +2 -4
data/docs/tags/index.html +82 -30
data/docs/tags/index.xml +1 -1
data/docs/tutorial/10-getting_started/index.html +87 -66
data/docs/tutorial/20-project_layout/index.html +126 -116
data/docs/tutorial/30-your_first_command/index.html +151 -141
data/docs/tutorial/40-options_parameters_and_arguments/index.html +233 -258
data/docs/tutorial/50-publishing/index.html +86 -66
data/docs/tutorial/index.html +75 -34
data/docs/tutorial/index.xml +4 -4
data/docs/webfonts/fa-brands-400.svg +1 -1260
data/docs/webfonts/fa-regular-400.svg +1 -471
data/docs/webfonts/fa-solid-900.svg +1 -2763
data/docs/whoami/index.html +76 -46
data/docs/whoami/index.xml +1 -1
data/lib/rbcli/configuration/configurate_blocks/me.rb +5 -5
data/lib/rbcli/util/deprecation_warning.rb +21 -4
data/lib/rbcli/version.rb +1 -1
data/rbcli.gemspec +8 -8
data/skeletons/project/Gemfile +1 -1
data/skeletons/project/config/general.rb +1 -1
data/skeletons/project/lib/lib.erb +2 -0
data/skeletons/project/spec/spec_helper.rb +7 -7
data/skeletons/project/spec/untitled_spec.rb +6 -6
data/skeletons/project/untitled.gemspec +28 -26
metadata +29 -20
data/docs-src/themes/hugo-theme-learn/static/js/html5shiv-printshiv.min.js +0 -4

data/docs/tutorial/20-project_layout/index.html CHANGED

@@ -3,7 +3,7 @@
   <head>
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <meta name="generator" content="Hugo 0.55.6" />
+    <meta name="generator" content="Hugo 0.74.3" />
     <meta name="description" content="">
@@ -12,20 +12,21 @@
     <title>The Project Layout :: RBCli Documentation</title>
-    <link href="/rbcli/css/nucleus.css?1561087612" rel="stylesheet">
-    <link href="/rbcli/css/fontawesome-all.min.css?1561087612" rel="stylesheet">
-    <link href="/rbcli/css/hybrid.css?1561087612" rel="stylesheet">
-    <link href="/rbcli/css/featherlight.min.css?1561087612" rel="stylesheet">
-    <link href="/rbcli/css/perfect-scrollbar.min.css?1561087612" rel="stylesheet">
-    <link href="/rbcli/css/auto-complete.css?1561087612" rel="stylesheet">
-    <link href="/rbcli/css/atom-one-dark-reasonable.css?1561087612" rel="stylesheet">
-    <link href="/rbcli/css/theme.css?1561087612" rel="stylesheet">
-    <link href="/rbcli/css/hugo-theme.css?1561087612" rel="stylesheet">
+    <link href="/rbcli/css/nucleus.css?1596148729" rel="stylesheet">
+    <link href="/rbcli/css/fontawesome-all.min.css?1596148729" rel="stylesheet">
+    <link href="/rbcli/css/hybrid.css?1596148729" rel="stylesheet">
+    <link href="/rbcli/css/featherlight.min.css?1596148729" rel="stylesheet">
+    <link href="/rbcli/css/perfect-scrollbar.min.css?1596148729" rel="stylesheet">
+    <link href="/rbcli/css/auto-complete.css?1596148729" rel="stylesheet">
+    <link href="/rbcli/css/atom-one-dark-reasonable.css?1596148729" rel="stylesheet">
+    <link href="/rbcli/css/theme.css?1596148729" rel="stylesheet">
+    <link href="/rbcli/css/hugo-theme.css?1596148729" rel="stylesheet">
+    <link href="/rbcli/css/theme-blue.css?1596148729" rel="stylesheet">
-      <link href="/rbcli/css/theme-blue.css?1561087612" rel="stylesheet">
-    <script src="/rbcli/js/jquery-3.3.1.min.js?1561087612"></script>
+    <script src="/rbcli/js/jquery-3.3.1.min.js?1596148729"></script>
     <style>
       :root #header + #content > #left > #rlblock_left{
@@ -54,14 +55,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
-<script type="text/javascript" src="/rbcli/js/lunr.min.js?1561087612"></script>
-<script type="text/javascript" src="/rbcli/js/auto-complete.js?1561087612"></script>
+<script type="text/javascript" src="/rbcli/js/lunr.min.js?1596148729"></script>
+<script type="text/javascript" src="/rbcli/js/auto-complete.js?1596148729"></script>
 <script type="text/javascript">
         var baseurl = "https:\/\/akhoury6.github.io\/rbcli\/";
 </script>
-<script type="text/javascript" src="/rbcli/js/search.js?1561087612"></script>
+<script type="text/javascript" src="/rbcli/js/search.js?1596148729"></script>
   </div>
@@ -74,6 +75,8 @@
@@ -96,6 +99,8 @@
@@ -121,6 +126,8 @@
@@ -140,6 +147,8 @@
@@ -159,6 +168,8 @@
@@ -178,6 +189,8 @@
@@ -197,6 +210,8 @@
@@ -223,6 +238,8 @@
@@ -248,6 +265,8 @@
@@ -267,6 +286,8 @@
@@ -286,6 +307,8 @@
@@ -305,6 +328,8 @@
@@ -324,6 +349,8 @@
@@ -343,6 +370,8 @@
@@ -362,6 +391,8 @@
@@ -381,6 +412,8 @@
@@ -400,6 +433,8 @@
@@ -426,6 +461,8 @@
@@ -451,6 +488,8 @@
@@ -470,6 +509,8 @@
@@ -489,6 +530,8 @@
@@ -508,6 +551,8 @@
@@ -534,6 +579,8 @@
@@ -585,7 +632,6 @@
         <section id="body">
         <div id="overlay"></div>
         <div class="padding highlightable">
@@ -619,9 +665,9 @@
             <a href='/rbcli/'></a> > <a href='/rbcli/tutorial/'>Tutorial</a> > The Project Layout
@@ -631,20 +677,18 @@
                     <div class="progress">
     <div class="wrapper">
 <nav id="TableOfContents">
-<ul>
-<li>
-<ul>
-<li><a href="#project-initialization-types">Project Initialization Types</a>
-<ul>
-<li><a href="#project-mode">Project Mode</a></li>
-<li><a href="#mini-micro-modes">Mini &amp; Micro Modes</a></li>
-</ul></li>
-<li><a href="#project-mode-structure">Project Mode Structure</a></li>
-<li><a href="#git-rubygems-and-rspec">Git, RubyGems, and rspec</a></li>
-<li><a href="#rbcli-folders">RBCli Folders</a></li>
-<li><a href="#next-steps">Next Steps</a></li>
-</ul></li>
-</ul>
+  <ul>
+    <li><a href="#project-initialization-types">Project Initialization Types</a>
+      <ul>
+        <li><a href="#project-mode">Project Mode</a></li>
+        <li><a href="#mini--micro-modes">Mini &amp; Micro Modes</a></li>
+      </ul>
+    </li>
+    <li><a href="#project-mode-structure">Project Mode Structure</a></li>
+    <li><a href="#git-rubygems-and-rspec">Git, RubyGems, and rspec</a></li>
+    <li><a href="#rbcli-folders">RBCli Folders</a></li>
+    <li><a href="#next-steps">Next Steps</a></li>
+  </ul>
 </nav>
     </div>
 </div>
@@ -668,50 +712,29 @@
 <p>Now we will learn about what an RBCli project looks like and how to start using it.</p>
 <h2 id="project-initialization-types">Project Initialization Types</h2>
 <p>RBCli can initialize a tool in three different modes:</p>
 <ul>
 <li>Project Mode (default)</li>
 <li>Mini Mode</li>
 <li>Micro Mode</li>
 </ul>
 <h3 id="project-mode">Project Mode</h3>
 <p>If you&rsquo;ve been following along with the tutorial, you&rsquo;ve already seen Project Mode. An RBCli Project consists of several folders, each of which has a specific function. The RBCli framework handles loading and parsing the code automatically. To generate a standard, full-featured RBCli project, run:</p>
-<pre><code class="language-bash">rbcli init -n mytool
-</code></pre>
-<p>where <code>mytool</code> can be replaced with any other command name you&rsquo;d like. (We will continue using <code>mytool</code> in this tutorial though!)</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">rbcli init -n mytool
+</code></pre></div><p>where <code>mytool</code> can be replaced with any other command name you&rsquo;d like. (We will continue using <code>mytool</code> in this tutorial though!)</p>
 <p>Inside the newly created <code>mytool</code> folder you will see a bunch of files and folders related to your project. We will go over the structure later.</p>
-<h3 id="mini-micro-modes">Mini &amp; Micro Modes</h3>
+<h3 id="mini--micro-modes">Mini &amp; Micro Modes</h3>
 <p>If you need to write a CLI tool but project mode feels a bit overkill for you &ndash; if you think a single-file script is all that is needed &ndash; that&rsquo;s where the Mini and Micro modes come in. Instead of generating a full directory tree, you get only a single file that contains most of the functionality of RBCli. To use it, run:</p>
-<pre><code class="language-bash">rbcli init -n mytool -t mini
-# or
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">rbcli init -n mytool -t mini
+<span style="color:#75715e"># or</span>
 rbcli init -n mytool -t micro
-</code></pre>
-<p>The only difference between the two is that <code>mini</code> will show you all available options and some documentation to help you, while <code>micro</code> is for advanced users who just want the samllest file possible.</p>
+</code></pre></div><p>The only difference between the two is that <code>mini</code> will show you all available options and some documentation to help you, while <code>micro</code> is for advanced users who just want the samllest file possible.</p>
 <p>As far as documentation goes, every piece of code present in those files is identical to Project mode so it should be pretty easy to navigate.</p>
 <h2 id="project-mode-structure">Project Mode Structure</h2>
 <p>An RBCli project has the following structure:</p>
-<pre><code class="language-text">&lt;name&gt;/
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-text" data-lang="text">&lt;name&gt;/
 |--- application/
 |   |--- commands/
 |   |   |--- scripts/
@@ -733,111 +756,99 @@ rbcli init -n mytool -t micro
 |--- README.md
 |--- Rakefile
 |--- &lt;name&gt;.gemspec
-</code></pre>
-<h2 id="git-rubygems-and-rspec">Git, RubyGems, and rspec</h2>
+</code></pre></div><h2 id="git-rubygems-and-rspec">Git, RubyGems, and rspec</h2>
 <p>A few files aren&rsquo;t part of RBCli itself, but are provided for your convenience. If you&rsquo;re experienced in Ruby and Git you can skip over this.</p>
 <ul>
 <li><code>.gitignore</code>
 <ul>
 <li>Specifies which files to ignore in git. If you don&rsquo;t use git you can delete this file</li>
-</ul></li>
+</ul>
+</li>
 <li><code>.rspec</code>
 <ul>
 <li>Configures Rspec for testing your code</li>
-</ul></li>
+</ul>
+</li>
 <li><code>Gemfile</code>
 <ul>
 <li>Allows declaring dependencies for when your users install your application</li>
-</ul></li>
+</ul>
+</li>
 <li><code>Gemspec</code>
 <ul>
 <li>Same as above, but also lets you fill in more information so that you can publish your application as a gem</li>
-</ul></li>
+</ul>
+</li>
 <li><code>README.md</code>
 <ul>
 <li>A skeleton README file that will appear as a front page documentation to your code in most source control systems (i.e. Github, Bitbucket)</li>
-</ul></li>
+</ul>
+</li>
 <li><code>CODE_OF_CONDUCT.md</code>
 <ul>
 <li>Taken directly from the <a href="http://contributor-covenant.org">contributor covenant</a> for your convenience</li>
-</ul></li>
+</ul>
+</li>
 <li><code>Rakefile</code>
 <ul>
 <li>So you can run rspec tests as a rake task</li>
-</ul></li>
 </ul>
+</li>
+</ul>
 <p>There is a lot of controvesy online regarding using the <code>gemfile</code> vs the <code>gemspec</code>. If you are new to Ruby in general then I suggest declaring your dependencies in the gemspec and leaving the <code>gemfile</code> as-is. This keeps things simple and allows publishing and distributing your tool as a gem.</p>
 <p>Additionally, note that a git repo is not created automatically. Using git is out of scope of this tutorial, but you can find tutorials <a href="https://www.tutorialspoint.com/git/">here</a>.</p>
 <h2 id="rbcli-folders">RBCli Folders</h2>
 <ul>
 <li><code>application/</code>
 <ul>
 <li>This is where the core of your application will live. You will define CLI options, commands, scripts, and hooks within this folder.</li>
-</ul></li>
+</ul>
+</li>
 <li><code>config/</code>
 <ul>
 <li>This folder contains the configuration for RBCli&rsquo;s features; such as storage, logging, and automatic updates.</li>
-</ul></li>
+</ul>
+</li>
 <li><code>exe/</code>
 <ul>
 <li>This folder contains the executable for your tool. You should not edit it; doing so may lead to unexpected behavior.</li>
-</ul></li>
+</ul>
+</li>
 <li><code>hooks/</code>
 <ul>
 <li>RBCli has several hooks that can be used to run code at different times, such as the &lsquo;default&rsquo; code that is run when no command is selected. This is where they are placed.</li>
-</ul></li>
+</ul>
+</li>
 <li><code>lib/</code>
 <ul>
 <li>This folder is for you to write any additional code as you see fit, for importing into your commands, scripts, and hooks. It is automatically added to the $LOAD_PATH for you, so you can just use require statements like <code>require 'abc.rb'</code>  without worrying about where they are located on the filesystem.</li>
-</ul></li>
+</ul>
+</li>
 <li><code>userconf/</code>
 <ul>
 <li>This folder is for you to place the layout and defaults of any userspace config file. Acceptable formats are yaml and json, though we recommend YAML since it is by far easier to read and supports comments.</li>
-</ul></li>
+</ul>
+</li>
 <li><code>spec/</code>
 <ul>
 <li>This folder is for your rspec tests.</li>
-</ul></li>
+</ul>
+</li>
 <li><code>.rbcli</code>
 <ul>
 <li>This file is for internal use by RBCli. It should not be modified or deleted.</li>
-</ul></li>
 </ul>
+</li>
+</ul>
 <h2 id="next-steps">Next Steps</h2>
 <p>For the purposes of getting started right now, you don&rsquo;t actually need to edit any of the defaults already present.</p>
 <p>We just finished going through what an RBCli project looks like. Now let&rsquo;s create our first application with it!</p>
-<footer class=" footline" >
+<footer class="footline">
 </footer>
         </div>
@@ -1265,20 +1276,19 @@ rbcli init -n mytool -t micro
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/rbcli/js/clipboard.min.js?1561087612"></script>
-    <script src="/rbcli/js/perfect-scrollbar.min.js?1561087612"></script>
-    <script src="/rbcli/js/perfect-scrollbar.jquery.min.js?1561087612"></script>
-    <script src="/rbcli/js/jquery.sticky.js?1561087612"></script>
-    <script src="/rbcli/js/featherlight.min.js?1561087612"></script>
-    <script src="/rbcli/js/html5shiv-printshiv.min.js?1561087612"></script>
-    <script src="/rbcli/js/highlight.pack.js?1561087612"></script>
+    <script src="/rbcli/js/clipboard.min.js?1596148729"></script>
+    <script src="/rbcli/js/perfect-scrollbar.min.js?1596148729"></script>
+    <script src="/rbcli/js/perfect-scrollbar.jquery.min.js?1596148729"></script>
+    <script src="/rbcli/js/jquery.sticky.js?1596148729"></script>
+    <script src="/rbcli/js/featherlight.min.js?1596148729"></script>
+    <script src="/rbcli/js/highlight.pack.js?1596148729"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/rbcli/js/modernizr.custom-3.6.0.js?1561087612"></script>
-    <script src="/rbcli/js/learn.js?1561087612"></script>
-    <script src="/rbcli/js/hugo-learn.js?1561087612"></script>
+    <script src="/rbcli/js/modernizr.custom-3.6.0.js?1596148729"></script>
+    <script src="/rbcli/js/learn.js?1596148729"></script>
+    <script src="/rbcli/js/hugo-learn.js?1596148729"></script>
-    <link href="/rbcli/mermaid/mermaid.css?1561087612" rel="stylesheet" />
-    <script src="/rbcli/mermaid/mermaid.js?1561087612"></script>
+    <link href="/rbcli/mermaid/mermaid.css?1596148729" rel="stylesheet" />
+    <script src="/rbcli/mermaid/mermaid.js?1596148729"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>