attparser 1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7da2181748d2b153f2f668e93d938759b8a944d167f79a657c662370f3df3794
+  data.tar.gz: 518522c1bcbb049c8f801f67f7049df314b38ea9ff08fe91c49386f2c2f582a1
+SHA512:
+  metadata.gz: eb8eb8b5dc1455fa8411805f7efb89d94fc32c9deb737262168e3f4881b70b8e651abb69586b0e4604f50ac14d87b865c478382c4a4de15ac0515d31b5e9d3fd
+  data.tar.gz: d27989e050df57bcb24ba44a02f2f00104a3510a282df65a7e8c562c2c59ec796fd8ba59d2700d42c5442d6c93c0d3f23093c888d50677ae864ecaa269839aa1

data/README.md

@@ -0,0 +1,58 @@
+# AttParser
+
+AttParser parses a string like you might find in an HTML tag. Optionally, it will
+convert certain values into other classes like Integer or TrueClass.
+
+In its simplest use, give AttParser a string that is formatted like the
+attributes in HTML. Then run the string through `AttParser.parse()`. That method
+will return a hash.
+
+```ruby 
+raw = 'whatever="dude" ready YEAH=man'
+atts = AttParser.parse(raw)
+atts['whatever'] # => "dude"
+atts['ready']    # => nil
+atts['yeah']     # => "man"
+```
+
+The attribute names are downcased. Values quotes are returned as string. Values
+without spaces are returned as string. If an attribute does not have a value
+(i.e. there is no equals sign) then the value is `nil`.
+
+## Infer
+
+If you add the `infer` option then certain values are inferred as objects other
+than strings. NOTE: Only unquoted strings are inferred, never quoted strings.
+Quoted strings are always returned as strings.
+
+```ruby 
+raw = 'my-false=false my-true=true my-int=-2 my-float=3.4 my-nil=nil'
+atts = AttParser.parse(raw, 'infer'=>true)
+atts['my-false'].class  # => FalseClass
+atts['my-true'].class   # => TrueClass
+atts['my-int'].class    # => Integer
+atts['my-float'].class  # => Float
+atts['my-nil'].class    # => NilClass
+```
+
+## That's it
+
+That's what AttParser does. If you want to get more complex, it's probably best
+to use JSON.
+
+## Install
+
+```
+gem install attparser
+```
+
+## Author
+
+Mike O'Sullivan
+mike@idocs.com
+
+## History
+
+| version | date          | notes                                                 |
+|---------|---------------|-------------------------------------------------------|
+| 1.0     | June 18, 2020 | Initial upload.                                       |

data/lib/attparser.rb

@@ -0,0 +1,129 @@
+#===============================================================================
+# AttParser
+#
+module AttParser
+	# version
+	VERSION = '1.0'
+	
+	#---------------------------------------------------------------------------
+	# parse
+	#
+	def self.parse(raw, opts={})
+		# $tm.hrm
+		raw = raw.strip
+		state = 'none'
+		name = nil
+		val = nil
+		atts = {}
+		infer = opts['infer']
+		
+		# split
+		tokens = raw.split(/(\\")|(")|(\=)|(\s+)/mu)
+		tokens = tokens.grep(/./mu)
+		
+		# loop through tokens
+		tokens.each do |token|
+			# state: none
+			if state == 'none'
+				if token.match(/\S/mu)
+					name = token.downcase
+					val = nil
+					state = 'after-name'
+				end
+			
+			# state: after-name
+			elsif state == 'after-name'
+				if token.match(/./mu)
+					if token == '='
+						state = 'after-equals'
+					elsif token.match(/\S/mu)
+						atts[name] = nil
+						name = token
+						val = nil
+						state = 'after-name'
+					end
+				end
+			
+			# state: after-equals
+			elsif state == 'after-equals'
+				if token == '"'
+					val = ''
+					state = 'in-quote'
+				elsif token.match(/\S/mu)
+					atts[name] = self.infer(infer, token)
+					name = val = nil
+					state = 'none'
+				end
+			
+			# state: in-quote
+			elsif state == 'in-quote'
+				if token == '"'
+					atts[name] = val
+					name = val = nil
+					state = 'none'
+				elsif token == '\\"'
+					val += '"'
+				else
+					val += token
+				end
+			
+			# else unknown state
+			else
+				raise 'uknown-state: ' + state
+			end
+		end
+		
+		# if name, add to atts
+		if name
+			atts[name] = nil
+		end
+		
+		# return
+		return atts
+	end
+	#
+	# parse
+	#---------------------------------------------------------------------------
+	
+	
+	#---------------------------------------------------------------------------
+	# infer
+	#
+	def self.infer(infer, val)
+		# $tm.hrm
+		
+		# early exit: don't infer
+		infer or return val
+		
+		# true
+		if val.downcase == 'true'
+			return true
+		
+		# false
+		elsif val.downcase == 'false'
+			return false
+				
+		# null or nil
+		elsif (val.downcase == 'null') or (val.downcase == 'nil')
+			return nil
+			
+		# integer
+		elsif rv = Integer(val) rescue false
+			return rv
+		
+		# float
+		elsif rv = Float(val) rescue false
+			return rv
+			
+		# else return value as is
+		else
+			return val
+		end
+	end
+	#
+	# infer
+	#---------------------------------------------------------------------------
+end
+#
+# AttParser
+#===============================================================================

metadata

@@ -0,0 +1,45 @@
+--- !ruby/object:Gem::Specification
+name: attparser
+version: !ruby/object:Gem::Version
+  version: '1.0'
+platform: ruby
+authors:
+- Mike O'Sullivan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-06-18 00:00:00.000000000 Z
+dependencies: []
+description: Parse a string of attributes like you might find in an XML tag
+email: mike@idocs.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/attparser.rb
+homepage: https://rubygems.org/gems/attparser
+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.7.6
+signing_key: 
+specification_version: 4
+summary: Parse a string of attributes
+test_files: []