woro 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5a7d57892a65138472c52bcf5c91ead031cd022f
-  data.tar.gz: 5fc6dbd1d5e0ab491f9e06a1d17b87ccc69e86bd
+  metadata.gz: 9280b0c23821f1b2f349fb0653519a738e12640b
+  data.tar.gz: 9a96cbb374926861269b29bfbc7536b966478a79
 SHA512:
-  metadata.gz: f0dda43342aab660543a9b115438ab7322ef00242a767518818ec7f81701f25efac7935b3973f2cbe2431819530d929906a489e1e0ead0fda3fc98ecf75fe7b8
-  data.tar.gz: 0a7e6eff1e8467046c18dfdf13eb3111865737438bbdac1f49f76d503ee95585a0c0441e8d630bb8e621099493b5c93ce84f85406a7aeffd2575b93295c8fece
+  metadata.gz: bab818aa8921e7c73e0f7cd124550336fb35c25f8e725e21056e5cc197787da6d76e06225252a3e35798f8548f977c9f10dfcd3c8570106e859015fb831b74d0
+  data.tar.gz: f73111d88b02d1e23e25a588d718b2d42862e5bccc02493a8318c5d6a666ccd229c0b809972e92ba9893a801a97559b5183acf79734816f0de8bce886f6d5dfd

data/Gemfile

@@ -2,3 +2,10 @@ source 'https://rubygems.org'
 
 # Specify your gem's dependencies in woro.gemspec
 gemspec
+
+group :test do
+  gem 'aruba'
+  gem "rspec"
+  gem "rspec-nc"
+  gem 'fakefs'
+end

data/README.md

@@ -3,7 +3,7 @@
 Write once, run once.
 
 Manage one-time remote tasks in your Rails project.
-Plugins with Mina to add support for rake tasks hosted in remote collection, such as Gist.
+Plugins with Mina and Capistrano to add support for rake tasks hosted in remote collection, such as Gist.
 
 Say you have a data migration to perform on a remote server. The procedure is too complex to just do it in the remote console and using database migrations would be evil. A rake task would be nice, but checking this in with the source code repository adds clutter, as you know you will only run this once.
 Woro offers a quick way of pushing rake tasks onto the remote server, execute them and delete them instantly. Using Github's gist, you keep version control of the tasks and can share them with colleagues.
@@ -32,6 +32,17 @@ Or install it yourself as:
 $ gem install woro
 ```
 
+Then run:
+
+```shell
+$ woro init
+```
+
+This will create `lib/woro_tasks/` folder and `lib/tasks/woro.rake`.
+Here the Woro task files are stored, edited locally and run using rake.
+
+### for use with Mina
+
 Require `mina/woro` in your `config/deploy.rb`:
 
 ```rb
@@ -41,33 +52,26 @@ require 'mina/git'
 require 'mina/woro'
 
 ...
+```
 
-task setup: :environment do
-  ...
-end
+### for use with Capistrano
 
-desc 'Deploys the current version to the server.'
-task deploy: :environment do
-  ...
-end
-```
+Require `capistrano/woro` in your `config/deploy.rb`:
 
-Then run:
+```rb
+require 'capistrano/rails'
+require 'capistrano/woro'
 
-```shell
-$ woro init
+...
 ```
 
-This will create `lib/woro_tasks/` folder and `lib/tasks/woro.rake`.
-Here the Woro task files are stored and edited locally.
-
 ## Usage
 
 ```shell
 $ woro new cleanup_users
 ```
 
-Can be used to create the template for a new task in `lib/tasks/`.
+Can be used to create the template for a new task in `lib/woro_tasks/`.
 
 The task itself is a regular rake-task in the woro-namespace. You can test it locally using rake:
 
@@ -76,33 +80,39 @@ $ rake woro:cleanup_users
 ```
 
 Once you are done writing the task and you want to execute it on the remote system.
-First you have to push them online.
+First you have to push them online, in this case to Gist.
 
 ```shell
-$ woro push cleanup_users
+$ woro push gist:cleanup_users
 ```
 
 _Attention, depending on whether you set up a Gist/Github login on
 initialization. These tasks are online anonymous, but public, or
 private under the specified Github account._
 
+Now, to run a task remotely using Mina, specify the task:
+
+```shell
+$ mina woro:run task=gist:cleanup_users
+```
 
-Now, to run a task remotely using mina, specify the task:
+Or to run it with Capistrano:
 
 ```shell
-$ mina woro:run task=cleanup_users
+$ cap woro:run task=gist:cleanup_users
 ```
 
-To show a list of all uploaded tasks do:
+To show a list of all tasks uploaded to any collection do:
 
 ```shell
 $ woro list
+$ woro ls
 ```
 
-And finally you can download an existing task:
+And finally you can download an existing task to your local woro tasks directory.
 
 ```shell
-$ woro pull cleanup_users
+$ woro pull gist:cleanup_users
 ```
 
 ## Contributing

data/bin/woro

@@ -32,33 +32,32 @@ command :init do |c|
 
     if agree 'Login to Gist/Github for private Woro tasks (Yes/No)?  '
       Gist.login!
-    #else
-      #gen_access_token = agree "Secure gists via random access token?"
-    end
+    #elsif agree 'Login to AWS/S3 for private Woro tasks (Yes/No)?  '
 
+    end
+    # if none of these, use gist, but public
 
     # create Gist with welcome file
     # additional tasks will be added to this first gist
     app_name = ask 'Application name: '
-    result = Woro::Gister.create_initial_gist(app_name)
+    result = Woro::Adapters::Gist.create_initial_remote_task(app_name)
 
     # configure adapters
     gist_adapter = {
       gist_id: result['id'],
       public: false
     }
-    # TODO generate access token
-    #gist_adapter[:access_token] = 'access_token' if gen_access_token
-    adapters = { gist: gist_adapter }
 
     unless File.exists? File.dirname(Woro::Configuration.config_file)
       FileUtils.mkdir_p File.dirname(Woro::Configuration.config_file)
     end
-    config = Woro::Configuration.save(adapters: adapters)
     say 'Initialized at `./config/woro.yml`'
 
+    options.default(adapters: { gist: gist_adapter } )
+    config = Woro::Configuration.save(options.__hash__)
+
     unless File.exists? config.woro_task_dir
-      FileUtils.mkdir_p
+      FileUtils.mkdir_p config.woro_task_dir
       say "Create #{config.woro_task_dir}"
     end
 
@@ -76,10 +75,10 @@ command :new do |c|
   c.example 'Creates tasks called "cleanup", "fix1" and "fix2"', 'woro new cleanup fix1 fix2'
   c.option '--[no-]force', 'force overwrite of existing task file'
   c.action do |args, options|
-    args.each do |arg|
-      config = Woro::Configuration.load
-      task = Woro::Task.new(config.adapters[:gist][:gist_id], arg)
-      force_overwrite = options.force
+    config = Woro::Configuration.load
+    force_overwrite = options.force
+    args.each do |task_name|
+      task = Woro::Task.new(task_name)
       if !task.exists? || force_overwrite || agree("Overwrite existing #{task.file_path}?")
         task.create_from_task_template
         say "Created #{task.file_path}"
@@ -94,12 +93,18 @@ command :push do |c|
   c.description = 'Pushes one or more local tasks to the remote collection. Existing tasks by this name in the remote connection will be updated.'
   c.example 'Pushes the task "cleanup" to the remote collection', 'woro push cleanup'
   c.action do |args, options|
+    config = Woro::Configuration.load
     args.each do |arg|
-      config = Woro::Configuration.load
+      unless arg.include?(':')
+        say_error "Does not specify upload target"
+        next
+      end
+      adapter_name, task_name = arg.split(':')
+      adapter = config.adapter adapter_name
       # Pushes a new woro task by given name to gist, this can be done multiple time.
-      task = Woro::Task.new(config.adapters[:gist][:gist_id], arg)
+      task = Woro::Task.new(task_name)
       if task.exists?
-        result = task.push
+        result = adapter.push(task)
         say "Uploaded #{task.file_path} to #{result['url']}"
       else
         say "Task #{task.task_name} not found at #{task.file_path}"
@@ -112,16 +117,23 @@ command :pull do |c|
   c.syntax      = 'woro pull <task> [options]'
   c.summary     = 'Pull Woro task from remote repository'
   c.description = 'Pulls one task from the remote collection. Existing local tasks can be overwritten.'
-  c.example 'Pulls the task "cleanup" from the remote collection', 'woro pull cleanup'
+  c.example 'Pulls the task "cleanup" from the remote collection', 'woro pull gist:cleanup'
   c.option '--[no-]force', 'force overwrite of existing task file'
   c.action do |args, options|
     config = Woro::Configuration.load
-    # Pulls the  woro task by given name to gist, this can be done multiple time.
-    task = Woro::Task.new(config.adapters[:gist][:gist_id], args.first)
-    force_save = options.force
-    if !task.exists? || force_overwrite || agree("Overwrite existing #{task.file_path}?")
-      system "cd '#{config.woro_task_dir}' && curl -O -# #{task.raw_url}"
-      say "Downloaded #{task.task_name} to #{task.file_path}"
+    args.each do |arg|
+      unless arg.include?(':')
+        say_error "Does not specify download target"
+        next
+      end
+      adapter_name, task_name = arg.split(':')
+      adapter = config.adapter adapter_name
+      task = Woro::Task.new(task_name)
+      force_overwrite = options.force
+      if !task.exists? || force_overwrite || agree("Overwrite existing #{task.file_path}?")
+        system "cd '#{config.woro_task_dir}' && curl -O -# #{adapter.raw_url(task.file_name)}"
+        say "Downloaded #{task.task_name} to #{task.file_path}"
+      end
     end
   end
 end
@@ -135,13 +147,25 @@ command :list do |c|
   c.action do |args, options|
     abort "invalid command. See 'woro help' for more information" unless args.empty?
     config = Woro::Configuration.load
-    files = Woro::Gister.get_list_of_files config.adapters[:gist][:gist_id]
-    tasks = files.map { |file_name, data| OpenStruct.new(name_with_args: file_name.split('.rake').first, comment: Woro::Gister.extract_description(data)) if file_name.include? '.rake' }
-    tasks.compact!
-    width ||= tasks.map { |t| t.name_with_args.length }.max || 10
-    tasks.each do |t|
-      puts "  %-#{width}s   # %s" % [ t.name_with_args, t.comment ]
+    config.adapters.each do |adapter_config|
+      puts "#{adapter_config[0]} ---"
+      adapter = config.adapter(adapter_config[0])
+      files = adapter.list_keys || {}
+      tasks = files.map do |file_name, data|
+        if file_name.include? '.rake'
+          OpenStruct.new(name_with_args: file_name.split('.rake').first,
+                         comment: adapter.extract_description(data))
+        end
+      end
+      tasks.compact!
+      Woro::TaskHelper.print_task_list(tasks)
+    end
+    puts "local ---"
+    tasks = Woro::TaskHelper.woro_task_files(config.woro_task_dir) do |file_name, data|
+      OpenStruct.new(name_with_args: file_name.split('.rake').first,
+                     comment: Woro::TaskHelper.extract_description(data))
     end
+    Woro::TaskHelper.print_task_list(tasks)
   end
 end
 alias_command :ls, :list

data/lib/capistrano/woro.rb

@@ -0,0 +1 @@
+load File.expand_path("../../woro/tasks/capistrano.rake", __FILE__)

data/lib/woro.rb

@@ -1,4 +1,6 @@
 require 'woro/version'
+require 'woro/task_helper'
 require 'woro/task'
-require 'woro/gister'
+require 'woro/adapters/s3'
+require 'woro/adapters/gist'
 require 'woro/configuration'

data/lib/woro/adapters/gist.rb

@@ -0,0 +1,82 @@
+require 'gist'
+
+module Woro
+  module Adapters
+    class Gist
+
+      attr_reader :gist_id
+
+      # Create a new gist collection adapter
+      # @param gist_id [String] gist to which the adapter connects
+      def initialize(gist_id)
+        @gist_id = gist_id
+      end
+
+      # Returns the list of files included in the Gist
+      # @return [Hash] List of files in the format { filename: { data }}
+      def list_keys
+        gist['files']
+      end
+
+      # Push this task's file content to the Gist collection on the server.
+      # Existing contents by the same #file_name will be overriden, but
+      # can be accessed via Github or Gist's API.
+      def push(task)
+        ::Gist.multi_gist({ task.file_name => task.read_task_file },
+                        public: false,
+                        update: gist_id,
+                        output: :all)
+      end
+
+      # The Gist contains a collection of files.
+      # These are stored and accessed on Github.
+      # @return [Hash] parsed JSON hash of the gist's metadata
+      def gist
+        @gist ||= retrieve_gist(gist_id)
+      end
+
+      # Retrieves metadata of the specified gist
+      # @param gist_id [String] id of the gist
+      # @return [Hash] parsed JSON hash
+      def retrieve_gist(gist_id)
+        service_url = "https://api.github.com/gists/#{gist_id}"
+        response = Net::HTTP.get_response(URI.parse(service_url))
+        JSON.parse(response.body || '')
+      end
+
+      # Retrieves the data hash included in the gist under the #file_name.
+      # @param file_name [String] name of the file to retrieve the download url
+      # @return [Hash] parsed JSON hash
+      def retrieve_file_data(file_name)
+        gist['files'][file_name]
+      end
+
+      # The raw url is a permalink for downloading the content rake task within
+      # the Gist as a file.
+      # @param file_name [String] name of the file to retrieve the download url
+      # @return [String] HTTP-URL of addressed file within the gist collection
+      def raw_url(file_name)
+        retrieve_file_data(file_name)['raw_url']
+      end
+
+      # Creates an initial welcome gist on project setup
+      # @param app_name [String] Name of the app is displayed in the initial welcome message
+      def self.create_initial_remote_task(app_name, access_token=nil)
+        ::Gist.gist("Welcome to the Woro Task Repository for #{app_name}", filename: app_name, access_token: access_token)
+      end
+
+      # Extract description from gist's data content string.
+      # @param data [Hash] gist data hash
+      # [String] description string
+      def extract_description(data)
+        Woro::TaskHelper.extract_description(data['content'])
+      end
+
+      # Read the rake task template
+      # @return [String]
+      def read_template_file
+        File.read(File.join(File.dirname(__FILE__), 'templates','task.rake') )
+      end
+    end
+  end
+end

data/lib/woro/configuration.rb

@@ -4,12 +4,13 @@ include Commander::UI
 
 module Woro
   class Configuration
-    attr_reader :adapters, :woro_task_dir
+    attr_reader :adapters, :woro_task_dir, :app_name
 
     # Initialize configuration.
     def initialize(options = {})
       @woro_task_dir = Configuration.woro_task_dir
       @adapters = options[:adapters]
+      @app_name = options[:app_name]
     end
 
     # Load configuration file or default_options. Passed options take precedence.
@@ -17,7 +18,7 @@ module Woro
       user_options = options.reject{|k,v| ![:adapters, :app_name].include? k}
 
       if !(File.exists? config_file)
-        File.open(config_file, 'w') { |file| YAML::dump(default_options, file) }
+        File.open(config_file, 'w') { |file| YAML.dump(default_options, file) }
         say "Initialized default config file in #{config_file}. See 'woro help init' for options."
       end
 
@@ -31,7 +32,7 @@ module Woro
       force_save = options.delete :force
 
       if !(File.exists? config_file) || force_save
-        File.open(config_file, 'w') { |file| YAML::dump(default_options.merge(user_options), file) }
+        File.open(config_file, 'w') { |file| YAML.dump(default_options.merge(user_options), file) }
         say "Initialized config file in #{config_file}"
       else
         say_error "Not overwriting existing config file #{config_file}, use --force to override. See 'woro help init'."
@@ -39,6 +40,15 @@ module Woro
       self
     end
 
+    def adapter(name)
+      options = adapters[name.to_sym]
+
+      case name.to_sym
+      when :gist
+        @gist_adapter ||= Woro::Adapters::Gist.new(options[:gist_id])
+      end
+    end
+
     # Helpers
 
     def self.config_file

data/lib/woro/task.rb

@@ -4,25 +4,22 @@ require 'erb'
 module Woro
   # Task object, helps in the creation and management of gists.
   class Task
-    attr_reader :task_name, :gist_id, :gist
+    attr_reader :task_name, :gist
 
-    def initialize(gist_id, task_name)
+    def initialize(task_name)
       @task_name = Woro::Task.sanitize_task_name task_name
-      @gist_id = gist_id
     end
 
-    # Create a new task based on a template rake-task.
-    # @param gist_id [String] gist to which the task is added
     # @param task_name [String] sanitized name of the task, used throughout the further processing
     # @return [Task] the created task
-    def self.create(gist_id, task_name)
-      task = Woro::Task.new(gist_id, task_name)
+    def self.create(task_name)
+      task = Woro::Task.new(task_name)
       task.create_from_task_template
       task
     end
 
     def self.sanitize_task_name(task_name)
-      task_name.strip.split(' ').first
+      task_name.strip.split(' ').first # not nice
     end
 
     # File name based on the task's name.
@@ -34,18 +31,18 @@ module Woro
     # File name based on the task's filename (see #file_name).
     # @return [String]
     def file_path
-      File.join('lib','woro_tasks', file_name)
+      File.join 'lib', 'woro_tasks', file_name
     end
 
     # Returns true if a task of this name exists locally
     def exists?
-      File.exists? file_path
+      File.exist? file_path
     end
 
     # Creates a new rake task file at the file path (see #file_path).
     def create_from_task_template
       b = binding
-      template = ERB.new(Gister.read_template_file).result(b)
+      template = ERB.new(Woro::TaskHelper.read_template_file).result(b)
       File.open(file_path, 'w') do |f|
         f.puts template
       end
@@ -63,34 +60,5 @@ module Woro
     def read_task_file
       File.read(file_path)
     end
-
-    # Push this task's file content to the Gist collection on the server.
-    # Existing contents by the same #file_name will be overriden, but
-    # can be accessed via Github or Gist's API.
-    def push
-      Gist.multi_gist({ file_name => read_task_file },
-                       public: false,
-                       update: gist_id,
-                       output: :all)
-    end
-
-    # The Gist contains a collection of files.
-    # These are stored and accessed on Github.
-    # @return [Hash] parsed JSON hash of the gist's metadata
-    def gist
-      @gist ||= Gister.retrieve_gist(gist_id)
-    end
-
-    # Retrieves the data hash included in the gist under the #file_name.
-    # @return [Hash] parsed JSON hash
-    def retrieve_file_data
-      gist['files'][file_name]
-    end
-
-    # The raw url is a permalink for downloading the content rake task within
-    # the Gist as a file.
-    def raw_url
-      retrieve_file_data['raw_url']
-    end
   end
 end

data/lib/woro/task_helper.rb

@@ -0,0 +1,39 @@
+module Woro
+  class TaskHelper
+
+    class << self
+
+      def print_task_list(tasks)
+        width ||= tasks.map { |t| t.name_with_args.length }.max || 10
+        tasks.each do |t|
+          puts "  %-#{width}s   # %s" % [ t.name_with_args, t.comment ]
+        end
+      end
+
+      # Perform an action over all files within the woro task directory
+      def woro_task_files(directory, &block)
+        tasks = []
+        Dir.foreach(directory) do |file_name|
+          if file_name.include? '.rake'
+            data = File.read(File.join(directory, file_name))
+            tasks << yield(file_name, data)
+          end
+        end
+        tasks
+      end
+
+      # Extract description from gist's data content string.
+      # @param data [Hash] gist data hash
+      # [String] description string
+      def extract_description(task_content)
+        task_content.match(/desc ['"]([a-zA-Z0-9\s]*)['"]/)[1]
+      end
+
+      # Read the rake task template
+      # @return [String]
+      def read_template_file
+        File.read(File.join(File.dirname(__FILE__), 'templates','task.rake') )
+      end
+    end
+  end
+end

data/lib/woro/tasks/capistrano.rake

@@ -1,58 +1,31 @@
-require 'ostruct'
-require 'woro/gister'
-require 'woro/task'
-
-# Capistrano Recipes for managing woro tasks
-#
-# Add these callbacks to have the delayed_job process restart when the server
-# is restarted:
-#
-#   after "deploy:stop",    "delayed_job:stop"
-#   after "deploy:start",   "delayed_job:start"
-#   after "deploy:restart", "delayed_job:restart"
-#
-# If you want to use command line options, for example to start multiple workers,
-# define a Capistrano variable delayed_job_args:
-#
-#   set :delayed_job_args, "-n 2"
-#
-# If you've got delayed_job workers running on a servers, you can also specify
-# which servers have delayed_job running and should be restarted after deploy.
-#
-#   set :delayed_job_server_role, :worker
-#
-
-Capistrano::Configuration.instance.load do
-  namespace :delayed_job do
-    def rails_env
-      fetch(:rails_env, false) ? "RAILS_ENV=#{fetch(:rails_env)}" : ''
-    end
-
-    def args
-      fetch(:delayed_job_args, '')
-    end
-
-    def roles
-      fetch(:delayed_job_server_role, :app)
-    end
-
-    def delayed_job_command
-      fetch(:delayed_job_command, 'script/delayed_job')
-    end
-
-    desc 'Stop the delayed_job process'
-    task :stop, :roles => lambda { roles } do
-      run "cd #{current_path} && #{rails_env} #{delayed_job_command} stop #{args}"
-    end
-
-    desc 'Start the delayed_job process'
-    task :start, :roles => lambda { roles } do
-      run "cd #{current_path} && #{rails_env} #{delayed_job_command} start #{args}"
-    end
-
-    desc 'Restart the delayed_job process'
-    task :restart, :roles => lambda { roles } do
-      run "cd #{current_path} && #{rails_env} #{delayed_job_command} restart #{args}"
+require 'woro'
+
+# Capistrano recipees for managing woro tasks
+namespace :woro do
+  desc 'Run Woro task remotely'
+  task run: 'deploy:set_rails_env' do
+
+    on roles(:app), in: :sequence, wait: 5 do
+      unless ENV['task'].include?(':')
+        error "Does not specify upload target"
+      else
+        config = Woro::Configuration.load
+
+        adapter_name, task_name = ENV['task'].split(':')
+        adapter = config.adapter(adapter_name)
+        task = Woro::Task.new(task_name)
+
+        info "Execute #{task.task_name} remotely"
+        within File.join(release_path, 'lib', 'tasks') do
+          execute :curl, "#{adapter.raw_url(task.file_name)}",  '-o' "woro_#{task.file_name}"
+        end
+        within release_path do
+          with rails_env: fetch(:rails_env) do
+            execute :rake, "woro:#{task.task_name}"
+            execute :rm, "lib/tasks/woro_#{task.file_name}"
+          end
+        end
+      end
     end
   end
 end

data/lib/woro/tasks/mina.rake

@@ -6,12 +6,18 @@ namespace :woro do
   desc 'Run Woro task remotely'
   task run: :environment do
     config = Woro::Configuration.load
-    task = Woro::Task.new(config.adapter[:gist][:gist_id], ENV['task'])
+    unless ENV['task'].include?(':')
+      print_error "Does not specify upload target"
+      return
+    end
+    adapter_name, task_name = ENV['task'].split(':')
+    adapter = config.adapter(adapter_name)
+    task = Woro::Task.new(task_name)
     print_status "Execute #{task.task_name} remotely"
     in_directory "#{app_path}" do
-      queue! "cd 'lib/tasks' && curl -O #{task.raw_url}"
+      queue! "cd 'lib/tasks' && curl #{adapter.raw_url(task.file_name)} -o woro_#{task.file_name}"
       queue! "#{bundle_prefix} rake woro:#{task.task_name}"
-      queue! "rm lib/tasks/#{task.file_name}"
+      queue! "rm lib/tasks/woro_#{task.file_name}"
     end
   end
 end

data/lib/woro/version.rb

@@ -1,4 +1,4 @@
 module Woro
   # Look shiny!
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/spec/fixtures/fresh_template.yml

@@ -0,0 +1,6 @@
+namespace :woro do
+  desc 'Write your description here'
+  task <%= task_name %>: :environment do
+    # your code
+  end
+end

data/spec/fixtures/gist.json

@@ -0,0 +1,103 @@
+{
+  "url": "https://api.github.com/gists/aa5a315d61ae9438b18d",
+  "forks_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/forks",
+  "commits_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/commits",
+  "id": "aa5a315d61ae9438b18d",
+  "description": "description of gist",
+  "public": true,
+  "owner": {
+    "login": "octocat",
+    "id": 1,
+    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+    "gravatar_id": "",
+    "url": "https://api.github.com/users/octocat",
+    "html_url": "https://github.com/octocat",
+    "followers_url": "https://api.github.com/users/octocat/followers",
+    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
+    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
+    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
+    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
+    "organizations_url": "https://api.github.com/users/octocat/orgs",
+    "repos_url": "https://api.github.com/users/octocat/repos",
+    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
+    "received_events_url": "https://api.github.com/users/octocat/received_events",
+    "type": "User",
+    "site_admin": false
+  },
+  "user": null,
+  "files": {
+    "create_user.rake": {
+      "size": 932,
+      "raw_url": "https://gist.githubusercontent.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl",
+      "type": "text/plain",
+      "language": "Ruby",
+      "truncated": false,
+      "content": "namespace :woro do\n  desc 'Create User'\n  task create_user: :environment do\n    # Code\n  end\nend\n"
+    }
+  },
+  "comments": 0,
+  "comments_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/comments/",
+  "html_url": "https://gist.github.com/aa5a315d61ae9438b18d",
+  "git_pull_url": "https://gist.github.com/aa5a315d61ae9438b18d.git",
+  "git_push_url": "https://gist.github.com/aa5a315d61ae9438b18d.git",
+  "created_at": "2010-04-14T02:15:15Z",
+  "updated_at": "2011-06-20T11:34:15Z",
+  "forks": [
+    {
+      "user": {
+        "login": "octocat",
+        "id": 1,
+        "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+        "gravatar_id": "",
+        "url": "https://api.github.com/users/octocat",
+        "html_url": "https://github.com/octocat",
+        "followers_url": "https://api.github.com/users/octocat/followers",
+        "following_url": "https://api.github.com/users/octocat/following{/other_user}",
+        "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
+        "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
+        "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
+        "organizations_url": "https://api.github.com/users/octocat/orgs",
+        "repos_url": "https://api.github.com/users/octocat/repos",
+        "events_url": "https://api.github.com/users/octocat/events{/privacy}",
+        "received_events_url": "https://api.github.com/users/octocat/received_events",
+        "type": "User",
+        "site_admin": false
+      },
+      "url": "https://api.github.com/gists/dee9c42e4998ce2ea439",
+      "id": "dee9c42e4998ce2ea439",
+      "created_at": "2011-04-14T16:00:49Z",
+      "updated_at": "2011-04-14T16:00:49Z"
+    }
+  ],
+  "history": [
+    {
+      "url": "https://api.github.com/gists/aa5a315d61ae9438b18d/57a7f021a713b1c5a6a199b54cc514735d2d462f",
+      "version": "57a7f021a713b1c5a6a199b54cc514735d2d462f",
+      "user": {
+        "login": "octocat",
+        "id": 1,
+        "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+        "gravatar_id": "",
+        "url": "https://api.github.com/users/octocat",
+        "html_url": "https://github.com/octocat",
+        "followers_url": "https://api.github.com/users/octocat/followers",
+        "following_url": "https://api.github.com/users/octocat/following{/other_user}",
+        "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
+        "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
+        "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
+        "organizations_url": "https://api.github.com/users/octocat/orgs",
+        "repos_url": "https://api.github.com/users/octocat/repos",
+        "events_url": "https://api.github.com/users/octocat/events{/privacy}",
+        "received_events_url": "https://api.github.com/users/octocat/received_events",
+        "type": "User",
+        "site_admin": false
+      },
+      "change_status": {
+        "deletions": 0,
+        "additions": 180,
+        "total": 180
+      },
+      "committed_at": "2010-04-14T02:15:15Z"
+    }
+  ]
+}

data/spec/lib/woro/adapters/gist_spec.rb

@@ -0,0 +1,62 @@
+require 'spec_helper'
+require 'json'
+
+describe Woro::Adapters::Gist do
+
+  let!(:gist_id) { rand(999)}
+  let(:task) { Woro::Task.new('create_user') }
+  subject { Woro::Adapters::Gist.new(gist_id) }
+  let(:gist_hash) do
+    FakeFS.deactivate!
+    body = File.read(File.join('spec', 'fixtures', 'gist.json'))
+    FakeFS.activate!
+    JSON.parse(body)
+  end
+
+  before do
+    allow(subject).to receive(:gist).once.and_return gist_hash
+  end
+
+  describe '#list_keys' do
+    it 'returns list' do
+      expected_list = {
+        "create_user.rake" => {
+          "size"=>932, "raw_url"=>"https://gist.githubusercontent.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl", "type"=>"text/plain", "language"=>"Ruby", "truncated"=>false, "content"=>"namespace :woro do\n  desc 'Create User'\n  task create_user: :environment do\n    # Code\n  end\nend\n"
+        }
+      }
+      expect(subject.list_keys).to eq expected_list
+    end
+  end
+
+  describe '#push' do
+    it 'calls gist services with correct params' do
+      File.open(task.file_path, 'w') do |f|
+        f.puts 'hey'
+      end
+      expected_files_hash = { task.file_name => task.read_task_file }
+      expected_params_hash = { public: false,
+                               update: gist_id,
+                               output: :all
+                              }
+      expect(Gist).to receive(:multi_gist).with(expected_files_hash, expected_params_hash).and_return gist_hash
+      subject.push(task)
+    end
+  end
+
+
+  describe '#retrieve_file_data' do
+    it 'returns data hash from file' do
+      expected_hash = {
+        "size"=>932, "raw_url"=>"https://gist.githubusercontent.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl", "type"=>"text/plain", "language"=>"Ruby", "truncated"=>false, "content"=>"namespace :woro do\n  desc 'Create User'\n  task create_user: :environment do\n    # Code\n  end\nend\n"
+      }
+      expect(subject.retrieve_file_data('create_user.rake')).to eq expected_hash
+    end
+  end
+
+  describe '#raw_url' do
+    it 'returns raw_url of file' do
+      expected_url = "https://gist.githubusercontent.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl"
+      expect(subject.raw_url('create_user.rake')).to eq expected_url
+    end
+  end
+end

data/spec/lib/woro/configuration_spec.rb

@@ -0,0 +1,103 @@
+require 'spec_helper'
+
+describe Woro::Configuration do
+
+  describe '#initialize' do
+    it 'instantiates object' do
+      options = {
+        adapters: %(foo baz),
+        app_name: 'bar'
+      }
+      config = Woro::Configuration.new(options)
+      expect(config.adapters).to eq %(foo baz)
+      expect(config.app_name).to eq 'bar'
+    end
+  end
+
+  describe '.load' do
+    context 'not given a configuration file' do
+      it 'returns Configuration object with default options' do
+        config = Woro::Configuration.load
+        expect(config.adapters).to be_falsy
+        expect(config.app_name).to be_falsy
+      end
+
+      it 'writes a configuration file with default options' do
+        Woro::Configuration.load
+        expect(File.read(Woro::Configuration.config_file)).to eq \
+          YAML.dump(Woro::Configuration.default_options)
+      end
+    end
+
+    context 'given a configuration file' do
+      before(:each) do
+        opts = {
+          adapters: %w(foo baz),
+          app_name: 'bar'
+        }
+        File.open(Woro::Configuration.config_file, 'w') do |file|
+          YAML.dump(opts, file)
+        end
+      end
+
+      it 'returns Configuration object with options in file' do
+        config = Woro::Configuration.load
+        expect(config.adapters).to eq %w(foo baz)
+        expect(config.app_name).to eq 'bar'
+      end
+
+      context 'given options' do
+        it 'overrides options in configuration file' do
+          options = {
+            adapters:  %w(goo grr),
+            app_name: 'car'
+          }
+          config = Woro::Configuration.load(options)
+          expect(config.adapters).to eq %w(goo grr)
+          expect(config.app_name).to eq 'car'
+        end
+      end
+    end
+  end
+
+  describe '.save' do
+    let(:options) do
+      {
+        adapters: ['foo', 'baz'],
+        app_name: 'bar'
+      }
+    end
+
+    context 'not given a configuration file' do
+      it 'writes a configuration file with options' do
+        Woro::Configuration.save(options)
+        expect(File.read(Woro::Configuration.config_file)).to eq \
+          YAML.dump(options)
+      end
+    end
+
+    context 'given a configuration file' do
+      before(:each) do
+        opts = {
+          adapters: ['goo', 'grr'],
+          app_name: 'car'
+        }
+        File.open(Woro::Configuration.config_file, 'w') do |file|
+          YAML.dump(opts, file)
+        end
+      end
+
+      it 'does not overwrite' do
+        Woro::Configuration.save(options)
+        expect(File.read(Woro::Configuration.config_file)).to_not eq \
+          YAML.dump(options)
+      end
+
+      it 'does overwrite if passed `force` option' do
+        Woro::Configuration.save(options.merge(:force => true))
+        expect(File.read(Woro::Configuration.config_file)).to eq \
+          YAML.dump(options)
+      end
+    end
+  end
+end

data/spec/lib/woro/task_spec.rb

@@ -0,0 +1,33 @@
+require 'spec_helper'
+
+describe Woro::Task do
+
+  subject { Woro::Task.new('cleanup_task') }
+
+  describe '#create_from_task_template' do
+    it 'creates new file' do
+      FakeFS.deactivate!
+      example_path = File.join('spec', 'fixtures','fresh_template.yml')
+      fresh_template_body = File.read example_path
+      FakeFS.activate!
+      subject.create_from_task_template
+      expect(File.read(Woro::Task.file_path)).to eq fresh_template_body
+    end
+  end
+
+  describe '#file_name' do
+    context 'taskname is cleanup_task' do
+      it 'returns cleanup_task.rake' do
+        expect(subject.file_name).to eq 'cleanup_task.rake'
+      end
+    end
+  end
+
+  describe '#file_path' do
+    context 'task path is lib/woro_tasks/cleanup_task' do
+      it 'returns lib/woro_tasks/cleanup_task.rake' do
+        expect(subject.file_path).to eq 'lib/woro_tasks/cleanup_task.rake'
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,25 @@
+require 'pry'
+require 'woro'
+require 'fakefs/safe'
+require 'aws-sdk-v1'
+
+Dir[('./spec/support/**/*.rb')].each {|f| require f}
+
+RSpec.configure do |config|
+  config.color = true
+  config.order = 'random'
+
+  config.before(:each) do
+    FakeFS.activate!
+    FileUtils.mkdir_p 'config'
+    FileUtils.mkdir_p 'lib/woro_tasks'
+    FileUtils.mkdir_p 'lib/tasks'
+  end
+
+  config.after(:each) do
+    FakeFS.deactivate!
+    FakeFS::FileSystem.clear
+  end
+
+end
+

data/woro.gemspec

@@ -23,8 +23,6 @@ Gem::Specification.new do |spec|
 
   spec.add_development_dependency "bundler", "~> 1.7"
   spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "rspec"
-  spec.add_development_dependency "rspec-nc"
   spec.add_development_dependency "guard"
   spec.add_development_dependency "guard-rspec"
   spec.add_development_dependency "pry"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: woro
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Daniel Senff
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-04-27 00:00:00.000000000 Z
+date: 2015-06-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gist
@@ -66,34 +66,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '10.0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  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: rspec-nc
-  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: guard
   requirement: !ruby/object:Gem::Requirement
@@ -192,16 +164,24 @@ files:
 - README.md
 - Rakefile
 - bin/woro
+- lib/capistrano/woro.rb
 - lib/mina/woro.rb
 - lib/woro.rb
+- lib/woro/adapters/gist.rb
 - lib/woro/configuration.rb
-- lib/woro/gister.rb
 - lib/woro/task.rb
+- lib/woro/task_helper.rb
 - lib/woro/tasks/capistrano.rake
 - lib/woro/tasks/mina.rake
 - lib/woro/templates/task.rake
 - lib/woro/templates/woro.rake
 - lib/woro/version.rb
+- spec/fixtures/fresh_template.yml
+- spec/fixtures/gist.json
+- spec/lib/woro/adapters/gist_spec.rb
+- spec/lib/woro/configuration_spec.rb
+- spec/lib/woro/task_spec.rb
+- spec/spec_helper.rb
 - woro.gemspec
 homepage: http://github.com/Dahie/woro
 licenses:
@@ -228,4 +208,10 @@ signing_key:
 specification_version: 4
 summary: Write once, run once. One-time migration task management on remote servers
   through mina.
-test_files: []
+test_files:
+- spec/fixtures/fresh_template.yml
+- spec/fixtures/gist.json
+- spec/lib/woro/adapters/gist_spec.rb
+- spec/lib/woro/configuration_spec.rb
+- spec/lib/woro/task_spec.rb
+- spec/spec_helper.rb

data/lib/woro/gister.rb

@@ -1,45 +0,0 @@
-require 'gist'
-require 'net/https'
-
-# All classes and modules specific to Woro.
-module Woro
-  # Various shared static helpers
-  class Gister
-    class << self
-      # Creates an initial welcome gist on project setup
-      # @param app_name [String] Name of the app is displayed in the initial welcome message
-      def create_initial_gist(app_name, access_token=nil)
-        Gist.gist("Welcome to the Woro Task Repository for #{app_name}", filename: app_name, access_token: access_token)
-      end
-
-      # Retrieves metadata of the specified gist
-      # @param gist_id [String] id of the gist
-      # @return [Hash] parsed JSON hash
-      def retrieve_gist(gist_id)
-        service_url = "https://api.github.com/gists/#{gist_id}"
-        response = Net::HTTP.get_response(URI.parse(service_url))
-        JSON.parse(response.body)
-      end
-
-      # Extract description from gist's data content string.
-      # @param data [Hash] gist data hash
-      # [String] description string
-      def extract_description(data)
-        data['content'].match(/desc ['"]([a-zA-Z0-9\s]*)['"]/)[1]
-      end
-
-      # Returns the list of files included in the specified gist
-      # @param gist_id [String] id of the gist
-      # @return [Hash] List of files in the format { filename: { data }}
-      def get_list_of_files(gist_id)
-        retrieve_gist(gist_id)['files']
-      end
-
-      # Read the rake task template
-      # @return [String]
-      def read_template_file
-        File.read(File.dirname(__FILE__) + '/templates/task.rake')
-      end
-    end
-  end
-end