cartage-rack 1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1fa674a4148825b651ef4b4877a11512f398fccf
+  data.tar.gz: 41fd855e575def1e21c4822ad926825bbfb29f84
+SHA512:
+  metadata.gz: bd9c50ca6065c103d6df58d84541be5d9d342955e1ce14ed5e103bd31a78d6098a95e405f8c55b371eb31657dc9e9aac408723901a02f553aba9460f4f4af232
+  data.tar.gz: cdf0ee60b847b6c8450c7c87492474147691bcd880554a091ddf4ec287c33b721667f0b7f4ced8012f538ef985a05704c159b8f6375b7f892341b90f9b4f7587

data/.autotest

@@ -0,0 +1,27 @@
+# -*- ruby -*-
+
+require "autotest/restart"
+
+Autotest.add_hook :initialize do |at|
+  # .minitest.rb ensures that the gem version of minitest is used.
+  at.testlib = ".minitest.rb"
+  # at.testlib = "minitest/unit"
+  #
+  # at.extra_files << "../some/external/dependency.rb"
+  #
+  # at.libs << ":../some/external"
+  #
+  # at.add_exception "vendor"
+  #
+  # at.add_mapping(/dependency.rb/) do |f, _|
+  #   at.files_matching(/test_.*rb$/)
+  # end
+  #
+  # %w(TestA TestB).each do |klass|
+  #   at.extra_class_map[klass] = "test/test_misc.rb"
+  # end
+end
+
+# Autotest.add_hook :run_command do |at|
+#   system "rake build"
+# end

data/.gemtest

@@ -0,0 +1 @@
+

data/.minitest.rb

@@ -0,0 +1,2 @@
+gem "minitest"
+require "minitest/autorun"

data/Contributing.rdoc

@@ -0,0 +1,63 @@
+== Contributing
+
+We value any contribution to cartage-rack you can provide: a bug report, a
+feature request, or code contributions.
+
+cartage-rack has a few contribution guidelines:
+
+* Changes *will* *not* be accepted without tests. The test suite is written
+  with {Minitest}[https://github.com/seattlerb/minitest].
+* Match our coding style.
+* Use a thoughtfully-named topic branch that contains your change. Rebase your
+  commits into logical chunks as necessary.
+* Use {quality commit messages}[http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html].
+* Do not change the version number; when your patch is accepted and a release
+  is made, the version will be updated at that point.
+* Submit a GitHub pull request with your changes.
+
+=== Test Dependencies
+
+cartage-rack uses Ryan Davis’s {Hoe}[https://github.com/seattlerb/hoe] to manage
+the release process, and it adds a number of rake tasks. You will mostly be
+interested in:
+
+    $ rake
+
+which runs the tests the same way that:
+
+    $ rake test
+    $ rake travis
+
+will do.
+
+To assist with the installation of the development dependencies for cartage-rack,
+I have provided the simplest possible Gemfile pointing to the (generated)
++cartage-rack.gemspec+ file. This will permit you to do:
+
+    $ bundle install
+
+to get the development dependencies. If you aleady have +hoe+ installed, you
+can accomplish the same thing with:
+
+    $ rake newb
+
+This task will install any missing dependencies, run the tests/specs, and
+generate the RDoc.
+
+=== Workflow
+
+Here's the most direct way to get your work merged into the project:
+
+* Fork the project.
+* Clone down your fork (<tt>git clone git://github.com/KineticCafe/cartage-rack.git</tt>).
+* Create a topic branch to contain your change (<tt>git checkout -b my\_awesome\_feature</tt>).
+* Hack away, add tests. Not necessarily in that order.
+* Make sure everything still passes by running +rake+.
+* If necessary, rebase your commits into logical chunks, without errors.
+* Push the branch up (<tt>git push origin my\_awesome\_feature</tt>).
+* Create a pull request against KineticCafe/cartage-rack and describe
+  what your change does and the why you think it should be merged.
+
+=== Contributors
+
+* Austin Ziegler created cartage-rack.

data/Gemfile

@@ -0,0 +1,9 @@
+# -*- ruby -*-
+
+# NOTE: This file is not the canonical source of dependencies. Edit the
+# Rakefile, instead.
+
+source "https://rubygems.org/"
+gemspec
+
+# vim: syntax=ruby

data/History.rdoc

@@ -0,0 +1,5 @@
+=== 1.0 / 2015-03-20
+
+*   1 major enhancement
+
+    *   Birthday!

data/Licence.rdoc

@@ -0,0 +1,27 @@
+== Licence
+
+This software is available under an MIT-style licence.
+
+* Copyright 2015 Kinetic Cafe
+
+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 names of its contributors may not be used to endorse or promote
+  products derived from this software without specific prior written
+  permission.
+
+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/Manifest.txt

@@ -0,0 +1,11 @@
+.autotest
+.gemtest
+.minitest.rb
+Contributing.rdoc
+Gemfile
+History.rdoc
+Licence.rdoc
+Manifest.txt
+README.rdoc
+Rakefile
+lib/cartage/rack.rb

data/README.rdoc

@@ -0,0 +1,68 @@
+= cartage-rack by Kinetic Cafe
+
+code :: https://github.com/KineticCafe/cartage-rack/
+issues :: https://github.com/KineticCafe/cartage-rack/issues
+continuous integration :: {<img src="https://travis-ci.org/KineticCafe/cartage-rack.png" />}[https://travis-ci.org/KineticCafe/cartage-rack]
+
+== Description
+
+cartage-rack is a plug-in for {cartage}[https://github.com/KineticCafe/cartage]
+to provide a Rack application.
+
+Cartage provides a repeatable means to create a package for a Rails application
+that can be used in deployment with a configuration tool like Ansible, Chef,
+Puppet, or Salt. The package is created with its dependencies bundled in
++vendor/bundle+, so it can be deployed in environments with strict access
+control rules and without requiring development tool access.
+
+== Synopsis
+
+Cartage::Rack provides a Rack application generator to read and return the
++release_hashref+ from an endpoint to verify that the server was deployed. This
+endpoint supports both JSON and plaintext output. To add this to a Rails
+application, simply mount it in +config/routes.rb+:
+
+    require 'cartage/rack'
+
+    Rails.application.routes.draw do
+      get '/release' => Cartage::Rack.mount(Rails.root)
+    end
+
+Or map it in a normal Rack application in +config.ru+:
+
+    require 'cartage/rack'
+    map('/release') do
+      run Cartage::Rack.mount(Dir.pwd)
+    end
+
+It can then be queried easily:
+
+    % rails start
+    % curl localhost:3000/release
+    development: (git) main
+    % curl localhost:3000/release.json
+    { "env" : "development", "release_hashref" : "(git) main" }
+
+== Install
+
+Add cartage-rack to your Gemfile:
+
+    gem 'cartage-rack', '~> 1.0'
+
+Or manually install:
+
+  % gem install cartage-rack
+
+== cartage-rack Semantic Versioning
+
+cartage-rack uses a {Semantic Versioning}[http://semver.org/] scheme with one
+change:
+
+* When PATCH is zero (+0+), it will be omitted from version references.
+
+cartage-rack will generally track cartage for major versions to ensure plugin API
+compatibility.
+
+:include: Contributing.rdoc
+
+:include: Licence.rdoc

data/Rakefile

@@ -0,0 +1,49 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require 'pathname'
+
+Hoe.plugin :doofus
+Hoe.plugin :email unless ENV['CI'] or ENV['TRAVIS']
+Hoe.plugin :gemspec2
+Hoe.plugin :git
+Hoe.plugin :minitest
+Hoe.plugin :rubygems
+
+spec = Hoe.spec 'cartage-rack' do
+  developer('Austin Ziegler', 'aziegler@kineticcafe.com')
+
+  self.history_file = 'History.rdoc'
+  self.readme_file = 'README.rdoc'
+  self.extra_rdoc_files = FileList['*.rdoc'].to_a
+
+  license 'MIT'
+
+  self.extra_dev_deps << ['rake', '~> 10.0']
+  self.extra_dev_deps << ['rack-test', '~> 0.6']
+  self.extra_dev_deps << ['hoe-doofus', '~> 1.0']
+  self.extra_dev_deps << ['hoe-gemspec2', '~> 1.1']
+  self.extra_dev_deps << ['hoe-git', '~> 1.5']
+  self.extra_dev_deps << ['minitest', '~> 5.4']
+  self.extra_dev_deps << ['minitest-autotest', '~> 1.0']
+  self.extra_dev_deps << ['minitest-bisect', '~> 1.2']
+  self.extra_dev_deps << ['minitest-focus', '~> 1.1']
+  self.extra_dev_deps << ['minitest-moar', '~> 0.0']
+  self.extra_dev_deps << ['minitest-pretty_diff', '~> 0.1']
+  self.extra_dev_deps << ['simplecov', '~> 0.7']
+end
+
+namespace :test do
+  task :coverage do
+    prelude = <<-EOS
+require 'simplecov'
+SimpleCov.start('test_frameworks') { command_name 'Minitest' }
+gem 'minitest'
+    EOS
+    spec.test_prelude = prelude.split($/).join('; ')
+    Rake::Task['test'].execute
+  end
+end
+
+# vim: syntax=ruby

data/lib/cartage/rack.rb

@@ -0,0 +1,52 @@
+require 'pathname'
+
+# Cartage, a package builder.
+class Cartage; end
+
+# Cartage::Rack is a simple application that reads an application’s
+# +release_hashref+ and returns it as a +text/plain+ string, or as
+# +application/json+ if it is called with +.json+.
+#
+# If +release_hashref+ does not exist, Cartage::Rack will read the hash of the
+# current HEAD.
+class Cartage::Rack
+  VERSION = '1.0' #:nodoc:
+
+  # Creates a new version of the Cartage::Rack application to the specified
+  # +root_path+, or +Dir.pwd+.
+  def self.mount(root_path = Dir.pwd)
+    new(root_path)
+  end
+
+  # Sets the root path for Cartage::Rack.
+  def initialize(root_path)
+    @root_path = Pathname(root_path)
+  end
+
+  # The Rack application method.
+  def call(env)
+    file = @root_path.join('release_hashref')
+    release_hashref = if file.exist?
+                        file.read
+                      elsif @root_path.join('.git').directory?
+                        "(git) #{%x(git rev-parse --abbrev-ref HEAD)}"
+                      else
+                        'UNKNOWN - no release_hashref or source control directory'
+                      end
+    application_env = ENV['RAILS_ENV'] || ENV['RACK_ENV'] || 'UNKNOWN'
+
+    case env['PATH_INFO']
+    when /\.json\z/
+      type = 'application/json'
+      body = {
+        env: application_env,
+        release_hashref: release_hashref
+      }.to_json
+    else
+      type = 'text/plain'
+      body = "#{application_env}: #{release_hashref}"
+    end
+
+    [ '200', { 'Content-Type' => type }, [ body ] ]
+  end
+end

metadata

@@ -0,0 +1,267 @@
+--- !ruby/object:Gem::Specification
+name: cartage-rack
+version: !ruby/object:Gem::Version
+  version: '1.0'
+platform: ruby
+authors:
+- Austin Ziegler
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-03-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.5'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !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: rack-test
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: hoe-doofus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: hoe-gemspec2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: hoe-git
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: minitest-autotest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: minitest-bisect
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: minitest-focus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: minitest-moar
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+- !ruby/object:Gem::Dependency
+  name: minitest-pretty_diff
+  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: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+description: |-
+  cartage-rack is a plug-in for {cartage}[https://github.com/KineticCafe/cartage]
+  to provide a Rack application.
+
+  Cartage provides a repeatable means to create a package for a Rails application
+  that can be used in deployment with a configuration tool like Ansible, Chef,
+  Puppet, or Salt. The package is created with its dependencies bundled in
+  +vendor/bundle+, so it can be deployed in environments with strict access
+  control rules and without requiring development tool access.
+email:
+- aziegler@kineticcafe.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- Contributing.rdoc
+- History.rdoc
+- Licence.rdoc
+- Manifest.txt
+- README.rdoc
+files:
+- ".autotest"
+- ".gemtest"
+- ".minitest.rb"
+- Contributing.rdoc
+- Gemfile
+- History.rdoc
+- Licence.rdoc
+- Manifest.txt
+- README.rdoc
+- Rakefile
+- lib/cartage/rack.rb
+homepage: https://github.com/KineticCafe/cartage-rack/
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--main"
+- README.rdoc
+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.2.2
+signing_key: 
+specification_version: 4
+summary: cartage-rack is a plug-in for {cartage}[https://github.com/KineticCafe/cartage]
+  to provide a Rack application
+test_files: []