parsed-attributes 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1aae2201346318b078febd33f14aa52f11935c7f
+  data.tar.gz: 0de771e1ba13bd77f0384210dd42ec67ac808c44
+SHA512:
+  metadata.gz: 4e486091e68ed956d73c7b9f3870c3cffffc526eb7e3b1a545341a8e6de8089b3271e530142124c1e0c93cde18d56ce9b9af3f38a39e990b8e499a94c83f9c4d
+  data.tar.gz: 79a766d510c8f3dbca9c78fc219fc9301413254f0ad2344d4d1c2e92e5b603aeea0021bccd10c865c297dab2cb9e657a1a3d55dbd050a2e2fdbe163729412f18

data/lib/parsed/base.rb

@@ -0,0 +1,87 @@
+module Parsed
+  module Base
+
+    ##
+    # Helper to define the raw methods
+    # ---
+    # Expects:
+    #  name (String):: Determines the method name.
+    #                  For example: 'yaml' will create the methods
+    #                   - #raw_yaml
+    #                   - #raw_yaml=
+    #
+    #                  And assumes the instance variables:
+    #                   - @raw_yaml
+    #                   - @parsed_yaml
+    def __define_parsed_attributes_raw_methods(name)
+      attr_reader "raw_#{name}"
+      
+      define_method "raw_#{name}=" do |raw|
+        self.instance_variable_set("@raw_#{name}", raw)
+        if self.instance_variable_defined?("@parsed_#{name}")
+          self.remove_instance_variable("@parsed_#{name}")
+        end
+      end
+    end
+
+    ##
+    # Helper to define the parsed method
+    # ---
+    # This handles the behavior around exceptions, and setting/removing the
+    # the instance variables.
+    #
+    # Expects:
+    #  name (String):: Determines the method name.
+    #                  For example: 'yaml' will create the method
+    #                   - #parsed_yaml
+    #
+    #                  And assumes the instance variables:
+    #                   - @raw_yaml
+    #                   - @parsed_yaml
+    #  options (acts like Hash):: Modifies the exception handling behavior
+    #                  raises_once (boolean):: Setting to true will raise on the first error.
+    #
+    #                                          This is mostly so that if you are catching and 
+    #                                          printing error messages they won't flood the
+    #                                          terminal.
+    #
+    #                                          This overrides the raises option
+    #
+    #                  raises(boolean):: Setting to true will raise on every error.
+    #
+    # This method accepts a block, which is passed the raw value, and is expected to return
+    # the parsed data.
+    def __define_parsed_attributes_parsed_methods(name, options={}, &parse_block)
+      parsed_varname = "@parsed_#{name}"
+
+      define_method "parsed_#{name}" do
+        if self.instance_variable_defined? parsed_varname
+          return self.instance_variable_get parsed_varname
+        end
+
+        unless parse_block.nil?
+          begin
+            parsed = parse_block.call self.instance_variable_get("@raw_#{name}")
+            self.instance_variable_set(parsed_varname, parsed)          
+          rescue StandardError => e
+            if options[:raise_once] == true
+              self.instance_variable_set(parsed_varname, nil)
+            end
+            raise e if options[:raise] == true || options[:raise_once] == true
+          end
+        end
+        
+        return self.instance_variable_get(parsed_varname)
+      end
+    end
+
+    ##
+    # Shortcut method for if the default behavior is desired.
+    # ---
+    # Refer to the documentation for the other methods
+    def __define_parsed_attributes_all_methods(name, options={}, &parse_block)
+      __define_parsed_attributes_raw_methods    name
+      __define_parsed_attributes_parsed_methods name, options, &parse_block
+    end
+  end
+end

data/lib/parsed/json.rb

@@ -0,0 +1,18 @@
+require_relative 'base'
+require 'json'
+
+module Parsed
+  module Json
+    include Parsed::Base
+
+    ##
+    # Defines an attribute pair to handle JSON encoded date
+    # ---
+    # Accepts default options, see Parsed::Base    
+    def json_attribute(name, options = {})      
+      __define_parsed_attributes_all_methods name, options do |raw_value|
+        JSON.parse raw_value
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: parsed-attributes
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Morgen Peschke
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-07-31 00:00:00.000000000 Z
+dependencies: []
+description: |2
+                    Helps with parsing data by creating paired
+                    attributes, a raw attribute, and a linked read-only
+                    parsed attribute. The parsed attribute auto-updates
+                    when the raw counterpart is updated.
+email: morgen.peschke@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/parsed/base.rb
+- lib/parsed/json.rb
+homepage: https://github.com/morgen-peschke/parsed-attributes
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Generates paired attributes that parse their contents.
+test_files: []