random_outcome 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ec01216c257498d7ec663d0cb3bb99868723eb17
+  data.tar.gz: 4ba6c9d3626524b12af29344d17194fce7943344
+SHA512:
+  metadata.gz: 483bc08406ad70ce1d7ff93a2d3fb793ae3259977bfc2f03fc71e46122787543b5fbc8a748491013ab65cf9a6702edaba5b2841f2af33405ad0b561b39e4d706
+  data.tar.gz: 374f8fb4809a969595ca9f9552a5e0d7259d575eb4c159458eeaa54f429ab96c6428446979c1fa8425fa64fd8bce9401302e5c2e310a3e7c0a00a5861a7b9dab

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/.rvmrc

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+
+# This is an RVM Project .rvmrc file, used to automatically load the ruby
+# development environment upon cd'ing into the directory
+
+# First we specify our desired <ruby>[@<gemset>], the @gemset name is optional,
+# Only full ruby name is supported here, for short names use:
+#     echo "rvm use 2.0.0" > .rvmrc
+environment_id="ruby-2.0.0-p247@random_outcome"
+
+# Uncomment the following lines if you want to verify rvm version per project
+# rvmrc_rvm_version="1.22.14 (stable)" # 1.10.1 seems like a safe start
+# eval "$(echo ${rvm_version}.${rvmrc_rvm_version} | __rvm_awk -F. '{print "[[ "$1*65536+$2*256+$3" -ge "$4*65536+$5*256+$6" ]]"}' )" || {
+#   echo "This .rvmrc file requires at least RVM ${rvmrc_rvm_version}, aborting loading."
+#   return 1
+# }
+
+# First we attempt to load the desired environment directly from the environment
+# file. This is very fast and efficient compared to running through the entire
+# CLI and selector. If you want feedback on which environment was used then
+# insert the word 'use' after --create as this triggers verbose mode.
+if [[ -d "${rvm_path:-$HOME/.rvm}/environments"
+  && -s "${rvm_path:-$HOME/.rvm}/environments/$environment_id" ]]
+then
+  \. "${rvm_path:-$HOME/.rvm}/environments/$environment_id"
+  for __hook in "${rvm_path:-$HOME/.rvm}/hooks/after_use"*
+  do
+    if [[ -f "${__hook}" && -x "${__hook}" && -s "${__hook}" ]]
+    then \. "${__hook}" || true
+    fi
+  done
+  unset __hook
+  if (( ${rvm_use_flag:=1} >= 2 )) # display only when forced
+  then
+    if [[ $- == *i* ]] # check for interactive shells
+    then printf "%b" "Using: $(tput setaf 2 2>/dev/null)$GEM_HOME$(tput sgr0 2>/dev/null)
+" # show the user the ruby and gemset they are using in green
+    else printf "%b" "Using: $GEM_HOME
+" # don't use colors in non-interactive shells
+    fi
+  fi
+else
+  # If the environment file has not yet been created, use the RVM CLI to select.
+  rvm --create  "$environment_id" || {
+    echo "Failed to create RVM environment '${environment_id}'."
+    return 1
+  }
+fi
+
+# If you use bundler, this might be useful to you:
+# if [[ -s Gemfile ]] && {
+#   ! builtin command -v bundle >/dev/null ||
+#   builtin command -v bundle | GREP_OPTIONS="" \grep $rvm_path/bin/bundle >/dev/null
+# }
+# then
+#   printf "%b" "The rubygem 'bundler' is not installed. Installing it now.\n"
+#   gem install bundler
+# fi
+# if [[ -s Gemfile ]] && builtin command -v bundle >/dev/null
+# then
+#   bundle install | GREP_OPTIONS="" \grep -vE '^Using|Your bundle is complete'
+# fi

data/Gemfile

@@ -0,0 +1,16 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "rspec", "~> 2.8.0"
+  gem "yard", "~> 0.7"
+  gem "rdoc", "~> 3.12"
+  gem "bundler", "~> 1.0"
+  gem "jeweler", "~> 1.8.7"
+end
+
+gem "activesupport"

data/Gemfile.lock

@@ -0,0 +1,78 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (4.0.0)
+      i18n (~> 0.6, >= 0.6.4)
+      minitest (~> 4.2)
+      multi_json (~> 1.3)
+      thread_safe (~> 0.1)
+      tzinfo (~> 0.3.37)
+    addressable (2.3.5)
+    atomic (1.1.14)
+    builder (3.2.2)
+    diff-lcs (1.1.3)
+    faraday (0.8.8)
+      multipart-post (~> 1.2.0)
+    git (1.2.6)
+    github_api (0.10.1)
+      addressable
+      faraday (~> 0.8.1)
+      hashie (>= 1.2)
+      multi_json (~> 1.4)
+      nokogiri (~> 1.5.2)
+      oauth2
+    hashie (2.0.5)
+    highline (1.6.20)
+    httpauth (0.2.0)
+    i18n (0.6.5)
+    jeweler (1.8.8)
+      builder
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      github_api (= 0.10.1)
+      highline (>= 1.6.15)
+      nokogiri (= 1.5.10)
+      rake
+      rdoc
+    json (1.8.1)
+    jwt (0.1.8)
+      multi_json (>= 1.5)
+    minitest (4.7.5)
+    multi_json (1.8.2)
+    multi_xml (0.5.5)
+    multipart-post (1.2.0)
+    nokogiri (1.5.10)
+    oauth2 (0.9.2)
+      faraday (~> 0.8)
+      httpauth (~> 0.2)
+      jwt (~> 0.1.4)
+      multi_json (~> 1.0)
+      multi_xml (~> 0.5)
+      rack (~> 1.2)
+    rack (1.5.2)
+    rake (10.1.0)
+    rdoc (3.12.2)
+      json (~> 1.4)
+    rspec (2.8.0)
+      rspec-core (~> 2.8.0)
+      rspec-expectations (~> 2.8.0)
+      rspec-mocks (~> 2.8.0)
+    rspec-core (2.8.0)
+    rspec-expectations (2.8.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.8.0)
+    thread_safe (0.1.3)
+      atomic
+    tzinfo (0.3.38)
+    yard (0.8.7.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport
+  bundler (~> 1.0)
+  jeweler (~> 1.8.7)
+  rdoc (~> 3.12)
+  rspec (~> 2.8.0)
+  yard (~> 0.7)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Nigel Lowry
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,19 @@
+= random_outcome
+
+Description goes here.
+
+== Contributing to random_outcome
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2013 Nigel Lowry. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,42 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "random_outcome"
+  gem.homepage = "http://github.com/nigel-lowry/random_outcome"
+  gem.license = "MIT"
+  gem.summary = %Q{Small Ruby gem for generating outcomes with specified probabilities}
+  gem.description = %Q{Generates outcomes with specified probabilities which could be useful for gaming. Uses the wheel of fortune method.}
+  gem.email = "nigel-lowry@ultra.eclipse.co.uk"
+  gem.authors = ["Nigel Lowry"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/simulator.rb

@@ -0,0 +1,61 @@
+require 'active_support/all'
+
+# Generates outcomes with specified probabilities
+class Simulator
+
+  # creates a new Simulator which will return the desired outcomes with the given probability
+  # @param outcome_to_probability [Hash<Symbol, Number>] hash of outcomes to their probability (represented as
+  #   numbers between zero and one)
+  # @note raises errors if there is only one possible outcome (why bother using this if there's only one
+  #   outcome?), if the probabilities don't total one (use Rationals if this proves problematic with rounding) or
+  #   if any of the outcomes are impossible (why include them if they can never happen?)
+  def initialize outcome_to_probability
+    raise_if_only_have_one_outcome outcome_to_probability
+    raise_if_probabilities_total_isnt_one outcome_to_probability
+    raise_if_have_any_impossible_outcomes outcome_to_probability
+    raise_if_have_any_negative_probabilities outcome_to_probability
+    @probability_range_to_outcome = probability_range_to_outcome outcome_to_probability
+  end
+
+  # generate an outcome with the initialised probabilities
+  # @return [Symbol] symbol for outcome
+  def outcome
+    num = random_float_including_zero_and_excluding_one # don't inline
+    @probability_range_to_outcome.detect {|probability_range, _| num.in? probability_range }.last
+  end
+
+private
+
+  def raise_if_only_have_one_outcome outcome_to_probability
+    raise "only have one outcome" unless outcome_to_probability.many?
+  end
+
+  def raise_if_probabilities_total_isnt_one outcome_to_probability
+    raise "probabilities don't total one" unless outcome_to_probability.values.sum == 1.0
+  end
+
+  def raise_if_have_any_impossible_outcomes outcome_to_probability
+    raise "have an impossible outcome" if outcome_to_probability.has_value? 0.0
+  end
+
+  def raise_if_have_any_negative_probabilities outcome_to_probability
+    raise "have negative probability" if outcome_to_probability.values.any? {|probability| probability < 0.0 }
+  end
+
+  def random_float_including_zero_and_excluding_one
+    rand
+  end
+
+  def probability_range_to_outcome outcome_to_probability
+    range_to_outcome = {}
+    lower_bound = 0.0
+
+    outcome_to_probability.each do |outcome, probability|
+      upper_bound = lower_bound + probability
+      range_to_outcome.store lower_bound...upper_bound, outcome
+      lower_bound = upper_bound
+    end
+
+    range_to_outcome
+  end
+end

data/random_outcome.gemspec

@@ -0,0 +1,69 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+# stub: random_outcome 0.1.0 ruby lib
+
+Gem::Specification.new do |s|
+  s.name = "random_outcome"
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Nigel Lowry"]
+  s.date = "2013-10-27"
+  s.description = "Generates outcomes with specified probabilities which could be useful for gaming. Uses the wheel of fortune method."
+  s.email = "nigel-lowry@ultra.eclipse.co.uk"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    ".rvmrc",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "lib/simulator.rb",
+    "random_outcome.gemspec",
+    "spec/simulator_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/support/matchers/give_the_outcome.rb"
+  ]
+  s.homepage = "http://github.com/nigel-lowry/random_outcome"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "2.1.5"
+  s.summary = "Small Ruby gem for generating outcomes with specified probabilities"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activesupport>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.8.0"])
+      s.add_development_dependency(%q<yard>, ["~> 0.7"])
+      s.add_development_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.7"])
+    else
+      s.add_dependency(%q<activesupport>, [">= 0"])
+      s.add_dependency(%q<rspec>, ["~> 2.8.0"])
+      s.add_dependency(%q<yard>, ["~> 0.7"])
+      s.add_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_dependency(%q<bundler>, ["~> 1.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.7"])
+    end
+  else
+    s.add_dependency(%q<activesupport>, [">= 0"])
+    s.add_dependency(%q<rspec>, ["~> 2.8.0"])
+    s.add_dependency(%q<yard>, ["~> 0.7"])
+    s.add_dependency(%q<rdoc>, ["~> 3.12"])
+    s.add_dependency(%q<bundler>, ["~> 1.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.7"])
+  end
+end
+

data/spec/simulator_spec.rb

@@ -0,0 +1,81 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Simulator do
+
+  context "p(A) = 10%, p(B) = 90%" do
+    before :all do
+      @simulator = Simulator.new(A: 0.1, B: 0.9)
+    end
+
+    subject { @simulator }
+
+    it { should give_the_outcome(:A).with_the_probability(0.1) }
+    it { should give_the_outcome(:B).with_the_probability(0.9) }
+    it { should give_the_outcome(:C).with_the_probability(0.0) }
+  end
+
+  context "p(A) = 40%, p(B) = 60%" do
+    before :all do
+      @simulator = Simulator.new(A: 0.4, B: 0.6)
+    end
+
+    subject { @simulator }
+
+    it { should give_the_outcome(:A).with_the_probability(0.4) }
+    it { should give_the_outcome(:B).with_the_probability(0.6) }
+  end
+
+  context "p(A) = 10%, p(B) = 20%, p(C) = 70%" do
+    before :all do
+      @simulator = Simulator.new(A: 0.1, B: 0.2, C: 0.7)
+    end
+
+    subject { @simulator }
+
+    it { should give_the_outcome(:A).with_the_probability(0.1) }
+    it { should give_the_outcome(:B).with_the_probability(0.2) }
+    it { should give_the_outcome(:C).with_the_probability(0.7) }
+  end
+
+  context "with no outcomes" do
+    it "will raise error" do
+      expect { Simulator.new({}) }.to raise_error
+    end
+  end
+
+  context "with only one outcome" do
+    it "will raise error" do
+      expect { Simulator.new(A: 1.0) }.to raise_error
+    end
+  end
+
+  context "with any probabilities less than 0.0" do
+    it "will raise error" do
+      expect { Simulator.new(A: 0.9, B: 0.2, C: -0.1) }.to raise_error
+    end
+  end
+
+  context "with any probabilities greater than or equal to 1.0" do
+    it "will raise error" do
+      expect { Simulator.new(A: 1.1, B: 0.1, C: -0.2) }.to raise_error
+    end
+  end
+
+  context "with probabilities summing to less than 1.0" do
+    it "will raise error" do
+      expect { Simulator.new(A: 0.1, B: 0.89) }.to raise_error
+    end
+  end
+
+  context "with probabilities summing to more than 1.0" do
+    it "will raise error" do
+      expect { Simulator.new(A: 0.1, B: 0.91) }.to raise_error
+    end
+  end
+
+  context "with an impossible event" do
+    it "will raise error" do
+      expect { Simulator.new(A: 0.1, B: 0.9, C: 0.0) }.to raise_error
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'simulator'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  
+end

data/spec/support/matchers/give_the_outcome.rb

@@ -0,0 +1,28 @@
+RSpec::Matchers.define :give_the_outcome do |outcome|
+  match do |actual|
+    outcome_count = 0
+    trial_count = 100_000
+
+    trial_count.times do
+      outcome_count += 1 if actual.outcome == outcome
+    end
+
+    (outcome_count / trial_count.to_f).should be_within(0.01).of(@probability)
+  end
+
+  chain :with_the_probability do |probability|
+    @probability = probability
+  end
+
+  failure_message_for_should do |actual|
+    "expected that #{outcome} would occur with a probability of #{@probability}"
+  end
+
+  failure_message_for_should_not do |actual|
+    "expected that #{outcome} would not occur with a probability of #{@probability}"
+  end
+
+  description do
+    "occur with a probability of #{@probability}"
+  end
+end

metadata

@@ -0,0 +1,144 @@
+--- !ruby/object:Gem::Specification
+name: random_outcome
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nigel Lowry
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.8.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.8.0
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.7
+description: Generates outcomes with specified probabilities which could be useful
+  for gaming. Uses the wheel of fortune method.
+email: nigel-lowry@ultra.eclipse.co.uk
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .document
+- .rspec
+- .rvmrc
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/simulator.rb
+- random_outcome.gemspec
+- spec/simulator_spec.rb
+- spec/spec_helper.rb
+- spec/support/matchers/give_the_outcome.rb
+homepage: http://github.com/nigel-lowry/random_outcome
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.1.5
+signing_key: 
+specification_version: 4
+summary: Small Ruby gem for generating outcomes with specified probabilities
+test_files: []