flexirecord 0.0.6 → 1.0.0

data/CHANGELOG

@@ -41,3 +41,14 @@
   - >
     SELECT DISTINCT has been replaced by SELECT (ALL).
 
+- Release of version 0.0.6.
+
+- 2007-02-16:
+  - >
+    Added two documentation comments.
+
+- 2007-03-01:
+  - >
+    PostgreSQL's types 'date', 'timestamp' and 'timestamptz' now get converted to a ruby Time object, when being read from the database. Ruby Time objects get converted to the following string representation, when being written to the database: 'YYYY-MM-DD HH:MM:SS.uuuuuu+/-hh', where hh is the offset in hours from UTC. This string can be (implicitly or explicitly) type casted by PostgreSQL to a Date/Time type. 
+
+- Release of version 1.0.0.

data/lib/flexirecord.rb

@@ -18,13 +18,13 @@ require 'rational'
 #
 # -----
 #
-# FlexiRecord is a library for object oriented access to databases. Each table is represented by a class, each row of that table is represented by an object of that class. This library is especially aimed to properly support database transactions. By now only PostgreSQL (version 8.2 or higher!) is supported as a backend.
+# FlexiRecord is a ruby library providing object oriented access to databases (object-relational mapping). Each table is represented by a class, each row of that table is represented by an object of that class. This library is especially aimed to properly support database transactions. By now only PostgreSQL (version 8.2 or higher!) is supported as a backend.
 #
-# Please note that this is an alpha release. This means the library is mostly untested yet. Use it at your own risk.
+# Please mind that this is a beta release.
 #
 # To use FlexiRecord, you have to first create a new ConnectionPool with ConnectionPool.new. If all tables are stored on the same database, you can directly assign the ConnectionPool to the BaseRecord class, by calling:
 #
-# BaseRecord.connection_pool = ConnectionPool.new(...)
+# FlexiRecord::BaseRecord.connection_pool = FlexiRecord::ConnectionPool.new(...)
 #
 # You should also create sub-classes of BaseRecord, representing the tables of your database.
 #
@@ -1120,7 +1120,7 @@ module FlexiRecord
         end
       end
 
-      # TODO: write documentation
+      # Destroys the record in the database, by executing a DELETE command.
       def destroy
         if self.saved?
           self.class.db_execute('DELETE FROM ' << self.class.table <<
@@ -1271,6 +1271,12 @@ module FlexiRecord
         command_argument = command_arguments.shift
         if command_argument.kind_of? Rational
           command_argument = command_argument.to_f
+        elsif command_argument.kind_of? Time
+          time_offset_hours = command_argument.utc_offset / 3600
+          unless 3600 * time_offset_hours == command_argument.utc_offset
+            raise "Time zone offset is not an integer amount of hours."
+          end
+          command_argument = "%s.%06i%+03i" % [command_argument.strftime("%Y-%m-%d %H:%M:%S"), command_argument.usec, time_offset_hours]
         end
         PGconn.quote(command_argument) << $1
         # argument = command_arguments.shift
@@ -1297,14 +1303,14 @@ module FlexiRecord
                   nil
                 else
                   if @data_types
-                    case @data_types[backend_result.type(col)]
-                    when "bool"    then value_string[0, 1] == 't'
-                    when "int2"    then value_string.to_i
-                    when "int4"    then value_string.to_i
-                    when "int8"    then value_string.to_i
-                    when "text"    then value_string
-                    when "varchar" then value_string
-                    when "numeric" then
+                    data_type = @data_types[backend_result.type(col)]
+                    if data_type == "bool"
+                      value_string[0, 1] == 't'
+                    elsif ["int2", "int4", "int8"].include? data_type
+                      value_string.to_i
+                    elsif ["text", "varchar"].include? data_type
+                      value_string
+                    elsif data_type == "numeric"
                       unless value_string =~ /^([0-9]*)(\.([0-9]+)?)?$/
                         raise "Unexpected format for numeric data from database."
                       end
@@ -1313,6 +1319,21 @@ module FlexiRecord
                       else
                         $1.to_i
                       end
+                    elsif data_type == "date"
+                      unless value_string =~ /^([0-9]{4})-([0-9]{2})-([0-9]{2})$/
+                        raise "Unexpected format for date from database."
+                      end
+                      Time.local($1.to_i, $2.to_i, $3.to_i)
+                    elsif data_type == "timestamp"
+                      unless value_string =~ /^([0-9]{4})-([0-9]{2})-([0-9]{2}) ([0-9]{2}):([0-9]{2}):([0-9]{2})(\.([0-9]*))?$/
+                        raise "Unexpected format for timestamp without time zone from database."
+                      end
+                      Time.local($1.to_i, $2.to_i, $3.to_i, $4.to_i, $5.to_i, $6.to_i, $8.to_i)
+                    elsif data_type == "timestamptz"
+                      unless value_string =~ /^([0-9]{4})-([0-9]{2})-([0-9]{2}) ([0-9]{2}):([0-9]{2}):([0-9]{2})(\.([0-9]*))?([+-][0-9]{2})$/
+                        aise "Unexpected format for timestamp with time zone from database."
+                      end
+                      (Time.utc($1.to_i, $2.to_i, $3.to_i, $4.to_i, $5.to_i, $6.to_i, $8.to_i) - (3600 * $9.to_i)).localtime
                     else
                       value_string
                     end
@@ -1434,7 +1455,7 @@ module FlexiRecord
       end
     end
 
-    # TODO: write documentation
+    # Closes the connection. The connection object must not be used after it is closed.
     def close
       @backend_connection.close
       @backend_connection = nil

metadata

@@ -3,9 +3,9 @@ rubygems_version: 0.9.0
 specification_version: 1
 name: flexirecord
 version: !ruby/object:Gem::Version 
-  version: 0.0.6
-date: 2007-02-16 00:00:00 +00:00
-summary: Object-Oriented Database Access Library
+  version: 1.0.0
+date: 2007-03-02 00:00:00 +00:00
+summary: Object-Oriented Database Access Library (ORM layer)
 require_paths: 
 - lib/
 email: jan.behrens@flexiguided.de