dot_usage 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3755f4c87fb8d99aca2dfdf9a6e235ea969137ab
+  data.tar.gz: 49b60a77f0626cae034c9961a84a7a1faa534ebb
+SHA512:
+  metadata.gz: 86589255a119b3b6b58709ce8ba97f8904533300a0953323e102fa1d600837c700da733302e9af88bf132fc295f25f93562e012522a19fce6a29fd3328826205
+  data.tar.gz: 69e746e3805555b533f028a7b301f41f5fa326e285ae4c2e239bb482ea87bc55cb104c3c3b9904e0f9bbcfc8f64493a86b101834da12bebe1781194d286ba749

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+/_site/

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.0
+before_install: gem install bundler -v 1.12.5

data/.usage.yml

@@ -0,0 +1,10 @@
+install:
+  - gem install dot_usage
+
+build: bin/setup
+
+test:
+  - rake test
+
+help:
+  README.md: "## Getting Help"

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in dot_usage.gemspec
+gemspec

data/README.md

@@ -0,0 +1,102 @@
+# [dot_usage](https://beneills.github.io/dot_usage/)
+
+_a file format and utility to control building, running and testing source code_
+
+1) __Define__ some targets for your project either explicitly, or by pointing to existing documentation:
+
+```yaml
+# .usage.yml
+
+install:
+  - gem install dot_usage
+
+test:
+  - rake test
+
+help:
+  README.md: "## Getting Help"
+```
+
+2) Then your users can safely __execute__ the targets:
+
+```shell
+$ gem install dot_usage
+
+$ cd my_project && ls -a
+.usage.yml ...
+
+$ dot_usage install
+Installing dot_usage (guided)
+> Run `gem install dot_usage` [Y/n]? y
+Successfully installed.
+```
+
+## Rationale
+
+We present a single interface for users to interact with your repository, without learning/remembering incantations for twenty different build systems.  This makes is quicker for them to get started using or contributing.
+
+## Features
+
+*dot_usage* allows project maintainers to easily communicate how to interact with a repository, in a way that a machine can understand.  This can be used to supplement the usual human-readable instructions in _README.md_.  Crucially, we permit linking to code snippets in Markdown documents, meaning no code duplication.
+
+We allow arbitrary targets, but recommend using __install__, __build__, __test__, and __help__.
+
+### Target Recipes
+```yaml
+# Define recipes as a list of shell commands
+target-one:
+  - echo "command one"
+  - echo "command two"
+
+# Or as a link to a Markdown section with a single code snippet
+target-two:
+  README.md: "### Doing thing two"
+```
+
+### Guided Invocation
+```shell
+# Prompt before every command
+$ dot_usage install
+Installing dot_usage (guided)
+> Run `gem install dot_usage` [Y/n]? y
+Successfully installed.
+
+# Or run them blindly
+$ dot_usage install -y
+Installing dot_usage (guided)
+> Running `gem install dot_usage`
+Successfully installed.
+```
+
+### Listing Targets
+```
+# Run with -v for full command listing
+$ dot_usage
+Available targets:
+ - install
+ - test
+ - help
+```
+
+### Generating a dotfile
+```
+$ cd my_project
+$ dot_usage
+Generated .usage.yml
+```
+
+## Getting Help
+
+```shell
+dot_usage -h
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/beneills/dot_usage.

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task :default => :test

data/_config.yml

@@ -0,0 +1,30 @@
+# Welcome to Jekyll!
+#
+# This config file is meant for settings that affect your whole blog, values
+# which you are expected to set up once and rarely need to edit after that.
+# For technical reasons, this file is *NOT* reloaded automatically when you use
+# 'jekyll serve'. If you change this file, please restart the server process.
+
+# Site settings
+title: dot_usage
+description: a file format and utility to control building, running and testing source code
+github_username: beneills
+
+exclude:
+ - bin
+ - data
+ - exe
+ - lib
+ - test
+ - Gemfile
+ - Gemfile.lock
+ - README.md
+ - Rakefile
+ - dot_usage.gemspec
+
+include:
+ - index.md
+
+# Build settings
+markdown: kramdown
+highlighter: rouge

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "dot_usage"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/generate_site

@@ -0,0 +1,12 @@
+#!/bin/bash
+
+cat > index.md <<- EOM
+---
+---
+<link rel="stylesheet" type="text/css" href="site/css/modest.css">
+
+<a href="https://github.com/beneills/dot_usage"><img style="position: absolute; top: 0; right: 0; border: 0;" src="https://camo.githubusercontent.com/e7bbb0521b397edbd5fe43e7f760759336b5e05f/68747470733a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f677265656e5f3030373230302e706e67" alt="Fork me on GitHub" data-canonical-src="https://s3.amazonaws.com/github/ribbons/forkme_right_green_007200.png"></a>
+
+EOM
+
+cat README.md >> index.md

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/data/example.usage.yml

@@ -0,0 +1,15 @@
+install:
+  - echo "Installing..."
+  - echo "Installed blah."
+
+build:
+  - echo "Building..."
+
+test:
+  - echo "Testing..."
+
+help:
+  - echo "Getting help..."
+
+#other:
+#  README.md: "##Other"

data/dot_usage.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'dot_usage/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "dot_usage"
+  spec.version       = DotUsage::VERSION
+  spec.licenses      = ['MIT']
+  spec.authors       = ["Ben Eills"]
+  spec.email         = ["ben@beneills.com"]
+
+  spec.summary       = %q{File format and utility to control building, running and testing source code.}
+  spec.homepage      = "https://github.com/beneills/dot_usage"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.12"
+  spec.add_development_dependency "jekyll", "~> 3.1"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "minitest", "~> 5.0"
+end

data/exe/dot_usage

@@ -0,0 +1,123 @@
+#!/usr/bin/env ruby
+
+require 'fileutils'
+require 'optparse'
+require 'optparse/time'
+require 'ostruct'
+require 'pp'
+
+require 'dot_usage'
+require 'dot_usage/version'
+
+DEFAULT_DOT_USAGE_FILE = '.usage.yml'
+EXAMPLE_FILE = 'data/example.usage.yml'
+
+class DotUsageOptparse
+
+  #
+  # Return a structure describing the options after consuming some of args.
+  #
+  def self.parse(args)
+    # The options specified on the command line will be collected in *options*.
+    # We set default values here.
+    options = OpenStruct.new
+    options.file = DEFAULT_DOT_USAGE_FILE
+    options.yes = false
+    options.verbose = false
+
+    opt_parser = OptionParser.new do |opts|
+      opts.banner = "Usage: dot_usage [TARGET [options]]"
+
+      opts.separator ""
+      opts.separator "Specific options:"
+
+      opts.on("-f", "--file FILE",
+              "Use a custom dot_usage file") do |f|
+        options.file = f
+      end
+
+      opts.on("-y", "--yes", "Run target blindly without prompting") do |v|
+        options.yes = v
+      end
+
+      opts.on("-v", "--[no-]verbose", "Run verbosely") do |v|
+        options.verbose = v
+      end
+
+      opts.separator ""
+      opts.separator "Common options:"
+
+      opts.on_tail("-h", "--help", "Show this message") do
+        puts opts
+        exit
+      end
+
+      opts.on_tail("--version", "Show version") do
+        puts DotUsage::VERSION
+        exit
+      end
+    end
+
+    opt_parser.parse! args
+    options
+  end
+end
+
+#
+# List targets in current directory.
+#
+def list(options)
+  DotUsage.list_targets options
+
+  0
+end
+
+#
+# Generate a dotfile in current directory.
+#
+def generate(options)
+  # Check for existing dotfile
+  if File.exists? DEFAULT_DOT_USAGE_FILE
+    STDERR.puts "#{DEFAULT_DOT_USAGE_FILE} already exists!"
+    return 1
+  end
+
+  FileUtils.copy EXAMPLE_FILE, DEFAULT_DOT_USAGE_FILE
+
+  puts "Generated #{DEFAULT_DOT_USAGE_FILE}"
+
+  0
+end
+
+#
+# Run a given target
+#
+def run_target(target, options)
+  DotUsage.run_target target, options
+end
+
+#
+# Main entry point.
+#
+def main
+  options = DotUsageOptparse.parse(ARGV)
+
+  ret = case ARGV.length
+  when 0
+    if File.exists? options.file
+      list options
+    else
+      generate options
+    end
+  when 1
+    target = ARGV.pop
+    run_target target, options
+  else
+    puts 'bad'
+    1
+  end
+
+  exit ret
+end
+
+main

data/index.md

@@ -0,0 +1,108 @@
+---
+---
+<link rel="stylesheet" type="text/css" href="site/css/modest.css">
+
+<a href="https://github.com/beneills/dot_usage"><img style="position: absolute; top: 0; right: 0; border: 0;" src="https://camo.githubusercontent.com/e7bbb0521b397edbd5fe43e7f760759336b5e05f/68747470733a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f677265656e5f3030373230302e706e67" alt="Fork me on GitHub" data-canonical-src="https://s3.amazonaws.com/github/ribbons/forkme_right_green_007200.png"></a>
+
+# dot_usage
+
+_a file format and utility to control building, running and testing source code_
+
+1) __Define__ some targets for your project either explicitly, or by pointing to existing documentation:
+
+```yaml
+# .usage.yml
+
+install:
+  - gem install dot_usage
+
+test:
+  - rake test
+
+help:
+  README.md: "## Getting Help"
+```
+
+2) Then your users can safely __execute__ the targets:
+
+```shell
+$ gem install dot_usage
+
+$ cd my_project && ls -a
+.usage.yml ...
+
+$ dot_usage install
+Installing dot_usage (guided)
+> Run `gem install dot_usage` [Y/n]? y
+Successfully installed.
+```
+
+## Rationale
+
+We present a single interface for users to interact with your repository, without learning/remembering incantations for twenty different build systems.  This makes is quicker for them to get started using or contributing.
+
+## Features
+
+*dot_usage* allows project maintainers to easily communicate how to interact with a repository, in a way that a machine can understand.  This can be used to supplement the usual human-readable instructions in _README.md_.  Crucially, we permit linking to code snippets in Markdown documents, meaning no code duplication.
+
+We allow arbitrary targets, but recommend using __install__, __build__, __test__, and __help__.
+
+### Target Recipes
+```yaml
+# Define recipes as a list of shell commands
+target-one:
+  - echo "command one"
+  - echo "command two"
+
+# Or as a link to a Markdown section with a single code snippet
+target-two:
+  README.md: "### Doing thing two"
+```
+
+### Guided Invocation
+```shell
+# Prompt before every command
+$ dot_usage install
+Installing dot_usage (guided)
+> Run `gem install dot_usage` [Y/n]? y
+Successfully installed.
+
+# Or run them blindly
+$ dot_usage install -y
+Installing dot_usage (guided)
+> Running `gem install dot_usage`
+Successfully installed.
+```
+
+### Listing Targets
+```
+# Run with -v for full command listing
+$ dot_usage
+Available targets:
+ - install
+ - test
+ - help
+```
+
+### Generating a dotfile
+```
+$ cd my_project
+$ dot_usage
+Generated .usage.yml
+```
+
+## Getting Help
+
+```shell
+dot_usage -h
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/beneills/dot_usage.

data/lib/dot_usage.rb

@@ -0,0 +1,143 @@
+require 'open3'
+require 'yaml'
+
+require "dot_usage/markdown"
+require "dot_usage/version"
+
+module DotUsage
+  class DotUsageFile
+    def initialize(filename)
+      @filename = filename
+      @data = YAML.load_file filename
+    end
+
+    def targets
+      @data.keys
+    end
+
+    def recipe(target)
+      content = @data[target]
+
+      if content.instance_of? Array
+        content
+      elsif content.instance_of? String
+        [content]
+      elsif content.instance_of? Hash
+        unless 1 == content.length
+          STDERR.puts content
+          STDERR.puts 'Error: hash may only have one entry!'
+          return 1
+        end
+
+        md = MarkdownFile.new content.keys.first
+
+        md.snippet content.values.first
+      else
+        STDERR.puts content
+        STDERR.puts 'Error: invalid recipe!'
+        1
+      end
+    end
+  end
+
+  class Target
+    def initialize(name)
+      @name = name
+    end
+
+    def recipe(options)
+      file = DotUsageFile.new(options.file)
+
+      file.recipe @name
+    end
+
+    def run(options)
+      recipe(options).each do |cmd|
+        status = Command.new(cmd).run(options)
+
+        unless status
+          STDERR.puts '> Command failed.  Aborting!'
+          return 1
+        end
+      end
+
+      0
+    end
+  end
+
+  class Command
+    def initialize(cmd)
+      @cmd = cmd
+    end
+
+    def run(options)
+      if options.yes
+        run_without_prompt(options)
+      else
+        run_with_prompt(options)
+      end
+    end
+
+    private
+
+    def execute(cmd)
+      system cmd
+    end
+
+    def run_without_prompt(options)
+      puts "> Running `#{@cmd}`"
+
+      execute @cmd
+    end
+
+    def run_with_prompt(options)
+      print "> Run `#{@cmd}` [Y/n]? "
+
+      go = case gets.chomp
+      when "y", "Y", "yes", ""
+        true
+      when "n", "N", "no"
+        false
+      else
+        STDERR.puts '> Invalid choice!'
+        false
+      end
+
+      if go
+        execute @cmd
+      else
+        puts "Quitting!"
+        1
+      end
+    end
+  end
+
+  #
+  # List targets
+  #
+  def self.list_targets(options)
+    file = DotUsageFile.new options.file
+
+    puts "Available targets:"
+    file.targets.each do |target|
+      puts " - #{target}"
+
+      if options.verbose
+        Target.new(target).recipe(options).each do |cmd|
+          puts "     `#{cmd}`"
+        end
+      end
+    end
+
+    0
+  end
+
+  #
+  # Run a given target
+  #
+  def self.run_target(target, options)
+    target = Target.new target
+
+    target.run options
+  end
+end

data/lib/dot_usage/markdown.rb

@@ -0,0 +1,62 @@
+INDENTATION = "    "
+
+class MarkdownFile
+  def initialize(filename)
+    @filename = filename
+    @contents = File.read filename
+  end
+
+  def section(heading)
+    after_heading_regexp = /^#{heading}$(?<after>.+)/m
+    next_heading_regexp = /(?<section>.+)^#+/m
+
+    after_match_data = after_heading_regexp.match @contents
+    return nil unless after_match_data
+
+    after_heading = after_match_data[:after]
+
+    before_match_data = next_heading_regexp.match after_heading
+    return nil unless before_match_data
+
+    before_match_data[:section]
+  end
+
+  def snippet(heading)
+    s = section heading
+    return nil if s.nil?
+
+    [extract_quoted_snippet(s), extract_indented_snippet(s)].select { |r| ! r.nil? }.first
+  end
+
+  private
+
+  # Try to extract a triple quoted snippet from the section
+  #
+  # Otherwise, return nil
+  def extract_quoted_snippet(section)
+    quoted_snipped_regexp = /^```\S*$(?<quoted_snippet>.+?)^```$/m
+
+    match_data = quoted_snipped_regexp.match(section)
+
+    if match_data
+      match_data[:quoted_snippet].strip.split "\n"
+    else
+      nil
+    end
+  end
+
+  # Try to extract an indented snippet from the section
+  #
+  # Otherwise, return nil
+  def extract_indented_snippet(section)
+    indentation_regexp = /^(?<after>#{INDENTATION}.+)$/m
+
+    match_data = indentation_regexp.match(section)
+
+    if match_data
+      match_data[:after].lines.take_while { |line| line.strip.empty? or line.start_with? INDENTATION }.map { |l| l.strip }.select { |l| ! l.empty?}
+    else
+      nil
+    end
+  end
+end

data/lib/dot_usage/version.rb

@@ -0,0 +1,3 @@
+module DotUsage
+  VERSION = "0.1.0"
+end

data/site/css/modest.css

@@ -0,0 +1,221 @@
+# From https://github.com/markdowncss/modest
+
+@media print {
+  *,
+  *:before,
+  *:after {
+    background: transparent !important;
+    color: #000 !important;
+    box-shadow: none !important;
+    text-shadow: none !important;
+  }
+
+  a,
+  a:visited {
+    text-decoration: underline;
+  }
+
+  a[href]:after {
+    content: " (" attr(href) ")";
+  }
+
+  abbr[title]:after {
+    content: " (" attr(title) ")";
+  }
+
+  a[href^="#"]:after,
+  a[href^="javascript:"]:after {
+    content: "";
+  }
+
+  pre,
+  blockquote {
+    border: 1px solid #999;
+    page-break-inside: avoid;
+  }
+
+  thead {
+    display: table-header-group;
+  }
+
+  tr,
+  img {
+    page-break-inside: avoid;
+  }
+
+  img {
+    max-width: 100% !important;
+  }
+
+  p,
+  h2,
+  h3 {
+    orphans: 3;
+    widows: 3;
+  }
+
+  h2,
+  h3 {
+    page-break-after: avoid;
+  }
+}
+
+pre,
+code {
+  font-family: Menlo, Monaco, "Courier New", monospace;
+}
+
+pre {
+  padding: .5rem;
+  line-height: 1.25;
+  overflow-x: scroll;
+}
+
+a,
+a:visited {
+  color: #3498db;
+}
+
+a:hover,
+a:focus,
+a:active {
+  color: #2980b9;
+}
+
+.modest-no-decoration {
+  text-decoration: none;
+}
+
+html {
+  font-size: 12px;
+}
+
+@media screen and (min-width: 32rem) and (max-width: 48rem) {
+  html {
+    font-size: 15px;
+  }
+}
+
+@media screen and (min-width: 48rem) {
+  html {
+    font-size: 16px;
+  }
+}
+
+body {
+  line-height: 1.85;
+}
+
+p,
+.modest-p {
+  font-size: 1rem;
+  margin-bottom: 1.3rem;
+}
+
+h1,
+.modest-h1,
+h2,
+.modest-h2,
+h3,
+.modest-h3,
+h4,
+.modest-h4 {
+  margin: 1.414rem 0 .5rem;
+  font-weight: inherit;
+  line-height: 1.42;
+}
+
+h1,
+.modest-h1 {
+  margin-top: 0;
+  font-size: 3.998rem;
+}
+
+h2,
+.modest-h2 {
+  font-size: 2.827rem;
+}
+
+h3,
+.modest-h3 {
+  font-size: 1.999rem;
+}
+
+h4,
+.modest-h4 {
+  font-size: 1.414rem;
+}
+
+h5,
+.modest-h5 {
+  font-size: 1.121rem;
+}
+
+h6,
+.modest-h6 {
+  font-size: .88rem;
+}
+
+small,
+.modest-small {
+  font-size: .707em;
+}
+
+/* https://github.com/mrmrs/fluidity */
+
+img,
+canvas,
+iframe,
+video,
+svg,
+select,
+textarea {
+  max-width: 100%;
+}
+
+@import url(http://fonts.googleapis.com/css?family=Open+Sans+Condensed:300,300italic,700);
+
+@import url(http://fonts.googleapis.com/css?family=Arimo:700,700italic);
+
+html {
+  font-size: 18px;
+  max-width: 100%;
+}
+
+body {
+  color: #444;
+  font-family: 'Open Sans Condensed', sans-serif;
+  font-weight: 300;
+  margin: 0 auto;
+  max-width: 48rem;
+  line-height: 1.45;
+  padding: .25rem;
+}
+
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+  font-family: Arimo, Helvetica, sans-serif;
+}
+
+h1,
+h2,
+h3 {
+  border-bottom: 2px solid #fafafa;
+  margin-bottom: 1.15rem;
+  padding-bottom: .5rem;
+  text-align: center;
+}
+
+blockquote {
+  border-left: 8px solid #fafafa;
+  padding: 1rem;
+}
+
+pre,
+code {
+  background-color: #fafafa;
+}

metadata

@@ -0,0 +1,119 @@
+--- !ruby/object:Gem::Specification
+name: dot_usage
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ben Eills
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-07-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+- !ruby/object:Gem::Dependency
+  name: jekyll
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: 
+email:
+- ben@beneills.com
+executables:
+- dot_usage
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- ".usage.yml"
+- Gemfile
+- README.md
+- Rakefile
+- _config.yml
+- bin/console
+- bin/generate_site
+- bin/setup
+- data/example.usage.yml
+- dot_usage.gemspec
+- exe/dot_usage
+- index.md
+- lib/dot_usage.rb
+- lib/dot_usage/markdown.rb
+- lib/dot_usage/version.rb
+- site/css/modest.css
+homepage: https://github.com/beneills/dot_usage
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: File format and utility to control building, running and testing source code.
+test_files: []