tourets 0.1.0

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+.rvmrc
+.rspec
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in tourets.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Jeremy Woertink & Justin Mitchell
+
+MIT License
+
+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.md

@@ -0,0 +1,97 @@
+# TouRETS
+
+The name came from a play on Tourette's and RETS. Because when you work with RETS you feel like you have Tourette's. 
+The goal of this gem is to make a really clean and familiar API for connecting to a RETS server. This gem was designed to be used with rails, so it takes a lot of the API that rails uses.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'tourets', :github => 'jwoertink/tourets'
+
+Add a rets_config.yml to the config directory of your rails app
+
+```yaml
+-
+  mls: 'GLVAR'
+  url: 'http://las.rets.interealty.com/Login.asmx/Login'
+  username: 'user'
+  password: 'secret'
+  rets_version: '1.8'
+  auth_mode: :digest
+  useragent:
+    name: 'some_user_connector'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install tourets
+
+## Usage
+(since this is still new, this usage may change often)
+
+```ruby
+begin
+	TouRETS.establish_connection('GLVAR')
+	# Get a list of properties with 3 bedrooms and 2 bathrooms
+	@properties = TouRETS::Property.where(:bedrooms => 3, :bathrooms => 2)
+	# Grab all the photos for the first property
+	@photos = @properties.first.photos
+	# Iterate through all those photos, save them into tempfiles, and then do stuff?
+	@photos.each do |photo|
+		begin
+			tmp = Tempfile.new(photo.filename)
+			tmp.write(photo.image)
+			# you have an actual photo now. Maybe push to S3?
+		ensure
+			tmp.close
+			tmp.unlink
+		end
+	end
+ensure
+	TouRETS.close_connection
+end
+```
+
+Before doing anything, you must make your first initial connection to your MLS server.
+```ruby
+if TouRETS.current_connection?
+	# Get the sysid for the last property in that instance array
+	property_id = @properties.last.id
+	puts property_id 					#=> 1234567
+	# Grab the second picture for that property
+	picture = TouRETS::Photo.find(property_id, :id => 2)
+	puts picture.content_type	#=> image/jpeg
+	puts picture.filename 		#=> 1234567-2.jpg
+	puts picture.id 					#=> 2
+	# This returns the binary string data that gets written to a file
+	puts picture.image.class	#=> String
+end
+```
+
+## ruby-rets
+This gem relies heavily on the work done by Zachary Anker (zanker) with the [ruby-rets](https://github.com/Placester/ruby-rets) gem.
+There is a `TouRETS::Search#find` class which just makes a direct call to the `RETS::Base::Core#search`. This gives you the option to still use
+that gem inside of this one.
+
+## TODO (in no particular order)
+1. Add in other Objects like VRImage, Thumbnail, Map, Video, Audio
+2. Add in other Resources like Agent, Office, LotsAndLand
+3. CLEAN CODE!!!!!
+4. Add in limits, and selects to searches
+5. TEST TEST TEST TEST
+6. Add some passing specs.
+7. Document the hell out of this thing
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/lib/tourets.rb

@@ -0,0 +1,61 @@
+require 'ruby-rets'
+require 'tourets/rails'
+require 'tourets/utilities'
+require 'tourets/exceptions'
+require 'tourets/extensions/hash' # This should go away after Rails 4.0
+require 'tourets/search'
+require 'tourets/photo'
+require 'tourets/property'
+
+module TouRETS
+  include Utilities
+  
+  class << self
+    attr_accessor :current_connection
+    
+    # This will take the specific MLS you want to connect to
+    # There must be a rets_config.yml file in the :rails_root/config directory
+    # 
+    def establish_connection(mls) 
+      config_file = File.join(app_root, 'config', 'rets_config.yml')
+      if File.exists?(config_file)
+        connections = YAML.load_file(config_file)
+        conn = connections.select { |conn| conn['mls'] == mls }.first
+        if conn.nil?
+          raise ConfigurationError, "Missing or incorrect MLS key `#{mls}`."
+        else
+          conn.recursive_symbolize_keys!
+          conn.delete(:mls)
+          self.current_connection = RETS::Client.login(conn)
+        end
+      else
+        raise ConfigurationError, "Couldn't find Config File in #{config_file}."
+      end
+    end
+    
+    # Closes the current connection to the RETS server
+    def close_connection
+      current_connection.logout if current_connection?
+      current_connection = nil
+    end
+    
+    def ensure_connected!
+      raise ConnectionError, "You must establish a connection first." unless current_connection?
+    end
+    
+    def current_connection?
+      !current_connection.nil?
+    end
+    
+    # The root of the application using this gem
+    def app_root
+      if defined?(Rails)
+        ::Rails.root
+      else
+        Dir.pwd
+      end
+    end
+    
+  end
+  
+end

data/lib/tourets/exceptions.rb

@@ -0,0 +1,7 @@
+module TouRETS
+  
+  class ConfigurationError < StandardError; end
+  
+  class ConnectionError < StandardError; end
+  
+end

data/lib/tourets/extensions/hash.rb

@@ -0,0 +1,20 @@
+# This is only a temporary fix until it's patched in Rails
+class Hash
+  
+  def recursive_symbolize_keys!
+    symbolize_keys!
+    
+    values.each{|h| h.recursive_symbolize_keys! if h.is_a?(Hash)}
+    values.select{|v| v.is_a?(Array)}.flatten.each{|h| h.recursive_symbolize_keys! if h.is_a?(Hash)}
+    self
+  end
+  
+  #In case for some reason this isn't picked up from Rails
+  def symbolize_keys!
+    keys.each do |key|
+      self[(key.to_sym rescue key) || key] = delete(key)
+    end
+    self
+  end
+  
+end

data/lib/tourets/photo.rb

@@ -0,0 +1,53 @@
+module TouRETS
+  class Photo
+    
+    class << self
+      
+      # Find the photo 
+      # Use find("1234", :id => 1) to find the photo with ID 1 in the 1234 group
+      # Default it to return all of the photos.
+      def find(sysid, opts={})
+        limit = opts[:id] || "*"
+        [].tap do |photos|
+          TouRETS.current_connection.get_object(:resource => opts[:resource], :type => :Photo, :location => false, :id => "#{sysid}:#{limit}") do |headers, content|
+            photos << new(headers, content)
+          end
+        end
+      end
+      
+    end
+
+    attr_accessor :id, :resource_id, :content_type, :content
+    
+    # id is the ID of the photo
+    # resource_id is the ID of the resource it belongs to. Properties will probably be sysid everytime
+    # content_type is the Image content_type
+    # content is the Binary string that can be written to a file to display the image.
+    def initialize(headers, content)
+      self.id = headers["object-id"]
+      self.resource_id = headers["content-id"]
+      self.content_type = headers["content-type"]
+      self.content = content
+    end
+    
+    # Use this method to get the binary string to write to a file.
+    # Sometimes the string will contin ASCII-8BIT characters.
+    # Forcing to UTF-8 will make it write to a file easier.
+    def image
+      content.to_s.force_encoding("UTF-8")
+    end
+    
+    # Returns a filename based on the resource_id and id of the photo
+    # should have proper extension on it.
+    def filename
+      ext = case content_type
+      when /jpeg$/, /jpg$/ then "jpg"
+      when /png$/ then "png"
+      when /gif$/ then "gif"
+      else "jpg"
+      end
+      "#{resource_id}-#{id}.#{ext}"
+    end
+    
+  end
+end

data/lib/tourets/property.rb

@@ -0,0 +1,84 @@
+module TouRETS
+  class Property
+    include Utilities
+    extend Utilities
+    
+    SEARCH_QUERY_DEFAULTS = {:active_properties => "ER,EA,C", :idx_display => "Y", :internet_display => "Y"}
+    # This class searches for ResidentialProperty, Condo, SingleFamily, Rental
+    # Some MLS use "1", some use :RES... Will need to decide which way is to be used.
+    SEARCH_CONFIG_DEFAULTS = {:search_type => :Property, :class => "1"}
+    
+    class << self
+      
+      # Returns an array of all of the properties
+      # Property.all
+      def all
+        where
+      end
+      
+      # Returns an array of property results.
+      # Property.where(:bedrooms => 7, :bathrooms => 4, :list_price => 200000..300000)
+      # Property.where(:property_type => {:not => ['CONDO', 'TOWNHOME']}, :area => {:or => ['South West', 'North West']})
+      # Property.where(:area => ['South West', 'North West']) # This is like 'AND'
+      def where(search_params = {})
+        TouRETS.ensure_connected!
+        [].tap do |properties|
+          search_params = map_search_params(SEARCH_QUERY_DEFAULTS.merge(search_params))
+          search_config = SEARCH_CONFIG_DEFAULTS.merge({:query => hash_to_rets_query_string(search_params)})
+          Search.find(search_config) do |property|
+            properties << self.new(property)
+          end
+        end
+      end
+      
+      # # Propert.where(:bedrooms => 3).limit(10) #not implemented
+      # def limit(limit_number = 5000)
+      #   SEARCH_CONFIG_DEFAULTS.merge!(:limit => limit_number)
+      #   self
+      # end
+      # 
+      # # Property.where(:bedrooms => 3).count #not implemented
+      # def count
+      #   SEARCH_CONFIG_DEFAULTS.merge!(:count_mode => :only)
+      #   self
+      # end
+      # 
+      # # Property.select(['SystemName', 'LongName']).where(:bedrooms => 3) #not implemented
+      # # select is to limit which fields actually get returned. This could help with mapping
+      # def select(fields=[])
+      #   {:select => fields}
+      #   self
+      # end
+      
+    end
+    
+    attr_accessor :attributes
+    
+    def initialize(args = {})
+      self.attributes = args
+    end
+    
+    # Return an array of the photo objects that belong to a particular property
+    def photos
+      @photos ||= grab_photos
+    end
+    
+    def method_missing(method_name, *args, &block)
+      val = attributes[key_map[method_name.to_sym]]
+      if val.nil?
+        super
+      else
+        return val
+      end
+    end
+    
+    private
+    
+      def grab_photos
+        [].tap do |pics|
+          pics << TouRETS::Photo.find(attributes['sysid'], :resource => :Property)
+        end.flatten
+      end
+    
+  end
+end

data/lib/tourets/rails.rb

@@ -0,0 +1,10 @@
+require 'rails'
+require 'tourets/rails/engine'
+require 'tourets/rails/railtie'
+require 'tourets/rails/version'
+
+module TouRETS
+  module Rails
+    
+  end
+end

data/lib/tourets/rails/engine.rb

@@ -0,0 +1,6 @@
+module TouRETS
+  module Rails
+    class Engine < ::Rails::Engine
+    end
+  end
+end

data/lib/tourets/rails/railtie.rb

@@ -0,0 +1,8 @@
+
+module TouRETS
+  module Rails
+    class Railtie < ::Rails::Railtie
+      
+    end
+  end
+end

data/lib/tourets/rails/version.rb

@@ -0,0 +1,6 @@
+module TouRETS
+  module Rails
+    VERSION = "0.1.0"
+    
+  end
+end

data/lib/tourets/search.rb

@@ -0,0 +1,19 @@
+module TouRETS
+  
+  class Search
+    
+    class << self
+      
+      # This works as a raw search. This give the developer a chance 
+      # to customize how they want to search.
+      def find(search_params = {}, &block)
+        raise ArgumentError, "No block passed" unless block_given?
+        TouRETS.ensure_connected!
+        TouRETS.current_connection.search(search_params, &block)
+      end
+      
+    end
+    
+  end
+  
+end

data/lib/tourets/utilities.rb

@@ -0,0 +1,138 @@
+module TouRETS
+  module Utilities
+    
+    # Convert a key value pair into a RETS formatted query string.
+    # TODO: Take values that are arrays, ranges, or hashes, and convert those properly
+    def hash_to_rets_query_string(hash)
+      [].tap do |str|
+        hash.each_pair do |k,v|
+          val = value_map(v)
+          str << "(#{k.to_s.camelize}=#{val})"
+        end
+      end.join(',')
+    end
+    
+    # This takes a hash of search parameters, and modifies 
+    # the hash to have the correct key types for the current RETS server
+    def map_search_params(search_params)
+      Hash[search_params.map {|k, v| [key_map[k], v] }]
+    end
+    
+    # Giant Hash.
+    # TODO: OPTIMIZE!!!! ZOMG! O_o
+    # Maybe break this into a YAML file that will pick which keymap to use based on the current_connection?
+    # I'm thinking maybe like a dictionary lookup. Figure out what each RETS server uses.
+    # Also good to note that there are different data types, but they all are strings. 
+    # We could figure out a way to convert to Integer, or DateTime objects, etc... depending.
+    def key_map
+      {
+        :id => "sysid",         #String
+        :property_type => "1",  #String
+        :acreage => "2",        #Float
+        :zip_code => "10",      #String
+        :address => "13",       #String
+        :partial_flag => "17",  #String
+        :close_date => "25",    #DateTime
+        :agent_name => "26",    #String
+        :annual_property_tax => "28", #Integer
+        :has_dishwasher => "30",      #Boolean
+        :has_disposal => "31",        #Boolean
+        :has_refrigerator => "33",    #Boolean
+        :dryer_hookup => "34",        #String
+        :area => "37",                #String
+        :association_fee => "39",     #Integer
+        #1st Encumbr Assumption Desc => "43" # Like the mortgage...
+        :three_quarter_baths => "60", #Integer
+        :bathrooms => "61",           #Integer
+        :half_baths => "62",          #Integer
+        :total_baths => "63",         #Integer
+        :downstairs_bath_desc => "63",#String
+        :bedrooms => "68",            #Integer
+        :built_desc => "72",          #String
+        :carport_desc => "73",        #String
+        :carports => "74",            #Integer
+        :comp_days_on_market => "81", #Integer (this is nil sometimes)
+        :contingency_desc => "84",    #String
+        :contract_date => "85",       #DateTime
+        :cooling_fuel_desc => "86",   #String
+        :county => "87",              #String
+        :second_bed_dim => "89",      #String
+        :third_bed_dim => "90",       #String
+        :fourth_bed_dim => "91",      #String
+        :dining_room_dim => "92",     #String
+        :family_room_dim => "93",     #String
+        :fifth_bed_dim => "94",       #String
+        :living_room_dim => "95",     #String
+        :master_bed_dim => "96",      #String
+        :fifth_bed_desc => "97",      #String
+        :days_on_market => "101",     #Integer
+        :entry_date => "104",         #DateTime
+        :fence => "112",              #String
+        :fireplaces => "113",         #Integer
+        :converted_garage? => "120",  #Boolean
+        :garages => "122",            #Integer
+        :ground_mounted? => "125",    #Boolean
+        :images => "129",             #Integer
+        :internet_display => "130",   #Boolean
+        :land_use => "132",           #Integer
+        :last_transaction_code => "134", #String
+        :last_transaction_at => "135",#DateTime
+        :list_office_code => "137",   #String
+        :listed_on => "138",          #DateTime
+        :agentcode => "143",          #String
+        :list_price => "144",         #Float
+        :agent_member_id => "145",    #String
+        :lot_sqft => "154",           #Integer
+        :community => "155",          #String
+        :listing_number => "163",     #String
+        :occupancy_desc => "170",     #String
+        :listing_office => "171",     #String
+        :listing_office_phone => "172", #String
+        :original_list_price => "173",#Float
+        :parcel_number => "176",      #String
+        :photo_instructions => "182", #String
+        :pools => "184",              #Integer
+        :property_condition => "202", #String
+        :has_pool => "203",           #Boolean
+        :record_deleted_at => "205",  #DateTime
+        :record_deleted => "207",     #Boolean
+        :buyer_broker => "211",       #String
+        :elementary_school_2 => "213",#String
+        :highschool => "214",         #String
+        :middle_school => "215",      #String
+        :year_round_school => "216",  #String
+        :buyer_agentcode => "218",    #String
+        :sewer => "219",              #String
+        # #Loft => "231",             #Integer
+        :has_spa => "236",            #Boolean
+        :active_properties => "242",
+        :idx_display => "1809",
+        :sqft => "2361"
+      }
+    end
+    
+    # Take values like true and false, convert them to "Y" or "N". make collections into joint strings.
+    def value_map(value)
+      v = case value.class
+      when Array
+        value.join(',')
+      when Range
+        "#{value.first}-#{value.last}"
+      when Hash
+        if value.has_key?(:or)
+          "|#{value[:or].join(',')}"
+        elsif value.has_key?(:not)
+          "~#{value[:not].join(',')}"
+        end
+      when TrueClass
+        "Y" # TODO: figure out if this should be Y or Yes
+      when FalseClass
+        "N" # TODO: figure out if this should be N or No
+      else
+        value
+      end
+      v
+    end
+    
+  end
+end

data/lib/tourets/vrimage.rb

@@ -0,0 +1,30 @@
+# NOTE: This class is not really implemented yet. 
+
+module TouRETS
+  
+  # VRImage is a multiple-view, possibly-interactive image related to the :resource
+  class VRImage
+    
+    class << self
+      
+      # Find the vrimage 
+      # Use find("1234", :id => 1) to find the photo with ID 1 in the 1234 group
+      # Default it to return all of the photos.
+      def find(sysid, opts={})
+        limit = opts[:id] || "*"
+        [].tap do |photos|
+          TouRETS.current_connection.get_object(:resource => opts[:resource], :type => :VRImage, :location => false, :id => "#{sysid}:#{limit}") do |headers, content|
+            photos << new(headers, content)
+          end
+        end
+      end
+      
+    end
+    
+    
+    def initialize(headers, content)
+      
+    end
+    
+  end
+end

data/tourets.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/tourets/rails/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Jeremy Woertink", "Justin Mitchell"]
+  gem.email         = ["jeremywoertink@gmail.com", "jmitchell4140@gmail.com"]
+  gem.description   = "TouRETS is a rails gem used to interface with multiple RETS using the ruby-rets gem"
+  gem.summary       = "Use RETS with a LOT less hassle"
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "tourets"
+  gem.require_paths = ["lib"]
+  gem.version       = TouRETS::Rails::VERSION
+  
+  gem.add_dependency('ruby-rets', '2.0.5')
+  gem.add_dependency('railties', '>= 3.1')
+  gem.add_development_dependency('rspec')
+  gem.add_development_dependency('rails', '>= 3.1')
+end

metadata

@@ -0,0 +1,136 @@
+--- !ruby/object:Gem::Specification
+name: tourets
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Jeremy Woertink
+- Justin Mitchell
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-11-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ruby-rets
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.0.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.0.5
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.1'
+description: TouRETS is a rails gem used to interface with multiple RETS using the
+  ruby-rets gem
+email:
+- jeremywoertink@gmail.com
+- jmitchell4140@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/tourets.rb
+- lib/tourets/exceptions.rb
+- lib/tourets/extensions/hash.rb
+- lib/tourets/photo.rb
+- lib/tourets/property.rb
+- lib/tourets/rails.rb
+- lib/tourets/rails/engine.rb
+- lib/tourets/rails/railtie.rb
+- lib/tourets/rails/version.rb
+- lib/tourets/search.rb
+- lib/tourets/utilities.rb
+- lib/tourets/vrimage.rb
+- tourets.gemspec
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 3840694011043471350
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 3840694011043471350
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Use RETS with a LOT less hassle
+test_files: []