RubyGems - rbcli - Versions diffs - 0.1.10 → 0.2.0 - Mend

rbcli 0.1.10 → 0.2.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 (129) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +31 -0
data/CODE_OF_CONDUCT.md +1 -1
data/Gemfile.lock +12 -12
data/LICENSE.txt +674 -21
data/README.md +80 -443
data/bin/console +19 -0
data/bin/setup +20 -0
data/docs/404.html +639 -0
data/docs/advanced/automatic_updates/index.html +791 -0
data/docs/advanced/command_types/index.html +946 -0
data/docs/advanced/distributed_state_locking/index.html +777 -0
data/docs/advanced/hooks/index.html +836 -0
data/docs/advanced/state_storage/index.html +957 -0
data/docs/advanced/user_config_files/index.html +818 -0
data/docs/assets/fonts/font-awesome.css +4 -0
data/docs/assets/fonts/material-icons.css +13 -0
data/docs/assets/fonts/specimen/FontAwesome.ttf +0 -0
data/docs/assets/fonts/specimen/FontAwesome.woff +0 -0
data/docs/assets/fonts/specimen/FontAwesome.woff2 +0 -0
data/docs/assets/fonts/specimen/MaterialIcons-Regular.ttf +0 -0
data/docs/assets/fonts/specimen/MaterialIcons-Regular.woff +0 -0
data/docs/assets/fonts/specimen/MaterialIcons-Regular.woff2 +0 -0
data/docs/assets/images/favicon.png +0 -0
data/docs/assets/images/icons/bitbucket.1b09e088.svg +20 -0
data/docs/assets/images/icons/github.f0b8504a.svg +18 -0
data/docs/assets/images/icons/gitlab.6dd19c00.svg +38 -0
data/docs/assets/javascripts/application.a59e2a89.js +1 -0
data/docs/assets/javascripts/lunr/lunr.da.js +1 -0
data/docs/assets/javascripts/lunr/lunr.de.js +1 -0
data/docs/assets/javascripts/lunr/lunr.du.js +1 -0
data/docs/assets/javascripts/lunr/lunr.es.js +1 -0
data/docs/assets/javascripts/lunr/lunr.fi.js +1 -0
data/docs/assets/javascripts/lunr/lunr.fr.js +1 -0
data/docs/assets/javascripts/lunr/lunr.hu.js +1 -0
data/docs/assets/javascripts/lunr/lunr.it.js +1 -0
data/docs/assets/javascripts/lunr/lunr.jp.js +1 -0
data/docs/assets/javascripts/lunr/lunr.multi.js +1 -0
data/docs/assets/javascripts/lunr/lunr.no.js +1 -0
data/docs/assets/javascripts/lunr/lunr.pt.js +1 -0
data/docs/assets/javascripts/lunr/lunr.ro.js +1 -0
data/docs/assets/javascripts/lunr/lunr.ru.js +1 -0
data/docs/assets/javascripts/lunr/lunr.stemmer.support.js +1 -0
data/docs/assets/javascripts/lunr/lunr.sv.js +1 -0
data/docs/assets/javascripts/lunr/lunr.tr.js +1 -0
data/docs/assets/javascripts/lunr/tinyseg.js +1 -0
data/docs/assets/javascripts/modernizr.1aa3b519.js +1 -0
data/docs/assets/stylesheets/application-palette.6079476c.css +2 -0
data/docs/assets/stylesheets/application.ba0fd1a6.css +2 -0
data/docs/development/code_of_conduct/index.html +883 -0
data/docs/development/contributing/index.html +744 -0
data/docs/development/license/index.html +715 -0
data/docs/imported/changelog/index.html +853 -0
data/docs/imported/quick_reference/index.html +1057 -0
data/docs/index.html +732 -0
data/docs/search/search_index.json +569 -0
data/docs/sitemap.xml +93 -0
data/docs/tutorial/10-getting_started/index.html +806 -0
data/docs/tutorial/20-project_layout/index.html +972 -0
data/docs/tutorial/30-your_first_command/index.html +906 -0
data/docs/tutorial/40-options_parameters_and_arguments/index.html +1049 -0
data/docs/tutorial/50-publishing/index.html +838 -0
data/docs/whoami/index.html +709 -0
data/docs-src/docs/advanced/automatic_updates.md +42 -0
data/docs-src/docs/advanced/command_types.md +144 -0
data/docs-src/docs/advanced/distributed_state_locking.md +33 -0
data/docs-src/docs/advanced/hooks.md +65 -0
data/docs-src/docs/advanced/logging.md +35 -0
data/docs-src/docs/advanced/state_storage.md +117 -0
data/docs-src/docs/advanced/user_config_files.md +47 -0
data/docs-src/docs/development/code_of_conduct.md +74 -0
data/docs-src/docs/development/contributing.md +49 -0
data/docs-src/docs/development/license.md +10 -0
data/docs-src/docs/imported/changelog.md +31 -0
data/docs-src/docs/imported/quick_reference.md +150 -0
data/docs-src/docs/index.md +38 -0
data/docs-src/docs/tutorial/10-getting_started.md +41 -0
data/docs-src/docs/tutorial/20-project_layout.md +115 -0
data/docs-src/docs/tutorial/30-your_first_command.md +126 -0
data/docs-src/docs/tutorial/40-options_parameters_and_arguments.md +251 -0
data/docs-src/docs/tutorial/50-publishing.md +47 -0
data/docs-src/docs/whoami.md +28 -0
data/docs-src/makesite.sh +14 -0
data/docs-src/mkdocs.yml +76 -0
data/docs-src/runsite.sh +3 -0
data/exe/rbcli +76 -5
data/lib/rbcli/autoupdate/autoupdate.rb +24 -4
data/lib/rbcli/autoupdate/gem_updater.rb +23 -2
data/lib/rbcli/autoupdate/github_updater.rb +22 -1
data/lib/rbcli/configuration/config.rb +22 -1
data/lib/rbcli/configuration/configurate.rb +24 -2
data/lib/rbcli/engine/command.rb +26 -6
data/lib/rbcli/engine/load_project.rb +29 -3
data/lib/rbcli/engine/parser.rb +25 -4
data/lib/rbcli/logging/logging.rb +21 -0
data/lib/rbcli/scriptwrapping/scriptwrapper.rb +30 -11
data/lib/rbcli/stateful_systems/configuratestorage.rb +20 -0
data/lib/rbcli/stateful_systems/state_storage.rb +20 -0
data/lib/rbcli/stateful_systems/storagetypes/localstate.rb +20 -0
data/lib/rbcli/stateful_systems/storagetypes/remote_state_connectors/dynamodb.rb +20 -0
data/lib/rbcli/stateful_systems/storagetypes/remotestate_dynamodb.rb +20 -0
data/lib/rbcli/util/hash_deep_symbolize.rb +43 -22
data/lib/rbcli/util/string_colorize.rb +20 -0
data/lib/rbcli/version.rb +21 -1
data/lib/rbcli-tool/generators.rb +20 -0
data/lib/rbcli-tool/mdless_fix.rb +20 -0
data/lib/rbcli-tool/project.rb +27 -2
data/lib/rbcli-tool/util.rb +20 -0
data/lib/rbcli-tool.rb +20 -0
data/lib/rbcli.rb +20 -0
data/lib-sh/lib-rbcli.sh +19 -0
data/rbcli.gemspec +22 -3
data/skeletons/project/CODE_OF_CONDUCT.md +1 -1
data/skeletons/project/README.md +17 -2
data/skeletons/project/application/commands/command.erb +10 -8
data/skeletons/project/application/commands/script.erb +3 -1
data/skeletons/project/application/commands/scripts/script.sh +2 -2
data/skeletons/project/application/options.rb +12 -3
data/skeletons/project/config/autoupdate.rb +5 -2
data/skeletons/project/config/storage.rb +7 -6
data/skeletons/project/config/userspace.rb +6 -1
data/skeletons/project/exe/executable +1 -1
data/skeletons/project/lib/.keep +0 -0
data/skeletons/project/untitled.gemspec +4 -4
data/skeletons/project/{default_user_configs → userconf}/user_defaults.yml +0 -0
metadata +85 -9
data/examples/defaults.yml +0 -4
data/examples/myscript.sh +0 -23
data/examples/mytool +0 -95

data/docs/advanced/state_storage/index.html ADDED Viewed

@@ -0,0 +1,957 @@
+<!DOCTYPE html>
+<html lang="en" class="no-js">
+  <head>
+      <meta charset="utf-8">
+      <meta name="viewport" content="width=device-width,initial-scale=1">
+      <meta http-equiv="x-ua-compatible" content="ie=edge">
+        <meta name="description" content="Description">
+        <meta name="author" content="Andrew Khoury">
+        <meta name="lang:clipboard.copy" content="Copy to clipboard">
+        <meta name="lang:clipboard.copied" content="Copied to clipboard">
+        <meta name="lang:search.language" content="en">
+        <meta name="lang:search.pipeline.stopwords" content="True">
+        <meta name="lang:search.pipeline.trimmer" content="True">
+        <meta name="lang:search.result.none" content="No matching documents">
+        <meta name="lang:search.result.one" content="1 matching document">
+        <meta name="lang:search.result.other" content="# matching documents">
+        <meta name="lang:search.tokenizer" content="[\s\-]+">
+      <link rel="shortcut icon" href="../../assets/images/favicon.png">
+      <meta name="generator" content="mkdocs-0.17.5, mkdocs-material-2.9.2">
+        <title>State Storage - RBCli Documentation</title>
+      <link rel="stylesheet" href="../../assets/stylesheets/application.ba0fd1a6.css">
+      <script src="../../assets/javascripts/modernizr.1aa3b519.js"></script>
+      <link href="https://fonts.gstatic.com" rel="preconnect" crossorigin>
+        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700|Roboto+Mono">
+        <style>body,input{font-family:"Roboto","Helvetica Neue",Helvetica,Arial,sans-serif}code,kbd,pre{font-family:"Roboto Mono","Courier New",Courier,monospace}</style>
+    <link rel="stylesheet" href="../../assets/fonts/material-icons.css">
+  </head>
+    <body dir="ltr">
+    <svg class="md-svg">
+      <defs>
+          <svg xmlns="http://www.w3.org/2000/svg" width="416" height="448"
+    viewBox="0 0 416 448" id="__github">
+  <path fill="currentColor" d="M160 304q0 10-3.125 20.5t-10.75 19-18.125
+        8.5-18.125-8.5-10.75-19-3.125-20.5 3.125-20.5 10.75-19 18.125-8.5
+        18.125 8.5 10.75 19 3.125 20.5zM320 304q0 10-3.125 20.5t-10.75
+        19-18.125 8.5-18.125-8.5-10.75-19-3.125-20.5 3.125-20.5 10.75-19
+        18.125-8.5 18.125 8.5 10.75 19 3.125 20.5zM360
+        304q0-30-17.25-51t-46.75-21q-10.25 0-48.75 5.25-17.75 2.75-39.25
+        2.75t-39.25-2.75q-38-5.25-48.75-5.25-29.5 0-46.75 21t-17.25 51q0 22 8
+        38.375t20.25 25.75 30.5 15 35 7.375 37.25 1.75h42q20.5 0
+        37.25-1.75t35-7.375 30.5-15 20.25-25.75 8-38.375zM416 260q0 51.75-15.25
+        82.75-9.5 19.25-26.375 33.25t-35.25 21.5-42.5 11.875-42.875 5.5-41.75
+        1.125q-19.5 0-35.5-0.75t-36.875-3.125-38.125-7.5-34.25-12.875-30.25-20.25-21.5-28.75q-15.5-30.75-15.5-82.75
+        0-59.25 34-99-6.75-20.5-6.75-42.5 0-29 12.75-54.5 27 0 47.5 9.875t47.25
+        30.875q36.75-8.75 77.25-8.75 37 0 70 8 26.25-20.5
+        46.75-30.25t47.25-9.75q12.75 25.5 12.75 54.5 0 21.75-6.75 42 34 40 34
+        99.5z" />
+</svg>
+      </defs>
+    </svg>
+    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
+    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
+    <label class="md-overlay" data-md-component="overlay" for="__drawer"></label>
+      <a href="#state-storage" tabindex="1" class="md-skip">
+        Skip to content
+      </a>
+      <header class="md-header" data-md-component="header">
+  <nav class="md-header-nav md-grid">
+    <div class="md-flex">
+      <div class="md-flex__cell md-flex__cell--shrink">
+        <a href="../.." title="RBCli Documentation" class="md-header-nav__button md-logo">
+            <i class="md-icon">devices</i>
+        </a>
+      </div>
+      <div class="md-flex__cell md-flex__cell--shrink">
+        <label class="md-icon md-icon--menu md-header-nav__button" for="__drawer"></label>
+      </div>
+      <div class="md-flex__cell md-flex__cell--stretch">
+        <div class="md-flex__ellipsis md-header-nav__title" data-md-component="title">
+              <span class="md-header-nav__topic">
+                RBCli Documentation
+              </span>
+              <span class="md-header-nav__topic">
+                State Storage
+              </span>
+        </div>
+      </div>
+      <div class="md-flex__cell md-flex__cell--shrink">
+            <label class="md-icon md-icon--search md-header-nav__button" for="__search"></label>
+<div class="md-search" data-md-component="search" role="dialog">
+  <label class="md-search__overlay" for="__search"></label>
+  <div class="md-search__inner" role="search">
+    <form class="md-search__form" name="search">
+      <input type="text" class="md-search__input" name="query" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="query" data-md-state="active">
+      <label class="md-icon md-search__icon" for="__search"></label>
+      <button type="reset" class="md-icon md-search__icon" data-md-component="reset" tabindex="-1">
+        &#xE5CD;
+      </button>
+    </form>
+    <div class="md-search__output">
+      <div class="md-search__scrollwrap" data-md-scrollfix>
+        <div class="md-search-result" data-md-component="result">
+          <div class="md-search-result__meta">
+            Type to start searching
+          </div>
+          <ol class="md-search-result__list"></ol>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+      </div>
+        <div class="md-flex__cell md-flex__cell--shrink">
+          <div class="md-header-nav__source">
+  <a href="https://github.com/akhoury6/rbcli/" title="Go to repository" class="md-source" data-md-source="github">
+      <div class="md-source__icon">
+        <svg viewBox="0 0 24 24" width="24" height="24">
+          <use xlink:href="#__github" width="24" height="24"></use>
+        </svg>
+      </div>
+    <div class="md-source__repository">
+      GitHub
+    </div>
+  </a>
+          </div>
+        </div>
+    </div>
+  </nav>
+</header>
+    <div class="md-container">
+<nav class="md-tabs md-tabs--active" data-md-component="tabs">
+  <div class="md-tabs__inner md-grid">
+    <ul class="md-tabs__list">
+  <li class="md-tabs__item">
+      <a href="../.." title="Home" class="md-tabs__link">
+        Home
+      </a>
+  </li>
+    <li class="md-tabs__item">
+        <a href="../../tutorial/10-getting_started/" title="Tutorial" class="md-tabs__link">
+          Tutorial
+        </a>
+    </li>
+    <li class="md-tabs__item">
+        <a href="../command_types/" title="Advanced Features" class="md-tabs__link md-tabs__link--active">
+          Advanced Features
+        </a>
+    </li>
+    <li class="md-tabs__item">
+        <a href="../../development/contributing/" title="Development" class="md-tabs__link">
+          Development
+        </a>
+    </li>
+    </ul>
+  </div>
+</nav>
+      <main class="md-main">
+        <div class="md-main__inner md-grid" data-md-component="container">
+              <div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    <nav class="md-nav md-nav--primary" data-md-level="0">
+  <label class="md-nav__title md-nav__title--site" for="__drawer">
+    <span class="md-nav__button md-logo">
+        <i class="md-icon">devices</i>
+    </span>
+    RBCli Documentation
+  </label>
+    <div class="md-nav__source">
+  <a href="https://github.com/akhoury6/rbcli/" title="Go to repository" class="md-source" data-md-source="github">
+      <div class="md-source__icon">
+        <svg viewBox="0 0 24 24" width="24" height="24">
+          <use xlink:href="#__github" width="24" height="24"></use>
+        </svg>
+      </div>
+    <div class="md-source__repository">
+      GitHub
+    </div>
+  </a>
+    </div>
+  <ul class="md-nav__list" data-md-scrollfix>
+  <li class="md-nav__item">
+    <a href="../.." title="Home" class="md-nav__link">
+      Home
+    </a>
+  </li>
+  <li class="md-nav__item">
+    <a href="../../imported/quick_reference/" title="Quick Reference" class="md-nav__link">
+      Quick Reference
+    </a>
+  </li>
+  <li class="md-nav__item md-nav__item--nested">
+      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3">
+    <label class="md-nav__link" for="nav-3">
+      Tutorial
+    </label>
+    <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
+      <label class="md-nav__title" for="nav-3">
+        Tutorial
+      </label>
+      <ul class="md-nav__list" data-md-scrollfix>
+  <li class="md-nav__item">
+    <a href="../../tutorial/10-getting_started/" title="Getting Started" class="md-nav__link">
+      Getting Started
+    </a>
+  </li>
+  <li class="md-nav__item">
+    <a href="../../tutorial/20-project_layout/" title="The Project Layout" class="md-nav__link">
+      The Project Layout
+    </a>
+  </li>
+  <li class="md-nav__item">
+    <a href="../../tutorial/30-your_first_command/" title="Your First Command" class="md-nav__link">
+      Your First Command
+    </a>
+  </li>
+  <li class="md-nav__item">
+    <a href="../../tutorial/40-options_parameters_and_arguments/" title="Options, Parameters, and Arguments" class="md-nav__link">
+      Options, Parameters, and Arguments
+    </a>
+  </li>
+  <li class="md-nav__item">
+    <a href="../../tutorial/50-publishing/" title="Publishing and Distribution" class="md-nav__link">
+      Publishing and Distribution
+    </a>
+  </li>
+      </ul>
+    </nav>
+  </li>
+  <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4" checked>
+    <label class="md-nav__link" for="nav-4">
+      Advanced Features
+    </label>
+    <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
+      <label class="md-nav__title" for="nav-4">
+        Advanced Features
+      </label>
+      <ul class="md-nav__list" data-md-scrollfix>
+  <li class="md-nav__item">
+    <a href="../command_types/" title="Command Types" class="md-nav__link">
+      Command Types
+    </a>
+  </li>
+  <li class="md-nav__item">
+    <a href="../user_config_files/" title="User Config Files" class="md-nav__link">
+      User Config Files
+    </a>
+  </li>
+  <li class="md-nav__item">
+    <a href="../hooks/" title="Hooks" class="md-nav__link">
+      Hooks
+    </a>
+  </li>
+  <li class="md-nav__item">
+    <a href="../automatic_updates/" title="Automatic Updates" class="md-nav__link">
+      Automatic Updates
+    </a>
+  </li>
+  <li class="md-nav__item md-nav__item--active">
+    <input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc">
+      <label class="md-nav__link md-nav__link--active" for="__toc">
+        State Storage
+      </label>
+    <a href="./" title="State Storage" class="md-nav__link md-nav__link--active">
+      State Storage
+    </a>
+<nav class="md-nav md-nav--secondary">
+    <label class="md-nav__title" for="__toc">Table of contents</label>
+    <ul class="md-nav__list" data-md-scrollfix>
+        <li class="md-nav__item">
+  <a href="#local-state" title="Local State" class="md-nav__link">
+    Local State
+  </a>
+    <nav class="md-nav">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#configuration" title="Configuration" class="md-nav__link">
+    Configuration
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#access-and-usage" title="Access and Usage" class="md-nav__link">
+    Access and Usage
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+        <li class="md-nav__item">
+  <a href="#remote-state" title="Remote State" class="md-nav__link">
+    Remote State
+  </a>
+    <nav class="md-nav">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#configuration_1" title="Configuration" class="md-nav__link">
+    Configuration
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#access-and-usage_1" title="Access and Usage" class="md-nav__link">
+    Access and Usage
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+    </ul>
+</nav>
+  </li>
+  <li class="md-nav__item">
+    <a href="../distributed_state_locking/" title="Distributed State Locking" class="md-nav__link">
+      Distributed State Locking
+    </a>
+  </li>
+      </ul>
+    </nav>
+  </li>
+  <li class="md-nav__item md-nav__item--nested">
+      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5">
+    <label class="md-nav__link" for="nav-5">
+      Development
+    </label>
+    <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
+      <label class="md-nav__title" for="nav-5">
+        Development
+      </label>
+      <ul class="md-nav__list" data-md-scrollfix>
+  <li class="md-nav__item">
+    <a href="../../development/contributing/" title="Contribution Guide" class="md-nav__link">
+      Contribution Guide
+    </a>
+  </li>
+  <li class="md-nav__item">
+    <a href="../../development/license/" title="License Info" class="md-nav__link">
+      License Info
+    </a>
+  </li>
+  <li class="md-nav__item">
+    <a href="../../development/code_of_conduct/" title="Code of Conduct" class="md-nav__link">
+      Code of Conduct
+    </a>
+  </li>
+  <li class="md-nav__item">
+    <a href="../../imported/changelog/" title="Changelog" class="md-nav__link">
+      Changelog
+    </a>
+  </li>
+      </ul>
+    </nav>
+  </li>
+  <li class="md-nav__item">
+    <a href="../../whoami/" title="$ whoami" class="md-nav__link">
+      $ whoami
+    </a>
+  </li>
+  </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+              <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+<nav class="md-nav md-nav--secondary">
+    <label class="md-nav__title" for="__toc">Table of contents</label>
+    <ul class="md-nav__list" data-md-scrollfix>
+        <li class="md-nav__item">
+  <a href="#local-state" title="Local State" class="md-nav__link">
+    Local State
+  </a>
+    <nav class="md-nav">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#configuration" title="Configuration" class="md-nav__link">
+    Configuration
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#access-and-usage" title="Access and Usage" class="md-nav__link">
+    Access and Usage
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+        <li class="md-nav__item">
+  <a href="#remote-state" title="Remote State" class="md-nav__link">
+    Remote State
+  </a>
+    <nav class="md-nav">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#configuration_1" title="Configuration" class="md-nav__link">
+    Configuration
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#access-and-usage_1" title="Access and Usage" class="md-nav__link">
+    Access and Usage
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+    </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+          <div class="md-content">
+            <article class="md-content__inner md-typeset">
+                <h1 id="state-storage">State Storage</h1>
+<p>RBCli supports both local and remote state storage. This is done by synchronizing a Hash with either the local disk or a remote database.</p>
+<h2 id="local-state">Local State</h2>
+<p>RBCli's local state storage gives you access to a hash that is automatically persisted to disk when changes are made.</p>
+<h3 id="configuration">Configuration</h3>
+<p>You can configure it in <code>config/storage.rb</code>.</p>
+<pre><code class="ruby">local_state '/var/mytool/localstate', force_creation: true, halt_on_error: true
+</code></pre>
+<p>There are three parameters to configure it with:</p>
+<ul>
+<li>The <code>path</code> as a string (self-explanatory)</li>
+<li><code>force_creation</code><ul>
+<li>This will attempt to create the path and file if it does not exist (equivalent to an <code>mkdir -p</code> and <code>touch</code> in linux)</li>
+</ul>
+</li>
+<li><code>halt_on_error</code><ul>
+<li>RBCli's default behavior is to raise an exception if the file can not be created, read, or updated at any point in time</li>
+<li>If this is set to <code>false</code>, RBCli will silence any errors pertaining to file access and will fall back to whatever data is available. Note that if this is enabled, changes made to the state may not be persisted to disk.<ul>
+<li>If creation fails and file does not exist, you start with an empty hash</li>
+<li>If file exists but can't be read, you will have an empty hash</li>
+<li>If file can be read but not written, the hash will be populated with the data. Writes will be stored in memory while the application is running, but will not be persisted to disk.</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+<h3 id="access-and-usage">Access and Usage</h3>
+<p>Once configured you can access it with a standard hash syntax in your Standard Commands:</p>
+<pre><code class="ruby">Rbcli.local_state[:yourkeyhere]
+</code></pre>
+<p>The methods available for use at the top level are as follows:</p>
+<p>Hash native methods:</p>
+<ul>
+<li><code>[]</code> (Regular hash syntax. Keys are accessed via either symbols or strings indifferently.)</li>
+<li><code>[]=</code> (Assignment operator)</li>
+<li><code>delete</code></li>
+<li><code>each</code></li>
+<li><code>key?</code></li>
+</ul>
+<p>Additional methods:</p>
+<ul>
+<li><code>commit</code><ul>
+<li>Every assignment to the top level of the hash will result in a write to disk (for example: <code>Rbcli.local_state[:yourkey] = 'foo'</code>). However, if you are manipulating nested hashes, these saves will not be triggered. You can trigger them manually by calling <code>commit</code>.</li>
+</ul>
+</li>
+<li><code>clear</code><ul>
+<li>Resets the data back to an empty hash.</li>
+</ul>
+</li>
+<li><code>refresh</code><ul>
+<li>Loads the most current version of the data from the disk</li>
+</ul>
+</li>
+<li><code>disconnect</code><ul>
+<li>Removes the data from memory and sets <code>Rbcli.local_state = nil</code>. Data will be read from disk again on next access.</li>
+</ul>
+</li>
+</ul>
+<p>Every assignment will result in a write to disk, so if an operation will require a large number of assignments/writes it should be performed to a different hash before beign assigned to this one.</p>
+<h2 id="remote-state">Remote State</h2>
+<p>RBCli's remote state storage gives you access to a hash that is automatically persisted to a remote storage location when changes are made. It has optional locking built-in, meaning that multiple users may share remote state without any data consistency issues.</p>
+<p>Currently, this feature requires AWS DynamoDB, though other backend systems will be added in the future.</p>
+<h3 id="configuration_1">Configuration</h3>
+<p>Before DynamoDB can be used, AWS API credentials have to be created and made available. RBCli will attempt to find credentials from the following locations in order:</p>
+<ol>
+<li>User's config file</li>
+<li>Environment variables <code>AWS_ACCESS_KEY_ID</code> and <code>AWS_SECRET_ACCESS_KEY</code></li>
+<li>User's AWSCLI configuration at <code>~/.aws/credentials</code></li>
+</ol>
+<p>For more information about generating and storing AWS credentials, see <a href="https://docs.aws.amazon.com/sdk-for-ruby/v3/developer-guide/setup-config.html">Configuring the AWS SDK for Ruby</a>. Please make sure that your users are aware that they will need to provide their own credentials to use this feature.</p>
+<p>You can configure it in <code>config/storage.rb</code>.</p>
+<pre><code class="ruby">remote_state_dynamodb table_name: 'mytable', region: 'us-east-1', force_creation: true, halt_on_error: true, locking: false
+</code></pre>
+<p>These are the parameters:</p>
+<ul>
+<li><code>table_name</code><ul>
+<li>The name of the DynamoDB table to use.</li>
+</ul>
+</li>
+<li><code>region</code><ul>
+<li>The AWS region that the database is located</li>
+</ul>
+</li>
+<li><code>force_creation</code><ul>
+<li>Creates the DynamoDB table if it does not already exist</li>
+</ul>
+</li>
+<li><code>halt_on_error</code><ul>
+<li>Similar to the way <a href="#local-state">Local State</a> works, setting this to <code>false</code> will silence any errors in connecting to the DynamoDB table. Instead, your application will simply have access to an empty hash that does not get persisted anywhere.</li>
+<li>This is good for use cases that involve using this storage as a cache, where a connection error might mean the feature doesn't work but its not important enough to interrupt the user.</li>
+</ul>
+</li>
+<li><code>locking</code><ul>
+<li>Setting this to <code>true</code> enables locking, meaning only one instance of your application can access the shared data at any given time. For more information see <a href="../distributed_state_locking/">Distributed State Locking</a>.</li>
+</ul>
+</li>
+</ul>
+<h3 id="access-and-usage_1">Access and Usage</h3>
+<p>Once configured you can access it with a standard hash syntax:</p>
+<pre><code class="ruby">Rbcli.remote_state[:yourkeyhere]
+</code></pre>
+<p>This works the same way that <a href="#local-state">Local State</a> does, with the same performance caveats (try not to write too frequently).</p>
+<p>Note that all state in Rbcli is <strong>lazy-loaded</strong>, so no connections will be made until your code attempts to access the data even if the feature is enabled.</p>
+<p>For more information on the available commands, see the documentation on <a href="#local-state">Local State</a></p>
+            </article>
+          </div>
+        </div>
+      </main>
+<footer class="md-footer">
+    <div class="md-footer-nav">
+      <nav class="md-footer-nav__inner md-grid">
+          <a href="../automatic_updates/" title="Automatic Updates" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
+            <div class="md-flex__cell md-flex__cell--shrink">
+              <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
+            </div>
+            <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
+              <span class="md-flex__ellipsis">
+                <span class="md-footer-nav__direction">
+                  Previous
+                </span>
+                Automatic Updates
+              </span>
+            </div>
+          </a>
+          <a href="../distributed_state_locking/" title="Distributed State Locking" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
+            <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
+              <span class="md-flex__ellipsis">
+                <span class="md-footer-nav__direction">
+                  Next
+                </span>
+                Distributed State Locking
+              </span>
+            </div>
+            <div class="md-flex__cell md-flex__cell--shrink">
+              <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
+            </div>
+          </a>
+      </nav>
+    </div>
+  <div class="md-footer-meta md-typeset">
+    <div class="md-footer-meta__inner md-grid">
+      <div class="md-footer-copyright">
+          <div class="md-footer-copyright__highlight">
+            Copyright © 2018 Andrew Khoury
+          </div>
+        powered by
+        <a href="https://www.mkdocs.org">MkDocs</a>
+        and
+        <a href="https://squidfunk.github.io/mkdocs-material/">
+          Material for MkDocs</a>
+      </div>
+    </div>
+  </div>
+</footer>
+    </div>
+      <script src="../../assets/javascripts/application.a59e2a89.js"></script>
+      <script>app.initialize({version:"0.17.5",url:{base:"../.."}})</script>
+  </body>
+</html>