seedable 0.0.1

data/lib/seedable/object_tracker.rb

@@ -0,0 +1,45 @@
+# encoding: UTF-8
+
+module Seedable # :nodoc:
+  class ObjectTracker # :nodoc:
+
+    attr_accessor :graph
+
+    # Create a new instance of the object tracker.
+    #
+    def initialize
+      @graph = {}
+    end
+
+    # Determine if the object tracker has already picked this object up.
+    #
+    def contains?(object)
+      key, id = to_key_and_id(object)
+
+      @graph[key].is_a?(Enumerable) ? @graph[key].include?(id) : @graph[key]
+    end
+
+    # Add this object to the object tracker.
+    #
+    def add(object)
+      key, id = to_key_and_id(object)
+
+      @graph[key] ? @graph[key] << id : @graph[key] = [id]
+    end
+
+    # Display the object tracker in yaml for easy viewing.
+    #
+    def to_s
+      @graph.to_yaml
+    end
+
+    # Convert a particular object to a hash key and id, based from the
+    # object's class and primary key.
+    # 
+    def to_key_and_id(object)
+      [object.class.to_s.underscore.to_sym, object.id]
+    end
+    private :to_key_and_id
+
+  end
+end

data/lib/seedable/version.rb

@@ -0,0 +1,5 @@
+# encoding: UTF-8
+
+module Seedable # :nodoc:
+  VERSION = "0.0.1"
+end

data/seedable.gemspec

@@ -0,0 +1,44 @@
+# encoding: UTF-8
+
+$:.push File.expand_path("../lib", __FILE__)
+require "seedable/version"
+
+Gem::Specification.new do |s|
+  s.name        = "seedable"
+  s.version     = Seedable::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Christopher Meiklejohn"]
+  s.email       = ["christopher.meiklejohn@gmail.com"]
+  s.homepage    = "http://github.com/cmeiklejohn/seedable"
+  s.summary     = %q{Allows for quick serialization/deserialization of objects for moving between environments.}
+  s.description = %q{Allows for quick serialization/deserialization of objects for moving between environments.}
+
+  s.rubyforge_project = "seedable"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency('rails', '>= 3.1.0')
+
+  s.add_development_dependency('bundler', '~> 1.0.0')
+  s.add_development_dependency('rspec') 
+  s.add_development_dependency('rspec-rails') 
+  s.add_development_dependency('sqlite3')
+  s.add_development_dependency('factory_girl')
+  s.add_development_dependency('factory_girl_rails')
+  s.add_development_dependency('mocha')
+  s.add_development_dependency('appraisal', '~> 0.3.5')
+  s.add_development_dependency('timecop')
+  s.add_development_dependency('horo') 
+  s.add_development_dependency('simplecov') 
+  s.add_development_dependency('diesel') 
+  s.add_development_dependency('guard') 
+  s.add_development_dependency('guard-rspec')
+
+  if RUBY_PLATFORM =~ /linux/i
+    s.add_development_dependency('rb-inotify')
+    s.add_development_dependency('libnotify')
+  end
+end

data/spec/database.yml

@@ -0,0 +1,7 @@
+# encoding: UTF-8
+
+test:
+  adapter: sqlite3
+  database: db/test.sqlite3
+  pool: 5
+  timeout: 5000

data/spec/models/filtered_garage_spec.rb

@@ -0,0 +1,22 @@
+# encoding: UTF-8
+
+require 'spec_helper'
+
+describe FilteredGarage do 
+
+  before(:each) do 
+    Timecop.freeze(2010, 01, 01)
+    @garage = Factory.create(:filtered_garage)
+  end
+
+  after(:each) do 
+    Timecop.return
+  end
+
+  describe "with filtered attributes" do 
+    it "should return properly formatted json when to_seedable is called" do 
+      @garage.as_seedable.should == {"filtered_garage"=>{"id"=>1, "updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "created_at"=>"Fri Jan 01 00:00:00 -0500 2010"}}
+    end
+  end
+
+end

data/spec/models/garage_spec.rb

@@ -0,0 +1,197 @@
+# encoding: UTF-8
+
+require 'spec_helper'
+
+describe Garage do 
+
+  before(:each) do 
+    Timecop.freeze(2010, 01, 01)
+    @garage = Factory.create(:garage)
+  end
+
+  after(:each) do 
+    Timecop.return
+  end
+
+  describe "with no associations" do
+    it "should return a proper hash of attributes and associations" do
+      @garage.as_seedable.should == {"garage"=>{"id"=>1, "updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "name"=>"Chris", "created_at"=>"Fri Jan 01 00:00:00 -0500 2010"}}
+    end
+
+    it "should export and import correctly" do 
+      @hash = @garage.as_seedable
+      @json = @garage.to_seedable
+
+      @hash.should == {"garage"=>{"id"=>1, "updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "name"=>"Chris", "created_at"=>"Fri Jan 01 00:00:00 -0500 2010"}}
+
+      @garage.delete
+      Garage.all.count.should == 0
+
+      @garage = Garage.from_seedable(@json) 
+      @garage.as_seedable.should == @hash
+      @garage.to_seedable.should == @json
+    end
+  end
+
+  describe "with a bike" do 
+    before(:each) do 
+      @bike = Factory.create(:bike)
+      @garage.bikes << @bike
+
+      Garage.include_associations([:bikes])
+    end
+
+    it "should not traverse to bike when exporting since it is not seedable" do 
+      @garage.as_seedable.should == {"garage"=>{"id"=>1, "updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "name"=>"Chris", "created_at"=>"Fri Jan 01 00:00:00 -0500 2010"}}
+    end
+  end
+
+  describe "with one car" do
+    before(:each) do 
+      @car = Factory.create(:car)
+      @garage.cars << @car
+      Garage.include_associations([:cars])
+    end
+
+    it "should return a proper hash of attributes and associations" do
+      Car.filter_attributes([])
+      Garage.filter_attributes([])
+      
+      @garage.as_seedable.should == {"garage"=>{"id"=>1, "updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "name"=>"Chris", :cars=>[{"id"=>1, "updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "model"=>"Impreza", "created_at"=>"Fri Jan 01 00:00:00 -0500 2010", "garage_id"=>1, "make"=>"Subaru"}], "created_at"=>"Fri Jan 01 00:00:00 -0500 2010"}}
+    end
+
+    it "should omit filtered attributes and return properly formatted json when to_seedable is called" do 
+      Garage.filter_attributes([:id])
+      Car.filter_attributes([:id, :garage_id])
+
+      @garage.as_seedable.should == {"garage"=>{"updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "name"=>"Chris", :cars=>[{"updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "model"=>"Impreza", "created_at"=>"Fri Jan 01 00:00:00 -0500 2010", "make"=>"Subaru"}], "created_at"=>"Fri Jan 01 00:00:00 -0500 2010"}}
+    end
+
+    it "should export and import the records correctly without ids" do
+      Garage.filter_attributes([:id])
+      Car.filter_attributes([:id, :garage_id])
+
+      @hash = @garage.as_seedable
+      @json = @garage.to_seedable
+
+      @car.delete
+      @garage.delete
+
+      Car.all.count.should == 0
+      Garage.all.count.should == 0
+
+      @hash.should == {"garage"=>{"updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "name"=>"Chris", :cars=>[{"updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "model"=>"Impreza", "created_at"=>"Fri Jan 01 00:00:00 -0500 2010", "make"=>"Subaru"}], "created_at"=>"Fri Jan 01 00:00:00 -0500 2010"}}
+
+      @garage = Garage.from_seedable(@json) 
+      @garage.as_seedable.should == @hash
+      @garage.to_seedable.should == @json
+    end
+
+    # TODO: Marked pending since this behavior fails in rails 3.0, but
+    # works in rails 3.2.  
+    #
+    # For this to work, mass assignment protection
+    # changes from rails-3.2 are necessary since they'll alow you to
+    # bypass protection on all associated objects and set primary key
+    # values on the associated objects.
+    #
+    pending "should export and import the records correctly with ids"
+  end
+
+  describe "with one car and two drivers" do
+    before(:each) do 
+      @car = Factory.create(:car)
+      @garage.cars << @car
+      2.times do 
+        @car.drivers << Factory.create(:driver)
+      end
+
+      Car.filter_attributes([:id, :garage_id])
+      Garage.filter_attributes([:id])
+      Driver.filter_attributes([:id, :car_id])
+
+      Car.include_associations([:drivers])
+      Garage.include_associations([:cars])
+    end
+
+    it "serialize and deserialize into objects correctly" do
+      @hash = @garage.as_seedable
+      @json = @garage.to_seedable
+
+      @hash.should == {"garage"=>{"updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "name"=>"Chris", :cars=>[{"updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "model"=>"Impreza", "created_at"=>"Fri Jan 01 00:00:00 -0500 2010", :drivers=>[{"updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "name"=>"Chris", "created_at"=>"Fri Jan 01 00:00:00 -0500 2010"}, {"updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "name"=>"Chris", "created_at"=>"Fri Jan 01 00:00:00 -0500 2010"}], "make"=>"Subaru"}], "created_at"=>"Fri Jan 01 00:00:00 -0500 2010"}}
+
+      @garage = Garage.from_seedable(@json)
+      @garage.as_seedable.should == @hash
+      @garage.to_seedable.should == @json
+    end
+
+    describe "with a dependency back to garage" do 
+      it "should be able to export correctly by not traversing direct ancestors" do
+        Car.filter_attributes([:id, :garage_id])
+        Garage.filter_attributes([:id])
+        Driver.filter_attributes([:id, :car_id])
+
+        Car.include_associations([:drivers, :garage])
+        Garage.include_associations([:cars])
+
+        @hash = @garage.as_seedable
+        @json = @garage.to_seedable
+
+        @hash.should == {"garage"=>{"updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "name"=>"Chris", :cars=>[{"updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "model"=>"Impreza", "created_at"=>"Fri Jan 01 00:00:00 -0500 2010", :drivers=>[{"updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "name"=>"Chris", "created_at"=>"Fri Jan 01 00:00:00 -0500 2010"}, {"updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "name"=>"Chris", "created_at"=>"Fri Jan 01 00:00:00 -0500 2010"}], "make"=>"Subaru"}], "created_at"=>"Fri Jan 01 00:00:00 -0500 2010"}}
+
+        @garage = Garage.from_seedable(@json)
+        @garage.as_seedable.should == @hash
+        @garage.to_seedable.should == @json
+      end
+    end
+  end
+
+  describe "with two cars with the same driver" do 
+    before(:each) do 
+      @driver = Factory.create(:driver)
+      2.times do 
+        @car = Factory.create(:car)
+        @car.drivers << @driver
+        @garage.cars << @car
+      end
+
+      Car.filter_attributes([])
+      Garage.filter_attributes([])
+      Driver.filter_attributes([])
+
+      Car.include_associations([:drivers])
+      Garage.include_associations([:cars])
+    end
+
+    it "should import and export only one driver correctly" do 
+      @garage.as_seedable.should == {"garage"=>{"id"=>1, "updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "name"=>"Chris", :cars=>[{"id"=>1, "updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "model"=>"Impreza", "created_at"=>"Fri Jan 01 00:00:00 -0500 2010", "garage_id"=>1, :drivers=>[{"id"=>1, "updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "car_id"=>2, "name"=>"Chris", "created_at"=>"Fri Jan 01 00:00:00 -0500 2010"}], "make"=>"Subaru"}, {"id"=>2, "updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "model"=>"Impreza", "created_at"=>"Fri Jan 01 00:00:00 -0500 2010", "garage_id"=>1, :drivers=>[{}], "make"=>"Subaru"}], "created_at"=>"Fri Jan 01 00:00:00 -0500 2010"}}
+    end
+  end
+    
+  describe "in an array of garages" do
+    before(:each) do 
+      @garages = []
+      2.times do 
+        @garages << @garage
+      end
+
+      Car.filter_attributes([:id, :garage_id])
+      Garage.filter_attributes([:id])
+      Driver.filter_attributes([:id, :car_id])
+
+      @hash = @garages.as_seedable
+      @json = @garages.to_seedable
+    end
+
+    it "should export correctly" do 
+      @hash.should == [{"garage"=>{"updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "name"=>"Chris", :cars=>[], "created_at"=>"Fri Jan 01 00:00:00 -0500 2010"}}, {"garage"=>{"updated_at"=>"Fri Jan 01 00:00:00 -0500 2010", "name"=>"Chris", :cars=>[], "created_at"=>"Fri Jan 01 00:00:00 -0500 2010"}}]
+    end
+
+    it "should reload correctly" do 
+      @garages = Seedable.from_seedable(@json)
+      @garages.as_seedable.should == @hash
+      @garages.to_seedable.should == @json
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,41 @@
+# encoding: UTF-8
+
+ENV["RAILS_ENV"] ||= "test"
+
+PROJECT_ROOT = File.expand_path("../..", __FILE__)
+$LOAD_PATH << File.join(PROJECT_ROOT, "lib")
+
+require 'rails/all'
+require 'rails/test_help'
+Bundler.require
+
+require 'diesel/testing'
+require 'rspec/rails'
+
+require 'factory_girl_rails'
+require 'timecop'
+
+require 'seedable'
+
+if RUBY_VERSION > "1.9"
+  require 'simplecov'
+  SimpleCov.start
+end
+
+Dir[Rails.root.join("spec/support/**/*.rb")].each { |f| require f }
+
+ActiveRecord::Base.establish_connection(
+  :adapter => "sqlite3", 
+  :database => ":memory:"
+)
+
+ActiveRecord::Base.silence do
+  ActiveRecord::Migration.verbose = false
+
+  load(File.dirname(__FILE__) + '/../db/schema.rb')
+end
+
+RSpec.configure do |config|
+  config.use_transactional_fixtures = true
+  config.backtrace_clean_patterns << %r{gems/}
+end

data/spec/support/factories.rb

@@ -0,0 +1,23 @@
+# encoding: UTF-8
+
+require 'spec_helper'
+
+Factory.define :garage do |garage|
+  garage.name "Chris"
+end
+
+Factory.define :filtered_garage do |garage|
+  garage.name "Chris"
+end
+
+Factory.define :bike do |bike|
+end
+
+Factory.define :car do |car|
+  car.make "Subaru"
+  car.model "Impreza"
+end
+
+Factory.define :driver do |driver|
+  driver.name "Chris"
+end

data/spec/support/models.rb

@@ -0,0 +1,43 @@
+# encoding: UTF-8
+
+class Garage < ActiveRecord::Base
+  include Seedable
+
+  has_many :cars
+  has_many :bikes
+
+  seedable :include_associations => []
+end
+
+class FilteredGarage < ActiveRecord::Base
+  include Seedable
+
+  has_many :cars
+  has_many :bikes
+
+  seedable :include_associations => [], :filter_attributes => [:name]
+end
+
+class Car < ActiveRecord::Base
+  include Seedable
+
+  belongs_to :garage
+
+  has_many :drivers
+
+  seedable :include_associations => []
+end
+
+class Bike < ActiveRecord::Base
+  include Seedable
+
+  belongs_to :garage
+end
+
+class Driver < ActiveRecord::Base
+  include Seedable
+
+  belongs_to :car
+
+  seedable :include_associations => []
+end

metadata

@@ -0,0 +1,271 @@
+--- !ruby/object:Gem::Specification
+name: seedable
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Christopher Meiklejohn
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-09-02 00:00:00.000000000 -04:00
+default_executable: 
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: &16523360 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *16523360
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &16521980 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: *16521980
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &16521500 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *16521500
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: &16520300 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *16520300
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: &16504720 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *16504720
+- !ruby/object:Gem::Dependency
+  name: factory_girl
+  requirement: &16503480 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *16503480
+- !ruby/object:Gem::Dependency
+  name: factory_girl_rails
+  requirement: &16502040 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *16502040
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: &16500080 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *16500080
+- !ruby/object:Gem::Dependency
+  name: appraisal
+  requirement: &16486220 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.3.5
+  type: :development
+  prerelease: false
+  version_requirements: *16486220
+- !ruby/object:Gem::Dependency
+  name: timecop
+  requirement: &16485320 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *16485320
+- !ruby/object:Gem::Dependency
+  name: horo
+  requirement: &16484380 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *16484380
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: &16482980 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *16482980
+- !ruby/object:Gem::Dependency
+  name: diesel
+  requirement: &16444480 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *16444480
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: &16443620 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *16443620
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: &16442800 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *16442800
+- !ruby/object:Gem::Dependency
+  name: rb-inotify
+  requirement: &16440580 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *16440580
+- !ruby/object:Gem::Dependency
+  name: libnotify
+  requirement: &16438380 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *16438380
+description: Allows for quick serialization/deserialization of objects for moving
+  between environments.
+email:
+- christopher.meiklejohn@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .rvmrc
+- .travis.yml
+- Appraisals
+- Gemfile
+- Guardfile
+- LICENSE
+- README.rdoc
+- Rakefile
+- db/schema.rb
+- gemfiles/rails-3.1.0.gemfile
+- gemfiles/rails-3.1.0.gemfile.lock
+- gemfiles/rails-master.gemfile
+- gemfiles/rails-master.gemfile.lock
+- lib/seedable.rb
+- lib/seedable/core_ext.rb
+- lib/seedable/exporter.rb
+- lib/seedable/helpers.rb
+- lib/seedable/importer.rb
+- lib/seedable/object_tracker.rb
+- lib/seedable/version.rb
+- seedable.gemspec
+- spec/database.yml
+- spec/models/filtered_garage_spec.rb
+- spec/models/garage_spec.rb
+- spec/spec_helper.rb
+- spec/support/factories.rb
+- spec/support/models.rb
+has_rdoc: true
+homepage: http://github.com/cmeiklejohn/seedable
+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: -3243611342215626697
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -3243611342215626697
+requirements: []
+rubyforge_project: seedable
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Allows for quick serialization/deserialization of objects for moving between
+  environments.
+test_files: []