hashematics 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5007851850b8910d16671bd8c72ed343c257f64e389e177fe1eaa50a98b118a7
+  data.tar.gz: d3104c63ea0b0e641996c35f363dc8aaf53816ba0824fdfc40a248689124b9d9
+SHA512:
+  metadata.gz: 7a5309d785c85d5a0899854f462bfa8d6eebc3802317dedbe58b48f4d9d91b6b64b39583e4389082b9c4d0355130afb7cb359060e2849c29e5d180b0f6ce8d95
+  data.tar.gz: 7eac28ed9ffee6374cbc08585f6d3e985c3d9f0f393b7b0c6993c631282047f16dc718d27b2dd1d1fbd7f789d13b8dd0558e881f77b298a7ecda7906c7f4bbac

data/.editorconfig

@@ -0,0 +1,8 @@
+# See http://editorconfig.org/
+
+[*]
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+end_of_line = lf

data/.gitignore

@@ -0,0 +1,4 @@
+.DS_Store
+*.gem
+/tmp
+/coverage

data/.rubocop.yml

@@ -0,0 +1,11 @@
+Metrics/LineLength:
+  Max: 100
+
+Metrics/BlockLength:
+  ExcludedMethods: ['let', 'it', 'describe', 'context', 'specify']
+
+Metrics/MethodLength:
+  Max: 25
+
+AllCops:
+  TargetRubyVersion: 2.3

data/.ruby-version

@@ -0,0 +1 @@
+2.6.0

data/.travis.yml

@@ -0,0 +1,20 @@
+env:
+  global:
+    - CC_TEST_REPORTER_ID=da9fc61f4ee94591c463b7fc0b8088e1eb5f26feaa95b5b08890959a5e9cc3b6
+language: ruby
+rvm:
+  # Build on the latest stable of all supported Rubies (https://www.ruby-lang.org/en/downloads/):
+  - 2.3.8
+  - 2.4.5
+  - 2.5.3
+  - 2.6.0
+cache: bundler
+before_script:
+  - curl -L https://codeclimate.com/downloads/test-reporter/test-reporter-latest-linux-amd64 > ./cc-test-reporter
+  - chmod +x ./cc-test-reporter
+  - ./cc-test-reporter before-build
+script:
+  - bundle exec rubocop
+  - bundle exec rspec spec --format documentation
+after_script:
+  - ./cc-test-reporter after-build --exit-code $TRAVIS_TEST_RESULT

data/CHANGELOG.md

@@ -0,0 +1,7 @@
+# 1.0.0 (March 27th, 2019)
+
+Initial Release
+
+# 0.0.1 (March 14th, 2019)
+
+Library Shell.

data/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,123 @@
+PATH
+  remote: .
+  specs:
+    hashematics (1.0.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    Ascii85 (1.0.3)
+    afm (0.2.2)
+    ansi (1.5.0)
+    ast (2.4.0)
+    coderay (1.1.2)
+    concurrent-ruby (1.1.5)
+    diff-lcs (1.3)
+    docile (1.3.1)
+    faker (1.9.3)
+      i18n (>= 0.7)
+    ffi (1.9.25)
+    formatador (0.2.5)
+    guard (2.15.0)
+      formatador (>= 0.2.4)
+      listen (>= 2.7, < 4.0)
+      lumberjack (>= 1.0.12, < 2.0)
+      nenv (~> 0.1)
+      notiffany (~> 0.0)
+      pry (>= 0.9.12)
+      shellany (~> 0.0)
+      thor (>= 0.18.1)
+    guard-compat (1.2.1)
+    guard-rspec (4.7.3)
+      guard (~> 2.1)
+      guard-compat (~> 1.1)
+      rspec (>= 2.99.0, < 4.0)
+    hashery (2.1.2)
+    hirb (0.7.3)
+    i18n (1.6.0)
+      concurrent-ruby (~> 1.0)
+    jaro_winkler (1.5.2)
+    json (2.1.0)
+    listen (3.1.5)
+      rb-fsevent (~> 0.9, >= 0.9.4)
+      rb-inotify (~> 0.9, >= 0.9.7)
+      ruby_dep (~> 1.2)
+    lumberjack (1.0.13)
+    method_source (0.9.2)
+    nenv (0.3.0)
+    notiffany (0.1.1)
+      nenv (~> 0.1)
+      shellany (~> 0.0)
+    parallel (1.13.0)
+    parser (2.6.0.0)
+      ast (~> 2.4.0)
+    pdf-inspector (1.3.0)
+      pdf-reader (>= 1.0, < 3.0.a)
+    pdf-reader (2.2.0)
+      Ascii85 (~> 1.0.0)
+      afm (~> 0.2.1)
+      hashery (~> 2.0)
+      ruby-rc4
+      ttfunk
+    powerpack (0.1.2)
+    pry (0.12.2)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    rainbow (3.0.0)
+    rb-fsevent (0.10.3)
+    rb-inotify (0.9.10)
+      ffi (>= 0.5.0, < 2)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.0)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-mocks (3.8.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.0)
+    rubocop (0.63.1)
+      jaro_winkler (~> 1.5.1)
+      parallel (~> 1.10)
+      parser (>= 2.5, != 2.5.1.1)
+      powerpack (~> 0.1)
+      rainbow (>= 2.2.2, < 4.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (~> 1.4.0)
+    ruby-progressbar (1.10.0)
+    ruby-rc4 (0.1.5)
+    ruby_dep (1.5.0)
+    shellany (0.0.1)
+    simplecov (0.16.1)
+      docile (~> 1.1)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-console (0.4.2)
+      ansi
+      hirb
+      simplecov
+    simplecov-html (0.10.2)
+    thor (0.20.3)
+    ttfunk (1.5.1)
+    unicode-display_width (1.4.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  faker (~> 1)
+  guard-rspec (~> 4.7)
+  hashematics!
+  pdf-inspector (~> 1)
+  pry (~> 0)
+  rspec (~> 3.8)
+  rubocop (~> 0.63.1)
+  simplecov (~> 0.16.1)
+  simplecov-console (~> 0.4.2)
+
+BUNDLED WITH
+   1.17.3

data/Guardfile

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+guard :rspec, cmd: 'bundle exec rspec' do
+  require 'guard/rspec/dsl'
+  dsl = Guard::RSpec::Dsl.new(self)
+
+  # RSpec files
+  rspec = dsl.rspec
+  watch(rspec.spec_helper) { rspec.spec_dir }
+  watch(rspec.spec_support) { rspec.spec_dir }
+  watch(rspec.spec_files)
+
+  # Ruby files
+  ruby = dsl.ruby
+  dsl.watch_spec_files_for(ruby.lib_files)
+end

data/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2019 Blue Marble Payroll, LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,660 @@
+# Hashematics
+
+[![Gem Version](https://badge.fury.io/rb/hashematics.svg)](https://badge.fury.io/rb/hashematics) [![Build Status](https://travis-ci.org/bluemarblepayroll/hashematics.svg?branch=master)](https://travis-ci.org/bluemarblepayroll/hashematics) [![Maintainability](https://api.codeclimate.com/v1/badges/a171325c301e58eb4fb0/maintainability)](https://codeclimate.com/github/bluemarblepayroll/hashematics/maintainability) [![Test Coverage](https://api.codeclimate.com/v1/badges/a171325c301e58eb4fb0/test_coverage)](https://codeclimate.com/github/bluemarblepayroll/hashematics/test_coverage) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Hashematics is a configuration-based object graphing tool which can turn a flat, single dimensional dataset into a structure of deeply nested objects.
+
+## Installation
+
+To install through Rubygems:
+
+````
+gem install install hashematics
+````
+
+You can also add this to your Gemfile:
+
+````
+bundle add hashematics
+````
+
+## Examples
+
+### Getting Started
+
+Take the following simple, non-nested data set:
+
+id | first | last
+-- | ----- | ------
+1  | Bruce | Banner
+2  | Tony  | Stark
+
+We could read this in using the following configuration:
+
+```ruby
+rows = [
+  {
+    id: 1,
+    first: 'Bruce',
+    last: 'Banner'
+  },
+  {
+    id: 2,
+    first: 'Tony',
+    last: 'Stark'
+  }
+]
+
+graph  = ::Hashematics.graph(rows: rows)
+objects = graph.rows
+```
+
+The variable `objects` will now contain the same data as `rows`.  This, so far, is not very useful but it sets up base case.
+
+### Introduction to Simple Shaping
+
+Let's say that we only want id and first variables:
+
+```ruby
+config = {
+  types: {
+    person: {
+      properties: %i[id first]
+    }
+  },
+  groups: {
+    avengers: {
+      by: :id,
+      type: :person
+    }
+  }
+}
+
+rows = [
+  {
+    id: 1,
+    first: 'Bruce',
+    last: 'Banner'
+  },
+  {
+    id: 2,
+    first: 'Tony',
+    last: 'Stark'
+  }
+]
+
+graph  = ::Hashematics.graph(config: config, rows: rows)
+objects = graph.data(:avengers)
+```
+
+Notice how we are grouping the data and calling the #data API.  Now the `objects` variable should now look like:
+
+```ruby
+[
+  {
+    id: 1,
+    first: 'Bruce'
+  },
+  {
+    id: 2,
+    first: 'Tony'
+  }
+]
+```
+
+### Cross-Mapping Shape Attribute Names
+
+Say we wanted to change the attribute names:
+
+```ruby
+config = {
+  types: {
+    person: {
+      properties: {
+        id_number: :id,
+        first_name: :first
+      }
+    }
+  },
+  groups: {
+    avengers: {
+      by: :id,
+      type: :person
+    }
+  }
+}
+
+rows = [
+  {
+    id: 1,
+    first: 'Bruce',
+    last: 'Banner'
+  },
+  {
+    id: 2,
+    first: 'Tony',
+    last: 'Stark'
+  }
+]
+
+graph  = ::Hashematics.graph(config: config, rows: rows)
+objects = graph.data(:avengers)
+```
+
+The `objects` variable should now look like:
+
+```ruby
+[
+  {
+    id_number: 1,
+    first_name: 'Bruce'
+  },
+  {
+    id_number: 2,
+    first_name: 'Tony'
+  }
+]
+```
+
+### Nested Shaping
+
+Let's build on our initial data set to:
+
+* include child data (one-to-many) relationship
+* start with different attributes (cross map attribute names)
+
+ID # | First Name | Last Name | Costume ID # | Costume Name | Costume Color
+---- | ---------- | --------- | ------------ | ------------ | -------------
+1    | Bruce      | Banner    | 3            | Basic Hulk   | Green
+1    | Bruce      | Banner    | 4            | Mad Hulk     | Red
+2    | Tony       | Stark     | 5            | Mark I       | Gray
+2    | Tony       | Stark     | 6            | Mark IV      | Red
+2    | Tony       | Stark     | 7            | Mark VI      | Nano-Blue
+
+We could now read this in as:
+
+```ruby
+config = {
+  types: {
+    person: {
+      properties: {
+        id: 'ID #',
+        first: 'First Name',
+        last: 'Last Name'
+      }
+    },
+    costume: {
+      properties: {
+        id: 'Costume ID #',
+        name: 'Costume Name',
+        color: 'Costume Color'
+      }
+    }
+  },
+  groups: {
+    avengers: {
+      by: 'ID #',
+      type: :person,
+      groups: {
+        costumes: {
+          by: 'Costume ID #',
+          type: :costume
+        }
+      }
+    }
+  }
+}
+
+rows = [
+  {
+    'ID #' => 1,
+    'First Name' => 'Bruce',
+    'Last Name' => 'Banner',
+    'Costume ID #' => 3,
+    'Costume Name' => 'Basic Hulk',
+    'Costume Color' => 'Green'
+  },
+  {
+    'ID #' => 1,
+    'First Name' => 'Bruce',
+    'Last Name' => 'Banner',
+    'Costume ID #' => 4,
+    'Costume Name' => 'Mad Hulk',
+    'Costume Color' => 'Red'
+  },
+  {
+    'ID #' => 2,
+    'First Name' => 'Tony',
+    'Last Name' => 'Stark',
+    'Costume ID #' => 5,
+    'Costume Name' => 'Mark I',
+    'Costume Color' => 'Gray'
+  },
+  {
+    'ID #' => 2,
+    'First Name' => 'Tony',
+    'Last Name' => 'Stark',
+    'Costume ID #' => 6,
+    'Costume Name' => 'Mark IV',
+    'Costume Color' => 'Red'
+  },
+  {
+    'ID #' => 2,
+    'First Name' => 'Tony',
+    'Last Name' => 'Stark',
+    'Costume ID #' => 7,
+    'Costume Name' => 'Mark VI',
+    'Costume Color' => 'Nano-Blue'
+  }
+]
+
+graph  = ::Hashematics.graph(config: config, rows: rows)
+objects = graph.data(:avengers)
+```
+
+The `objects` variable should now look like:
+
+```ruby
+[
+  {
+    id: 1,
+    first: 'Bruce',
+    last: 'Banner',
+    costumes: [
+      { id: 3, name: 'Basic Hulk', color: 'Green' },
+      { id: 4, name: 'Mad Hulk', color: 'Red' }
+    ]
+  },
+  {
+    id: 2,
+    first: 'Tony',
+    last: 'Stark',
+    costumes: [
+      { id: 5, name: 'Mark I', color: 'Gray' },
+      { id: 6, name: 'Mark IV', color: 'Red' },
+      { id: 7, name: 'Mark VI', color: 'Nano-Blue' }
+    ]
+  }
+]
+```
+
+Shaping / grouping is recursive and should support richer breadth as well as depth graphs.
+
+### Multiple Top-Level Graphs
+
+You are not limited to just one top-level graph.  For example, we could expand on the previous example to include another grouping of costumes:
+
+```ruby
+config = {
+  types: {
+    person: {
+      properties: {
+        id: 'ID #',
+        first: 'First Name',
+        last: 'Last Name'
+      }
+    },
+    costume: {
+      properties: {
+        id: 'Costume ID #',
+        name: 'Costume Name',
+        color: 'Costume Color'
+      }
+    }
+  },
+  groups: {
+    avengers: {
+      by: 'ID #',
+      type: :person,
+      groups: {
+        costumes: {
+          by: 'Costume ID #',
+          type: :costume
+        }
+      }
+    },
+    costumes: {
+      by: 'Costume ID #',
+      type: :costume
+    }
+  }
+}
+
+rows = [
+  {
+    'ID #' => 1,
+    'First Name' => 'Bruce',
+    'Last Name' => 'Banner',
+    'Costume ID #' => 3,
+    'Costume Name' => 'Basic Hulk',
+    'Costume Color' => 'Green'
+  },
+  {
+    'ID #' => 1,
+    'First Name' => 'Bruce',
+    'Last Name' => 'Banner',
+    'Costume ID #' => 4,
+    'Costume Name' => 'Mad Hulk',
+    'Costume Color' => 'Red'
+  },
+  {
+    'ID #' => 2,
+    'First Name' => 'Tony',
+    'Last Name' => 'Stark',
+    'Costume ID #' => 5,
+    'Costume Name' => 'Mark I',
+    'Costume Color' => 'Gray'
+  },
+  {
+    'ID #' => 2,
+    'First Name' => 'Tony',
+    'Last Name' => 'Stark',
+    'Costume ID #' => 6,
+    'Costume Name' => 'Mark IV',
+    'Costume Color' => 'Red'
+  },
+  {
+    'ID #' => 2,
+    'First Name' => 'Tony',
+    'Last Name' => 'Stark',
+    'Costume ID #' => 7,
+    'Costume Name' => 'Mark VI',
+    'Costume Color' => 'Nano-Blue'
+  }
+]
+
+graph  = ::Hashematics.graph(config: config, rows: rows)
+objects = graph.data(:costumes)
+```
+
+The `objects` variable should now look like:
+
+```ruby
+[
+  { id: 3, name: 'Basic Hulk', color: 'Green' },
+  { id: 4, name: 'Mad Hulk', color: 'Red' },
+  { id: 5, name: 'Mark I', color: 'Gray' },
+  { id: 6, name: 'Mark IV', color: 'Red' },
+  { id: 7, name: 'Mark VI', color: 'Nano-Blue' }
+]
+```
+
+### Handling Blanks
+
+Records with blank ID's are ignored by default.  This is due to the flat nature of the incoming data.  Take the following example:
+
+ID # | First Name | Last Name | Costume ID # | Costume Name | Costume Color
+---- | ---------- | --------- | ------------ | ------------ | -------------
+1    | Bruce      | Banner    | 3            | Basic Hulk   | Green
+2    | Tony       | Stark     |              |              |
+     |            |           | 4            | Undercover   | Purple
+
+This is interpreted as:
+
+* Bruce Banner is an avenger and has 2 costumes
+* Tony Stark is an avenger but has no costumes
+* An undercover purple costume exists, but belongs to no avenger
+
+We could read this in while ignoring blank IDs (default):
+
+```ruby
+config = {
+  types: {
+    person: {
+      properties: {
+        id: 'ID #',
+        first: 'First Name',
+        last: 'Last Name'
+      }
+    },
+    costume: {
+      properties: {
+        id: 'Costume ID #',
+        name: 'Costume Name',
+        color: 'Costume Color'
+      }
+    }
+  },
+  groups: {
+    avengers: {
+      by: 'ID #',
+      type: :person,
+      groups: {
+        costumes: {
+          by: 'Costume ID #',
+          type: :costume
+        }
+      }
+    },
+    costumes: {
+      by: 'Costume ID #',
+      type: :costume
+    }
+  }
+}
+
+rows = [
+  {
+    'ID #' => 1,
+    'First Name' => 'Bruce',
+    'Last Name' => 'Banner',
+    'Costume ID #' => 3,
+    'Costume Name' => 'Basic Hulk',
+    'Costume Color' => 'Green'
+  },
+  {
+    'ID #' => 2,
+    'First Name' => 'Tony',
+    'Last Name' => 'Stark',
+    'Costume ID #' => '',
+    'Costume Name' => '',
+    'Costume Color' => ''
+  },
+  {
+    'Costume ID #' => 4,
+    'Costume Name' => 'Undercover',
+    'Costume Color' => 'Purple'
+  }
+]
+
+graph   = ::Hashematics.graph(config: config, rows: rows)
+avengers = graph.data(:avengers)
+costumes = graph.data(:costumes)
+```
+
+The `avengers` variable should now look like:
+
+```ruby
+[
+  {
+    id: 1,
+    first: 'Bruce',
+    last: 'Banner',
+    costumes: [
+      { id: 3, name: 'Basic Hulk', color: 'Green' }
+    ]
+  },
+  {
+    id: 2,
+    first: 'Tony',
+    last: 'Stark',
+    costumes: []
+  }
+]
+```
+
+The `costumes` variable should now look like:
+
+```ruby
+[
+  { id: 3, name: 'Basic Hulk', color: 'Green' },
+  { id: 4, name: 'Undercover', color: 'Purple' }
+]
+```
+
+If you wish to include blank objects, then pass in ```include_blank: true``` option into the group configuration:
+
+```ruby
+config = {
+  types: {
+    person: {
+      properties: {
+        id: 'ID #',
+        first: 'First Name',
+        last: 'Last Name'
+      }
+    },
+    costume: {
+      properties: {
+        id: 'Costume ID #',
+        name: 'Costume Name',
+        color: 'Costume Color'
+      }
+    }
+  },
+  groups: {
+    avengers: {
+      by: 'ID #',
+      include_blank: true,
+      type: :person,
+      groups: {
+        costumes: {
+          by: 'Costume ID #',
+          type: :costume
+        }
+      }
+    },
+    costumes: {
+      by: 'Costume ID #',
+      include_blank: true,
+      type: :costume
+    }
+  }
+}
+
+rows = [
+  {
+    'ID #' => 1,
+    'First Name' => 'Bruce',
+    'Last Name' => 'Banner',
+    'Costume ID #' => 3,
+    'Costume Name' => 'Basic Hulk',
+    'Costume Color' => 'Green'
+  },
+  {
+    'ID #' => 2,
+    'First Name' => 'Tony',
+    'Last Name' => 'Stark',
+    'Costume ID #' => '',
+    'Costume Name' => '',
+    'Costume Color' => ''
+  },
+  {
+    'Costume ID #' => 4,
+    'Costume Name' => 'Undercover',
+    'Costume Color' => 'Purple'
+  }
+]
+
+graph   = ::Hashematics.graph(config: config, rows: rows)
+avengers = graph.data(:avengers)
+costumes = graph.data(:costumes)
+```
+
+The `avengers` variable should now look like:
+
+```ruby
+[
+  {
+    id: 1,
+    first: 'Bruce',
+    last: 'Banner',
+    costumes: [
+      { id: 3, name: 'Basic Hulk', color: 'Green' }
+    ]
+  },
+  {
+    id: 2,
+    first: 'Tony',
+    last: 'Stark',
+    costumes: []
+  },
+  {
+    id: nil,
+    first: nil,
+    last: nil,
+    costumes: [
+      { id: 4, name: 'Undercover', color: 'Purple' }
+    ]
+  }
+]
+```
+
+The `costumes` variable should now look like:
+
+```ruby
+[
+  { id: 3, name: 'Basic Hulk', color: 'Green' },
+  { id: '', name: '', color: '' },
+  { id: 4, name: 'Undercover', color: 'Purple' }
+]
+```
+
+### Advanced Options
+
+Some other options available are:
+
+* Custom Object Types: `object_class` attribute for a type defaults to Hash but can be set as a class constant or a proc/lambda.  If it is a class constant, then a new instance will be initialized from the incoming Hash.  If it is a function then it will be called with the incoming hash passed in and expecting an object as a return.
+* Compoound Unique Identifiers: `by` can either be a string, symbol, or array.
+
+## Contributing
+
+### Development Environment Configuration
+
+Basic steps to take to get this repository compiling:
+
+1. Install [Ruby](https://www.ruby-lang.org/en/documentation/installation/) (check hashematics.gemspec for versions supported)
+2. Install bundler (gem install bundler)
+3. Clone the repository (git clone git@github.com:bluemarblepayroll/hashematics.git)
+4. Navigate to the root folder (cd hashematics)
+5. Install dependencies (bundle)
+
+### Running Tests
+
+To execute the test suite run:
+
+````
+bundle exec rspec spec --format documentation
+````
+
+Alternatively, you can have Guard watch for changes:
+
+````
+bundle exec guard
+````
+
+Also, do not forget to run Rubocop:
+
+````
+bundle exec rubocop
+````
+
+### Publishing
+
+Note: ensure you have proper authorization before trying to publish new versions.
+
+After code changes have successfully gone through the Pull Request review process then the following steps should be followed for publishing new versions:
+
+1. Merge Pull Request into master
+2. Update ```lib/hashematics/version.rb``` using [semantic versioning](https://semver.org/)
+3. Install dependencies: ```bundle```
+4. Update ```CHANGELOG.md``` with release notes
+5. Commit & push master to remote and ensure CI builds master successfully
+6. Build the project locally: `gem build hashematics`
+7. Publish package to RubyGems: `gem push hashematics-X.gem` where X is the version to push
+8. Tag master with new version: `git tag <version>`
+9. Push tags remotely: `git push origin --tags`
+
+## License
+
+This project is MIT Licensed.