textgoeshere-daemon-kit 0.1.8rc3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (185) hide show
  1. data/.gitignore +5 -0
  2. data/Configuration.txt +110 -0
  3. data/Deployment.txt +113 -0
  4. data/History.txt +124 -0
  5. data/Logging.txt +96 -0
  6. data/PostInstall.txt +6 -0
  7. data/README.rdoc +128 -0
  8. data/Rakefile +29 -0
  9. data/RuoteParticipants.txt +113 -0
  10. data/TODO.txt +27 -0
  11. data/bin/daemon-kit +18 -0
  12. data/config/website.yml +2 -0
  13. data/daemon-kit.gemspec +265 -0
  14. data/lib/daemon_kit/abstract_logger.rb +249 -0
  15. data/lib/daemon_kit/amqp.rb +39 -0
  16. data/lib/daemon_kit/application.rb +230 -0
  17. data/lib/daemon_kit/arguments.rb +165 -0
  18. data/lib/daemon_kit/commands/console.rb +38 -0
  19. data/lib/daemon_kit/commands/destroy.rb +10 -0
  20. data/lib/daemon_kit/commands/generate.rb +10 -0
  21. data/lib/daemon_kit/config.rb +113 -0
  22. data/lib/daemon_kit/console_daemon.rb +2 -0
  23. data/lib/daemon_kit/core_ext/configurable.rb +96 -0
  24. data/lib/daemon_kit/core_ext/string.rb +22 -0
  25. data/lib/daemon_kit/core_ext.rb +1 -0
  26. data/lib/daemon_kit/cron.rb +48 -0
  27. data/lib/daemon_kit/cucumber/world.rb +38 -0
  28. data/lib/daemon_kit/deployment/capistrano.rb +516 -0
  29. data/lib/daemon_kit/em.rb +43 -0
  30. data/lib/daemon_kit/error_handlers/base.rb +32 -0
  31. data/lib/daemon_kit/error_handlers/hoptoad.rb +180 -0
  32. data/lib/daemon_kit/exceptions.rb +15 -0
  33. data/lib/daemon_kit/generators/base.rb +60 -0
  34. data/lib/daemon_kit/generators.rb +67 -0
  35. data/lib/daemon_kit/initializer.rb +453 -0
  36. data/lib/daemon_kit/jabber.rb +171 -0
  37. data/lib/daemon_kit/nanite/agent.rb +77 -0
  38. data/lib/daemon_kit/nanite.rb +7 -0
  39. data/lib/daemon_kit/pid_file.rb +61 -0
  40. data/lib/daemon_kit/ruote_participants.rb +125 -0
  41. data/lib/daemon_kit/ruote_pseudo_participant.rb +68 -0
  42. data/lib/daemon_kit/ruote_workitem.rb +187 -0
  43. data/lib/daemon_kit/safety.rb +84 -0
  44. data/lib/daemon_kit/tasks/environment.rake +10 -0
  45. data/lib/daemon_kit/tasks/framework.rake +123 -0
  46. data/lib/daemon_kit/tasks/god.rake +62 -0
  47. data/lib/daemon_kit/tasks/log.rake +8 -0
  48. data/lib/daemon_kit/tasks/monit.rake +29 -0
  49. data/lib/daemon_kit/tasks.rb +2 -0
  50. data/lib/daemon_kit/vendor/thor-0.13.6/CHANGELOG.rdoc +89 -0
  51. data/lib/daemon_kit/vendor/thor-0.13.6/LICENSE +20 -0
  52. data/lib/daemon_kit/vendor/thor-0.13.6/README.rdoc +297 -0
  53. data/lib/daemon_kit/vendor/thor-0.13.6/Thorfile +69 -0
  54. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/actions/create_file.rb +103 -0
  55. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/actions/directory.rb +91 -0
  56. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/actions/empty_directory.rb +134 -0
  57. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/actions/file_manipulation.rb +223 -0
  58. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/actions/inject_into_file.rb +104 -0
  59. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/actions.rb +296 -0
  60. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/base.rb +540 -0
  61. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/core_ext/file_binary_read.rb +9 -0
  62. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/core_ext/hash_with_indifferent_access.rb +75 -0
  63. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/core_ext/ordered_hash.rb +100 -0
  64. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/error.rb +30 -0
  65. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/group.rb +271 -0
  66. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/invocation.rb +180 -0
  67. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/parser/argument.rb +67 -0
  68. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/parser/arguments.rb +150 -0
  69. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/parser/option.rb +128 -0
  70. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/parser/options.rb +169 -0
  71. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/parser.rb +4 -0
  72. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/rake_compat.rb +66 -0
  73. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/runner.rb +314 -0
  74. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/shell/basic.rb +239 -0
  75. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/shell/color.rb +108 -0
  76. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/shell.rb +83 -0
  77. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/task.rb +102 -0
  78. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/util.rb +224 -0
  79. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor/version.rb +3 -0
  80. data/lib/daemon_kit/vendor/thor-0.13.6/lib/thor.rb +244 -0
  81. data/lib/daemon_kit/xmpp.rb +100 -0
  82. data/lib/daemon_kit.rb +59 -0
  83. data/lib/generators/daemon_kit/amqp/USAGE +5 -0
  84. data/lib/generators/daemon_kit/amqp/amqp_generator.rb +24 -0
  85. data/lib/generators/daemon_kit/amqp/templates/config/amqp.yml +28 -0
  86. data/lib/generators/daemon_kit/amqp/templates/config/pre-daemonize/amqp.rb +7 -0
  87. data/lib/generators/daemon_kit/amqp/templates/libexec/%app_name%-daemon.rb +37 -0
  88. data/lib/generators/daemon_kit/app/USAGE +7 -0
  89. data/lib/generators/daemon_kit/app/app_generator.rb +140 -0
  90. data/lib/generators/daemon_kit/app/templates/Gemfile +8 -0
  91. data/lib/generators/daemon_kit/app/templates/README.tt +58 -0
  92. data/lib/generators/daemon_kit/app/templates/Rakefile +6 -0
  93. data/lib/generators/daemon_kit/app/templates/bin/daemon.tt +7 -0
  94. data/lib/generators/daemon_kit/app/templates/config/arguments.rb +12 -0
  95. data/lib/generators/daemon_kit/app/templates/config/boot.rb +70 -0
  96. data/lib/generators/daemon_kit/app/templates/config/environment.rb.tt +26 -0
  97. data/lib/generators/daemon_kit/app/templates/config/environments/development.rb +2 -0
  98. data/lib/generators/daemon_kit/app/templates/config/environments/production.rb +5 -0
  99. data/lib/generators/daemon_kit/app/templates/config/environments/test.rb +2 -0
  100. data/lib/generators/daemon_kit/app/templates/config/post-daemonize/readme +5 -0
  101. data/lib/generators/daemon_kit/app/templates/config/pre-daemonize/readme +12 -0
  102. data/lib/generators/daemon_kit/app/templates/lib/%app_name%.rb +2 -0
  103. data/lib/generators/daemon_kit/app/templates/libexec/%app_name%-daemon.rb +18 -0
  104. data/lib/generators/daemon_kit/app/templates/script/console +3 -0
  105. data/lib/generators/daemon_kit/app/templates/script/destroy +3 -0
  106. data/lib/generators/daemon_kit/app/templates/script/generate +3 -0
  107. data/lib/generators/daemon_kit/capistrano/capistrano_generator.rb +26 -0
  108. data/lib/generators/daemon_kit/capistrano/templates/Capfile +10 -0
  109. data/lib/generators/daemon_kit/capistrano/templates/USAGE +10 -0
  110. data/lib/generators/daemon_kit/capistrano/templates/config/deploy/logrotate.erb +13 -0
  111. data/lib/generators/daemon_kit/capistrano/templates/config/deploy/production.rb.tt +6 -0
  112. data/lib/generators/daemon_kit/capistrano/templates/config/deploy/staging.rb.tt +6 -0
  113. data/lib/generators/daemon_kit/capistrano/templates/config/deploy.rb.tt +67 -0
  114. data/lib/generators/daemon_kit/capistrano/templates/config/environments/staging.rb +0 -0
  115. data/lib/generators/daemon_kit/cron/USAGE +5 -0
  116. data/lib/generators/daemon_kit/cron/cron_generator.rb +24 -0
  117. data/lib/generators/daemon_kit/cron/templates/config/pre-daemonize/cron.rb +11 -0
  118. data/lib/generators/daemon_kit/cron/templates/libexec/%app_name%-daemon.rb +43 -0
  119. data/lib/generators/daemon_kit/cucumber/USAGE +11 -0
  120. data/lib/generators/daemon_kit/cucumber/cucumber_generator.rb +45 -0
  121. data/lib/generators/daemon_kit/cucumber/templates/config/environments/cucumber.rb +2 -0
  122. data/lib/generators/daemon_kit/cucumber/templates/features/step_definitions/.empty_directory +0 -0
  123. data/lib/generators/daemon_kit/cucumber/templates/features/support/env.rb +7 -0
  124. data/lib/generators/daemon_kit/cucumber/templates/script/cucumber +7 -0
  125. data/lib/generators/daemon_kit/cucumber/templates/tasks/cucumber.rake +13 -0
  126. data/lib/generators/daemon_kit/nanite_agent/USAGE +5 -0
  127. data/lib/generators/daemon_kit/nanite_agent/nanite_agent_generator.rb +29 -0
  128. data/lib/generators/daemon_kit/nanite_agent/templates/config/nanite.yml +35 -0
  129. data/lib/generators/daemon_kit/nanite_agent/templates/config/pre-daemonize/nanite_agent.rb +6 -0
  130. data/lib/generators/daemon_kit/nanite_agent/templates/lib/actors/sample.rb +11 -0
  131. data/lib/generators/daemon_kit/nanite_agent/templates/libexec/%app_name%-daemon.rb +31 -0
  132. data/lib/generators/daemon_kit/rspec/USAGE +5 -0
  133. data/lib/generators/daemon_kit/rspec/rspec_generator.rb +20 -0
  134. data/lib/generators/daemon_kit/rspec/templates/spec/%app_name%_spec.rb +11 -0
  135. data/lib/generators/daemon_kit/rspec/templates/spec/spec.opts +1 -0
  136. data/lib/generators/daemon_kit/rspec/templates/spec/spec_helper.rb +23 -0
  137. data/lib/generators/daemon_kit/rspec/templates/tasks/rspec.rake +19 -0
  138. data/lib/generators/daemon_kit/ruote/USAGE +5 -0
  139. data/lib/generators/daemon_kit/ruote/ruote_generator.rb +29 -0
  140. data/lib/generators/daemon_kit/ruote/templates/config/amqp.yml +30 -0
  141. data/lib/generators/daemon_kit/ruote/templates/config/pre-daemonize/ruote.rb +13 -0
  142. data/lib/generators/daemon_kit/ruote/templates/config/ruote.yml +23 -0
  143. data/lib/generators/daemon_kit/ruote/templates/lib/%app_name%.rb +4 -0
  144. data/lib/generators/daemon_kit/ruote/templates/lib/sample.rb +26 -0
  145. data/lib/generators/daemon_kit/ruote/templates/libexec/%app_name%-daemon.rb +33 -0
  146. data/lib/generators/daemon_kit/test_unit/USAGE +5 -0
  147. data/lib/generators/daemon_kit/test_unit/templates/tasks/test_unit.rake +7 -0
  148. data/lib/generators/daemon_kit/test_unit/templates/test/%app_name%_test.rb.tt +9 -0
  149. data/lib/generators/daemon_kit/test_unit/templates/test/test_helper.rb +6 -0
  150. data/lib/generators/daemon_kit/test_unit/test_unit_generator.rb +20 -0
  151. data/lib/generators/daemon_kit/xmpp/templates/config/pre-daemonize/xmpp.rb +6 -0
  152. data/lib/generators/daemon_kit/xmpp/templates/config/xmpp.yml +29 -0
  153. data/lib/generators/daemon_kit/xmpp/templates/libexec/%app_name%-daemon.rb +27 -0
  154. data/lib/generators/daemon_kit/xmpp/xmpp_generator.rb +24 -0
  155. data/script/console +10 -0
  156. data/script/destroy +14 -0
  157. data/script/generate +14 -0
  158. data/script/txt2html +71 -0
  159. data/spec/abstract_logger_spec.rb +126 -0
  160. data/spec/argument_spec.rb +70 -0
  161. data/spec/config_spec.rb +83 -0
  162. data/spec/configurable_spec.rb +56 -0
  163. data/spec/daemon_kit_spec.rb +7 -0
  164. data/spec/error_handlers_spec.rb +23 -0
  165. data/spec/fixtures/env.yml +15 -0
  166. data/spec/fixtures/noenv.yml +4 -0
  167. data/spec/initializer_spec.rb +26 -0
  168. data/spec/spec.opts +1 -0
  169. data/spec/spec_helper.rb +27 -0
  170. data/tasks/cucumber.rake +13 -0
  171. data/tasks/rspec.rake +21 -0
  172. data/tasks/tests.rake +6 -0
  173. data/templates/god/god.erb +69 -0
  174. data/templates/monit/monit.erb +14 -0
  175. data/test/test_amqp_generator.rb +48 -0
  176. data/test/test_cron_generator.rb +45 -0
  177. data/test/test_daemon-kit_generator.rb +84 -0
  178. data/test/test_daemon_kit_config.rb +28 -0
  179. data/test/test_deploy_capistrano_generator.rb +48 -0
  180. data/test/test_generator_helper.rb +29 -0
  181. data/test/test_helper.rb +7 -0
  182. data/test/test_nanite_agent_generator.rb +49 -0
  183. data/test/test_ruote_generator.rb +51 -0
  184. data/test/test_test_unit_generator.rb +46 -0
  185. metadata +325 -0
@@ -0,0 +1,104 @@
1
+ require 'thor/actions/empty_directory'
2
+
3
+ class Thor
4
+ module Actions
5
+
6
+ # Injects the given content into a file. Different from gsub_file, this
7
+ # method is reversible.
8
+ #
9
+ # ==== Parameters
10
+ # destination<String>:: Relative path to the destination root
11
+ # data<String>:: Data to add to the file. Can be given as a block.
12
+ # config<Hash>:: give :verbose => false to not log the status and the flag
13
+ # for injection (:after or :before) or :force => true for
14
+ # insert two or more times the same content.
15
+ #
16
+ # ==== Examples
17
+ #
18
+ # inject_into_file "config/environment.rb", "config.gem :thor", :after => "Rails::Initializer.run do |config|\n"
19
+ #
20
+ # inject_into_file "config/environment.rb", :after => "Rails::Initializer.run do |config|\n" do
21
+ # gems = ask "Which gems would you like to add?"
22
+ # gems.split(" ").map{ |gem| " config.gem :#{gem}" }.join("\n")
23
+ # end
24
+ #
25
+ def inject_into_file(destination, *args, &block)
26
+ if block_given?
27
+ data, config = block, args.shift
28
+ else
29
+ data, config = args.shift, args.shift
30
+ end
31
+ action InjectIntoFile.new(self, destination, data, config)
32
+ end
33
+
34
+ class InjectIntoFile < EmptyDirectory #:nodoc:
35
+ attr_reader :replacement, :flag, :behavior
36
+
37
+ def initialize(base, destination, data, config)
38
+ super(base, destination, { :verbose => true }.merge(config))
39
+
40
+ @behavior, @flag = if @config.key?(:after)
41
+ [:after, @config.delete(:after)]
42
+ else
43
+ [:before, @config.delete(:before)]
44
+ end
45
+
46
+ @replacement = data.is_a?(Proc) ? data.call : data
47
+ @flag = Regexp.escape(@flag) unless @flag.is_a?(Regexp)
48
+ end
49
+
50
+ def invoke!
51
+ say_status :invoke
52
+
53
+ content = if @behavior == :after
54
+ '\0' + replacement
55
+ else
56
+ replacement + '\0'
57
+ end
58
+
59
+ replace!(/#{flag}/, content, config[:force])
60
+ end
61
+
62
+ def revoke!
63
+ say_status :revoke
64
+
65
+ regexp = if @behavior == :after
66
+ content = '\1\2'
67
+ /(#{flag})(.*)(#{Regexp.escape(replacement)})/m
68
+ else
69
+ content = '\2\3'
70
+ /(#{Regexp.escape(replacement)})(.*)(#{flag})/m
71
+ end
72
+
73
+ replace!(regexp, content, true)
74
+ end
75
+
76
+ protected
77
+
78
+ def say_status(behavior)
79
+ status = if flag == /\A/
80
+ behavior == :invoke ? :prepend : :unprepend
81
+ elsif flag == /\z/
82
+ behavior == :invoke ? :append : :unappend
83
+ else
84
+ behavior == :invoke ? :inject : :deinject
85
+ end
86
+
87
+ super(status, config[:verbose])
88
+ end
89
+
90
+ # Adds the content to the file.
91
+ #
92
+ def replace!(regexp, string, force)
93
+ unless base.options[:pretend]
94
+ content = File.binread(destination)
95
+ if force || !content.include?(replacement)
96
+ content.gsub!(regexp, string)
97
+ File.open(destination, 'wb') { |file| file.write(content) }
98
+ end
99
+ end
100
+ end
101
+
102
+ end
103
+ end
104
+ end
@@ -0,0 +1,296 @@
1
+ require 'fileutils'
2
+ require 'uri'
3
+ require 'thor/core_ext/file_binary_read'
4
+
5
+ Dir[File.join(File.dirname(__FILE__), "actions", "*.rb")].each do |action|
6
+ require action
7
+ end
8
+
9
+ class Thor
10
+ module Actions
11
+ attr_accessor :behavior
12
+
13
+ def self.included(base) #:nodoc:
14
+ base.extend ClassMethods
15
+ end
16
+
17
+ module ClassMethods
18
+ # Hold source paths for one Thor instance. source_paths_for_search is the
19
+ # method responsible to gather source_paths from this current class,
20
+ # inherited paths and the source root.
21
+ #
22
+ def source_paths
23
+ @_source_paths ||= []
24
+ end
25
+
26
+ # Stores and return the source root for this class
27
+ def source_root(path=nil)
28
+ @_source_root = path if path
29
+ @_source_root
30
+ end
31
+
32
+ # Returns the source paths in the following order:
33
+ #
34
+ # 1) This class source paths
35
+ # 2) Source root
36
+ # 3) Parents source paths
37
+ #
38
+ def source_paths_for_search
39
+ paths = []
40
+ paths += self.source_paths
41
+ paths << self.source_root if self.source_root
42
+ paths += from_superclass(:source_paths, [])
43
+ paths
44
+ end
45
+
46
+ # Add runtime options that help actions execution.
47
+ #
48
+ def add_runtime_options!
49
+ class_option :force, :type => :boolean, :aliases => "-f", :group => :runtime,
50
+ :desc => "Overwrite files that already exist"
51
+
52
+ class_option :pretend, :type => :boolean, :aliases => "-p", :group => :runtime,
53
+ :desc => "Run but do not make any changes"
54
+
55
+ class_option :quiet, :type => :boolean, :aliases => "-q", :group => :runtime,
56
+ :desc => "Supress status output"
57
+
58
+ class_option :skip, :type => :boolean, :aliases => "-s", :group => :runtime,
59
+ :desc => "Skip files that already exist"
60
+ end
61
+ end
62
+
63
+ # Extends initializer to add more configuration options.
64
+ #
65
+ # ==== Configuration
66
+ # behavior<Symbol>:: The actions default behavior. Can be :invoke or :revoke.
67
+ # It also accepts :force, :skip and :pretend to set the behavior
68
+ # and the respective option.
69
+ #
70
+ # destination_root<String>:: The root directory needed for some actions.
71
+ #
72
+ def initialize(args=[], options={}, config={})
73
+ self.behavior = case config[:behavior].to_s
74
+ when "force", "skip"
75
+ _cleanup_options_and_set(options, config[:behavior])
76
+ :invoke
77
+ when "revoke"
78
+ :revoke
79
+ else
80
+ :invoke
81
+ end
82
+
83
+ super
84
+ self.destination_root = config[:destination_root]
85
+ end
86
+
87
+ # Wraps an action object and call it accordingly to the thor class behavior.
88
+ #
89
+ def action(instance) #:nodoc:
90
+ if behavior == :revoke
91
+ instance.revoke!
92
+ else
93
+ instance.invoke!
94
+ end
95
+ end
96
+
97
+ # Returns the root for this thor class (also aliased as destination root).
98
+ #
99
+ def destination_root
100
+ @destination_stack.last
101
+ end
102
+
103
+ # Sets the root for this thor class. Relatives path are added to the
104
+ # directory where the script was invoked and expanded.
105
+ #
106
+ def destination_root=(root)
107
+ @destination_stack ||= []
108
+ @destination_stack[0] = File.expand_path(root || '')
109
+ end
110
+
111
+ # Returns the given path relative to the absolute root (ie, root where
112
+ # the script started).
113
+ #
114
+ def relative_to_original_destination_root(path, remove_dot=true)
115
+ path = path.gsub(@destination_stack[0], '.')
116
+ remove_dot ? (path[2..-1] || '') : path
117
+ end
118
+
119
+ # Holds source paths in instance so they can be manipulated.
120
+ #
121
+ def source_paths
122
+ @source_paths ||= self.class.source_paths_for_search
123
+ end
124
+
125
+ # Receives a file or directory and search for it in the source paths.
126
+ #
127
+ def find_in_source_paths(file)
128
+ relative_root = relative_to_original_destination_root(destination_root, false)
129
+
130
+ source_paths.each do |source|
131
+ source_file = File.expand_path(file, File.join(source, relative_root))
132
+ return source_file if File.exists?(source_file)
133
+ end
134
+
135
+ message = "Could not find #{file.inspect} in any of your source paths. "
136
+
137
+ unless self.class.source_root
138
+ message << "Please invoke #{self.class.name}.source_root(PATH) with the PATH containing your templates. "
139
+ end
140
+
141
+ if source_paths.empty?
142
+ message << "Currently you have no source paths."
143
+ else
144
+ message << "Your current source paths are: \n#{source_paths.join("\n")}"
145
+ end
146
+
147
+ raise Error, message
148
+ end
149
+
150
+ # Do something in the root or on a provided subfolder. If a relative path
151
+ # is given it's referenced from the current root. The full path is yielded
152
+ # to the block you provide. The path is set back to the previous path when
153
+ # the method exits.
154
+ #
155
+ # ==== Parameters
156
+ # dir<String>:: the directory to move to.
157
+ # config<Hash>:: give :verbose => true to log and use padding.
158
+ #
159
+ def inside(dir='', config={}, &block)
160
+ verbose = config.fetch(:verbose, false)
161
+
162
+ say_status :inside, dir, verbose
163
+ shell.padding += 1 if verbose
164
+ @destination_stack.push File.expand_path(dir, destination_root)
165
+
166
+ FileUtils.mkdir_p(destination_root) unless File.exist?(destination_root)
167
+ FileUtils.cd(destination_root) { block.arity == 1 ? yield(destination_root) : yield }
168
+
169
+ @destination_stack.pop
170
+ shell.padding -= 1 if verbose
171
+ end
172
+
173
+ # Goes to the root and execute the given block.
174
+ #
175
+ def in_root
176
+ inside(@destination_stack.first) { yield }
177
+ end
178
+
179
+ # Loads an external file and execute it in the instance binding.
180
+ #
181
+ # ==== Parameters
182
+ # path<String>:: The path to the file to execute. Can be a web address or
183
+ # a relative path from the source root.
184
+ #
185
+ # ==== Examples
186
+ #
187
+ # apply "http://gist.github.com/103208"
188
+ #
189
+ # apply "recipes/jquery.rb"
190
+ #
191
+ def apply(path, config={})
192
+ verbose = config.fetch(:verbose, true)
193
+ path = find_in_source_paths(path) unless path =~ /^http\:\/\//
194
+
195
+ say_status :apply, path, verbose
196
+ shell.padding += 1 if verbose
197
+
198
+ if URI(path).is_a?(URI::HTTP)
199
+ contents = open(path, "Accept" => "application/x-thor-template") {|io| io.read }
200
+ else
201
+ contents = open(path) {|io| io.read }
202
+ end
203
+
204
+ instance_eval(contents, path)
205
+ shell.padding -= 1 if verbose
206
+ end
207
+
208
+ # Executes a command returning the contents of the command.
209
+ #
210
+ # ==== Parameters
211
+ # command<String>:: the command to be executed.
212
+ # config<Hash>:: give :verbose => false to not log the status. Specify :with
213
+ # to append an executable to command executation.
214
+ #
215
+ # ==== Example
216
+ #
217
+ # inside('vendor') do
218
+ # run('ln -s ~/edge rails')
219
+ # end
220
+ #
221
+ def run(command, config={})
222
+ return unless behavior == :invoke
223
+
224
+ destination = relative_to_original_destination_root(destination_root, false)
225
+ desc = "#{command} from #{destination.inspect}"
226
+
227
+ if config[:with]
228
+ desc = "#{File.basename(config[:with].to_s)} #{desc}"
229
+ command = "#{config[:with]} #{command}"
230
+ end
231
+
232
+ say_status :run, desc, config.fetch(:verbose, true)
233
+ `#{command}` unless options[:pretend]
234
+ end
235
+
236
+ # Executes a ruby script (taking into account WIN32 platform quirks).
237
+ #
238
+ # ==== Parameters
239
+ # command<String>:: the command to be executed.
240
+ # config<Hash>:: give :verbose => false to not log the status.
241
+ #
242
+ def run_ruby_script(command, config={})
243
+ return unless behavior == :invoke
244
+ run command, config.merge(:with => Thor::Util.ruby_command)
245
+ end
246
+
247
+ # Run a thor command. A hash of options can be given and it's converted to
248
+ # switches.
249
+ #
250
+ # ==== Parameters
251
+ # task<String>:: the task to be invoked
252
+ # args<Array>:: arguments to the task
253
+ # config<Hash>:: give :verbose => false to not log the status. Other options
254
+ # are given as parameter to Thor.
255
+ #
256
+ # ==== Examples
257
+ #
258
+ # thor :install, "http://gist.github.com/103208"
259
+ # #=> thor install http://gist.github.com/103208
260
+ #
261
+ # thor :list, :all => true, :substring => 'rails'
262
+ # #=> thor list --all --substring=rails
263
+ #
264
+ def thor(task, *args)
265
+ config = args.last.is_a?(Hash) ? args.pop : {}
266
+ verbose = config.key?(:verbose) ? config.delete(:verbose) : true
267
+ pretend = config.key?(:pretend) ? config.delete(:pretend) : false
268
+
269
+ args.unshift task
270
+ args.push Thor::Options.to_switches(config)
271
+ command = args.join(' ').strip
272
+
273
+ run command, :with => :thor, :verbose => verbose, :pretend => pretend
274
+ end
275
+
276
+ protected
277
+
278
+ # Allow current root to be shared between invocations.
279
+ #
280
+ def _shared_configuration #:nodoc:
281
+ super.merge!(:destination_root => self.destination_root)
282
+ end
283
+
284
+ def _cleanup_options_and_set(options, key) #:nodoc:
285
+ case options
286
+ when Array
287
+ %w(--force -f --skip -s).each { |i| options.delete(i) }
288
+ options << "--#{key}"
289
+ when Hash
290
+ [:force, :skip, "force", "skip"].each { |i| options.delete(i) }
291
+ options.merge!(key => true)
292
+ end
293
+ end
294
+
295
+ end
296
+ end
@@ -0,0 +1,540 @@
1
+ require 'thor/core_ext/hash_with_indifferent_access'
2
+ require 'thor/core_ext/ordered_hash'
3
+ require 'thor/error'
4
+ require 'thor/shell'
5
+ require 'thor/invocation'
6
+ require 'thor/parser'
7
+ require 'thor/task'
8
+ require 'thor/util'
9
+
10
+ class Thor
11
+ autoload :Actions, 'thor/actions'
12
+ autoload :RakeCompat, 'thor/rake_compat'
13
+
14
+ # Shortcuts for help.
15
+ HELP_MAPPINGS = %w(-h -? --help -D)
16
+
17
+ # Thor methods that should not be overwritten by the user.
18
+ THOR_RESERVED_WORDS = %w(invoke shell options behavior root destination_root relative_root
19
+ action add_file create_file in_root inside run run_ruby_script)
20
+
21
+ module Base
22
+ attr_accessor :options
23
+
24
+ # It receives arguments in an Array and two hashes, one for options and
25
+ # other for configuration.
26
+ #
27
+ # Notice that it does not check if all required arguments were supplied.
28
+ # It should be done by the parser.
29
+ #
30
+ # ==== Parameters
31
+ # args<Array[Object]>:: An array of objects. The objects are applied to their
32
+ # respective accessors declared with <tt>argument</tt>.
33
+ #
34
+ # options<Hash>:: An options hash that will be available as self.options.
35
+ # The hash given is converted to a hash with indifferent
36
+ # access, magic predicates (options.skip?) and then frozen.
37
+ #
38
+ # config<Hash>:: Configuration for this Thor class.
39
+ #
40
+ def initialize(args=[], options={}, config={})
41
+ args = Thor::Arguments.parse(self.class.arguments, args)
42
+ args.each { |key, value| send("#{key}=", value) }
43
+
44
+ parse_options = self.class.class_options
45
+
46
+ if options.is_a?(Array)
47
+ task_options = config.delete(:task_options) # hook for start
48
+ parse_options = parse_options.merge(task_options) if task_options
49
+ array_options, hash_options = options, {}
50
+ else
51
+ array_options, hash_options = [], options
52
+ end
53
+
54
+ opts = Thor::Options.new(parse_options, hash_options)
55
+ self.options = opts.parse(array_options)
56
+ opts.check_unknown! if self.class.check_unknown_options?
57
+ end
58
+
59
+ class << self
60
+ def included(base) #:nodoc:
61
+ base.send :extend, ClassMethods
62
+ base.send :include, Invocation
63
+ base.send :include, Shell
64
+ end
65
+
66
+ # Returns the classes that inherits from Thor or Thor::Group.
67
+ #
68
+ # ==== Returns
69
+ # Array[Class]
70
+ #
71
+ def subclasses
72
+ @subclasses ||= []
73
+ end
74
+
75
+ # Returns the files where the subclasses are kept.
76
+ #
77
+ # ==== Returns
78
+ # Hash[path<String> => Class]
79
+ #
80
+ def subclass_files
81
+ @subclass_files ||= Hash.new{ |h,k| h[k] = [] }
82
+ end
83
+
84
+ # Whenever a class inherits from Thor or Thor::Group, we should track the
85
+ # class and the file on Thor::Base. This is the method responsable for it.
86
+ #
87
+ def register_klass_file(klass) #:nodoc:
88
+ file = caller[1].match(/(.*):\d+/)[1]
89
+ Thor::Base.subclasses << klass unless Thor::Base.subclasses.include?(klass)
90
+
91
+ file_subclasses = Thor::Base.subclass_files[File.expand_path(file)]
92
+ file_subclasses << klass unless file_subclasses.include?(klass)
93
+ end
94
+ end
95
+
96
+ module ClassMethods
97
+ attr_accessor :debugging
98
+
99
+ def attr_reader(*) #:nodoc:
100
+ no_tasks { super }
101
+ end
102
+
103
+ def attr_writer(*) #:nodoc:
104
+ no_tasks { super }
105
+ end
106
+
107
+ def attr_accessor(*) #:nodoc:
108
+ no_tasks { super }
109
+ end
110
+
111
+ # If you want to raise an error for unknown options, call check_unknown_options!
112
+ # This is disabled by default to allow dynamic invocations.
113
+ def check_unknown_options!
114
+ @check_unknown_options = true
115
+ end
116
+
117
+ def check_unknown_options? #:nodoc:
118
+ @check_unknown_options || false
119
+ end
120
+
121
+ # Adds an argument to the class and creates an attr_accessor for it.
122
+ #
123
+ # Arguments are different from options in several aspects. The first one
124
+ # is how they are parsed from the command line, arguments are retrieved
125
+ # from position:
126
+ #
127
+ # thor task NAME
128
+ #
129
+ # Instead of:
130
+ #
131
+ # thor task --name=NAME
132
+ #
133
+ # Besides, arguments are used inside your code as an accessor (self.argument),
134
+ # while options are all kept in a hash (self.options).
135
+ #
136
+ # Finally, arguments cannot have type :default or :boolean but can be
137
+ # optional (supplying :optional => :true or :required => false), although
138
+ # you cannot have a required argument after a non-required argument. If you
139
+ # try it, an error is raised.
140
+ #
141
+ # ==== Parameters
142
+ # name<Symbol>:: The name of the argument.
143
+ # options<Hash>:: Described below.
144
+ #
145
+ # ==== Options
146
+ # :desc - Description for the argument.
147
+ # :required - If the argument is required or not.
148
+ # :optional - If the argument is optional or not.
149
+ # :type - The type of the argument, can be :string, :hash, :array, :numeric.
150
+ # :default - Default value for this argument. It cannot be required and have default values.
151
+ # :banner - String to show on usage notes.
152
+ #
153
+ # ==== Errors
154
+ # ArgumentError:: Raised if you supply a required argument after a non required one.
155
+ #
156
+ def argument(name, options={})
157
+ is_thor_reserved_word?(name, :argument)
158
+ no_tasks { attr_accessor name }
159
+
160
+ required = if options.key?(:optional)
161
+ !options[:optional]
162
+ elsif options.key?(:required)
163
+ options[:required]
164
+ else
165
+ options[:default].nil?
166
+ end
167
+
168
+ remove_argument name
169
+
170
+ arguments.each do |argument|
171
+ next if argument.required?
172
+ raise ArgumentError, "You cannot have #{name.to_s.inspect} as required argument after " <<
173
+ "the non-required argument #{argument.human_name.inspect}."
174
+ end if required
175
+
176
+ arguments << Thor::Argument.new(name, options[:desc], required, options[:type],
177
+ options[:default], options[:banner])
178
+ end
179
+
180
+ # Returns this class arguments, looking up in the ancestors chain.
181
+ #
182
+ # ==== Returns
183
+ # Array[Thor::Argument]
184
+ #
185
+ def arguments
186
+ @arguments ||= from_superclass(:arguments, [])
187
+ end
188
+
189
+ # Adds a bunch of options to the set of class options.
190
+ #
191
+ # class_options :foo => false, :bar => :required, :baz => :string
192
+ #
193
+ # If you prefer more detailed declaration, check class_option.
194
+ #
195
+ # ==== Parameters
196
+ # Hash[Symbol => Object]
197
+ #
198
+ def class_options(options=nil)
199
+ @class_options ||= from_superclass(:class_options, {})
200
+ build_options(options, @class_options) if options
201
+ @class_options
202
+ end
203
+
204
+ # Adds an option to the set of class options
205
+ #
206
+ # ==== Parameters
207
+ # name<Symbol>:: The name of the argument.
208
+ # options<Hash>:: Described below.
209
+ #
210
+ # ==== Options
211
+ # :desc - Description for the argument.
212
+ # :required - If the argument is required or not.
213
+ # :default - Default value for this argument.
214
+ # :group - The group for this options. Use by class options to output options in different levels.
215
+ # :aliases - Aliases for this option.
216
+ # :type - The type of the argument, can be :string, :hash, :array, :numeric or :boolean.
217
+ # :banner - String to show on usage notes.
218
+ #
219
+ def class_option(name, options={})
220
+ build_option(name, options, class_options)
221
+ end
222
+
223
+ # Removes a previous defined argument. If :undefine is given, undefine
224
+ # accessors as well.
225
+ #
226
+ # ==== Paremeters
227
+ # names<Array>:: Arguments to be removed
228
+ #
229
+ # ==== Examples
230
+ #
231
+ # remove_argument :foo
232
+ # remove_argument :foo, :bar, :baz, :undefine => true
233
+ #
234
+ def remove_argument(*names)
235
+ options = names.last.is_a?(Hash) ? names.pop : {}
236
+
237
+ names.each do |name|
238
+ arguments.delete_if { |a| a.name == name.to_s }
239
+ undef_method name, "#{name}=" if options[:undefine]
240
+ end
241
+ end
242
+
243
+ # Removes a previous defined class option.
244
+ #
245
+ # ==== Paremeters
246
+ # names<Array>:: Class options to be removed
247
+ #
248
+ # ==== Examples
249
+ #
250
+ # remove_class_option :foo
251
+ # remove_class_option :foo, :bar, :baz
252
+ #
253
+ def remove_class_option(*names)
254
+ names.each do |name|
255
+ class_options.delete(name)
256
+ end
257
+ end
258
+
259
+ # Defines the group. This is used when thor list is invoked so you can specify
260
+ # that only tasks from a pre-defined group will be shown. Defaults to standard.
261
+ #
262
+ # ==== Parameters
263
+ # name<String|Symbol>
264
+ #
265
+ def group(name=nil)
266
+ case name
267
+ when nil
268
+ @group ||= from_superclass(:group, 'standard')
269
+ else
270
+ @group = name.to_s
271
+ end
272
+ end
273
+
274
+ # Returns the tasks for this Thor class.
275
+ #
276
+ # ==== Returns
277
+ # OrderedHash:: An ordered hash with tasks names as keys and Thor::Task
278
+ # objects as values.
279
+ #
280
+ def tasks
281
+ @tasks ||= Thor::CoreExt::OrderedHash.new
282
+ end
283
+
284
+ # Returns the tasks for this Thor class and all subclasses.
285
+ #
286
+ # ==== Returns
287
+ # OrderedHash:: An ordered hash with tasks names as keys and Thor::Task
288
+ # objects as values.
289
+ #
290
+ def all_tasks
291
+ @all_tasks ||= from_superclass(:all_tasks, Thor::CoreExt::OrderedHash.new)
292
+ @all_tasks.merge(tasks)
293
+ end
294
+
295
+ # Removes a given task from this Thor class. This is usually done if you
296
+ # are inheriting from another class and don't want it to be available
297
+ # anymore.
298
+ #
299
+ # By default it only remove the mapping to the task. But you can supply
300
+ # :undefine => true to undefine the method from the class as well.
301
+ #
302
+ # ==== Parameters
303
+ # name<Symbol|String>:: The name of the task to be removed
304
+ # options<Hash>:: You can give :undefine => true if you want tasks the method
305
+ # to be undefined from the class as well.
306
+ #
307
+ def remove_task(*names)
308
+ options = names.last.is_a?(Hash) ? names.pop : {}
309
+
310
+ names.each do |name|
311
+ tasks.delete(name.to_s)
312
+ all_tasks.delete(name.to_s)
313
+ undef_method name if options[:undefine]
314
+ end
315
+ end
316
+
317
+ # All methods defined inside the given block are not added as tasks.
318
+ #
319
+ # So you can do:
320
+ #
321
+ # class MyScript < Thor
322
+ # no_tasks do
323
+ # def this_is_not_a_task
324
+ # end
325
+ # end
326
+ # end
327
+ #
328
+ # You can also add the method and remove it from the task list:
329
+ #
330
+ # class MyScript < Thor
331
+ # def this_is_not_a_task
332
+ # end
333
+ # remove_task :this_is_not_a_task
334
+ # end
335
+ #
336
+ def no_tasks
337
+ @no_tasks = true
338
+ yield
339
+ @no_tasks = false
340
+ end
341
+
342
+ # Sets the namespace for the Thor or Thor::Group class. By default the
343
+ # namespace is retrieved from the class name. If your Thor class is named
344
+ # Scripts::MyScript, the help method, for example, will be called as:
345
+ #
346
+ # thor scripts:my_script -h
347
+ #
348
+ # If you change the namespace:
349
+ #
350
+ # namespace :my_scripts
351
+ #
352
+ # You change how your tasks are invoked:
353
+ #
354
+ # thor my_scripts -h
355
+ #
356
+ # Finally, if you change your namespace to default:
357
+ #
358
+ # namespace :default
359
+ #
360
+ # Your tasks can be invoked with a shortcut. Instead of:
361
+ #
362
+ # thor :my_task
363
+ #
364
+ def namespace(name=nil)
365
+ case name
366
+ when nil
367
+ @namespace ||= Thor::Util.namespace_from_thor_class(self)
368
+ else
369
+ @namespace = name.to_s
370
+ end
371
+ end
372
+
373
+ # Default way to start generators from the command line.
374
+ #
375
+ def start(given_args=ARGV, config={})
376
+ self.debugging = given_args.include?("--debug")
377
+ config[:shell] ||= Thor::Base.shell.new
378
+ yield(given_args.dup)
379
+ rescue Thor::Error => e
380
+ debugging ? (raise e) : config[:shell].error(e.message)
381
+ exit(1) if exit_on_failure?
382
+ end
383
+
384
+ def handle_no_task_error(task) #:nodoc:
385
+ if self.banner_base == "thor"
386
+ raise UndefinedTaskError, "Could not find task #{task.inspect} in #{namespace.inspect} namespace."
387
+ else
388
+ raise UndefinedTaskError, "Could not find task #{task.inspect}."
389
+ end
390
+ end
391
+
392
+ protected
393
+
394
+ # Prints the class options per group. If an option does not belong to
395
+ # any group, it's printed as Class option.
396
+ #
397
+ def class_options_help(shell, groups={}) #:nodoc:
398
+ # Group options by group
399
+ class_options.each do |_, value|
400
+ groups[value.group] ||= []
401
+ groups[value.group] << value
402
+ end
403
+
404
+ # Deal with default group
405
+ global_options = groups.delete(nil) || []
406
+ print_options(shell, global_options)
407
+
408
+ # Print all others
409
+ groups.each do |group_name, options|
410
+ print_options(shell, options, group_name)
411
+ end
412
+ end
413
+
414
+ # Receives a set of options and print them.
415
+ def print_options(shell, options, group_name=nil)
416
+ return if options.empty?
417
+
418
+ list = []
419
+ padding = options.collect{ |o| o.aliases.size }.max.to_i * 4
420
+
421
+ options.each do |option|
422
+ item = [ option.usage(padding) ]
423
+ item.push(option.description ? "# #{option.description}" : "")
424
+
425
+ list << item
426
+ list << [ "", "# Default: #{option.default}" ] if option.show_default?
427
+ end
428
+
429
+ shell.say(group_name ? "#{group_name} options:" : "Options:")
430
+ shell.print_table(list, :ident => 2)
431
+ shell.say ""
432
+ end
433
+
434
+ # Raises an error if the word given is a Thor reserved word.
435
+ def is_thor_reserved_word?(word, type) #:nodoc:
436
+ return false unless THOR_RESERVED_WORDS.include?(word.to_s)
437
+ raise "#{word.inspect} is a Thor reserved word and cannot be defined as #{type}"
438
+ end
439
+
440
+ # Build an option and adds it to the given scope.
441
+ #
442
+ # ==== Parameters
443
+ # name<Symbol>:: The name of the argument.
444
+ # options<Hash>:: Described in both class_option and method_option.
445
+ def build_option(name, options, scope) #:nodoc:
446
+ scope[name] = Thor::Option.new(name, options[:desc], options[:required],
447
+ options[:type], options[:default], options[:banner],
448
+ options[:group], options[:aliases])
449
+ end
450
+
451
+ # Receives a hash of options, parse them and add to the scope. This is a
452
+ # fast way to set a bunch of options:
453
+ #
454
+ # build_options :foo => true, :bar => :required, :baz => :string
455
+ #
456
+ # ==== Parameters
457
+ # Hash[Symbol => Object]
458
+ def build_options(options, scope) #:nodoc:
459
+ options.each do |key, value|
460
+ scope[key] = Thor::Option.parse(key, value)
461
+ end
462
+ end
463
+
464
+ # Finds a task with the given name. If the task belongs to the current
465
+ # class, just return it, otherwise dup it and add the fresh copy to the
466
+ # current task hash.
467
+ def find_and_refresh_task(name) #:nodoc:
468
+ task = if task = tasks[name.to_s]
469
+ task
470
+ elsif task = all_tasks[name.to_s]
471
+ tasks[name.to_s] = task.clone
472
+ else
473
+ raise ArgumentError, "You supplied :for => #{name.inspect}, but the task #{name.inspect} could not be found."
474
+ end
475
+ end
476
+
477
+ # Everytime someone inherits from a Thor class, register the klass
478
+ # and file into baseclass.
479
+ def inherited(klass)
480
+ Thor::Base.register_klass_file(klass)
481
+ end
482
+
483
+ # Fire this callback whenever a method is added. Added methods are
484
+ # tracked as tasks by invoking the create_task method.
485
+ def method_added(meth)
486
+ meth = meth.to_s
487
+
488
+ if meth == "initialize"
489
+ initialize_added
490
+ return
491
+ end
492
+
493
+ # Return if it's not a public instance method
494
+ return unless public_instance_methods.include?(meth) ||
495
+ public_instance_methods.include?(meth.to_sym)
496
+
497
+ return if @no_tasks || !create_task(meth)
498
+
499
+ is_thor_reserved_word?(meth, :task)
500
+ Thor::Base.register_klass_file(self)
501
+ end
502
+
503
+ # Retrieves a value from superclass. If it reaches the baseclass,
504
+ # returns default.
505
+ def from_superclass(method, default=nil)
506
+ if self == baseclass || !superclass.respond_to?(method, true)
507
+ default
508
+ else
509
+ value = superclass.send(method)
510
+ value.dup if value
511
+ end
512
+ end
513
+
514
+ # A flag that makes the process exit with status 1 if any error happens.
515
+ def exit_on_failure?
516
+ false
517
+ end
518
+
519
+ # Returns the base for banner.
520
+ def banner_base
521
+ @banner_base ||= $thor_runner ? "thor" : File.basename($0.split(" ").first)
522
+ end
523
+
524
+ # SIGNATURE: Sets the baseclass. This is where the superclass lookup
525
+ # finishes.
526
+ def baseclass #:nodoc:
527
+ end
528
+
529
+ # SIGNATURE: Creates a new task if valid_task? is true. This method is
530
+ # called when a new method is added to the class.
531
+ def create_task(meth) #:nodoc:
532
+ end
533
+
534
+ # SIGNATURE: Defines behavior when the initialize method is added to the
535
+ # class.
536
+ def initialize_added #:nodoc:
537
+ end
538
+ end
539
+ end
540
+ end