rubysync 0.0.5 → 0.1.0

data/HISTORY.txt

@@ -1,3 +1,10 @@
+== 0.1.0 / 2007-09-26
+
+* Dropped the map_client_to_vault and map_vault_to_client methods. in_transform and out_transform now handle that
+  this enables calculated and literal values as well as simple mappings
+* Now uses the class loader from activesupport - much more stable
+* Refreshed the examples
+
 == 0.0.5 / 2007-09-18
 
 * Fixed gem dependency issues

data/Manifest.txt

@@ -1,5 +1,3 @@
-.DS_Store
-.project
 COPYING
 HISTORY.txt
 Manifest.txt
@@ -7,71 +5,11 @@ README.txt
 Rakefile
 bin/rubysync
 bin/rubysync.rb
-docs/in_pipeline.graffle
 docs/init_openldap.ldif
-docs/out_pipeline.graffle
 docs/schema/99rubysync.ldif
 docs/schema/rubysync.schema
-docs/to_sync.txt
-docs/walkthru.txt
-examples/ar_client_webapp/README
-examples/ar_client_webapp/Rakefile
-examples/ar_client_webapp/app/controllers/application.rb
-examples/ar_client_webapp/app/controllers/user_controller.rb
-examples/ar_client_webapp/app/helpers/application_helper.rb
-examples/ar_client_webapp/app/helpers/user_helper.rb
-examples/ar_client_webapp/app/models/user.rb
-examples/ar_client_webapp/config/boot.rb
-examples/ar_client_webapp/config/database.yml
-examples/ar_client_webapp/config/environment.rb
-examples/ar_client_webapp/config/environments/development.rb
-examples/ar_client_webapp/config/environments/production.rb
-examples/ar_client_webapp/config/environments/test.rb
-examples/ar_client_webapp/config/routes.rb
-examples/ar_client_webapp/db/migrate/001_create_users.rb
-examples/ar_client_webapp/db/schema.rb
-examples/ar_client_webapp/doc/README_FOR_APP
-examples/ar_client_webapp/log/development.log
-examples/ar_client_webapp/log/production.log
-examples/ar_client_webapp/log/server.log
-examples/ar_client_webapp/log/test.log
-examples/ar_client_webapp/public/.htaccess
-examples/ar_client_webapp/public/404.html
-examples/ar_client_webapp/public/500.html
-examples/ar_client_webapp/public/dispatch.cgi
-examples/ar_client_webapp/public/dispatch.fcgi
-examples/ar_client_webapp/public/dispatch.rb
-examples/ar_client_webapp/public/favicon.ico
-examples/ar_client_webapp/public/images/rails.png
-examples/ar_client_webapp/public/index.html
-examples/ar_client_webapp/public/javascripts/application.js
-examples/ar_client_webapp/public/javascripts/controls.js
-examples/ar_client_webapp/public/javascripts/dragdrop.js
-examples/ar_client_webapp/public/javascripts/effects.js
-examples/ar_client_webapp/public/javascripts/prototype.js
-examples/ar_client_webapp/public/robots.txt
-examples/ar_client_webapp/script/about
-examples/ar_client_webapp/script/breakpointer
-examples/ar_client_webapp/script/console
-examples/ar_client_webapp/script/destroy
-examples/ar_client_webapp/script/generate
-examples/ar_client_webapp/script/performance/benchmarker
-examples/ar_client_webapp/script/performance/profiler
-examples/ar_client_webapp/script/plugin
-examples/ar_client_webapp/script/process/inspector
-examples/ar_client_webapp/script/process/reaper
-examples/ar_client_webapp/script/process/spawner
-examples/ar_client_webapp/script/runner
-examples/ar_client_webapp/script/server
-examples/ar_client_webapp/test/fixtures/users.yml
-examples/ar_client_webapp/test/functional/user_controller_test.rb
-examples/ar_client_webapp/test/test_helper.rb
-examples/ar_client_webapp/test/unit/user_test.rb
-examples/ar_client_webapp/tmp/sessions/ruby_sess.e2e3c63a67baef6d
-examples/ar_webapp/.DS_Store
 examples/ar_webapp/README
 examples/ar_webapp/Rakefile
-examples/ar_webapp/app/.DS_Store
 examples/ar_webapp/app/controllers/application.rb
 examples/ar_webapp/app/controllers/hobbies_controller.rb
 examples/ar_webapp/app/controllers/interests_controller.rb
@@ -87,9 +25,7 @@ examples/ar_webapp/app/models/ruby_sync_observer.rb
 examples/ar_webapp/app/models/ruby_sync_operation.rb
 examples/ar_webapp/app/models/ruby_sync_state.rb
 examples/ar_webapp/app/models/ruby_sync_value.rb
-examples/ar_webapp/app/views/.DS_Store
 examples/ar_webapp/app/views/layouts/application.rhtml
-examples/ar_webapp/app/views/people/.DS_Store
 examples/ar_webapp/app/views/people/show.rhtml
 examples/ar_webapp/config/boot.rb
 examples/ar_webapp/config/database.yml
@@ -159,12 +95,24 @@ examples/ar_webapp/test/unit/ruby_sync_observer_test.rb
 examples/ar_webapp/test/unit/ruby_sync_operation_test.rb
 examples/ar_webapp/test/unit/ruby_sync_state_test.rb
 examples/ar_webapp/test/unit/ruby_sync_value_test.rb
-examples/ims2/connectors/hr_db_connector.rb
-examples/ims2/connectors/my_csv_connector.rb
-examples/ims2/pipelines/hr_import_pipeline.rb
-examples/my_ims/connectors/my_csv_connector.rb
-examples/my_ims/connectors/my_db_connector.rb
-examples/my_ims/pipelines/my_pipeline.rb
+examples/csv_to_ldap/config/connectors/hr_connector.rb
+examples/csv_to_ldap/config/connectors/ldap_vault_connector.rb
+examples/csv_to_ldap/config/db/HrImportPipeline(vault)_assoc_to_path.db
+examples/csv_to_ldap/config/db/HrImportPipeline(vault)_mirror.db
+examples/csv_to_ldap/config/db/HrImportPipeline(vault)_path_to_assoc.db
+examples/csv_to_ldap/config/pipelines/hr_import_pipeline.rb
+examples/csv_to_ldap/in/henchmen.csv.bak
+examples/csv_to_xml/config/connectors/databank_connector.rb
+examples/csv_to_xml/config/connectors/hr_connector.rb
+examples/csv_to_xml/config/db/HrImportPipeline(vault)_assoc_to_path.db
+examples/csv_to_xml/config/db/HrImportPipeline(vault)_mirror.db
+examples/csv_to_xml/config/db/HrImportPipeline(vault)_path_to_assoc.db
+examples/csv_to_xml/config/pipelines/hr_import_pipeline.rb
+examples/csv_to_xml/databank.xml
+examples/csv_to_xml/in/henchmen.csv.bak
+examples/csv_to_xml/transcript.txt
+examples/data/henchmen.csv
+examples/data/more.csv
 lib/net/ldif.rb
 lib/ruby_sync.rb
 lib/ruby_sync/connectors/active_record_association_handler.rb
@@ -184,11 +132,6 @@ lib/ruby_sync/operation.rb
 lib/ruby_sync/pipelines/base_pipeline.rb
 lib/ruby_sync/util/metaid.rb
 lib/ruby_sync/util/utilities.rb
-lib/rubysync.rb
-nbproject/private/private.properties
-nbproject/project.properties
-nbproject/project.xml
-rubysync.tmproj
 test/data/example1.ldif
 test/data/example2.ldif
 test/data/example3.ldif
@@ -209,7 +152,6 @@ test/tc_ldap_connector.rb
 test/tc_ldap_vault.rb
 test/tc_ldif.rb
 test/tc_memory_connectors.rb
-test/tc_rubysync.rb
 test/tc_transformation.rb
 test/tc_utilities.rb
 test/tc_xml_connectors.rb

data/Rakefile

@@ -15,9 +15,9 @@
 
 require 'rubygems'
 require 'hoe'
-require './lib/rubysync.rb'
+require './lib/ruby_sync.rb'
 
-Hoe.new('rubysync', Rubysync::VERSION) do |p|
+Hoe.new('rubysync', RubySync::VERSION) do |p|
   p.rubyforge_name = 'rubysync'
   p.author = 'Ritchie Young'
   p.email = 'ritchiey@gmail.com'

data/bin/rubysync

@@ -76,7 +76,7 @@
 
 lib_path = File.dirname(__FILE__) + '/../lib'
 $:.unshift lib_path unless $:.include?(lib_path) || $:.include?(File.expand_path(lib_path))
-require "ruby_sync"
+require 'ruby_sync'
 require "simpleconsole"
 require 'rdoc/usage'
 
@@ -187,7 +187,7 @@ class Controller < SimpleConsole::Controller
   private
   
   def configure_logging
-    log_levels = [Logger::WARN, Logger::INFO, Logger::DEBUG]
+    log_levels = [::Logger::WARN, ::Logger::INFO, ::Logger::DEBUG]
     verbosity = [(params[:verbose]||0), log_levels.size-1].min
     log.level = log_levels[verbosity]
   end
@@ -264,9 +264,6 @@ def fields
   puts @field_names.join("\n")
 end
 
-                                            
-  
-
 end
 
 
@@ -285,8 +282,7 @@ end
   
   def pipeline_template name, vault_name, client_name
     vault = (vault_name)? ::RubySync::Connectors::BaseConnector.class_for(vault_name) : nil
-    vault_fields = vault && vault.fields || %w{allow these fields through}
-    possible_fields = (vault_fields.map {|n| ":#{n}"}).join(", ")
+    vault_fields = vault && vault.fields || []
 
     client = (client_name)? ::RubySync::Connectors::BaseConnector.class_for(client_name) : nil
     client_fields = client && client.fields || []
@@ -301,33 +297,76 @@ class #{name.to_s.camelize}Pipeline < RubySync::Pipelines::BasePipeline
   #{vault_specifier}
 
   # Remove any fields that you don't want to set in the client from the vault
-  allow_out #{possible_fields}
+  allow_out #{allow_through(vault_fields)}
 
   # Remove any fields that you don't want to set in the vault from the client
-  allow_in #{possible_fields}
+  allow_in #{allow_through(client_fields)}
 
   # If the client and vault have different names for the same field, define the
   # the mapping here. For example, if the vault has a field called "first name" and
   # the client has a field called givenName you may put:
-  #    'first name' => 'givenName'
-  # separate each mapping with a comma.
-  # The following fields were detected on the client:
-  # #{(client_fields.map {|f| "'#{f}'"}).join(",")}
-  map_vault_to_client({
-    #{(vault_fields.map {|f| "#'#{f}' => 'a_client_field'"}).join(",\n\t\t")}
-  })
-
+  #    map 'first name', 'givenName'
+  #
+  # You can also calculate the values for fields. For more info, see
+  # http://rubysync.org/docs/rubysync-transformations/
+  
   # "in" means going from client to vault
-  #in_transform do
-  #end
+  in_transform do
+    #{transform_fields(vault_fields, 'vault', 'client')}
+  end
 
   # "out" means going from vault to client
-  #out_transform do
-  #end
+  out_transform do
+    #{transform_fields(client_fields, 'client', 'vault')}
+  end
+
+  # if the vault doesn't already hold an association for this record
+  # from the client, perform a search here to see if a match can be found
+  # in_match do
+  # end
+
+  # if the vault doesn't have an association linking this record to one on
+  # the client, perform a search here to see if an existing client record
+  # matches this record
+  # out_match do
+  # end
+
+  # If this evaluates to false, it will veto the creation of a record on
+  # the vault. Good for checking you've got the required fields etc
+  # in_create_if do
+  # end
+
+  # if this evaluates to false for an outgoing event then it will
+  # veto the creation of a new record on the client
+  # out_create_if do
+  # end
+
+  # Should evaluate to the path for placing a new record on the vault
+  # in_place do
+  # end
+
+  # Should evaluate to the path for placing a new record on the client
+  # out_place do
+  # end
+  
+  
+  # These statements control logging. In log level 2 or higher (specify -v 2),
+  # the event will be dumped to the log at any of the places specified below.
+  # Uncomment and edit to taste. 
+  # dump_before :in_filter, :in_transform, :in_place, :out_filter, :out_place, :out_transform
+  # dump_after :in_filter, :in_transform, :in_place, :out_filter, :out_place, :out_transform
+
 
 end
     end;
   end
 
+def allow_through fields
+  (fields.empty? ? %w{allow these fields through} : fields).to_ruby
+end
+
+def transform_fields fields, mine, other
+  (fields.empty? ? ['sample',mine,'fields'] : fields).map {|f| "#map '#{f}', '#{other}_field'"}.join("\n    ")
+end
 
 SimpleConsole::Application.run(ARGV, Controller, View)

data/bin/rubysync.rb

@@ -76,7 +76,7 @@
 
 lib_path = File.dirname(__FILE__) + '/../lib'
 $:.unshift lib_path unless $:.include?(lib_path) || $:.include?(File.expand_path(lib_path))
-require "ruby_sync"
+require 'ruby_sync'
 require "simpleconsole"
 require 'rdoc/usage'
 
@@ -187,7 +187,7 @@ class Controller < SimpleConsole::Controller
   private
   
   def configure_logging
-    log_levels = [Logger::WARN, Logger::INFO, Logger::DEBUG]
+    log_levels = [::Logger::WARN, ::Logger::INFO, ::Logger::DEBUG]
     verbosity = [(params[:verbose]||0), log_levels.size-1].min
     log.level = log_levels[verbosity]
   end
@@ -264,9 +264,6 @@ def fields
   puts @field_names.join("\n")
 end
 
-                                            
-  
-
 end
 
 
@@ -285,8 +282,7 @@ end
   
   def pipeline_template name, vault_name, client_name
     vault = (vault_name)? ::RubySync::Connectors::BaseConnector.class_for(vault_name) : nil
-    vault_fields = vault && vault.fields || %w{allow these fields through}
-    possible_fields = (vault_fields.map {|n| ":#{n}"}).join(", ")
+    vault_fields = vault && vault.fields || []
 
     client = (client_name)? ::RubySync::Connectors::BaseConnector.class_for(client_name) : nil
     client_fields = client && client.fields || []
@@ -301,33 +297,76 @@ class #{name.to_s.camelize}Pipeline < RubySync::Pipelines::BasePipeline
   #{vault_specifier}
 
   # Remove any fields that you don't want to set in the client from the vault
-  allow_out #{possible_fields}
+  allow_out #{allow_through(vault_fields)}
 
   # Remove any fields that you don't want to set in the vault from the client
-  allow_in #{possible_fields}
+  allow_in #{allow_through(client_fields)}
 
   # If the client and vault have different names for the same field, define the
   # the mapping here. For example, if the vault has a field called "first name" and
   # the client has a field called givenName you may put:
-  #    'first name' => 'givenName'
-  # separate each mapping with a comma.
-  # The following fields were detected on the client:
-  # #{(client_fields.map {|f| "'#{f}'"}).join(",")}
-  map_vault_to_client({
-    #{(vault_fields.map {|f| "#'#{f}' => 'a_client_field'"}).join(",\n\t\t")}
-  })
-
+  #    map 'first name', 'givenName'
+  #
+  # You can also calculate the values for fields. For more info, see
+  # http://rubysync.org/docs/rubysync-transformations/
+  
   # "in" means going from client to vault
-  #in_transform do
-  #end
+  in_transform do
+    #{transform_fields(vault_fields, 'vault', 'client')}
+  end
 
   # "out" means going from vault to client
-  #out_transform do
-  #end
+  out_transform do
+    #{transform_fields(client_fields, 'client', 'vault')}
+  end
+
+  # if the vault doesn't already hold an association for this record
+  # from the client, perform a search here to see if a match can be found
+  # in_match do
+  # end
+
+  # if the vault doesn't have an association linking this record to one on
+  # the client, perform a search here to see if an existing client record
+  # matches this record
+  # out_match do
+  # end
+
+  # If this evaluates to false, it will veto the creation of a record on
+  # the vault. Good for checking you've got the required fields etc
+  # in_create_if do
+  # end
+
+  # if this evaluates to false for an outgoing event then it will
+  # veto the creation of a new record on the client
+  # out_create_if do
+  # end
+
+  # Should evaluate to the path for placing a new record on the vault
+  # in_place do
+  # end
+
+  # Should evaluate to the path for placing a new record on the client
+  # out_place do
+  # end
+  
+  
+  # These statements control logging. In log level 2 or higher (specify -v 2),
+  # the event will be dumped to the log at any of the places specified below.
+  # Uncomment and edit to taste. 
+  # dump_before :in_filter, :in_transform, :in_place, :out_filter, :out_place, :out_transform
+  # dump_after :in_filter, :in_transform, :in_place, :out_filter, :out_place, :out_transform
+
 
 end
     end;
   end
 
+def allow_through fields
+  (fields.empty? ? %w{allow these fields through} : fields).to_ruby
+end
+
+def transform_fields fields, mine, other
+  (fields.empty? ? ['sample',mine,'fields'] : fields).map {|f| "#map '#{f}', '#{other}_field'"}.join("\n    ")
+end
 
 SimpleConsole::Application.run(ARGV, Controller, View)

data/examples/ar_webapp/public/dispatch.cgi

@@ -1,4 +1,4 @@
-#!/opt/local/bin/ruby
+#!/usr/bin/env ruby
 
 require File.dirname(__FILE__) + "/../config/environment" unless defined?(RAILS_ROOT)
 

data/examples/ar_webapp/public/dispatch.fcgi

@@ -1,4 +1,4 @@
-#!/opt/local/bin/ruby
+#!/usr/bin/env ruby
 #
 # You may specify the path to the FastCGI crash log (a log of unhandled
 # exceptions which forced the FastCGI instance to exit, great for debugging)

data/examples/ar_webapp/public/dispatch.rb

@@ -1,4 +1,4 @@
-#!/opt/local/bin/ruby
+#!/usr/bin/env ruby
 
 require File.dirname(__FILE__) + "/../config/environment" unless defined?(RAILS_ROOT)
 

data/examples/csv_to_ldap/config/connectors/hr_connector.rb

@@ -0,0 +1,14 @@
+class HrConnector < RubySync::Connectors::CsvFileConnector
+  
+            # True if the first line of each file is a header
+            # and should be ignored
+            header_line   true
+
+            field_names   'id,first_name,last_name,skills'.split(',')
+            path_field    'id'
+            in_path       "#{File.dirname(__FILE__)}/../../in"
+            #out_path      '/directory/to/write/files/to'
+            in_glob       '*.csv'
+            out_extension '.csv'
+
+end

data/examples/csv_to_ldap/config/connectors/ldap_vault_connector.rb

@@ -0,0 +1,11 @@
+class LdapVaultConnector < RubySync::Connectors::LdapConnector
+        
+   host           'localhost'
+   port            389
+   username       'cn=Manager,dc=my-domain,dc=com'
+   password       'secret'
+   search_filter  "cn=*"
+   search_base    "ou=users,o=my-organization,dc=my-domain,dc=com"
+   #:bind_method  :simple
+
+end

data/examples/csv_to_ldap/config/pipelines/hr_import_pipeline.rb

@@ -0,0 +1,24 @@
+class HrImportPipeline < RubySync::Pipelines::BasePipeline
+
+  client :hr
+
+  vault :ldap_vault
+
+  # Remove any fields that you don't want to set in the vault from the client
+  allow_in 'id', 'first_name', 'last_name', 'skills'
+
+  # "in" means going from client to vault
+  in_transform do
+    map 'cn', 'id'
+    map 'sn', 'last_name'
+    map 'givenname', 'first_name'
+    map('employeeType') { value_of('skills').split(':') }
+    drop_changes_to 'skills'
+    map('objectclass') { 'inetOrgPerson' }
+  end
+  # Should evaluate to the path for placing a new record on the vault
+  in_place do
+    "cn=#{source_path},ou=users,o=my-organization,dc=my-domain,dc=com"
+  end
+
+end

data/examples/csv_to_ldap/in/henchmen.csv.bak

@@ -0,0 +1,3 @@
+id,first_name,last_name,skills
+bobby,BareKnuckle,Bobby,pugilism:yoga
+tt,Testy,Terry,kidnapping:interrogation:juggling

data/examples/csv_to_xml/config/connectors/databank_connector.rb

@@ -0,0 +1,8 @@
+class DatabankConnector < RubySync::Connectors::XmlConnector
+  
+#
+# You would normally specify an absolute pathname here.
+#
+filename "#{File.dirname(__FILE__)}/../../databank.xml"
+      
+end

data/examples/csv_to_xml/config/connectors/hr_connector.rb

@@ -0,0 +1,14 @@
+class HrConnector < RubySync::Connectors::CsvFileConnector
+  
+            # True if the first line of each file is a header
+            # and should be ignored
+            header_line   true
+
+            field_names   'id,first_name,last_name,skills'.split(',')
+            path_field    'id'
+            in_path       "#{File.dirname(__FILE__)}/../../in"
+            #out_path      '/directory/to/write/files/to'
+            in_glob       '*.csv'
+            out_extension '.csv'
+
+end

data/examples/csv_to_xml/config/pipelines/hr_import_pipeline.rb

@@ -0,0 +1,24 @@
+class HrImportPipeline < RubySync::Pipelines::BasePipeline
+
+  client :hr
+
+  vault :databank
+
+  # Remove any fields that you don't want to set in the vault from the client
+  allow_in 'id', 'first_name', 'last_name', 'skills'
+
+  # "in" means going from client to vault
+  in_transform do
+    map 'cn', 'id'
+    map 'sn', 'last_name'
+    map 'givenname', 'first_name'
+    map('employeeType') { value_of('skills').split(':') }
+    drop_changes_to 'skills'
+    map('objectclass') { 'inetOrgPerson' }
+  end
+  # Should evaluate to the path for placing a new record on the vault
+  in_place do
+    "cn=#{source_path},ou=users,o=my-organization,dc=my-domain,dc=com"
+  end
+
+end

data/examples/csv_to_xml/databank.xml

@@ -0,0 +1 @@
+<entries><entry id='cn=bobby,ou=users,o=my-organization,dc=my-domain,dc=com'><attr name='cn'><value>bobby</value></attr><attr name='givenname'><value>BareKnuckle</value></attr><attr name='objectclass'><value>inetOrgPerson</value></attr><attr name='sn'><value>Bobby</value></attr><attr name='employeeType'><value>pugilism</value><value>yoga</value></attr></entry><entry id='cn=tt,ou=users,o=my-organization,dc=my-domain,dc=com'><attr name='cn'><value>tt</value></attr><attr name='givenname'><value>Testy</value></attr><attr name='objectclass'><value>inetOrgPerson</value></attr><attr name='sn'><value>Terry</value></attr><attr name='employeeType'><value>kidnapping</value><value>interrogation</value><value>juggling</value></attr></entry></entries>

data/examples/csv_to_xml/in/henchmen.csv.bak

@@ -0,0 +1,3 @@
+id,first_name,last_name,skills
+bobby,BareKnuckle,Bobby,pugilism:yoga
+tt,Testy,Terry,kidnapping:interrogation:juggling

data/examples/csv_to_xml/transcript.txt

@@ -0,0 +1 @@
+$ rubysync create config
  
            # True if the first line of each file is a header
            # and should be ignored
            header_line   true
            field_names   'id,first_name,last_name,skills'.split(',')
            path_field    'id'
            in_path       "#{File.dirname(__FILE__)}/../../in"
            #out_path      '/directory/to/write/files/to'
            in_glob       '*.csv'
            out_extension '.csv'
  
      
  client :hr
  vault :databank
  # Remove any fields that you don't want to set in the vault from the client
  allow_in 'id', 'first_name', 'last_name', 'skills'
  # "in" means going from client to vault
  in_transform do
    map 'cn', 'id'
    map 'sn', 'last_name'
    map 'givenname', 'first_name'
    map('employeeType') { value_of('skills').split(':') }
    drop_changes_to 'skills'
    map('objectclass') { 'inetOrgPerson' }
  end
  # Should evaluate to the path for placing a new record on the vault
  in_place do
    "cn=#{source_path},ou=users,o=my-organization,dc=my-domain,dc=com"
  end
---
---
  <entry id='cn=bobby,ou=users,o=my-organization,dc=my-domain,dc=com'>
    <attr name='cn'>
      <value>bobby</value>
    </attr>
    <attr name='givenname'>
      <value>BareKnuckle</value>
    </attr>
    <attr name='objectclass'>
      <value>inetOrgPerson</value>
    </attr>
    <attr name='sn'>
      <value>Bobby</value>
    </attr>
    <attr name='employeeType'>
      <value>pugilism</value>
      <value>yoga</value>
    </attr>
  </entry>
  <entry id='cn=tt,ou=users,o=my-organization,dc=my-domain,dc=com'>
    <attr name='cn'>
      <value>tt</value>
    </attr>
    <attr name='givenname'>
      <value>Testy</value>
    </attr>
    <attr name='objectclass'>
      <value>inetOrgPerson</value>
    </attr>
    <attr name='sn'>
      <value>Terry</value>
    </attr>
    <attr name='employeeType'>
      <value>kidnapping</value>
      <value>interrogation</value>
      <value>juggling</value>
    </attr>
  </entry>

data/examples/data/henchmen.csv

@@ -0,0 +1,3 @@
+id,first_name,last_name,skills
+bobby,BareKnuckle,Bobby,pugilism:yoga
+tt,Testy,Terry,kidnapping:interrogation:juggling

data/examples/data/more.csv

@@ -0,0 +1,2 @@
+id,first_name,last_name,skills
+frenchy,Freddy,French,kung fu:assassinations:flower arranging