rubysync 0.0.5 → 0.1.0

data/docs/to_sync.txt

@@ -1,15 +0,0 @@
-Things to Sync
-
-gmail address book
-yahoo address book
-msn address book
-delicious links
-dobot.net tasks
-palm pilot tasks
-palm address book
-windows mobile address book
-rss feeds
-any HTML page using scRubyt
-imdb.com
-
-

data/docs/walkthru.txt

@@ -1,186 +0,0 @@
-$ mkdir x
-$ cd x
-$ rubysync create kaos
-$ ls -l
-total 0
-drwxr-xr-x   7 ritchiey  ritchiey  238 Aug 21 16:47 kaos
-$ cd kaos
-$ ls -l
-total 0
-drwxr-xr-x   2 ritchiey  ritchiey   68 Aug 21 16:47 connectors
-drwxr-xr-x   2 ritchiey  ritchiey   68 Aug 21 16:47 db
-drwxr-xr-x   2 ritchiey  ritchiey   68 Aug 21 16:47 log
-drwxr-xr-x   2 ritchiey  ritchiey   68 Aug 21 16:47 pipelines
-drwxr-xr-x   5 ritchiey  ritchiey  170 Aug 21 16:47 shared
-$ rubysync connector hr -t csv_file
-$ rubysync connector kaos_vault -t xml$ mate .. 
-$ cat connectors/hr_connector.rb 
-class HrConnector < RubySync::Connectors::CsvFileConnector
-            
-            field_names   ['id', 'first_name', 'last_name', 'skills']
-            path_field    'id'
-            in_path       '/Users/ritchiey/x/in'
-            out_path      '/Users/ritchiey/x/out'
-            in_glob       '*.csv'
-            out_extension '.csv'
-
-end
-$ cat connectors/kaos_vault_connector.rb 
-class KaosVaultConnector < RubySync::Connectors::XmlConnector
-            #
-          # "filename" should be the full name of the file containing
-          # the xml representation of the synchronized content.
-          # You probably want to change this:
-          #
-          filename "/Users/ritchiey/x/kaos.xml"
-
-end
-$ rubysync fields hr
-id
-first_name
-last_name
-skills
-$ rubysync fields kaos_vault
-
-$ rubysync pipeline hr_import -C hr -V kaos_vault
-$ # Now edit the pipeline config
-$ # Actually, here's the pipeline before editing
-$ cat pipelines/hr_import_pipeline.rb 
-class HrImportPipeline < RubySync::Pipelines::BasePipeline
-
-  client :hr
-
-  vault :kaos_vault
-
-  # Remove any fields that you don't want to set in the client from the vault
-  allow_out :allow, :these, :fields, :through
-
-  # Remove any fields that you don't want to set in the vault from the client
-  allow_in :allow, :these, :fields, :through
-
-  # 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:
-  # 'id', 'first_name', 'last_name', 'skills'
-  map_vault_to_client({
-    #'allow' => 'a_client_field',
-                #'these' => 'a_client_field',
-                #'fields' => 'a_client_field',
-                #'through' => 'a_client_field'
-  })
-
-  # "in" means going from client to vault
-  #in_transform do
-  #end
-
-  # "out" means going from vault to client
-  #out_transform do
-  #end
-
-end
-$ # now edit the pipeline
-$ cat pipelines/hr_import_pipeline.rb 
-class HrImportPipeline < RubySync::Pipelines::BasePipeline
-
-  client :hr
-
-  vault :kaos_vault
-
-  # Remove any fields that you don't want to set in the client from the vault
-  allow_out :id, :first_name, :last_name
-
-  # Remove any fields that you don't want to set in the vault from the client
-  allow_in :id, :first_name, :last_name
-
-  # 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:
-  # 'id', 'first_name', 'last_name', 'skills'
-  map_vault_to_client({
-    #'allow' => 'a_client_field',
-                #'these' => 'a_client_field',
-                #'fields' => 'a_client_field',
-                #'through' => 'a_client_field'
-  })
-
-  # "in" means going from client to vault
-  #in_transform do
-  #end
-
-  # "out" means going from vault to client
-  #out_transform do
-  #end
-
-end
-$ # so all we've done specified which fields to allow in an out. Notice that we left "skills" out.
-$ # also note that we're exporting as well as importing for now
-$ # so now we can run our sync      
-$ rubysync once hr_import
-$ # oops. Forgot to give it any data
-$ # notice, though how it created the import and export directories for us.
-$ cd ../in
-$ # lets make some henchmen
-$ cat > henchmen.csv
-bobby,BareKnuckle,Bobby,pugilism:yoga
-tt,Testy,Terry,kidnapping:interrogation:juggling
-$ ls -l
-total 8
--rw-r--r--   1 ritchiey  ritchiey  87 Aug 21 17:11 henchmen.csv
-$ # we need to run rubysync from within the configuration directory
-$ cd ../kaos/
-$ rubysync once hr_import
-$ ls -l ../in
-total 8
--rw-r--r--   1 ritchiey  ritchiey  87 Aug 21 17:11 henchmen.csv.bak
-$ # note that the csv has been renamed
-$ # lets have a look at the xml file thats been created
-$ cat ../kaos.xml
-<opt>
-  <tt>
-    <id>tt</id>
-    <first_name>Testy</first_name>
-    <last_name>Terry</last_name>
-  </tt>
-  <bobby>
-    <id>bobby</id>
-    <first_name>BareKnuckle</first_name>
-    <last_name>Bobby</last_name>
-  </bobby>
-</opt>
-$ # ok, great. We've got a couple of records in there. 
-$ # remember that we also configured an output directory
-$ ls -l ../out
-$ # no output. ok what if we modify the vault itself
-$ cat ../kaos.xml 
-<opt>
-  <tt>
-    <id>tt</id>
-    <first_name>Testy</first_name>
-    <last_name>Terry</last_name>
-  </tt>
-  <bobby>
-    <id>bobby</id>
-    <first_name>BareKnuckle</first_name>
-    <last_name>Bobby</last_name>
-  </bobby>
-  <desd>
-    <id>desd</id>
-    <first_name>Dangerous</first_name>
-    <last_name>Des</last_name>
-  </desd>
-</opt>
-$ # and run it again
-$ rubysync once hr_import
-$ ls -l ../out
-total 8
--rw-r--r--   1 ritchiey  ritchiey  20 Aug 21 17:25 20070821172521.csv
-$ cat ../out/20070821172521.csv 
-desd,Dangerous,Des,
-$ # So it just sends through the changes to the file 
-$ # How's it doingr

data/examples/ar_client_webapp/README

@@ -1,182 +0,0 @@
-== Welcome to Rails
-
-Rails is a web-application and persistence framework that includes everything
-needed to create database-backed web-applications according to the
-Model-View-Control pattern of separation. This pattern splits the view (also
-called the presentation) into "dumb" templates that are primarily responsible
-for inserting pre-built data in between HTML tags. The model contains the
-"smart" domain objects (such as Account, Product, Person, Post) that holds all
-the business logic and knows how to persist themselves to a database. The
-controller handles the incoming requests (such as Save New Account, Update
-Product, Show Post) by manipulating the model and directing data to the view.
-
-In Rails, the model is handled by what's called an object-relational mapping
-layer entitled Active Record. This layer allows you to present the data from
-database rows as objects and embellish these data objects with business logic
-methods. You can read more about Active Record in
-link:files/vendor/rails/activerecord/README.html.
-
-The controller and view are handled by the Action Pack, which handles both
-layers by its two parts: Action View and Action Controller. These two layers
-are bundled in a single package due to their heavy interdependence. This is
-unlike the relationship between the Active Record and Action Pack that is much
-more separate. Each of these packages can be used independently outside of
-Rails.  You can read more about Action Pack in
-link:files/vendor/rails/actionpack/README.html.
-
-
-== Getting started
-
-1. At the command prompt, start a new rails application using the rails command
-   and your application name. Ex: rails myapp
-   (If you've downloaded rails in a complete tgz or zip, this step is already done)
-2. Change directory into myapp and start the web server: <tt>script/server</tt> (run with --help for options)
-3. Go to http://localhost:3000/ and get "Welcome aboard: You’re riding the Rails!"
-4. Follow the guidelines to start developing your application
-
-
-== Web Servers
-
-By default, Rails will try to use Mongrel and lighttpd if they are installed, otherwise
-Rails will use the WEBrick, the webserver that ships with Ruby. When you run script/server,
-Rails will check if Mongrel exists, then lighttpd and finally fall back to WEBrick. This ensures
-that you can always get up and running quickly.
-
-Mongrel is a Ruby-based webserver with a C-component (which requires compilation) that is
-suitable for development and deployment of Rails applications. If you have Ruby Gems installed,
-getting up and running with mongrel is as easy as: <tt>gem install mongrel</tt>.
-More info at: http://mongrel.rubyforge.org
-
-If Mongrel is not installed, Rails will look for lighttpd. It's considerably faster than
-Mongrel and WEBrick and also suited for production use, but requires additional
-installation and currently only works well on OS X/Unix (Windows users are encouraged
-to start with Mongrel). We recommend version 1.4.11 and higher. You can download it from
-http://www.lighttpd.net.
-
-And finally, if neither Mongrel or lighttpd are installed, Rails will use the built-in Ruby
-web server, WEBrick. WEBrick is a small Ruby web server suitable for development, but not
-for production.
-
-But of course its also possible to run Rails on any platform that supports FCGI.
-Apache, LiteSpeed, IIS are just a few. For more information on FCGI,
-please visit: http://wiki.rubyonrails.com/rails/pages/FastCGI
-
-
-== Debugging Rails
-
-Have "tail -f" commands running on the server.log and development.log. Rails will
-automatically display debugging and runtime information to these files. Debugging
-info will also be shown in the browser on requests from 127.0.0.1.
-
-
-== Breakpoints
-
-Breakpoint support is available through the script/breakpointer client. This
-means that you can break out of execution at any point in the code, investigate
-and change the model, AND then resume execution! Example:
-
-  class WeblogController < ActionController::Base
-    def index
-      @posts = Post.find(:all)
-      breakpoint "Breaking out from the list"
-    end
-  end
-
-So the controller will accept the action, run the first line, then present you
-with a IRB prompt in the breakpointer window. Here you can do things like:
-
-Executing breakpoint "Breaking out from the list" at .../webrick_server.rb:16 in 'breakpoint'
-
-  >> @posts.inspect
-  => "[#<Post:0x14a6be8 @attributes={\"title\"=>nil, \"body\"=>nil, \"id\"=>\"1\"}>,
-       #<Post:0x14a6620 @attributes={\"title\"=>\"Rails you know!\", \"body\"=>\"Only ten..\", \"id\"=>\"2\"}>]"
-  >> @posts.first.title = "hello from a breakpoint"
-  => "hello from a breakpoint"
-
-...and even better is that you can examine how your runtime objects actually work:
-
-  >> f = @posts.first
-  => #<Post:0x13630c4 @attributes={"title"=>nil, "body"=>nil, "id"=>"1"}>
-  >> f.
-  Display all 152 possibilities? (y or n)
-
-Finally, when you're ready to resume execution, you press CTRL-D
-
-
-== Console
-
-You can interact with the domain model by starting the console through <tt>script/console</tt>.
-Here you'll have all parts of the application configured, just like it is when the
-application is running. You can inspect domain models, change values, and save to the
-database. Starting the script without arguments will launch it in the development environment.
-Passing an argument will specify a different environment, like <tt>script/console production</tt>.
-
-To reload your controllers and models after launching the console run <tt>reload!</tt>
-
-To reload your controllers and models after launching the console run <tt>reload!</tt>
-
-
-
-== Description of contents
-
-app
-  Holds all the code that's specific to this particular application.
-
-app/controllers
-  Holds controllers that should be named like weblogs_controller.rb for
-  automated URL mapping. All controllers should descend from ApplicationController
-  which itself descends from ActionController::Base.
-
-app/models
-  Holds models that should be named like post.rb.
-  Most models will descend from ActiveRecord::Base.
-
-app/views
-  Holds the template files for the view that should be named like
-  weblogs/index.rhtml for the WeblogsController#index action. All views use eRuby
-  syntax.
-
-app/views/layouts
-  Holds the template files for layouts to be used with views. This models the common
-  header/footer method of wrapping views. In your views, define a layout using the
-  <tt>layout :default</tt> and create a file named default.rhtml. Inside default.rhtml,
-  call <% yield %> to render the view using this layout.
-
-app/helpers
-  Holds view helpers that should be named like weblogs_helper.rb. These are generated
-  for you automatically when using script/generate for controllers. Helpers can be used to
-  wrap functionality for your views into methods.
-
-config
-  Configuration files for the Rails environment, the routing map, the database, and other dependencies.
-
-components
-  Self-contained mini-applications that can bundle together controllers, models, and views.
-
-db
-  Contains the database schema in schema.rb.  db/migrate contains all
-  the sequence of Migrations for your schema.
-
-doc
-  This directory is where your application documentation will be stored when generated
-  using <tt>rake doc:app</tt>
-
-lib
-  Application specific libraries. Basically, any kind of custom code that doesn't
-  belong under controllers, models, or helpers. This directory is in the load path.
-
-public
-  The directory available for the web server. Contains subdirectories for images, stylesheets,
-  and javascripts. Also contains the dispatchers and the default HTML files. This should be
-  set as the DOCUMENT_ROOT of your web server.
-
-script
-  Helper scripts for automation and generation.
-
-test
-  Unit and functional tests along with fixtures. When using the script/generate scripts, template
-  test files will be generated for you and placed in this directory.
-
-vendor
-  External libraries that the application depends on. Also includes the plugins subdirectory.
-  This directory is in the load path.

data/examples/ar_client_webapp/Rakefile

@@ -1,10 +0,0 @@
-# Add your own tasks in files placed in lib/tasks ending in .rake,
-# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
-
-require(File.join(File.dirname(__FILE__), 'config', 'boot'))
-
-require 'rake'
-require 'rake/testtask'
-require 'rake/rdoctask'
-
-require 'tasks/rails'

data/examples/ar_client_webapp/app/controllers/application.rb

@@ -1,7 +0,0 @@
-# Filters added to this controller apply to all controllers in the application.
-# Likewise, all the methods added will be available for all controllers.
-
-class ApplicationController < ActionController::Base
-  # Pick a unique cookie name to distinguish our session data from others'
-  session :session_key => '_ar_client_webapp_session_id'
-end

data/examples/ar_client_webapp/app/controllers/user_controller.rb

@@ -1,5 +0,0 @@
-class UserController < ApplicationController
-  
-  scaffold 'User'
-  
-end

data/examples/ar_client_webapp/app/helpers/application_helper.rb

@@ -1,3 +0,0 @@
-# Methods added to this helper will be available to all templates in the application.
-module ApplicationHelper
-end

data/examples/ar_client_webapp/app/helpers/user_helper.rb

@@ -1,2 +0,0 @@
-module UserHelper
-end

data/examples/ar_client_webapp/app/models/user.rb

@@ -1,2 +0,0 @@
-class User < ActiveRecord::Base
-end

data/examples/ar_client_webapp/config/boot.rb

@@ -1,45 +0,0 @@
-# Don't change this file. Configuration is done in config/environment.rb and config/environments/*.rb
-
-unless defined?(RAILS_ROOT)
-  root_path = File.join(File.dirname(__FILE__), '..')
-
-  unless RUBY_PLATFORM =~ /(:?mswin|mingw)/
-    require 'pathname'
-    root_path = Pathname.new(root_path).cleanpath(true).to_s
-  end
-
-  RAILS_ROOT = root_path
-end
-
-unless defined?(Rails::Initializer)
-  if File.directory?("#{RAILS_ROOT}/vendor/rails")
-    require "#{RAILS_ROOT}/vendor/rails/railties/lib/initializer"
-  else
-    require 'rubygems'
-
-    environment_without_comments = IO.readlines(File.dirname(__FILE__) + '/environment.rb').reject { |l| l =~ /^#/ }.join
-    environment_without_comments =~ /[^#]RAILS_GEM_VERSION = '([\d.]+)'/
-    rails_gem_version = $1
-
-    if version = defined?(RAILS_GEM_VERSION) ? RAILS_GEM_VERSION : rails_gem_version
-      # Asking for 1.1.6 will give you 1.1.6.5206, if available -- makes it easier to use beta gems
-      rails_gem = Gem.cache.search('rails', "~>#{version}.0").sort_by { |g| g.version.version }.last
-
-      if rails_gem
-        gem "rails", "=#{rails_gem.version.version}"
-        require rails_gem.full_gem_path + '/lib/initializer'
-      else
-        STDERR.puts %(Cannot find gem for Rails ~>#{version}.0:
-    Install the missing gem with 'gem install -v=#{version} rails', or
-    change environment.rb to define RAILS_GEM_VERSION with your desired version.
-  )
-        exit 1
-      end
-    else
-      gem "rails"
-      require 'initializer'
-    end
-  end
-
-  Rails::Initializer.run(:set_load_path)
-end

data/examples/ar_client_webapp/config/database.yml

@@ -1,36 +0,0 @@
-# MySQL (default setup).  Versions 4.1 and 5.0 are recommended.
-#
-# Install the MySQL driver:
-#   gem install mysql
-# On MacOS X:
-#   gem install mysql -- --include=/usr/local/lib
-# On Windows:
-#   gem install mysql
-#       Choose the win32 build.
-#       Install MySQL and put its /bin directory on your path.
-#
-# And be sure to use new-style password hashing:
-#   http://dev.mysql.com/doc/refman/5.0/en/old-client.html
-development:
-  adapter: mysql
-  database: ar_client_webapp_development
-  username: root
-  password:
-  socket: /tmp/mysql.sock
-
-# Warning: The database defined as 'test' will be erased and
-# re-generated from your development database when you run 'rake'.
-# Do not set this db to the same as development or production.
-test:
-  adapter: mysql
-  database: ar_client_webapp_test
-  username: root
-  password:
-  socket: /tmp/mysql.sock
-
-production:
-  adapter: mysql
-  database: ar_client_webapp_production
-  username: root
-  password: 
-  socket: /tmp/mysql.sock

data/examples/ar_client_webapp/config/environment.rb

@@ -1,60 +0,0 @@
-# Be sure to restart your web server when you modify this file.
-
-# Uncomment below to force Rails into production mode when 
-# you don't control web/app server and can't set it the proper way
-# ENV['RAILS_ENV'] ||= 'production'
-
-# Specifies gem version of Rails to use when vendor/rails is not present
-RAILS_GEM_VERSION = '1.2.3' unless defined? RAILS_GEM_VERSION
-
-# Bootstrap the Rails environment, frameworks, and default configuration
-require File.join(File.dirname(__FILE__), 'boot')
-
-Rails::Initializer.run do |config|
-  # Settings in config/environments/* take precedence over those specified here
-  
-  # Skip frameworks you're not going to use (only works if using vendor/rails)
-  # config.frameworks -= [ :action_web_service, :action_mailer ]
-
-  # Only load the plugins named here, by default all plugins in vendor/plugins are loaded
-  # config.plugins = %W( exception_notification ssl_requirement )
-
-  # Add additional load paths for your own custom dirs
-  # config.load_paths += %W( #{RAILS_ROOT}/extras )
-
-  # Force all environments to use the same logger level 
-  # (by default production uses :info, the others :debug)
-  # config.log_level = :debug
-
-  # Use the database for sessions instead of the file system
-  # (create the session table with 'rake db:sessions:create')
-  # config.action_controller.session_store = :active_record_store
-
-  # Use SQL instead of Active Record's schema dumper when creating the test database.
-  # This is necessary if your schema can't be completely dumped by the schema dumper, 
-  # like if you have constraints or database-specific column types
-  # config.active_record.schema_format = :sql
-
-  # Activate observers that should always be running
-  # config.active_record.observers = :cacher, :garbage_collector
-
-  # Make Active Record use UTC-base instead of local time
-  # config.active_record.default_timezone = :utc
-  
-  # See Rails::Configuration for more options
-end
-
-# Add new inflection rules using the following format 
-# (all these examples are active by default):
-# Inflector.inflections do |inflect|
-#   inflect.plural /^(ox)$/i, '\1en'
-#   inflect.singular /^(ox)en/i, '\1'
-#   inflect.irregular 'person', 'people'
-#   inflect.uncountable %w( fish sheep )
-# end
-
-# Add new mime types for use in respond_to blocks:
-# Mime::Type.register "text/richtext", :rtf
-# Mime::Type.register "application/x-mobile", :mobile
-
-# Include your application configuration below

data/examples/ar_client_webapp/config/environments/development.rb

@@ -1,21 +0,0 @@
-# Settings specified here will take precedence over those in config/environment.rb
-
-# In the development environment your application's code is reloaded on
-# every request.  This slows down response time but is perfect for development
-# since you don't have to restart the webserver when you make code changes.
-config.cache_classes = false
-
-# Log error messages when you accidentally call methods on nil.
-config.whiny_nils = true
-
-# Enable the breakpoint server that script/breakpointer connects to
-config.breakpoint_server = true
-
-# Show full error reports and disable caching
-config.action_controller.consider_all_requests_local = true
-config.action_controller.perform_caching             = false
-config.action_view.cache_template_extensions         = false
-config.action_view.debug_rjs                         = true
-
-# Don't care if the mailer can't send
-config.action_mailer.raise_delivery_errors = false

data/examples/ar_client_webapp/config/environments/production.rb

@@ -1,18 +0,0 @@
-# Settings specified here will take precedence over those in config/environment.rb
-
-# The production environment is meant for finished, "live" apps.
-# Code is not reloaded between requests
-config.cache_classes = true
-
-# Use a different logger for distributed setups
-# config.logger = SyslogLogger.new
-
-# Full error reports are disabled and caching is turned on
-config.action_controller.consider_all_requests_local = false
-config.action_controller.perform_caching             = true
-
-# Enable serving of images, stylesheets, and javascripts from an asset server
-# config.action_controller.asset_host                  = "http://assets.example.com"
-
-# Disable delivery errors, bad email addresses will be ignored
-# config.action_mailer.raise_delivery_errors = false

data/examples/ar_client_webapp/config/environments/test.rb

@@ -1,19 +0,0 @@
-# Settings specified here will take precedence over those in config/environment.rb
-
-# The test environment is used exclusively to run your application's
-# test suite.  You never need to work with it otherwise.  Remember that
-# your test database is "scratch space" for the test suite and is wiped
-# and recreated between test runs.  Don't rely on the data there!
-config.cache_classes = true
-
-# Log error messages when you accidentally call methods on nil.
-config.whiny_nils = true
-
-# Show full error reports and disable caching
-config.action_controller.consider_all_requests_local = true
-config.action_controller.perform_caching             = false
-
-# Tell ActionMailer not to deliver emails to the real world.
-# The :test delivery method accumulates sent emails in the
-# ActionMailer::Base.deliveries array.
-config.action_mailer.delivery_method = :test

data/examples/ar_client_webapp/config/routes.rb

@@ -1,23 +0,0 @@
-ActionController::Routing::Routes.draw do |map|
-  # The priority is based upon order of creation: first created -> highest priority.
-  
-  # Sample of regular route:
-  # map.connect 'products/:id', :controller => 'catalog', :action => 'view'
-  # Keep in mind you can assign values other than :controller and :action
-
-  # Sample of named route:
-  # map.purchase 'products/:id/purchase', :controller => 'catalog', :action => 'purchase'
-  # This route can be invoked with purchase_url(:id => product.id)
-
-  # You can have the root of your site routed by hooking up '' 
-  # -- just remember to delete public/index.html.
-  # map.connect '', :controller => "welcome"
-
-  # Allow downloading Web Service WSDL as a file with an extension
-  # instead of a file named 'wsdl'
-  map.connect ':controller/service.wsdl', :action => 'wsdl'
-
-  # Install the default route as the lowest priority.
-  map.connect ':controller/:action/:id.:format'
-  map.connect ':controller/:action/:id'
-end

data/examples/ar_client_webapp/db/migrate/001_create_users.rb

@@ -1,13 +0,0 @@
-class CreateUsers < ActiveRecord::Migration
-  def self.up
-    create_table :users do |t|
-      t.column :username, :string
-      t.column :name, :string
-      t.column :email, :string
-    end
-  end
-
-  def self.down
-    drop_table :users
-  end
-end