stax 0.0.6 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24b118344e504720f05bc0cf2ece8718f239f62be0c1108798e3b0ae293e824b
-  data.tar.gz: 7320e11f8631f087861934243b7eec97d17a992ebcb74b43512a345fe4423ef4
+  metadata.gz: 16b886170228e97d41cc2294002b13db11b77cc363c838181043418891cbc2b6
+  data.tar.gz: fc5d8071c9e5537af036509de4fcaebab03973297bab62421552bcd029de5abd
 SHA512:
-  metadata.gz: 36ded65f2ff9dedc05b985c0e9af6bf290ae8f301f32ba3653d439b7bbe406ba69b413ed0548a88f168d0603246a32b13e5feddc5a1c2656027aaff569c1f6d2
-  data.tar.gz: 1178754545a2d18103dbc0c87308c30de5d0a765e97e00542393e91567ebc33acaefc7ad86ae5d8331cbb8e9bbe6986130b1ffb1382d5f4edc1491acabd14c13
+  metadata.gz: df070637f695680a7e4474a4b734973ec063b4049ac00a4630fda0d192411aaa87a8146c156addbec21c8b708ddeed97d5c74130f7a80f4862ff4f65a6469258
+  data.tar.gz: 3f0fac8e4f16a786accca5e2f7661be3031caf21c3134156e7e489de49207373293320e22ebb8abf84a8b2371a38e93e11c18b288d8c092d19242592c4470a82

data/README.md

@@ -10,6 +10,54 @@ Stax can read template files written in `yaml`, `json` or the
 [cfer](https://github.com/seanedwards/cfer) ruby wrapper. It will
 choose which to use based on file extensions found.
 
+## Getting Started
+
+Install `stax`:
+
+```sh
+# gem install stax
+```
+
+Create a new `stax` application. You can choose to do this in an
+ops-specific subdirectory of your application code (thus delivering
+infrastructure to run an app with the app itself), or create an
+infrastructure-specific repo. It's up to you.
+
+```sh
+$ stax new ops
+```
+
+Change to your stax directory and install bundle:
+
+```sh
+$ cd ops
+$ bundle install
+```
+
+Create an example stack, and add a resource:
+
+```sh
+$ stax g stack example
+$ cat >> cf/example.rb
+resource :s3, 'AWS::S3::Bucket'
+^D
+$ stax example create
+```
+
+Your new stack should create, and you should now be able to list it,
+inspect resource, etc:
+
+```sh
+$ stax ls
+$ stax example resources
+```
+
+Delete your example stack:
+
+```sh
+$ stax example delete
+```
+
 ## Concepts
 
 ### Application

data/lib/stax.rb

@@ -1,5 +1,3 @@
-require 'thor'
-
 require 'stax/aws/sdk'
 require 'stax/aws/cfn'
 
@@ -8,9 +6,9 @@ require 'stax/staxfile'
 require 'stax/base'
 require 'stax/git'
 require 'stax/cli'
-require 'stax/meta'
 require 'stax/subcommand'
 require 'stax/cfer'
+
 require 'stax/stack'
 require 'stax/stack/cfn'
 require 'stax/stack/crud'
@@ -20,8 +18,6 @@ require 'stax/stack/outputs'
 require 'stax/stack/imports'
 require 'stax/stack/resources'
 
-require 'stax/generators'
-require 'stax/generate'
 require 'stax/mixin/ec2'
 require 'stax/mixin/alb'
 require 'stax/mixin/elb'

data/lib/stax/aws/apigw.rb

@@ -17,6 +17,18 @@ module Stax
           client.get_stages(rest_api_id: id, deployment_id: deployment).item
         end
 
+        def resources(id)
+          position = nil
+          items = []
+          loop do
+            resp = client.get_resources(rest_api_id: id, position: position)
+            items += resp.items
+            position = resp.position
+            break unless position
+          end
+          items
+        end
+
       end
 
     end

data/lib/stax/aws/cfn.rb

@@ -72,6 +72,8 @@ module Stax
 
         def describe(name)
           client.describe_stacks(stack_name: name).stacks.first
+        rescue ::Aws::CloudFormation::Errors::ValidationError
+          nil
         end
 
         def exists?(name)

data/lib/stax/base.rb

@@ -1,3 +1,4 @@
+require 'thor'
 require 'stax/aws/sts'
 
 module Stax

data/lib/stax/cli.rb

@@ -1,23 +1,13 @@
-require 'stax/aws/cfn'
+require 'stax/cli/version'
+require 'stax/cli/ls'
+require 'stax/cli/new'
+require 'stax/cli/generate'
+require 'stax/cli/crud'
+require 'stax/cli/info'
 
 module Stax
   class Cli < Base
     class_option :branch, type: :string, default: Git.branch, desc: 'git branch to use'
     class_option :app,    type: :string, default: File.basename(Git.toplevel), desc: 'application name'
-
-    desc 'version', 'show version'
-    def version
-      puts VERSION
-    end
-
-    desc 'ls', 'list stacks for this branch'
-    def ls
-      print_table Aws::Cfn.stacks.select { |s|
-        s.stack_name.start_with?(stack_prefix)
-      }.map { |s|
-        [s.stack_name, s.creation_time, color(s.stack_status, Aws::Cfn::COLORS), s.template_description]
-      }.sort
-    end
-
   end
 end

data/lib/stax/cli/generate.rb

@@ -0,0 +1,23 @@
+require 'stax/generators'
+
+module Stax
+  class Cli < Base
+
+    desc 'generate NAME [ARGS]', 'run code generators'
+    def generate(name = nil, *args)
+      Stax::Generators.load_builtin_generators
+      Stax::Generators.load_local_generators
+
+      if name.nil?
+        Stax::Generators::Base.subclasses.each do |g|
+          say_status(g.command_name, g.desc, :bold)
+        end
+      else
+        klass = Stax::Generators.find(name)
+        fail_task("Unknown generator #{name}") unless klass
+        klass.start(args)
+      end
+    end
+
+  end
+end

data/lib/stax/cli/info.rb

@@ -0,0 +1,23 @@
+module Stax
+  class Stack < Base
+
+    # no_commands do
+    #   def self.info(cmds)
+    #     puts "info: #{cmds}"
+    #   end
+    # end
+
+    desc 'info', 'service-specific info'
+    def info
+      ## get mixins in the order we declared them
+      self.class.subcommands.reverse.each do |cmd|
+        begin
+          invoke cmd, [:info]
+        rescue Thor::UndefinedCommandError => e
+          # no info no problem
+        end
+      end
+    end
+
+  end
+end

data/lib/stax/cli/ls.rb

@@ -0,0 +1,46 @@
+module Stax
+  class Cli < Base
+
+    no_commands do
+      def ls_staxfile_stacks
+        print_table Stax.stack_list.map { |id|
+          name = stack(id).stack_name
+          if (s = Aws::Cfn.describe(name))
+            [s.stack_name, s.creation_time, color(s.stack_status, Aws::Cfn::COLORS), s.description]
+          else
+            options[:existing] ? nil : [name, '-']
+          end
+        }.compact
+      end
+
+      def ls_stacks_with_prefix(prefix)
+        print_table Aws::Cfn.stacks.select { |s|
+          s.stack_name.start_with?(prefix || stack_prefix)
+        }.map { |s|
+          [s.stack_name, s.creation_time, color(s.stack_status, Aws::Cfn::COLORS), s.template_description]
+        }.sort
+      end
+
+      def ls_account_stacks
+        print_table Aws::Cfn.stacks.map { |s|
+          [s.stack_name, s.creation_time, color(s.stack_status, Aws::Cfn::COLORS), s.template_description]
+        }.sort
+      end
+    end
+
+    desc 'ls [PREFIX]', 'list stacks'
+    method_option :existing, aliases: '-e', type: :boolean, default: false, desc: 'list just existing stacks'
+    method_option :all,      aliases: '-a', type: :boolean, default: false, desc: 'list all running stacks with our prefix'
+    method_option :account,  aliases: '-A', type: :boolean, default: false, desc: 'list all running stacks in account'
+    def ls(prefix = nil)
+      if options[:account]
+        ls_account_stacks
+      elsif options[:all]
+        ls_stacks_with_prefix(prefix)
+      else
+        ls_staxfile_stacks
+      end
+    end
+
+  end
+end

data/lib/stax/cli/new.rb

@@ -0,0 +1,11 @@
+module Stax
+  class Cli < Base
+
+    desc 'new DIR', 'create new stax project in dir'
+    def new(dir)
+      Stax::Generators.load_builtin_generators
+      Stax::Generators::NewGenerator.start(Array(dir))
+    end
+
+  end
+end

data/lib/stax/cli/version.rb

@@ -0,0 +1,12 @@
+require 'stax/version'
+
+module Stax
+  class Cli < Base
+
+    desc 'version', 'show version'
+    def version
+      puts Stax::VERSION
+    end
+
+  end
+end

data/lib/stax/generators.rb

@@ -1,12 +1,24 @@
 require 'stax/generators/base'
-require 'stax/generators/stack/stack_generator'
-require 'stax/generators/generator/generator_generator'
 
 module Stax
   module Generators
 
-    def self.invoke(name, *args)
-      Stax::Generators::const_get(name.capitalize + 'Generator').start(args)
+    def self.load_builtin_generators
+      Dir[File.join(__dir__, 'generators', '**', '*_generator.rb')].map(&method(:require))
+    end
+
+    ## load any generators in project lib/generators/
+    def self.load_local_generators
+      if Stax.root_path
+        Dir[Stax.root_path.join('lib', 'generators', '**', '*_generator.rb')].map(&method(:require))
+      end
+    end
+
+    ## find subclass that matches command name
+    def self.find(name)
+      Base.subclasses.find do |g|
+        g.command_name == name
+      end
     end
 
   end

data/lib/stax/generators/base.rb

@@ -1,3 +1,5 @@
+require 'thor/group'
+
 module Stax
   module Generators
     class Base < Thor::Group
@@ -5,6 +7,12 @@ module Stax
 
       protected
 
+      ## show usage and exit
+      def usage!
+        self.class.help(self)
+        exit
+      end
+
       def self.subclasses
         ObjectSpace.each_object(singleton_class).map do |klass|
           klass == self ? nil : klass
@@ -16,9 +24,6 @@ module Stax
         self.to_s.split('::').last.delete_suffix('Generator').downcase
       end
 
-      def self.invoke(name, args = ARGV)
-      end
-
       ## override help banner to make sense for generators
       def self.banner(*args)
         "#{basename} generate #{command_name} ARGS"

data/lib/stax/generators/generator/generator_generator.rb

@@ -6,7 +6,7 @@ module Stax
       source_root File.expand_path('templates', __dir__)
 
       def check_args
-        abort('Give name of generator, e.g. FooBar or foo_bar') if args.size != 1
+        usage! if args.size != 1
       end
 
       def create_generator_file
@@ -19,6 +19,10 @@ module Stax
 
       private
 
+      def self.banner(*args)
+        "#{basename} generate #{command_name} NAME"
+      end
+
       def generator_name
         @_generator_name ||= args.first.underscore
       end
@@ -28,7 +32,7 @@ module Stax
       end
 
       def generator_path
-        @_generator_path ||= File.join('lib', 'generators', args.first.underscore)
+        @_generator_path ||= File.join([Stax.root_path, 'lib', 'generators', args.first.underscore].compact)
       end
 
     end

data/lib/stax/generators/new/new_generator.rb

@@ -0,0 +1,42 @@
+module Stax
+  module Generators
+    class NewGenerator < Base
+      desc 'Create new stax project in give dir.'
+
+      source_root File.expand_path('templates', __dir__)
+
+      def check_args
+        usage! if args.size != 1
+      end
+
+      def create_stax_dir
+        empty_directory(args.first)
+        self.destination_root = args.first
+      end
+
+      def create_staxfile
+        template('Staxfile')
+      end
+
+      def create_gemfile
+        template('Gemfile')
+      end
+
+      def create_dirs
+        empty_directory(File.join('lib', 'stack'))
+        empty_directory('cf')
+      end
+
+      def create_lib_stack
+        template(File.join('lib', 'stack.rb'))
+      end
+
+      private
+
+      def self.banner(*args)
+        "#{basename} generate #{command_name} DIR"
+      end
+
+    end
+  end
+end

data/lib/stax/generators/new/templates/Gemfile

@@ -0,0 +1,16 @@
+source 'https://rubygems.org'
+
+gem 'stax'
+# gem 'stax', git: 'https://github.com/rlister/stax'
+
+gem 'stax-nag'
+# gem 'stax-nag', git: 'https://github.com/rlister/stax-nag'
+
+gem 'stax-examples'
+# gem 'stax-examples', git: 'https://github.com/rlister/stax-examples'
+
+## this is a hack until this fixed: https://github.com/seanedwards/cfer/issues/50
+gem 'docile', '~> 1.2.0'
+
+## for ruby template wrappers
+gem 'cfer', '>= 0.6.0'

data/lib/stax/generators/new/templates/Staxfile

@@ -0,0 +1,5 @@
+require 'stax/examples'
+
+## add stacks here
+# stack :foo
+# stack :bar, import: :foo

data/lib/stax/generators/new/templates/lib/stack.rb

@@ -0,0 +1,38 @@
+## Monkey-patches you may make to change stack behavior.
+## Changing these here will affect all stacks.
+## You may also define these per-stack in the sub-class for each stack in lib/stacks/.
+
+module Stax
+  class Stack < Base
+
+    no_commands do
+
+      ## your application name, will start all stack names
+      # def app_name
+      #   @_app_name ||= options[:app].empty? ? nil : cfn_safe(options[:app])
+      # end
+
+      ## git branch to insert in stack names
+      # def branch_name
+      #   @_branch_name ||= cfn_safe(options[:branch])
+      # end
+
+      ## format of stack names like $app-$branch-$stack
+      # def stack_prefix
+      #   @_stack_prefix ||= [app_name, branch_name].compact.join('-') + '-'
+      # end
+
+      ## turn on stack protection when creating stack
+      # def cfn_termination_protection
+      #   false
+      # end
+
+      ## enforce changesets for stack update
+      # def stack_force_changeset
+      #   false
+      # end
+
+    end
+
+  end
+end

data/lib/stax/generators/stack/stack_generator.rb

@@ -12,7 +12,7 @@ module Stax
       class_option :yaml, type: :boolean, default: false, desc: 'create yaml templates'
 
       def check_args
-        abort('List one or more stacks to create') if args.empty?
+        usage! if args.empty?
       end
 
       def create_staxfile

data/lib/stax/mixin/alb.rb

@@ -3,13 +3,14 @@ require 'stax/aws/alb'
 module Stax
   module Alb
     def self.included(thor)
-      thor.desc(:alb, 'ALB subcommands')
+      thor.desc('alb COMMAND', 'ALB subcommands')
       thor.subcommand(:alb, Cmd::Alb)
     end
   end
 
   module Cmd
     class Alb < SubCommand
+      stax_info :status
 
       COLORS = {
         healthy:     :green,

data/lib/stax/mixin/apigw.rb

@@ -10,6 +10,7 @@ module Stax
 
   module Cmd
     class Apigw < SubCommand
+      stax_info :endpoints, :resources
 
       no_commands do
         def stack_apis
@@ -36,6 +37,30 @@ module Stax
         end
       end
 
+      desc 'resources', 'list resources'
+      def resources
+        stack_apis.each do |r|
+          api = Aws::APIGateway.api(r.physical_resource_id)
+          debug("Resources for API #{api.name} #{api.id}")
+          print_table Aws::APIGateway.resources(api.id).map { |r|
+            methods = r.resource_methods&.keys&.join(',')
+            [r.path, r.id, methods]
+          }.sort
+        end
+      end
+
+      desc 'endpoints', 'guess endpoint URIs'
+      def endpoints
+        stack_apis.each do |r|
+          api = Aws::APIGateway.api(r.physical_resource_id)
+          debug("Endpoints for API #{api.name} #{api.id}")
+          print_table Aws::APIGateway.stages(api.id).map { |s|
+            url = "https://#{api.id}.execute-api.#{aws_region}.amazonaws.com/#{s.stage_name}/"
+            [s.stage_name, url]
+          }.sort
+        end
+      end
+
     end
   end
 end

data/lib/stax/mixin/asg.rb

@@ -10,6 +10,8 @@ module Stax
 
   module Cmd
     class Asg < SubCommand
+      stax_info :status
+
       COLORS = {
         ## lifecycle states
         Pending: :yellow, InService: :green, Terminating: :red,

data/lib/stax/mixin/codebuild.rb

@@ -18,6 +18,8 @@ module Stax
 
   module Cmd
     class Codebuild < SubCommand
+      stax_info :builds
+
       COLORS = {
         SUCCEEDED:    :green,
         FAILED:       :red,

data/lib/stax/mixin/codepipeline.rb

@@ -18,6 +18,8 @@ module Stax
 
   module Cmd
     class Codepipeline < SubCommand
+      stax_info :state
+
       COLORS = {
         Succeeded: :green,
         Failed:    :red,

data/lib/stax/mixin/dynamodb.rb

@@ -6,13 +6,14 @@ require_relative 'dynamodb/backup'
 module Stax
   module DynamoDB
     def self.included(thor)
-      thor.desc(:dynamodb, 'Dynamo subcommands')
+      thor.desc('dynamodb COMMAND', 'Dynamo subcommands')
       thor.subcommand(:dynamodb, Cmd::DynamoDB)
     end
   end
 
   module Cmd
     class DynamoDB < SubCommand
+      stax_info :tables
 
       COLORS = {
         CREATING:  :yellow,
@@ -38,6 +39,7 @@ module Stax
 
       desc 'tables', 'list tables for stack'
       def tables
+        debug("Dynamo tables for stack #{my.stack_name}")
         print_table stack_tables.map { |r|
           t = Aws::DynamoDB.table(r.physical_resource_id)
           g = Aws::DynamoDB.global_table(r.physical_resource_id)

data/lib/stax/mixin/ecs.rb

@@ -4,7 +4,7 @@ require_relative 'ecs/deploy'
 module Stax
   module Ecs
     def self.included(thor)
-      thor.desc(:ecs, 'ECS subcommands')
+      thor.desc('ecs COMMAND', 'ECS subcommands')
       thor.subcommand(:ecs, Cmd::Ecs)
     end
 
@@ -63,6 +63,8 @@ module Stax
 
   module Cmd
     class Ecs < SubCommand
+      stax_info :tasks
+
       COLORS = {
         ACTIVE:   :green,
         INACTIVE: :red,

data/lib/stax/mixin/elb.rb

@@ -10,6 +10,7 @@ module Stax
 
   module Cmd
     class Elb < SubCommand
+      stax_info :status
 
       COLORS = {
         InService:    :green,

data/lib/stax/mixin/lambda.rb

@@ -6,13 +6,14 @@ require 'stax/aws/lambda'
 module Stax
   module Lambda
     def self.included(thor)
-      thor.desc(:lambda, 'Lambda subcommands')
+      thor.desc('lambda COMMAND', 'Lambda subcommands')
       thor.subcommand(:lambda, Cmd::Lambda)
     end
   end
 
   module Cmd
     class Lambda < SubCommand
+      stax_info :ls
 
       no_commands do
         def stack_lambdas
@@ -37,6 +38,7 @@ module Stax
 
       desc 'ls', 'list lambdas for stack'
       def ls
+        debug("Lambda functions for stack #{my.stack_name}")
         names = stack_lambdas.map(&:physical_resource_id)
         print_table Aws::Lambda.list.select { |l|
           names.include?(l.function_name)
@@ -99,5 +101,4 @@ module Stax
 
     end
   end
-
 end

data/lib/stax/mixin/logs.rb

@@ -4,7 +4,7 @@ module Stax
   module Logs
 
     def self.included(thor)
-      thor.desc(:logs, 'Logs subcommands')
+      thor.desc('logs COMMAND', 'Logs subcommands')
       thor.subcommand(:logs, Cmd::Logs)
     end
 

data/lib/stax/staxfile.rb

@@ -1,27 +1,37 @@
 module Stax
+  @@_root_path = nil
   @@_stack_list = []
 
+  ## the stax root is defined as location of Staxfile
+  def self.root_path
+    @@_root_path
+  end
+
   ## list of stacks defined in Staxfile
   def self.stack_list
     @@_stack_list
   end
 
-  ## try to require file from lib/stack/ for each stack
-  def self.auto_require(path)
-    stack_list.each do |stack|
-      f = path.join('lib', 'stack', "#{stack}.rb")
-      require(f) if File.exist?(f)
+  ## search up the dir tree for nearest Staxfile
+  def self.find_staxfile
+    Pathname.pwd.ascend do |path|
+      return path if File.exist?(file = path.join('Staxfile'))
     end
   end
 
-  ## search up the dir tree for nearest Staxfile
   def self.load_staxfile
-    Pathname.pwd.ascend do |path|
-      if File.exist?(file = path.join('Staxfile'))
-        load(file) if file
-        auto_require(path)
-        break
-      end
+    @@_root_path = find_staxfile
+    if root_path
+      load(root_path.join('Staxfile'))
+      require_stacks
+    end
+  end
+
+  ## auto-require any stack lib files
+  def self.require_stacks
+    stack_list.each do |stack|
+      f = root_path.join('lib', 'stack', "#{stack}.rb")
+      require(f) if File.exist?(f)
     end
   end
 
@@ -36,11 +46,11 @@ module Stax
     else
       self.const_set(c, Class.new(Stack))
     end.tap do |klass|
-      Cli.desc(name, "#{name} stack")
+      Cli.desc("#{name} COMMAND", "#{name} stack commands")
       Cli.subcommand(name, klass)
 
-      ## has syntax to include mixins
-      opt.fetch(:include, []).each do |i|
+      ## syntax to include mixins, reverse to give predictable include order
+      opt.fetch(:include, []).reverse.each do |i|
         klass.include(self.const_get(i))
       end
 

data/lib/stax/subcommand.rb

@@ -1,12 +1,35 @@
 module Stax
   class SubCommand < Base
-    no_commands do
 
+    class << self
+      def stax_info(*tasks)
+        @stax_info_tasks ||= []
+        @stax_info_tasks += tasks
+      end
+
+      def stax_info_tasks
+        @stax_info_tasks&.uniq
+      end
+    end
+
+    no_commands do
       ## return the Stack instance that called this subcommand
       def my
         @_my ||= stack(current_command_chain.first)
       end
+    end
 
+    desc 'info', 'stax info task', hide: true
+    def info
+      self.class.stax_info_tasks&.each do |task|
+        begin
+          invoke task
+          puts "\n"
+        rescue NoMethodError => e
+          warn(e.message)
+        end
+      end
     end
+
   end
 end

data/lib/stax/version.rb

@@ -1,3 +1,3 @@
 module Stax
-  VERSION = '0.0.6'
+  VERSION = '0.0.7'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stax
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
 platform: ruby
 authors:
 - Richard Lister
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-06-04 00:00:00.000000000 Z
+date: 2018-06-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -157,19 +157,27 @@ files:
 - lib/stax/base.rb
 - lib/stax/cfer.rb
 - lib/stax/cli.rb
+- lib/stax/cli/crud.rb
+- lib/stax/cli/generate.rb
+- lib/stax/cli/info.rb
+- lib/stax/cli/ls.rb
+- lib/stax/cli/new.rb
+- lib/stax/cli/version.rb
 - lib/stax/docker.rb
 - lib/stax/dsl.rb
-- lib/stax/generate.rb
 - lib/stax/generators.rb
 - lib/stax/generators/base.rb
 - lib/stax/generators/generator/generator_generator.rb
 - lib/stax/generators/generator/templates/generator.rb.erb
+- lib/stax/generators/new/new_generator.rb
+- lib/stax/generators/new/templates/Gemfile
+- lib/stax/generators/new/templates/Staxfile
+- lib/stax/generators/new/templates/lib/stack.rb
 - lib/stax/generators/stack/stack_generator.rb
 - lib/stax/git.rb
 - lib/stax/github.rb
 - lib/stax/iam.rb
 - lib/stax/keypair.rb
-- lib/stax/meta.rb
 - lib/stax/mixin/alb.rb
 - lib/stax/mixin/apigw.rb
 - lib/stax/mixin/asg.rb

data/lib/stax/generate.rb

@@ -1,12 +0,0 @@
-module Stax
-  class Cli < Base
-
-    desc 'generate NAME [ARGS]', 'run code generators'
-    def generate(generator, *args)
-      Stax::Generators.invoke(generator, *args)
-    rescue NameError => e
-      fail_task(e.message)
-    end
-
-  end
-end