class Cucumber::Configuration
The base class for configuring settings for a Cucumber run.
def self.default
def self.default new end
def all_files_to_load
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
def autoload_code_paths
def autoload_code_paths @options[:autoload_code_paths] end
def default_features_paths
def default_features_paths ["features"] end
def default_options
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 => Event::Bus.new(Event::NameResolver.new(Cucumber::Events)) } end
def dry_run?
def dry_run? @options[:dry_run] end
def error_stream
def error_stream @options[:error_stream] end
def event_bus
def event_bus @options[:event_bus] end
def expand?
def expand? @options[:expand] end
def fail_fast?
def fail_fast? @options[:fail_fast] end
def feature_dirs
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
def feature_files
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
def filters
def filters @options[:filters] end
def formats
def formats @options[:formats] end
def formatter_class(format)
def formatter_class(format) if(builtin = Cli::Options::BUILTIN_FORMATS[format]) constantize(builtin[0]) else constantize(format) end end
def formatter_factories
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
def guess?
def guess? @options[:guess] end
def initialize(user_options = {})
def initialize(user_options = {}) @options = default_options.merge(Cucumber::Hash(user_options)) end
def name_regexps
def name_regexps @options[:name_regexps] end
def options
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
def out_stream
def out_stream @options[:out_stream] end
def paths
def paths @options[:paths] end
def randomize?
def randomize? @options[:order] == 'random' end
def register_snippet_generator(generator)
def register_snippet_generator(generator) snippet_generators << generator self end
def remove_excluded_files_from(files)
def remove_excluded_files_from(files) files.reject! {|path| @options[:excludes].detect {|pattern| path =~ pattern } } end
def require_dirs
def require_dirs if @options[:require].empty? default_features_paths + Dir['vendor/{gems,plugins}/*/cucumber'] else @options[:require] end end
def seed
def seed Integer(@options[:seed] || rand(0xFFFF)) end
def snippet_generators
- snippet type
- multiline argument
- step text
- keyword
Each proc should take the following arguments:
formatter wants to display snippets to the user.
An array of procs that can generate snippets for undefined steps. These procs may be called if a
def snippet_generators @options[:snippet_generators] ||= [] end
def snippet_type
def snippet_type @options[:snippet_type] end
def step_defs_to_load
def step_defs_to_load all_files_to_load.reject {|f| f =~ %r{/support/} } end
def strict?
def strict? @options[:strict] end
def support_to_load
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
def tag_expression
def tag_expression Cucumber::Core::Gherkin::TagExpression.new(@options[:tag_expressions]) end
def tag_expressions
def tag_expressions @options[:tag_expressions] end
def tag_limits
def tag_limits tag_expression.limits.to_hash end
def to_hash
def to_hash @options end
def wip?
def wip? @options[:wip] end
def with_default_features_path(paths)
def with_default_features_path(paths) return default_features_paths if paths.empty? paths end
def with_options(new_options)
def with_options(new_options) self.class.new(@options.merge(new_options)) end