ginjo-rfm 1.4.2 → 1.4.3

data/README.md

@@ -38,12 +38,12 @@ Rfm depends on Nokogiri gem, which installs executables requiring C compilation.
 
 Terminal:
 
-    bash
+    #bash
     gem install ginjo-rfm
 
 Once the gem is installed, you can use rfm in your ruby scripts by requiring it:
 
-    ruby
+    #ruby
     require 'rubygems'
     require 'rfm'
 
@@ -51,13 +51,14 @@ Once the gem is installed, you can use rfm in your ruby scripts by requiring it:
 
 In the Gemfile:
 
-    ruby
+    #ruby
     gem 'ginjo-rfm'
 
-### Edge
-
-#### ActiveModel support.
+### Edge - in an upcoming version of ginjo-rfm
 
+ActiveModel support.
+    
+    #ruby
     class Account < Rfm::Base
       config :layout=>'account_xml'
       before_create :encrypt_password
@@ -65,20 +66,19 @@ In the Gemfile:
       validates :username, :presence => true
       attr_accessor :password
     end
-
+    
     @account = Account.new(:username=>'bill', :password=>'pass')
     @account.email = 'my@email.com'
     @account.save!
     
-#### Multiple backend xml parsers. Using ActiveSupport::XmlMini to support Nokogiri, Libxml-ruby, Rexml.
+Multiple backend xml parsers. Uses ActiveSupport::XmlMini to support Nokogiri, Libxml-ruby, or Rexml.
 
 		Rfm::Server.new(:backend => :nokogiri)
-		
-		Rfm::Server.new(:backend => :rexml)
+    # Backend options => :libxml, :libxmlsax, :nokogiri, :nokogirisax, :rexml
     
 Try it out:
 
-    gemfile
+    #gemfile
     gem 'ginjo-rfm', :git=>'git://github.com/ginjo/rfm.git', :branch=>'edge'
     
 ## Connecting
@@ -86,7 +86,7 @@ Try it out:
 IMPORTANT:SSL and Certificate verification are on by default. Please see Server#new in rdocs for explanation and setup.
 You connect with the Rfm::Server object. This little buddy will be your window into FileMaker data.
 
-    ruby
+    #ruby
     require 'rfm'
 
     my_server = Rfm::Server.new(
@@ -98,7 +98,7 @@ You connect with the Rfm::Server object. This little buddy will be your window i
 
 if your web publishing engine runs on a port other than 80, you can provide the port number as well:
 
-    ruby
+    #ruby
     my_server = Rfm::Server.new(
       :host           => 'myservername',
       :account_name   => 'user',
@@ -112,44 +112,44 @@ if your web publishing engine runs on a port other than 80, you can provide the
 
 All access to data in FileMaker's XML interface is done through layouts, and layouts live in databases. The Rfm::Server object has a collection of databases called 'db'. So to get ahold of a database called "My Database", you can do this:
 
-    ruby
+    #ruby
     my_db = my_server.db["My Database"]
 
 As a convenience, you can do this too:
 
-    ruby
+    #ruby
     my_db = my_server["My Database"]
 
 Finally, if you want to introspect the server and find out what databases are available, you can do this:
 
-    ruby
+    #ruby
     all_dbs = my_server.db.all
 
 In any case, you get back Rfm::Database objects. A database object in turn has a property called "layout":
 
-    ruby
+    #ruby
     my_layout = my_db.layout["My Layout"]
 
 Again, for convenience:
 
-    ruby
+    #ruby
     my_layout = my_db["My Layout"]
 
 And to get them all:
 
-    ruby
+    #ruby
     all_layouts = my_db.layout.all
 
 Bringing it all together, you can do this to go straight from a server to a specific layout:
 
-    ruby
+    #ruby
     my_layout = my_server["My Database"]["My Layout"]
 
 ## Working with Layouts
 
 Once you have a layout object, you can start doing some real work. To get every record from the layout:
 
-    ruby
+    #ruby
     my_layout.all   # be careful with this
 
 To get a random record:
@@ -159,12 +159,12 @@ To get a random record:
 
 To find every record with "Arizona" in the "State" field:
 
-    ruby
+    #ruby
     my_layout.find({"State" => "Arizona"})
 
 To add a new record with my personal info:
 
-    ruby
+    #ruby
     my_layout.create({
       :first_name   => "Geoff",
       :last_name    => "Coffey",
@@ -175,19 +175,19 @@ Notice that in this case I used symbols instead of strings for the hash keys. Th
 
 To edit the record whos recid (filemaker internal record id) is 200:
 
-    ruby
+    #ruby
     my_layout.edit(200, {:first_name => 'Mamie'})
 
 Note: See the "Record Objects" section below for more on editing records.
 
 To delete the record whose recid is 200:
 
-    ruby
+    #ruby
     my_layout.delete(200)
 
 All of these methods return an Rfm::Result::ResultSet object (see below), and every one of them takes an optional parameter (the very last one) with additional options. For example, to find just a page full of records, you can do this:
 
-    ruby
+    #ruby
     my_layout.find({:state => "AZ"}, {:max_records => 10, :skip_records => 100})
 
 For a complete list of the available options, see the "expand_options" method in the Rfm::Server object in the file named rfm_command.rb.
@@ -199,19 +199,19 @@ Finally, if filemaker returns an error when executing any of these methods, an e
 
 Any method on the Layout object that returns data will return a ResultSet object. Rfm::Result::ResultSet is a subclass of Array, so first and foremost, you can use it like any other array:
 
-    ruby
+    #ruby
     my_result = my_layout.any
     my_result.size  # returns '1'
     my_result[0]    # returns the first record (an Rfm::Result::Record object)
 
 The ResultSet object also tells you information about the fields and portals in the result. ResultSet#fields and ResultSet#portals are both standard ruby hashes, with strings for keys. The fields hash has Rfm::Result::Field objects for values. The portals hash has another hash for its values. This nested hash is the fields on the portal. This would print out all the field names:
 
-    ruby
+    #ruby
     my_result.fields.each { |name, field| puts name }
 
 This would print out the tables each portal on the layout is associated with. Below each table name, and indented, it will print the names of all the fields on each portal.
 
-    ruby
+    #ruby
     my_result.portals.each { |table, fields|
       puts "table: #{table}"
       fields.each { |name, field| puts "\t#{name}"}
@@ -219,42 +219,42 @@ This would print out the tables each portal on the layout is associated with. Be
 
 But most importantly, the ResultSet contains record objects. Rfm::Result::Record is a subclass of Hash, so it can be used in many standard ways. This code would print the value in the 'first_name' field in the first record of the ResultSet:
 
-    ruby
+    #ruby
     my_record = my_result[0]
     puts my_record["first_name"]
 
 As a convenience, if your field names are valid ruby method names (ie, they don't have spaces or odd punctuation in them), you can do this instead:
 
-    ruby
+    #ruby
     puts my_record.first_name
 
 Since ResultSets are arrays and Records are hashes, you can take advantage of Ruby's wonderful expressiveness. For example, to get a comma-separated list of the full names of all the people in California, you could do this:
 
-    ruby
+    #ruby
     my_layout.find(:state => 'CA').collect {|rec| "#{rec.first_name} #{rec.last_name}"}.join(", ")
 
 Record objects can also be edited:
 
-    ruby
+    #ruby
     my_record.first_name = 'Isabel'
 
 Once you have made a series of edits, you can save them back to the database like this:
 
-    ruby
+    #ruby
     my_record.save
 
 The save operation causes the record to be reloaded from the database, so any changes that have been made outside your script will also be picked up after the save.
 
 If you want to detect concurrent modification, you can do this instead:
 
-    ruby
+    #ruby
     my_record.save_if_not_modified
 
 This version will refuse to update the database and raise an error if the record was modified after it was loaded but before it was saved.
 
 Record objects also have portals. While the portals in a ResultSet tell you about the tables and fields the portals show, the portals in a Record have the actual data. For example, if an Order record has Line Item records, you could do this:
 
-    ruby
+    #ruby
     my_order = order_layout.any[0]  # the [0] is important!
     my_lines = my_order.portals["Line Items"]
 
@@ -262,13 +262,13 @@ At the end of the previous block of code, my_lines is an array of Record objects
 
 NOTE: Fields on a portal have the table name and the "::" stripped off of their names if they belong to the table the portal is tied to. In other words, if our "Line Items" portal includes a quantity field and a price field, you would do this:
 
-    ruby
+    #ruby
     my_lines[0]["Quantity"]
     my_lines[0]["Price"]
 
 You would NOT do this:
 
-    ruby
+    #ruby
     my_lines[0]["Line Items::Quantity"]
     my_lines[0]["Line Items::Quantity"]
 
@@ -276,7 +276,7 @@ My feeling is that the table name is redundant and cumbersome if it is the same
 
 Again, you can string things together with Ruby. This will calculate the total dollar amount of the order:
 
-    ruby
+    #ruby
     total = 0.0
     my_order.portals["Line Items"].each {|line| total += line.quantity * line.price}
 
@@ -315,7 +315,7 @@ When this is 'true' your script will dump the actual response it got from FileMa
 
 So, for an annoying, but detailed load of output, make a connection like this:
 
-    ruby
+    #ruby
     my_server => Rfm::Server.new(
       :host             => 'myservername',
       :account_name     => 'user',

data/lib/rfm.rb

@@ -1,14 +1,23 @@
-path = File.expand_path(File.dirname(__FILE__))
-$:.unshift(path) unless $:.include?(path)
+# path = File.expand_path(File.dirname(__FILE__))
+# $:.unshift(path) unless $:.include?(path)
+# 
+# require path + '/rfm/utilities/case_insensitive_hash'
+# require path + '/rfm/utilities/factory'
+# require path + '/rfm/version.rb'
+
+Rfm = Module.new unless defined? Rfm
+Rfm::PATH = File.expand_path(File.dirname(__FILE__))
+$LOAD_PATH.unshift(Rfm::PATH) unless $LOAD_PATH.include?(Rfm::PATH)
+
+require 'rfm/utilities/case_insensitive_hash'
+require 'rfm/utilities/factory'
+require 'rfm/version.rb'
 
-require path + '/rfm/utilities/case_insensitive_hash'
-require path + '/rfm/utilities/factory'
-require path + '/rfm/version.rb'
 
 module Rfm
 
 	if $0.to_s.match(/irb|rails|bundle/) # was ENV['_']
-  	puts "Using gem ginjo-rfm version: #{VERSION}"
+  	puts "Using gem ginjo-rfm version: #{::Rfm::VERSION}"
   end
   
   class CommunicationError  < StandardError; end
@@ -29,4 +38,5 @@ module Rfm
 		autoload :ValueListItem, 'rfm/metadata/value_list_item'
 	end
 	  
-end
+end
+

data/lib/rfm/VERSION

@@ -0,0 +1 @@
+1.4.3

data/lib/rfm/version.rb

@@ -1,13 +1,13 @@
 module Rfm
-	VERSION_DEFAULT = '1.4.2.pre'
-	VERSION = File.read(File.join(File.expand_path(File.dirname(File.dirname(File.dirname(__FILE__)))), 'VERSION')) rescue VERSION_DEFAULT
-	# 		if File.exists?('../../VERSION')
-	# 			File.read('../../VERSION')
-	# 		else
-	#   		'1.4.2.pre'
-	# 		end
-  module Version # :nodoc: all
-    MAJOR, MINOR, PATCH, BUILD = VERSION.split('.')
-    NUMBERS = [ MAJOR, MINOR, PATCH, BUILD ]
+
+	VERSION_DEFAULT = 'none'
+	VERSION = File.read(PATH + '/rfm/VERSION').first.gsub(/\n|\r/,'')  rescue VERSION_DEFAULT #File.read(File.join(File.expand_path(File.dirname(File.dirname(File.dirname(__FILE__)))), 'VERSION')) rescue VERSION_DEFAULT
+  
+  VERSION.instance_eval do
+  	def components; VERSION.split('.'); end
+  	def major; components[0]; end
+  	def minor; components[1]; end
+  	def patch; components[2]; end
+  	def build; components[3]; end
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: ginjo-rfm
 version: !ruby/object:Gem::Version 
-  hash: 3
+  hash: 1
   prerelease: 
   segments: 
   - 1
   - 4
-  - 2
-  version: 1.4.2
+  - 3
+  version: 1.4.3
 platform: ruby
 authors: 
 - Geoff Coffey
@@ -19,7 +19,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-11-16 00:00:00 Z
+date: 2011-11-22 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: nokogiri
@@ -46,6 +46,7 @@ extra_rdoc_files:
 - README.md
 files: 
 - lib/rfm.rb
+- lib/rfm/VERSION
 - lib/rfm/database.rb
 - lib/rfm/error.rb
 - lib/rfm/layout.rb