smg 0.0.1 → 0.0.2

data/README.rdoc

@@ -1,3 +1,70 @@
+== DESCRIPTION:
+
+XML to Object mapping library with simple declarative syntax.
+Backed by Nokogiri's SAX Parser.
+
+== FEATURES:
+
+* Typecasting
+* Nested resources (aka has_one)
+* Collections (aka has_many)
+
+== EXAMPLES:
+
+=== Twitter
+
+  class Status
+    include SMG::Resource
+
+    root 'status'
+
+    extract :id         , :class => :integer, :as => :status_id
+    extract :created_at , :class => :datetime
+    extract :text
+
+  end
+
+  class User
+    include SMG::Resource
+
+    root 'user'
+
+    extract :id                 , :class => :integer, :as => :twitter_id
+    extract :location           , :class => :string
+    extract :status             , :class => Status
+    extract :created_at         , :class => :datetime
+    extract :name
+    extract :screen_name
+
+  end
+
+=== discogs.com
+
+  class Label
+
+    class Release
+
+      include SMG::Resource
+
+      extract :release  , :at => :id, :as => :discogs_id, :class => :integer
+      extract :release  , :at => :status
+
+      root 'release'
+      extract :title
+      extract :catno
+      extract :artist
+
+    end
+
+    include SMG::Resource
+
+    root 'resp/label'
+    extract :name
+    extract :profile
+    collect 'releases/release'  , :as => :releases, :class => Release
+
+  end
+
 == REQUIREMENTS:
 
 nokogiri (>=1.3)
@@ -6,7 +73,7 @@ nokogiri (>=1.3)
 
 (The MIT License)
 
-Copyright (c) 2009
+Copyright (c) 2010
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/lib/smg/mapping.rb

@@ -13,9 +13,9 @@ module SMG #:nodoc:
     def attach_element(tag,options)
       chain = handle_path(tag)
       if options.key?(:at)
-        ele = Element.new(chain, options)
+        thing = Element.new(chain, options)
         @attributes[chain] ||= {}
-        @attributes[chain][ele.at] = ele
+        @attributes[chain][thing.at] = thing
       else
         @elements[chain] = Element.new(chain, options)
       end
@@ -27,8 +27,7 @@ module SMG #:nodoc:
     end
 
     def use_root(path)
-      raise "root already defined!" if @root
-      @root = normalize_path(path)
+      @root = normalize_path(path) # just a root tag for further definitions
     end
 
     private

data/lib/smg/mapping/element.rb

@@ -33,7 +33,7 @@ module SMG #:nodoc:
       def cast(value)
         @cast_to ? ::SMG::Mapping::TypeCasts[@cast_to, value] : value
       rescue
-        #TODO: report about malformed data
+        raise ArgumentError, "#{value.inspect} is not a valid source for #{@cast_to.inspect}"
       end
 
       def collection?

data/lib/smg/version.rb

@@ -1,5 +1,5 @@
 module SMG
-  VERSION = '0.0.1'
+  VERSION = '0.0.2'
 end
 
 # EOF

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 0
-  - 1
-  version: 0.0.1
+  - 2
+  version: 0.0.2
 platform: ruby
 authors: 
 - SSDany
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-04-16 00:00:00 +04:00
+date: 2010-04-17 00:00:00 +04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -30,7 +30,10 @@ dependencies:
         version: "1.3"
   type: :runtime
   version_requirements: *id001
-description: Simple declaratibve XML parsing library. Backed by Nokogiri
+description: |
+  Object to xml mapping library with simple declarative syntax.
+  Backed by Nokogiri's SAX Parser.
+
 email: inadsence@gmail.com
 executables: []