knife-stash 0.1.0

data/.gitignore

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

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+## v0.1.0
+
+* Initial release

data/Gemfile

@@ -0,0 +1,5 @@
+source :rubygems
+
+gemspec
+
+gem "faraday"

data/README.md

@@ -0,0 +1,117 @@
+# Knife Stash
+
+A knife plugin for Atlassian Stash.
+
+## Installation
+
+* Clone repo to ~/.chef/plugins/knife or path/to/cheforg/.chef/plugins/knife
+
+## Usage
+
+Plugin will prompt for any missing passwords.
+
+### Common parameters
+
+* `--noop` - Perform no modifying operations
+* `--stash-username USERNAME` - Stash username, defaults to
+  `ENV['USER']`
+* `--stash-password PASSWORD` - Stash password, defaults to nothing but will ask if necessary
+* `--stash-hostname HOSTNAME` - Stash hostname, no default
+
+### knife stash project create KEY NAME
+
+Creates a Stash project.
+
+* `--description DESCRIPTION` - optionally set a description for the project
+
+For example:
+
+    $ knife stash project create TEST "Test Project from API"
+    Created Stash Project: TEST (Test Project from API)
+
+### knife stash project delete KEY
+
+Deletes a Stash project.
+
+* `--delete-repos` - required if any repositories exist under project
+
+For example:
+
+    $ knife stash project delete TEST --delete-repos
+    Deleted Stash Repository: TEST/repo1
+    Deleted Stash Repository: TEST/repo2
+    Deleted Stash Project: TEST
+
+### knife stash project repos KEY
+
+Lists all Stash repositories in a project.
+
+    $ knife stash project repos COOKBOOKS
+    cessna (cessna)
+    netbackup (netbackup)
+    remoteaddr (remoteaddr)
+    template-cookbook (template-cookbook)
+    ...
+
+### knife stash projects
+
+Lists all Stash projects.
+
+    $ knife stash projects
+    CHEF_BASEBOX: Chef Basebox
+    COOKBOOKS: Chef Cookbooks
+    CHEFORG_CORE_SYSTEMS: Chef Organization core-systems
+    CHEFORG_FNCE: Chef Organization FNCE
+    ...
+
+### knife stash repo create KEY REPO
+
+Creates a Stash repository in a project.
+
+    $ knife stash repo create TEST repo1
+    Created Stash Repository: TEST/repo1
+    Available via (HTTPS): https://bflad@stash.example.com/scm/TEST/repo1.git
+    Available via (SSH): ssh://git@stash.example.com:7999/TEST/repo1.git
+
+### knife stash repo delete KEY REPO
+
+Deletes a Stash repository in a project.
+
+    $ knife stash repo delete TEST repo1
+    Deleted Stash Repository: TEST/repo1
+
+### knife stash repos
+
+Lists all Stash repositories in all projects.
+
+    $ knife stash repos
+    CHEF_BASEBOX/definitions
+    COOKBOOKS/cessna
+    COOKBOOKS/netbackup
+    COOKBOOKS/remoteaddr
+    COOKBOOKS/template-cookbook
+    CHEFORG_CORE_SYSTEMS/cheforg-core-systems
+    CHEFORG_FNCE/cheforg_fnce
+    ...
+
+## Contributing
+
+Please use standard Github issues and pull requests.
+
+## License and Author
+
+Author:: Brian Flad (<bflad417@gmail.com>)
+
+Copyright:: 2013
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/knife-stash.gemspec

@@ -0,0 +1,18 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/knife-stash/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Brian Flad"]
+  gem.email         = ["bflad417@gmail.com"]
+  gem.description   = %q{A knife plugin for Atlassian Stash.}
+  gem.summary       = gem.summary
+  gem.homepage      = "https://github.com/bflad/knife-stash"
+
+  gem.add_runtime_dependency "faraday"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "knife-stash"
+  gem.require_paths = ["lib"]
+  gem.version       = Knife::Stash::VERSION
+end

data/lib/chef/knife/BaseStashCommand.rb

@@ -0,0 +1,93 @@
+#
+# Author:: Brian Flad (<bflad417@gmail.com>)
+# License:: Apache License, Version 2.0
+#
+
+module StashKnifePlugin
+
+  require 'chef/knife'
+  require 'highline/import'
+  require 'faraday'
+  
+  class BaseStashCommand < Chef::Knife
+
+    deps do
+      require 'highline/import'
+    end
+
+  	def self.get_common_options
+  		unless defined? $default
+  			$default = Hash.new
+  		end
+
+      option :noop,
+        :long => "--noop",
+        :description => "Perform no modifying operations",
+        :boolean => false
+
+      option :stash_username,
+        :short => "-u USERNAME",
+        :long => "--stash-username USERNAME",
+        :description => "The username for Stash"
+      $default[:stash_username] = ENV['USER']
+
+      option :stash_password,
+        :short => "-p PASSWORD",
+        :long => "--stash-password PASSWORD",
+        :description => "The password for Stash"
+
+  		option :stash_hostname,
+  			:long => "--stash-hostname HOSTNAME",
+  			:description => "The hostname for Stash"
+
+  	end
+
+    def display_stash_error(message,response)
+      ui.fatal message
+      JSON.parse(response.body)['errors'].each do |error|
+        ui.fatal "#{error['context'] ? error['context'] + ": " : "" }#{error['message']}"
+      end
+    end
+
+    def get_all_values(stash,url,response)
+      r = JSON.parse(response.body)
+      yield r['values']
+      until r['isLastPage']
+        response = stash.get url, { :start => r['nextPageStart'] }
+        r = JSON.parse(response.body)
+        yield r['values']
+      end
+    end
+
+  	def get_config(key)
+  		key = key.to_sym
+  		rval = config[key] || Chef::Config[:knife][key] || $default[key]
+  		Chef::Log.debug("value for config item #{key}: #{rval}")
+  		rval
+  	end
+
+  	def get_stash_connection
+      config[:stash_hostname] = ask("Stash Hostname: ") { |q| q.echo = "*" } unless get_config(:stash_hostname)
+      config[:stash_username] = ask("Stash Username for #{get_config(:stash_hostname)}: ") { |q| q.echo = "*" } unless get_config(:stash_username)
+      config[:stash_password] = ask("Stash Password for #{get_config(:stash_username)}: ") { |q| q.echo = "*" } unless get_config(:stash_password)
+      
+      connection = Faraday.new(:url => "https://#{get_config(:stash_hostname)}", :ssl => {:verify => false}) do |faraday|
+        faraday.request  :url_encoded # form-encode POST params
+        #faraday.response :logger      # log requests to STDOUT
+        faraday.adapter  :net_http    # make requests with Net::HTTP
+      end
+      connection.basic_auth(get_config(:stash_username),get_config(:stash_password))
+      connection.url_prefix = "https://#{get_config(:stash_hostname)}/rest/api/1.0"
+      connection
+  	end
+
+    def get_repo_https_url(project_key,repo)
+      "https://#{get_config(:stash_username)}@#{get_config(:stash_hostname)}/scm/#{project_key}/#{repo}.git"
+    end
+
+    def get_repo_ssh_url(project_key,repo)
+      "ssh://git@#{get_config(:stash_hostname)}:7999/#{project_key}/#{repo}.git"
+    end
+
+  end
+end

data/lib/chef/knife/stash_project_create.rb

@@ -0,0 +1,68 @@
+#
+# Author:: Brian Flad (<bflad417@gmail.com>)
+# License:: Apache License, Version 2.0
+#
+
+module StashKnifePlugin
+
+  require 'chef/knife'
+
+  class StashProjectCreate < BaseStashCommand
+
+    banner "knife stash project create KEY NAME (options)"
+    category "stash"
+
+    option :description,
+        :short => "-d DESCRIPTION",
+        :long => "--description DESCRIPTION",
+        :description => "The description for the project"
+
+    get_common_options
+
+    def run
+      
+      key = name_args.first
+
+      if key.nil?
+        ui.fatal "You need a project key!"
+        show_usage
+        exit 1
+      end
+
+      name = name_args[1]
+
+      if name.nil?
+        ui.fatal "You need a project name!"
+        show_usage
+        exit 1
+      end
+
+      args = name_args[2]
+      if args.nil?
+        args = ""
+      end
+
+      stash = get_stash_connection
+      project = { :name => name, :key => key }
+      project[:description] = get_config(:description) if get_config(:description)
+
+      if get_config(:noop)
+        ui.info "#{ui.color "Skipping project creation process because --noop specified.", :red}"
+      else
+        response = stash.post do |post|
+          post.url "projects"
+          post.headers['Content-Type'] = "application/json"
+          post.body = JSON.generate(project)
+        end
+        if response.success?
+          ui.info "Created Stash Project: #{key} (#{name})"
+        else
+          display_stash_error "Could not create Stash project!", response
+          exit 1
+        end
+      end
+      
+    end
+
+  end
+end

data/lib/chef/knife/stash_project_delete.rb

@@ -0,0 +1,66 @@
+#
+# Author:: Brian Flad (<bflad417@gmail.com>)
+# License:: Apache License, Version 2.0
+#
+
+module StashKnifePlugin
+
+  require 'chef/knife'
+
+  class StashProjectDelete < BaseStashCommand
+
+    banner "knife stash project delete KEY (options)"
+    category "stash"
+
+    option :delete_repos,
+        :short => "-d",
+        :long => "--delete-repos",
+        :description => "Delete all repositories in project.",
+        :boolean => false
+
+    get_common_options
+
+    def run
+      
+      key = name_args.first
+
+      if key.nil?
+        ui.fatal "You need a project key!"
+        show_usage
+        exit 1
+      end
+
+      stash = get_stash_connection
+
+      if get_config(:noop)
+        ui.info "#{ui.color "Skipping project deletion process because --noop specified.", :red}"
+      else
+        if get_config(:delete_repos)
+          url = "projects/#{key}/repos"
+          response = stash.get url
+          if response.success?
+            get_all_values stash,url,response do |values|
+              values.each do |repo|
+                repo_delete = StashRepoDelete.new
+                repo_delete.name_args = [ key, repo['name'] ]
+                repo_delete.run
+              end
+            end
+          else
+            display_stash_error "Could not delete Stash project repositories!", response
+            exit 1
+          end
+        end
+        response = stash.delete "projects/#{key}"
+        if response.success?
+          ui.info "Deleted Stash Project: #{key}"
+        else
+          display_stash_error "Could not delete Stash project!", response
+          exit 1
+        end
+      end
+      
+    end
+
+  end
+end

data/lib/chef/knife/stash_project_repos.rb

@@ -0,0 +1,45 @@
+#
+# Author:: Brian Flad (<bflad417@gmail.com>)
+# License:: Apache License, Version 2.0
+#
+
+module StashKnifePlugin
+
+  require 'chef/knife'
+
+  class StashProjectRepos < BaseStashCommand
+
+    banner "knife stash project repos KEY (options)"
+    category "stash"
+
+    get_common_options
+
+    def run
+      
+      key = name_args.first
+
+      if key.nil?
+        ui.fatal "You need a project key!"
+        show_usage
+        exit 1
+      end
+
+      stash = get_stash_connection
+      url = "projects/#{key}/repos"
+      response = stash.get url
+
+      if response.success?
+        get_all_values stash,url,response do |values|
+          values.each do |repo|
+            ui.info "#{repo['slug']} (#{repo['name']})"
+          end
+        end
+      else
+        display_stash_error "Could not list Stash project repositories!", response
+        exit 1
+      end
+      
+    end
+
+  end
+end

data/lib/chef/knife/stash_projects.rb

@@ -0,0 +1,37 @@
+#
+# Author:: Brian Flad (<bflad417@gmail.com>)
+# License:: Apache License, Version 2.0
+#
+
+module StashKnifePlugin
+
+  require 'chef/knife'
+
+  class StashProjects < BaseStashCommand
+
+    banner "knife stash projects (options)"
+    category "stash"
+
+    get_common_options
+
+    def run
+      
+      stash = get_stash_connection
+      url = "projects"
+      response = stash.get url
+
+      if response.success?
+        get_all_values stash,url,response do |values|
+          values.each do |project|
+            ui.info "#{project['key']}: #{project['name']}"
+          end
+        end
+      else
+        display_stash_error "Could not list Stash projects!", response
+        exit 1
+      end
+      
+    end
+
+  end
+end

data/lib/chef/knife/stash_repo_create.rb

@@ -0,0 +1,64 @@
+#
+# Author:: Brian Flad (<bflad417@gmail.com>)
+# License:: Apache License, Version 2.0
+#
+
+module StashKnifePlugin
+
+  require 'chef/knife'
+
+  class StashRepoCreate < BaseStashCommand
+
+    banner "knife stash repo create PROJECT_KEY NAME (options)"
+    category "stash"
+
+    get_common_options
+
+    def run
+      
+      project_key = name_args.first
+
+      if project_key.nil?
+        ui.fatal "You need a project key!"
+        show_usage
+        exit 1
+      end
+
+      name = name_args[1]
+
+      if name.nil?
+        ui.fatal "You need a repository name!"
+        show_usage
+        exit 1
+      end
+
+      args = name_args[2]
+      if args.nil?
+        args = ""
+      end
+
+      stash = get_stash_connection
+      repo = { :name => name, :scmId => "git" }
+
+      if get_config(:noop)
+        ui.info "#{ui.color "Skipping repo creation process because --noop specified.", :red}"
+      else
+        response = stash.post do |post|
+          post.url "projects/#{project_key}/repos"
+          post.headers['Content-Type'] = "application/json"
+          post.body = JSON.generate(repo)
+        end
+        if response.success?
+          ui.info "Created Stash Repository: #{project_key}/#{name}"
+          ui.info "Available via (HTTPS): #{get_repo_https_url(project_key,name)}"
+          ui.info "Available via (SSH): #{get_repo_ssh_url(project_key,name)}"
+        else
+          display_stash_error "Could not create Stash repository!", response
+          exit 1
+        end
+      end
+      
+    end
+
+  end
+end

data/lib/chef/knife/stash_repo_delete.rb

@@ -0,0 +1,52 @@
+#
+# Author:: Brian Flad (<bflad417@gmail.com>)
+# License:: Apache License, Version 2.0
+#
+
+module StashKnifePlugin
+
+  require 'chef/knife'
+
+  class StashRepoDelete < BaseStashCommand
+
+    banner "knife stash repo delete KEY REPO (options)"
+    category "stash"
+
+    get_common_options
+
+    def run
+      
+      key = name_args.first
+
+      if key.nil?
+        ui.fatal "You need a project key!"
+        show_usage
+        exit 1
+      end
+
+      repo = name_args[1]
+
+      if repo.nil?
+        ui.fatal "You need a repository name!"
+        show_usage
+        exit 1
+      end
+
+      stash = get_stash_connection
+
+      if get_config(:noop)
+        ui.info "#{ui.color "Skipping project repository deletion process because --noop specified.", :red}"
+      else
+        response = stash.delete "projects/#{key}/repos/#{repo}"
+        if response.success?
+          ui.info "Deleted Stash Repository: #{key}/#{repo}"
+        else
+          display_stash_error "Could not delete Stash respository!", response
+          exit 1
+        end
+      end
+      
+    end
+
+  end
+end

data/lib/chef/knife/stash_repos.rb

@@ -0,0 +1,49 @@
+#
+# Author:: Brian Flad (<bflad417@gmail.com>)
+# License:: Apache License, Version 2.0
+#
+
+module StashKnifePlugin
+
+  require 'chef/knife'
+
+  class StashRepos < BaseStashCommand
+
+    banner "knife stash repos (options)"
+    category "stash"
+
+    get_common_options
+
+    def run
+
+      stash = get_stash_connection
+      url = "projects"
+      project_response = stash.get url
+
+      if project_response.success?
+        get_all_values stash,url,project_response do |project_values|
+          project_values.each do |project|
+            url = "projects/#{project['key']}/repos"
+            repo_response = stash.get url
+
+            if repo_response.success?
+              get_all_values stash,url,repo_response do |repo_values|
+                repo_values.each do |repo|
+                  ui.info "#{project['key']}/#{repo['slug']}"
+                end
+              end
+            else
+              display_stash_error "Could not list Stash project repositories!", repo_response
+              exit 1
+            end
+          end
+        end
+      else
+        display_stash_error "Could not list Stash projects!", project_response
+        exit 1
+      end
+      
+    end
+
+  end
+end

data/lib/knife-stash/version.rb

@@ -0,0 +1,5 @@
+module Knife
+  module Stash
+    VERSION = "0.1.0"
+  end
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: knife-stash
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Brian Flad
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A knife plugin for Atlassian Stash.
+email:
+- bflad417@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- CHANGELOG.md
+- Gemfile
+- README.md
+- Rakefile
+- knife-stash.gemspec
+- lib/chef/knife/BaseStashCommand.rb
+- lib/chef/knife/stash_project_create.rb
+- lib/chef/knife/stash_project_delete.rb
+- lib/chef/knife/stash_project_repos.rb
+- lib/chef/knife/stash_projects.rb
+- lib/chef/knife/stash_repo_create.rb
+- lib/chef/knife/stash_repo_delete.rb
+- lib/chef/knife/stash_repos.rb
+- lib/knife-stash/version.rb
+homepage: https://github.com/bflad/knife-stash
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: ''
+test_files: []