knife-spork 0.1.11 → 1.0.0

data/plugins/Campfire.md

@@ -0,0 +1,43 @@
+Campfire
+========
+Automatically posts informational messages to Campfire
+
+Gem Requirements
+----------------
+This plugin requires the following gems:
+
+```ruby
+gem 'tinder'
+```
+
+Hooks
+-----
+- `after_promote`
+- `after_upload`
+
+Configuration
+-------------
+```yaml
+plugins:
+  campfire:
+    account: my_company
+    token: ABC123
+    rooms:
+      - General
+      - Web Operations
+```
+
+#### account
+This is your campfire account name. It is the subdomain part of your account.
+
+- Type: `String`
+
+#### token
+This is the secure token you get from the Campfire configuration.
+
+- Type: `String`
+
+#### Rooms
+This is an array of room names to post messages to.
+
+- Type: `String`

data/plugins/Eventinator.md

@@ -0,0 +1,30 @@
+Eventinator
+===========
+
+Gem Requirements
+----------------
+This plugin has no gem requirements.
+
+Hooks
+-----
+- `after_upload`
+
+Configuration
+-------------
+```yaml
+plugins:
+  eventinator:
+    url: www.example.com
+    read_timeout: 5
+```
+
+#### url
+The server to post to.
+
+- Type: `String`
+
+#### read_timeout
+The timeout, in seconds, for the request to return.
+
+- Type: `Integer`
+- Default: `5`

data/plugins/Foodcritic.md

@@ -0,0 +1,53 @@
+Foodcritic
+==========
+Automatically runs foodcritic against your cookbooks on check and upload.
+
+Gem Requirements
+----------------
+This plugin requires the following gems:
+
+```ruby
+gem 'foodcritic'
+```
+
+Hooks
+-----
+- `after_check`
+- `before_upload`
+
+Configuration
+-------------
+```yaml
+plugins:
+  foodcritic:
+    tags:
+      - FC0023
+    fail_tags:
+      - any
+    include_rules:
+      - foodcritic/etsy
+    epic_fail: true
+```
+
+#### tags
+The tags to check against.
+
+- Type: `Array`
+- Default: '[any]'
+
+#### fail_tags
+The list of tags to fail on.
+
+- Type: 'Array'
+- Default: '[any]'
+
+#### include_rules
+An optional list of additional rules to run.
+
+- Type: `Array`
+
+#### epic_fail:
+If set to true, `epic_fail` will prevent you from uploading a cookbook until all foodcritic rules pass.
+
+- Type: `Boolean`
+- Default: `true`

data/plugins/Git.md

@@ -0,0 +1,46 @@
+Git
+===
+This plugin attempts to help manage your workflow by automatically pulling changes from your repo. **Do not use this plugin if you are not using Git.**
+
+Gem Requirements
+----------------
+This plugin requires the following gems:
+
+```ruby
+gem 'git'
+```
+
+Hooks
+-----
+- `before_bump`
+- `after_bump`
+- `after_promote`
+
+Configuration
+-------------
+```yaml
+plugins:
+  git:
+    remote: origin
+    branch: master
+```
+
+**Note** Due to the nature of the git plugin, it's possible that you accept all the defaults. In that case, you should make your configuration like this:
+
+```yaml
+plugins:
+  git:
+    enabled: true
+```
+
+#### remote
+The git remote to push/pull to/from.
+
+- Type: `String`
+- Default: `origin`
+
+#### branch
+The git brnach to push/pull to/from.
+
+- Type: `String`
+- Default: `master`

data/plugins/Graphite.md

@@ -0,0 +1,30 @@
+Graphite
+========
+Graphite will automatically send a request to your Graphite server under the deploys.chef.[environment] for graphical analysis.
+
+Gem Requirements
+----------------
+This plugin has no gem requirements.
+
+Hooks
+-----
+- `after_promote`
+
+Configuration
+-------------
+```yaml
+plugins:
+  graphite:
+    server: graphite.example.com
+    port: 12345
+```
+
+#### server
+The url to the graphite server
+
+- Type: `String`
+
+#### port
+The port of the graphite server
+
+- Type: `Integer`

data/plugins/HipChat.md

@@ -0,0 +1,50 @@
+HipChat
+=======
+HipChat posts messages to your HipChat client.
+
+Gem Requirements
+----------------
+This plugin requires the following gems:
+
+```ruby
+gem 'hipchat'
+```
+
+Hooks
+-----
+- `after_upload`
+- `after_promote`
+
+Configuration
+-------------
+```yaml
+plugins:
+  hipchat:
+    api_token: ABC123
+    rooms:
+      - General
+      - Web Operations
+    notify: true
+    color: yellow
+```
+
+#### api_token
+Your HipChat API token.
+
+- Type: `String`
+
+#### rooms
+The list of rooms to post to.
+
+- Type: `Array`
+
+#### notify
+Boolean value indicating whether the room should be notified.
+
+- Type: `Boolean`
+
+#### color
+THe color of the message.
+
+- Type: `String`
+- Acceptable Values: `[yellow, red, green, purple, random]`

data/plugins/Irccat.md

@@ -0,0 +1,44 @@
+Plugin Name
+===========
+This plugin interfaces with the irccat IRC bot (https://github.com/RJ/irccat)
+
+Gem Requirements
+----------------
+This plugin has no gem requirements.`
+
+Hooks
+-----
+- `after_promote`
+
+Configuration
+-------------
+```yaml
+plugins:
+  irccat:
+    server: irc.example.com
+    port: 54
+    channels:
+      - #chef
+      - #knife
+    gist: "/usr/bin/gist"
+```
+
+#### server
+The url of the IRC server.
+
+- Type: `String`
+
+#### port
+The port of the IRC server.
+
+- Type: `String`
+
+#### channels
+The channels to post to.
+
+- Type: `Array`
+
+#### gist
+Optional path to gist binary installed by https://rubygems.org/gems/gist
+
+- Type: `String`

data/plugins/README.md

@@ -0,0 +1,70 @@
+Plugins Directory
+=================
+This folder contains relevant documentation for each KnifeSpork plugin. For more information, usage, and options for an particular plugin, click on the assoicated markdown file in the tree above.
+
+Creating a Plugin
+-----------------
+To create a plugin, start with the following basic boiler template:
+
+```ruby
+require 'knife-spork/plugins/plugin'
+
+module KnifeSpork
+  module Plugins
+    class MyPlugin < Plugin
+      name :my_plugin
+
+      def perform
+        # your plugin code here
+      end
+    end
+  end
+end
+```
+
+**Don't forget to update the class name and the `name` at the very top of the class!**
+
+Helpers
+-------
+The following "helpers" or "methods" are exposed:
+
+#### safe_require
+This method allows you to safely require a gem. This is helpful when your plugin requires an external plugin. It will output a nice error message if the gem cannot be loaded and stop executing.
+
+#### current_user
+This method tries to get the current user's name in the following manner:
+
+1. From the git configuration
+2. From the `ENV`
+
+#### config
+This method returns the config associated with the current plugin. For example, if a `spork-config.yml` file looked like this:
+
+```yaml
+plugins:
+  my_plugin:
+    option_1: my_value
+    option_2: other_value
+```
+
+then
+
+```text
+config.option_1   #=> 'my_value'
+config.option_2   #=> 'other_value'
+```
+
+This uses `app_conf`, so you access the keys are methods, not `[]`.
+
+#### cookbooks
+This returns an array of `Chef::CookbookVersion` objects corresponding to the cookbooks that are being changed/altered in the hook. For more information on the methods avaliable, see the [file in the Chef repo](https://github.com/opscode/chef/blob/master/chef/lib/chef/cookbook_version.rb).
+
+#### environments
+This returns an array of `Chef::Environment` objects corresponding to the environments that are being changed/altered in the hook. For more information on the methods avaliable, see the [file in the Chef repo](https://github.com/opscode/chef/blob/master/chef/lib/chef/environment.rb).
+
+#### environment_diffs
+This returns a Hash of Hash objects containing a diff between local and remote environment for each environment changed/altered in the hook. Currently, this will only be populated during the promotea action. 
+
+
+#### ui
+This returns a `Chef::Knife::UI` element for outputting to the console. For more information on the methods avaliable, see the [file in the Chef repo](https://github.com/opscode/chef/blob/master/chef/lib/chef/knife/core/ui.rb).

data/plugins/Template.md

@@ -0,0 +1,34 @@
+Plugin Name
+===========
+Here is an optional, short description about your plugin.
+
+Gem Requirements
+----------------
+This plugin requires the following gems:
+
+```ruby
+gem 'my_gem', '~> 1.4.5'
+gem 'other_gem', '>= 5.0.1'
+```
+
+Hooks
+-----
+- `after_promote`
+
+Configuration
+-------------
+```yaml
+plugins:
+  plugin_name:
+    option_1: true
+    option_2:
+      - a
+      - b
+      - c
+```
+
+#### option_1
+This is a description of the option.
+
+- Type: `String`
+- Default: `ABC`

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: knife-spork
 version: !ruby/object:Gem::Version
-  version: 0.1.11
+  version: 1.0.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-06-05 00:00:00.000000000 Z
+date: 2012-08-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: chef
-  requirement: &70361791232900 !ruby/object:Gem::Requirement
+  requirement: &70197088928460 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: 0.10.4
   type: :runtime
   prerelease: false
-  version_requirements: *70361791232900
+  version_requirements: *70197088928460
 - !ruby/object:Gem::Dependency
   name: git
-  requirement: &70361791232420 !ruby/object:Gem::Requirement
+  requirement: &70197088927580 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: 1.2.5
   type: :runtime
   prerelease: false
-  version_requirements: *70361791232420
+  version_requirements: *70197088927580
 - !ruby/object:Gem::Dependency
   name: app_conf
-  requirement: &70361791231940 !ruby/object:Gem::Requirement
+  requirement: &70197088927020 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,39 +43,50 @@ dependencies:
         version: 0.4.0
   type: :runtime
   prerelease: false
-  version_requirements: *70361791231940
-- !ruby/object:Gem::Dependency
-  name: hipchat
-  requirement: &70361790131840 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: 0.4.0
-  type: :runtime
-  prerelease: false
-  version_requirements: *70361790131840
+  version_requirements: *70197088927020
 description: A workflow plugin to help many devs work with the same chef repo/server
 email: jonlives@gmail.com
 executables: []
 extensions: []
-extra_rdoc_files:
-- README.md
+extra_rdoc_files: []
 files:
-- README.md
+- .gitignore
+- .rvmrc
 - CHANGELOG.md
+- Gemfile
+- LICENSE
+- README.md
 - Rakefile
 - knife-spork.gemspec
 - lib/chef/knife/spork-bump.rb
 - lib/chef/knife/spork-check.rb
+- lib/chef/knife/spork-info.rb
 - lib/chef/knife/spork-promote.rb
 - lib/chef/knife/spork-upload.rb
 - lib/knife-spork.rb
+- lib/knife-spork/plugins.rb
+- lib/knife-spork/plugins/campfire.rb
+- lib/knife-spork/plugins/eventinator.rb
+- lib/knife-spork/plugins/foodcritic.rb
+- lib/knife-spork/plugins/git.rb
+- lib/knife-spork/plugins/graphite.rb
+- lib/knife-spork/plugins/hip_chat.rb
+- lib/knife-spork/plugins/irccat.rb
+- lib/knife-spork/plugins/plugin.rb
+- lib/knife-spork/runner.rb
+- plugins/Campfire.md
+- plugins/Eventinator.md
+- plugins/Foodcritic.md
+- plugins/Git.md
+- plugins/Graphite.md
+- plugins/HipChat.md
+- plugins/Irccat.md
+- plugins/README.md
+- plugins/Template.md
 homepage: https://github.com/jonlives/knife-spork
 licenses: []
 post_install_message: 
-rdoc_options:
-- --charset=UTF-8
+rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
@@ -91,10 +102,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: knife-spork
+rubyforge_project: 
 rubygems_version: 1.8.10
 signing_key: 
-specification_version: 2
+specification_version: 3
 summary: A workflow plugin to help many devs work with the same chef repo/server
 test_files: []
-has_rdoc: