about_yml 0.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c4b7c2cf619f3f89753d3eedf409b807dc400b91
+  data.tar.gz: 32b074f94be4e4c3458c4e8bb270a1f9ecfa0c02
+SHA512:
+  metadata.gz: 7335e922baee99f8a65ac43c677ed427103939a89eb445d3025dfa16358b90870597baa02ea9d760c16ed2605bd3c8cced2df4f782d81a2e17595753e8c78c57
+  data.tar.gz: bbfd96bc5d9a8c8f2edeff6271efb6278d4823bc8e12280c5fddb8203224bbdb653d2dcf5ed80d0ec24f7222a701a51eb7dce9f0e8d2c8daa201707269a33d5b

data/CONTRIBUTING.md

@@ -0,0 +1,15 @@
+## Welcome!
+
+We're so glad you're thinking about contributing to an 18F open source project! If you're unsure or afraid of anything, just ask or submit the issue or pull request anyways. The worst that can happen is that you'll be politely asked to change something. We appreciate any sort of contribution, and don't want a wall of rules to get in the way of that.
+
+Before contributing, we encourage you to read our CONTRIBUTING policy (you are here), our LICENSE, and our README, all of which should be in this repository. If you have any questions, or want to read more about our underlying policies, you can consult the 18F Open Source Policy GitHub repository at https://github.com/18f/open-source-policy, or just shoot us an email/official government letterhead note to [18f@gsa.gov](mailto:18f@gsa.gov).
+
+## Public domain
+
+This project is in the public domain within the United States, and
+copyright and related rights in the work worldwide are waived through
+the [CC0 1.0 Universal public domain dedication](https://creativecommons.org/publicdomain/zero/1.0/).
+
+All contributions to this project will be released under the CC0
+dedication. By submitting a pull request, you are agreeing to comply
+with this waiver of copyright interest.

data/LICENSE.md

@@ -0,0 +1,31 @@
+As a work of the United States Government, this project is in the
+public domain within the United States.
+
+Additionally, we waive copyright and related rights in the work
+worldwide through the CC0 1.0 Universal public domain dedication.
+
+## CC0 1.0 Universal Summary
+
+This is a human-readable summary of the [Legal Code (read the full text)](https://creativecommons.org/publicdomain/zero/1.0/legalcode).
+
+### No Copyright
+
+The person who associated a work with this deed has dedicated the work to
+the public domain by waiving all of his or her rights to the work worldwide
+under copyright law, including all related and neighboring rights, to the
+extent allowed by law.
+
+You can copy, modify, distribute and perform the work, even for commercial
+purposes, all without asking permission.
+
+### Other Information
+
+In no way are the patent or trademark rights of any person affected by CC0,
+nor are the rights that other persons may have in the work or in how the
+work is used, such as publicity or privacy rights.
+
+Unless expressly stated otherwise, the person who associated a work with
+this deed makes no warranties about the work, and disclaims liability for
+all uses of the work, to the fullest extent permitted by applicable law.
+When using or citing the work, you should not imply endorsement by the
+author or the affirmer.

data/README.md

@@ -0,0 +1,85 @@
+# `.about.yml` schema and tools
+
+The `.about.yml` mechanism allows an project to publish and maintain metadata
+that can be easily maintained by project owners, that is visible and
+accessible to interested parties, and that can be harvested and processed by
+tools and automated systems. It is implemented using the
+[YAML](https://en.wikipedia.org/wiki/YAML) format.
+
+The [18F Team API](https://team-api.18f.gov/public/api/) is the original,
+primary consumer of this information, which in turn provides data for:
+
+- [18F Hub](https://github.com/18F/hub)
+- [18F Dashboard](https://github.com/18F/dashboard)
+- [18F.gsa.gov](https://github.com/18F/18f.gsa.gov)
+
+We hope that every active 18F project, [working
+group](https://pages.18f.gov/grouplet-playbook/working-groups/), and
+[guild](https://pages.18f.gov/grouplet-playbook/guilds/) will publish
+`.about.yml` files in their respective repositories. By feeding this
+information through the Team API server and into our Hub, Dashboard, and main
+web site, cultivation of `.about.yml` files will help make our activity more
+easily transparent to our teammates, and to anyone outside our team who wishes
+to discover what we're working on (and how we work).
+
+## Installation
+
+Run `gem install about_yml` on the command line. You can also add `gem
+'about_yml'` to your project's `Gemfile` if you use
+[Bundler](http://bundler.io/) and wish to configure the `about_yml_validate`
+program as a pre-commit check.
+
+## Usage
+
+Most users will interact with the gem through one of the following
+command-line programs.
+
+### `about_yml_generate`
+
+This program will generate an empty `.about.yml` template with descriptions of
+each field. To add a new `.about.yml` file to your project where `MY-PROJECT`
+is the path to your local clone of your project's repository:
+
+```shell
+$ about_yml_generate > MY-PROJECT/.about.yml
+```
+
+### `about_yml_validate`
+
+This program checks one or more `.about.yml` files against the `.about.yml`
+schema. To check your project's `.about.yml` file:
+
+```shell
+$ about_yml_validate MY-PROJECT/.about.yml
+```
+
+### `about_yml_scrape`
+
+This program checks for an `.about.yml` file in every GitHub repository
+belonging to a specified organization, then downloads, validates, and
+categorizes all of the discovered files into a single YAML object. You must
+have a valid
+[GitHub API token](https://help.github.com/articles/creating-an-access-token-for-command-line-use/)
+to run this command.
+
+```shell
+$ about_yml_scrape 18F > 18F_about_yml_data.yml
+```
+
+### `github_org_descriptions`
+
+This program doesn't have anything to do with the `.about.yml` schema, but is
+a small, handy program that also uses the
+[`octokit`](https://rubygems.org/gems/octokit) gem to access the GitHub API.
+It will return a YAML list of names and descriptions for all of the
+repositories belonging to an organization.
+
+## Public domain
+
+This project is in the worldwide [public domain](LICENSE.md). As stated in [CONTRIBUTING](CONTRIBUTING.md):
+
+> This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the [CC0 1.0 Universal public domain dedication](https://creativecommons.org/publicdomain/zero/1.0/).
+>
+> All contributions to this project will be released under the CC0
+>dedication. By submitting a pull request, you are agreeing to comply
+>with this waiver of copyright interest.

data/bin/about_yml_generator

@@ -0,0 +1,6 @@
+#! /usr/bin/env ruby
+# @author Mike Bland (michael.bland@gsa.gov)
+
+require_relative '../lib/about_yml'
+
+puts AboutYml::TemplateGenerator.new.generate

data/bin/about_yml_scrape

@@ -0,0 +1,58 @@
+#! /usr/bin/env ruby
+
+require_relative '../lib/about_yml/about'
+require 'English'
+require 'safe_yaml'
+
+USAGE = <<END_USAGE
+Usage: #{$PROGRAM_NAME} github_org [github_token] [missing_outfile] \
+[raw_abouts_file]
+
+Scrapes the .about.yml files from an organization's GitHub repositories and
+writes their contents to standard output as YAML, categorized by visibility
+and owner type.
+
+Also validates the .about.yml files and prints errors to standard error. The
+program WILL NOT exit with an error if any files fail validation.
+
+where:
+  github_org       name of the GitHub organization to scan
+  github_token     path to a file containing a valid GitHub API token
+                     defaults to $HOME/.github_token
+  missing_outfile  (optional) path to a file that will contain a list of repos
+                     that do not have .about.yml files
+  raw_abouts_file  (optional) if the file exists, the program will read
+                     .about.yml data from it rather than scraping GitHub;
+                     otherwise, the unprocessed .about.yml data scraped from
+                     GitHub will be written to it
+END_USAGE
+
+def usage(exitstatus = 0)
+  (exitstatus == 0 ? $stdout : $stderr).puts USAGE
+  exit exitstatus
+end
+
+github_org, github_token, missing_outfile, raw_abouts_file = ARGV
+github_token ||= File.join(ENV['HOME'], '.github_token')
+usage 1 unless github_org && File.exist?(github_token)
+
+if raw_abouts_file && File.exist?(raw_abouts_file)
+  fetch_results = SafeYAML.load_file raw_abouts_file, safe: true
+else
+  access_key = File.read github_token
+  fetch_results = ::AboutYml::AboutFile.fetch_from_github github_org, access_key
+  File.write raw_abouts_file, fetch_results.to_yaml if raw_abouts_file
+  if missing_outfile
+    File.write missing_outfile, fetch_results['missing'].to_yaml
+  end
+end
+
+puts(%w(public private).each_with_object({}) do |scope, full_yml|
+  repo_to_data = fetch_results[scope]
+  results = ::AboutYml::AboutFile.validate_about_files repo_to_data
+  results['invalid'].each do |repo, result|
+    $stderr.puts "#{repo}:\n  #{result[:errors].join "\n  "}"
+  end
+  full_yml[scope] = ::AboutYml::AboutFile.organize_by_owner_type_and_name(
+    repo_to_data)
+end.to_yaml)

data/bin/about_yml_validate

@@ -0,0 +1,28 @@
+#! /usr/bin/env ruby
+
+require_relative '../lib/about_yml'
+require 'English'
+require 'safe_yaml'
+
+def usage(exitstatus = 0)
+  (exitstatus == 0 ? $stdout : $stderr).puts <<END_USAGE
+#{$PROGRAM_NAME} path_to_about_file [...]
+
+Validates .about.yml file contents. Prints nothing on success; prints errors
+to standard error.
+END_USAGE
+  exit exitstatus
+end
+
+usage 1 if ARGV.empty?
+ARGV.each { |f| abort "#{f} does not exist" unless File.exist? f }
+
+exitstatus = 0
+ARGV.each do |about_file|
+  about_data = SafeYAML.load_file about_file, safe: true
+  errors = ::AboutYml::AboutFile.validate_single_file about_data
+  next if errors.empty?
+  exitstatus = 1
+  $stderr.puts "#{about_file}:\n  #{errors.join "\n  "}"
+end
+exit exitstatus

data/bin/github_org_descriptions

@@ -0,0 +1,33 @@
+#! /usr/bin/env ruby
+
+require 'English'
+require 'octokit'
+require 'yaml'
+
+USAGE = <<END_USAGE
+Usage: #{$PROGRAM_NAME} github_org [github_token]
+
+Prints a list of an organization's GitHub repositories and their descriptions
+to standard output as YAML.
+
+where:
+  github_org    name of the GitHub organization to scan
+  github_token  path to a file containing a valid GitHub API token
+                  defaults to $HOME/.github_token
+END_USAGE
+
+def usage(exitstatus = 0)
+  (exitstatus == 0 ? $stdout : $stderr).puts USAGE
+  exit exitstatus
+end
+
+github_org, github_token = ARGV
+github_token ||= File.join(ENV['HOME'], '.github_token')
+usage 1 unless github_org && File.exist?(github_token)
+
+Octokit.auto_paginate = true
+client = Octokit::Client.new access_token: File.read(github_token)
+
+puts(client.org_repos(github_org).each_with_object([]) do |repo, descriptions|
+  descriptions << { 'repo' => repo.name, 'description' => repo.description }
+end.to_yaml)

data/lib/about_yml/about.rb

@@ -0,0 +1,82 @@
+require 'base64'
+require 'json'
+require 'json-schema'
+require 'octokit'
+require 'safe_yaml'
+
+SafeYAML::OPTIONS[:default_mode] = :safe
+Octokit.auto_paginate = true
+
+module AboutYml
+  class AboutFile
+    def self.schema
+      @schema ||= begin
+        raw_schema = File.read File.join(File.dirname(__FILE__), 'schema.json')
+        schema = ::JSON.parse raw_schema
+        ::JSON::Validator.fully_validate_schema schema
+        schema
+      end
+    end
+
+    def self.fetch_from_github(github_org, access_key)
+      client = Octokit::Client.new access_token: access_key
+      repos = client.org_repos github_org
+      result = {
+        'public' => {},
+        'private' => {},
+        'missing' => [],
+        'errors' => [],
+      }
+      repos.each { |repo| collect_repository_data repo, client, result }
+      result
+    end
+
+    def self.fetch_file_contents(client, repo_full_name, ref: 'master')
+      about = client.contents repo_full_name, path: '.about.yml', ref: ref
+      SafeYAML.load Base64.decode64(about['content'])
+    end
+
+    def self.collect_repository_data(repo, client, result)
+      collection = (repo.private == true) ? 'private' : 'public'
+      repo_name = repo.full_name
+      result[collection][repo_name] = fetch_file_contents client, repo_name
+    rescue Octokit::NotFound
+      result['missing'] << repo.full_name
+    rescue StandardError => err
+      $stderr.puts('Error while parsing .about.yml for ' \
+        "#{repo.full_name}:\n #{err}")
+      result['errors'] << repo.full_name
+    end
+    private_class_method :collect_repository_data
+
+    def self.validate_single_file(about_data)
+      ::JSON::Validator.fully_validate schema, about_data
+    end
+
+    def self.validate_about_files(repo_name_to_about_data)
+      r = { 'valid' => {}, 'invalid' => {} }
+      repo_name_to_about_data.each_with_object(r) do |data, results|
+        repo, contents = data
+        errors = validate_single_file contents
+        if errors.empty?
+          results['valid'][repo] = contents
+        else
+          results['invalid'][repo] = { errors: errors, contents: contents }
+        end
+      end
+    end
+
+    def self.organize_by_owner_type_and_name(abouts)
+      abouts.values.each_with_object({}) do |about, result|
+        owner_type = about['owner_type']
+        name = about['name']
+        if owner_type && name
+          (result[owner_type] ||= {})[name] = about
+        else
+          alt_id = about['full_name'] ? about['full_name'] : about['name']
+          result[alt_id + '/' + about['type']] = about
+        end
+      end
+    end
+  end
+end

data/lib/about_yml/schema.json

@@ -0,0 +1,200 @@
+{
+    "title": ".about.yml - .about.yml files",
+    "description": ".about.yml project metadata",
+    "$schema": "http://json-schema.org/draft-04/hyper-schema",
+    "type": "object",
+    "properties": {
+        "name": {
+            "type": "string",
+            "description": "Short name that acts as the project identifier"
+        },
+        "full_name": {
+            "type": "string",
+            "description": "Full proper name of the project"
+        },
+        "type": {
+            "type": "string",
+            "description": "The type of content in the repo",
+            "enum": ["app", "docs", "policy"]
+        },
+        "owner_type": {
+            "type": "string",
+            "description": "Describes whether a project team, working group/guild, etc. owns the repo",
+            "enum": ["guild", "working-group", "project"]
+        },
+        "parent": {
+            "type": "string",
+            "description": "Name of the main project repo if this is a sub-repo; name of the working group/guild repo if this is a working group/guild subproject"
+        },
+        "stage": {
+            "type": "string",
+            "enum": ["discovery", "alpha", "beta", "live"],
+            "description": "Maturity stage of the project"
+        },
+        "status": {
+            "type": "string",
+            "enum": ["active", "deprecated"],
+            "description": "Whether or not the project is actively maintained"
+        },
+        "description": {
+            "type": "string",
+            "description": "Description of the project"
+        },
+        "testable": {
+            "type": "boolean",
+            "default": false,
+            "description": "Should be 'true' if the project has a continuous build"
+        },
+        "team": {
+            "type": "array",
+            "description": "Team members contributing to the project",
+            "items": {
+                "$ref": "#/definitions/person"
+            },
+            "uniqueItems": true
+        },
+        "partners": {
+            "type": "array",
+            "description": "Partners for whom the project is developed",
+            "items": {"type": "string"},
+            "uniqueItems": true
+        },
+        "milestones": {
+            "type": "array",
+            "description": "Brief descriptions of significant project developments",
+            "items": {"type": "string"},
+            "uniqueItems": true
+        },
+        "stack": {
+            "type": "array",
+            "description": "Technologies used to build the project",
+            "items": {"type": "string"},
+            "uniqueItems": true
+        },
+        "impact": {
+            "type": "string",
+            "description": "Brief description of the project's outcomes"
+        },
+        "services": {
+            "type": "array",
+            "description": "Services used to supply project status information",
+            "items": {
+                "$ref": "#/definitions/service"
+            },
+            "uniqueItems": true
+        },
+        "licenses": {
+            "type": "object",
+            "description": "Licenses that apply to the project and/or its components",
+            "patternProperties": {
+                ".*": {"$ref": "#/definitions/license"}
+            }
+        },
+        "blog": {
+            "type": "array",
+            "description": "Blogs or websites associated with project development",
+            "items": {
+                "type": "string",
+                "format": "uri"
+            },
+            "format": "uri",
+            "uniqueItems": true
+        },
+        "links": {
+            "type": "array",
+            "description": "Links to project artifacts",
+            "items": {
+                "$ref": "#/definitions/link"
+            },
+            "format": "uri",
+            "uniqueItems": true
+        },
+        "contact": {
+            "type": "array",
+            "description": "Email addresses of points-of-contact",
+            "items": {
+              "type": "string",
+              "description": "Email address",
+              "format": "uri"
+            },
+            "uniqueItems": true
+        }
+    },
+    "required": [
+        "name", "full_name", "stage", "team", "licenses", "owner_type", "status", "testable"
+    ],
+    "definitions": {
+        "person": {
+            "type": "object",
+            "description": "Individual contributor to the project",
+            "properties": {
+                "github": {
+                    "type": "string",
+                    "description": "GitHub user name"
+                },
+                "id": {
+                    "type": "string",
+                    "description": "Internal team identifier/user name"
+                },
+                "role": {
+                    "type": "string",
+                    "description": "Team member's role; leads should be designated as 'lead'"
+                }
+            }
+        },
+        "service": {
+            "type": "object",
+            "description": "Service used to provide project status",
+            "properties": {
+                "name": {
+                    "type": "string",
+                    "description": "Name of the service"
+                },
+                "category": {
+                    "type": "string",
+                    "description": "Type of the service"
+                },
+                "url": {
+                    "type": "string",
+                    "description": "URL for detailed information",
+                    "format": "uri"
+                },
+                "badge": {
+                    "type": "string",
+                    "description": "URL for the status badge",
+                    "format": "uri"
+                }
+            }
+        },
+        "license": {
+            "type": "object",
+            "description": "License under which the project (or a component of the project) is offered",
+            "properties": {
+                "name": {
+                    "type": "string",
+                    "description": "Name of the license from the Software Package Data Exchange (SPDX): https://spdx.org/licenses/"
+                },
+                "url": {
+                    "type": "string",
+                    "description": "URL for the text of the license",
+                    "format": "uri"
+                }
+            }
+        },
+        "link": {
+            "type": "object",
+            "description": "Link to a project artifact",
+            "properties": {
+                "url": {
+                    "type": "string",
+                    "description": "URL for the link",
+                    "format": "uri"
+                },
+                "text": {
+                    "type": "string",
+                    "description": "Anchor text for the link"
+                }
+            }
+        }
+    }
+}

data/lib/about_yml/template_generator.rb

@@ -0,0 +1,67 @@
+# @author Mike Bland (michael.bland@gsa.gov)
+
+require_relative 'about'
+require 'json-schema'
+require 'safe_yaml'
+
+module AboutYml
+  class TemplateGenerator
+    attr_reader :schema, :properties, :required
+    def initialize
+      @schema = ::AboutYml::AboutFile.schema
+      @properties = schema['properties']
+      @required = schema['required']
+    end
+
+    def generate
+      props = properties.map { |name, defn| generate_item name, defn }
+      "---\n# #{schema['description']}\n#\n#{props.join "\n\n"}"
+    end
+
+    private
+
+    def generate_item(name, definition)
+      "#{property_description name, definition}\n#{name}:" \
+        "#{"\n- " if definition['type'] == 'array'}" \
+        "#{"\n  placeholder_label:" if definition['patternProperties']}"
+    end
+
+    def property_description(name, definition)
+      description = "# #{definition['description']}"
+      description += ' (required)' if required.include? name
+      description + value_description(definition)
+    end
+
+    def value_description(definition)
+      values = definition['enum']
+      return "\n# values: #{values.join ', '}" if values
+      type = definition['type']
+      return "\n# values: true, false" if type == 'boolean'
+      return item_description definition if type == 'array'
+      return pattern_desc definition if definition['patternProperties']
+      ''
+    end
+
+    def item_description(definition)
+      item_ref = definition['items']['$ref']
+      return '' unless item_ref
+      properties = definition_properties item_ref
+      descs = properties.map { |name, defn| "#{name}: #{defn['description']}" }
+      "\n# Items:\n# - #{descs.shift}\n#   #{descs.join "\n#   "}"
+    end
+
+    def pattern_desc(definition)
+      property_descs = definition['patternProperties'].map do |prop_name, ref|
+        descs = definition_properties(ref['$ref']).map do |defn_name, defn|
+          "#{defn_name}: #{defn['description']}"
+        end
+        "\n#   #{prop_name}:\n#     #{descs.join "\n#     "}"
+      end.join "\n"
+      "\n# Items by property name pattern:#{property_descs}"
+    end
+
+    def definition_properties(item_ref)
+      schema['definitions'][item_ref.split('/').last]['properties']
+    end
+  end
+end

data/lib/about_yml/version.rb

@@ -0,0 +1,5 @@
+# @author Mike Bland (michael.bland@gsa.gov)
+
+module AboutYml
+  VERSION = '0.0.0'
+end

data/lib/about_yml.rb

@@ -0,0 +1,5 @@
+# @author Mike Bland (michael.bland@gsa.gov)
+
+require_relative 'about_yml/about'
+require_relative 'about_yml/template_generator'
+require_relative 'about_yml/version'

metadata

@@ -0,0 +1,189 @@
+--- !ruby/object:Gem::Specification
+name: about_yml
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+platform: ruby
+authors:
+- Mike Bland
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-08-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: safe_yaml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: octokit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: json-schema
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: go_script
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: codeclimate-test-reporter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: The .about.yml mechanism allows an project to publish and maintain metadata
+  that can be easily maintained by project owners, that is visible and accessible
+  to interested parties, and that can be harvested and processed by tools and automated
+  systems.
+email:
+- michael.bland@gsa.gov
+executables:
+- about_yml_generator
+- about_yml_scrape
+- about_yml_validate
+- github_org_descriptions
+extensions: []
+extra_rdoc_files: []
+files:
+- CONTRIBUTING.md
+- LICENSE.md
+- README.md
+- bin/about_yml_generator
+- bin/about_yml_scrape
+- bin/about_yml_validate
+- bin/github_org_descriptions
+- lib/about_yml.rb
+- lib/about_yml/about.rb
+- lib/about_yml/schema.json
+- lib/about_yml/template_generator.rb
+- lib/about_yml/version.rb
+homepage: https://github.com/18F/about_yml
+licenses:
+- CC0
+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.4.5.1
+signing_key: 
+specification_version: 4
+summary: ".about.yml project metadata schema and tools"
+test_files: []