The base class for configuring settings for a Cucumber run.
# File lib/cucumber/configuration.rb, line 13 def self.default new end
# File lib/cucumber/configuration.rb, line 30 def initialize(user_options = {}) @options = default_options.merge(Cucumber::Hash(user_options)) end
# File lib/cucumber/configuration.rb, line 157 def all_files_to_load files = require_dirs.map do |path| path = path.gsub(/\/, '/') # In case we're on windows. Globs don't work with backslashes. path = path.gsub(/\/$/, '') # Strip trailing slash. File.directory?(path) ? Dir["#{path}/**/*"] : path end.flatten.uniq remove_excluded_files_from(files) files.reject! {|f| !File.file?(f)} files.reject! {|f| File.extname(f) == '.feature' } files.reject! {|f| f =~ /^http/} files.sort end
# File lib/cucumber/configuration.rb, line 96 def autoload_code_paths @options[:autoload_code_paths] end
# File lib/cucumber/configuration.rb, line 60 def dry_run? @options[:dry_run] end
# File lib/cucumber/configuration.rb, line 48 def error_stream @options[:error_stream] end
# File lib/cucumber/configuration.rb, line 84 def expand? @options[:expand] end
# File lib/cucumber/configuration.rb, line 64 def fail_fast? @options[:fail_fast] end
# File lib/cucumber/configuration.rb, line 104 def feature_dirs dirs = paths.map { |f| File.directory?(f) ? f : File.dirname(f) }.uniq dirs.delete('.') unless paths.include?('.') with_default_features_path(dirs) end
# File lib/cucumber/configuration.rb, line 131 def feature_files potential_feature_files = with_default_features_path(paths).map do |path| path = path.gsub(/\/, '/') # In case we're on windows. Globs don't work with backslashes. path = path.chomp('/') # TODO: Move to using feature loading strategies stored in # options[:feature_loaders] if File.directory?(path) Dir["#{path}/**/*.feature"].sort elsif Cli::RerunFile.can_read?(path) Cli::RerunFile.new(path).features else path end end.flatten.uniq remove_excluded_files_from(potential_feature_files) potential_feature_files end
# File lib/cucumber/configuration.rb, line 127 def filters @options[:filters] end
# File lib/cucumber/configuration.rb, line 92 def formats @options[:formats] end
# File lib/cucumber/configuration.rb, line 188 def formatter_class(format) if(builtin = Cli::Options::BUILTIN_FORMATS[format]) constantize(builtin[0]) else constantize(format) end end
# File lib/cucumber/configuration.rb, line 174 def formatter_factories @options[:formats].map do |format_and_out| format = format_and_out[0] path_or_io = format_and_out[1] begin factory = formatter_class(format) yield factory, path_or_io, Cli::Options.new(STDOUT, STDERR, @options) rescue Exception => e e.message << "\nError creating formatter: #{format}" raise e end end end
# File lib/cucumber/configuration.rb, line 72 def guess? @options[:guess] end
# File lib/cucumber/configuration.rb, line 123 def name_regexps @options[:name_regexps] end
TODO: Actually Deprecate???
# File lib/cucumber/configuration.rb, line 39 def options warn("Deprecated: Configuration#options will be removed from the next release of Cucumber. Please use the configuration object directly instead.") Marshal.load(Marhal.dump(@options)) end
# File lib/cucumber/configuration.rb, line 44 def out_stream @options[:out_stream] end
# File lib/cucumber/configuration.rb, line 88 def paths @options[:paths] end
# File lib/cucumber/configuration.rb, line 52 def randomize? @options[:order] == 'random' end
# File lib/cucumber/configuration.rb, line 214 def register_snippet_generator(generator) snippet_generators << generator self end
# File lib/cucumber/configuration.rb, line 68 def retry_attempts @options[:retry] end
# File lib/cucumber/configuration.rb, line 56 def seed Integer(@options[:seed] || rand(0xFFFF)) end
An array of procs that can generate snippets for undefined steps. These procs may be called if a formatter wants to display snippets to the user.
Each proc should take the following arguments:
- keyword - step text - multiline argument - snippet type
# File lib/cucumber/configuration.rb, line 210 def snippet_generators @options[:snippet_generators] ||= [] end
# File lib/cucumber/configuration.rb, line 100 def snippet_type @options[:snippet_type] end
# File lib/cucumber/configuration.rb, line 170 def step_defs_to_load all_files_to_load.reject {|f| f =~ %r{/support/} } end
# File lib/cucumber/configuration.rb, line 76 def strict? @options[:strict] end
# File lib/cucumber/configuration.rb, line 150 def support_to_load support_files = all_files_to_load.select {|f| f =~ %r{/support/} } env_files = support_files.select {|f| f =~ %r{/support/env\..*} } other_files = support_files - env_files @options[:dry_run] ? other_files : env_files + other_files end
todo: remove
# File lib/cucumber/configuration.rb, line 111 def tag_expression Cucumber::Core::Gherkin::TagExpression.new(@options[:tag_expressions]) end
# File lib/cucumber/configuration.rb, line 119 def tag_expressions @options[:tag_expressions] end
# File lib/cucumber/configuration.rb, line 115 def tag_limits tag_expression.limits.to_hash end
# File lib/cucumber/configuration.rb, line 196 def to_hash @options end
# File lib/cucumber/configuration.rb, line 80 def wip? @options[:wip] end
# File lib/cucumber/configuration.rb, line 34 def with_options(new_options) self.class.new(@options.merge(new_options)) end
# File lib/cucumber/configuration.rb, line 247 def default_features_paths ["features"] end
# File lib/cucumber/configuration.rb, line 221 def default_options { :autoload_code_paths => ['features/support', 'features/step_definitions'], :filters => [], :strict => false, :require => [], :dry_run => false, :fail_fast => false, :formats => [], :excludes => [], :tag_expressions => [], :name_regexps => [], :env_vars => {}, :diff_enabled => true, :snippets => true, :source => true, :duration => true, :event_bus => Events::Bus.new(Cucumber::Events) } end
# File lib/cucumber/configuration.rb, line 242 def event_bus @options[:event_bus] end
# File lib/cucumber/configuration.rb, line 256 def remove_excluded_files_from(files) files.reject! {|path| @options[:excludes].detect {|pattern| path =~ pattern } } end
# File lib/cucumber/configuration.rb, line 260 def require_dirs if @options[:require].empty? default_features_paths + Dir['vendor/{gems,plugins}/*/cucumber'] else @options[:require] end end
# File lib/cucumber/configuration.rb, line 251 def with_default_features_path(paths) return default_features_paths if paths.empty? paths end