chef-taste 1.0.0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Kannan Manickam <me@arangamani.net>
+
+MIT License
+
+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,108 @@
+# Chef::Taste
+
+Chef Taste is a simple command line utility to check a cookbook's dependency status.
+It will list the dependent cookbooks in a tabular format with the version information,
+status, and the changelog (if possible) for out-of-date cookbooks.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'chef-taste'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install chef-taste
+
+## Usage
+
+When you are inside the cookbooks directory, simply type `taste` to taste the cookbook.
+The `metadata.rb` of the cookbook is parsed to obtain the dependencies. It will display
+a table that contains the following rows:
+
+* `Name` - The name of the cookbook
+* `Requirement` - The version requirement specified in the metadata
+* `Used` - The final version used based on the requirement constraint
+* `Latest` - The latest version available in the community site
+* `Status` - The status of the cookbook: up-to-date (a green tick mark) or out-of-date (a red x mark)
+* `Changelog` - The changelog of out-of-date cookbooks if available.
+
+The overall status will also be displayed in the bottom of the table.
+
+### Changelog
+Most of the cookbooks are hosted in Github and are tagged for every release.
+The changelog is computed by obtaining the source URL provided in the community site and
+finding the tags being used and the latest tag and displaying a compare view that
+compares these two tags. This URL is then shortened using goo.gl URL shortener to fit the table.
+
+The details are obtained only for cookbooks available in the community site. Other cookbooks are
+displayed but will simply have `N/A` in their details.
+
+### Examples
+
+These examples are based on the cookbooks available in the `test/cookbooks` directory
+in this repository.
+
+#### 1. fried_rice cookbook
+
+```bash
+kannanmanickam@mac fried_rice$ taste
++------------+-------------+--------+--------+--------+----------------------+
+| Name       | Requirement | Used   | Latest | Status | Changelog            |
++------------+-------------+--------+--------+--------+----------------------+
+| ntp        | ~> 1.4.0    | 1.4.0  | 1.5.0  |   ✖    | http://goo.gl/qsfgwA |
+| swap       | = 0.3.5     | 0.3.5  | 0.3.6  |   ✖    | http://goo.gl/vZtUQJ |
+| windows    | >= 0.0.0    | 1.11.0 | 1.11.0 |   ✔    |                      |
+| awesome_cb | >= 0.0.0    | N/A    | N/A    |  N/A   |                      |
++------------+-------------+--------+--------+--------+----------------------+
+Status: out-of-date ( ✖ )
+```
+
+#### 2. noodles cookbook
+
+```bash
+kannanmanickam@mac noodles$ taste
++---------+-------------+--------+--------+--------+----------------------+
+| Name    | Requirement | Used   | Latest | Status | Changelog            |
++---------+-------------+--------+--------+--------+----------------------+
+| mysql   | ~> 3.0.12   | 3.0.12 | 3.0.12 |   ✔    |                      |
+| apache2 | ~> 1.7.0    | 1.7.0  | 1.8.4  |   ✖    | http://goo.gl/9ejcpi |
+| windows | >= 0.0.0    | 1.11.0 | 1.11.0 |   ✔    |                      |
++---------+-------------+--------+--------+--------+----------------------+
+Status: out-of-date ( ✖ )
+```
+
+#### 3. curry cookbook
+
+```bash
+kannanmanickam@mac curry$ taste
++-----------------+-------------+-------+--------+--------+-----------+
+| Name            | Requirement | Used  | Latest | Status | Changelog |
++-----------------+-------------+-------+--------+--------+-----------+
+| ntp             | >= 0.0.0    | 1.5.0 | 1.5.0  |   ✔    |           |
+| lvm             | >= 0.0.0    | 1.0.0 | 1.0.0  |   ✔    |           |
+| application     | >= 0.0.0    | 4.1.0 | 4.1.0  |   ✔    |           |
+| application_php | >= 0.0.0    | 2.0.0 | 2.0.0  |   ✔    |           |
++-----------------+-------------+-------+--------+--------+-----------+
+Status: up-to-date ( ✔ )
+```
+
+#### 4. water cookbook
+
+```bash
+kannanmanickam@mac water$ taste
+No dependent cookbooks
+```
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/taste

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+$:.push File.expand_path("../../lib", __FILE__)
+require 'chef/taste'
+
+Chef::Taste::Cli.start

data/chef-taste.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'chef/taste/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "chef-taste"
+  spec.version       = Chef::Taste::VERSION
+  spec.authors       = ["Kannan Manickam"]
+  spec.email         = ["me@arangamani.net"]
+  spec.description   = %q{This gem checks if updated versions of dependent cookbooks are available for the cookbook}
+  spec.summary       = %q{Chef cookbook dependency update checker}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+
+  spec.add_dependency "solve", "~> 0.8.0"
+  spec.add_dependency "berkshelf", "~> 2.0.10"
+  spec.add_dependency "thor", "~> 0.18.0"
+  spec.add_dependency "terminal-table", "~> 1.4.5"
+  spec.add_dependency "googl", "~> 0.6.3"
+  spec.add_dependency "octokit", "~> 2.5.0"
+  spec.add_dependency "colorize", "~> 0.5.8"
+end

data/lib/chef/taste.rb

@@ -0,0 +1,41 @@
+#
+# Copyright (c) 2013 Kannan Manickam <me@arangamani.net>
+#
+# MIT License
+#
+# 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.
+#
+
+require 'berkshelf'
+require 'colorize'
+require 'googl'
+require 'octokit'
+require 'ridley'
+require 'terminal-table'
+require 'thor'
+
+require_relative 'taste/cli'
+require_relative 'taste/changelog'
+require_relative 'taste/dependency'
+require_relative 'taste/dependency_checker'
+require_relative 'taste/display'
+require_relative 'taste/errors'
+require_relative 'taste/symbols'
+require_relative 'taste/version'

data/lib/chef/taste/changelog.rb

@@ -0,0 +1,107 @@
+#
+# Copyright (c) 2013 Kannan Manickam <me@arangamani.net>
+#
+# MIT License
+#
+# 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.
+#
+
+require 'chef/taste'
+
+module Chef
+  module Taste
+    # The Changelog class that computes the changelog if the current version
+    # being used and the latest version are different and the changelog is computable.
+    #
+    class Changelog
+      class << self
+        # Compute the changelog for the dependent cookbook if available
+        #
+        # @param dep [Dependency] the dependent cookbook
+        #
+        # @return [String] the goo.gl shortened URL for the changelog
+        #
+        def compute(dep)
+          changelog_url =
+            if dep.source_url =~ /^(https?:\/\/)?github.com\/(.*)\/(.*)$/
+              GithubChangelog.new("#{$2}/#{$3}", dep.version_used, dep.latest).compute
+            else
+              nil
+            end
+          Googl.shorten(changelog_url).short_url unless changelog_url.nil?
+        end
+      end
+
+      # The class for computing the changelog for cookbooks hosted in Github.
+      #
+      class GithubChangelog
+        # The Github repository
+        attr_reader :repo
+
+        # The version to compare from
+        attr_reader :from_version
+
+        # The version to compare to
+        attr_reader :to_version
+
+        # Constructor
+        #
+        # @param repo [String] the Github repo
+        # @param from_version [String] the version to compare from
+        # @param to_version [String] the version to compare to
+        #
+        # @return [GithubChangelog] the Github changelog object
+        #
+        def initialize(repo, from_version, to_version)
+          @repo = repo
+          @from_version = from_version
+          @to_version = to_version
+        end
+
+        # Computes the changelog URL for Github repositories
+        #
+        # @return [String] the computed changelog URL
+        #
+        def compute
+          tags = Octokit.tags(repo)
+          from_tag = nil
+          to_tag = nil
+          tags.each do |tag|
+            tag_name = tag.name
+            from_tag = tag_name if tag_name =~ /v?#{from_version}/
+            to_tag = tag_name if tag_name =~ /v?#{to_version}/
+          end
+          compare_url(from_tag, to_tag) if from_tag && to_tag
+        end
+
+        # Returns the compare URL for comparing two tags on Github
+        #
+        # @param from_tag [String] the tag to compare from
+        # @param to_tag [String] the tag to compare to
+        #
+        # @return [String] the Github URL to compare given two tags
+        #
+        def compare_url(from_tag, to_tag)
+          "https://github.com/#{repo}/compare/#{from_tag}...#{to_tag}"
+        end
+      end
+    end
+  end
+end

data/lib/chef/taste/cli.rb

@@ -0,0 +1,46 @@
+#
+# Copyright (c) 2013 Kannan Manickam <me@arangamani.net>
+#
+# MIT License
+#
+# 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.
+#
+
+require 'chef/taste'
+
+module Chef
+  module Taste
+    # The CLI for chef-taste
+    #
+    class Cli < Thor
+      # The default task
+      default_task :check
+
+      desc 'check', 'Check status of dependent cookbooks'
+      # The check command
+      def check
+        dependencies = DependencyChecker.check
+        Display.print(dependencies)
+      rescue NotACookbookError
+        puts "The path is not a cookbook path".red
+      end
+    end
+  end
+end

data/lib/chef/taste/dependency.rb

@@ -0,0 +1,72 @@
+#
+# Copyright (c) 2013 Kannan Manickam <me@arangamani.net>
+#
+# MIT License
+#
+# 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.
+#
+
+require 'chef/taste'
+
+module Chef
+  module Taste
+    # The class that contains information about a dependent cookbook
+    #
+    class Dependency
+      # The name of the dependency
+      attr_reader :name
+
+      # The requirement for the dependency
+      attr_reader :requirement
+
+      # The version of cookbook used after applying the version constraint
+      attr_accessor :version_used
+
+      # The latest version available for the dependency
+      attr_accessor :latest
+
+      # The status of the dependency
+      attr_accessor :status
+
+      # The source URL for a cookbook
+      attr_accessor :source_url
+
+      # The changelog link for the dependency if available
+      attr_accessor :changelog
+
+      # Constructor
+      #
+      # @param name [String] the name of the dependent cookbook
+      # @param requirement [String] the version requirement for dependent cookbook
+      #
+      # @return [Dependency] the Dependency object
+      #
+      def initialize(name, requirement)
+        @name = name
+        @requirement = requirement
+        @version_used = 'N/A'
+        @latest = 'N/A'
+        @status = 'N/A'
+        @source_url = nil
+        @changelog = nil
+      end
+    end
+  end
+end