ruby_sscanf 0.2.3 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a3637116ff8d600da08dc6dbdda7176f920e2b7c
-  data.tar.gz: 2f1d07cacd079a28c3d57e572e6f5d8392d5664f
+  metadata.gz: 39d5948584a8362aff629ef8e2e69d4e0ecf1db6
+  data.tar.gz: 34886c12fb70ee94405aa2bdbc1ee31effdb9aa2
 SHA512:
-  metadata.gz: 8e761ffadd60be04a4bfd62c96476a3bd2c7d06cd0f94aadf30b76ade72205617b3efa340c4dac26615fc82f290c200b70d13b4bb2d60a0a96a293511e7bc39e
-  data.tar.gz: 9473f807205c1539e1960a9c8b6bbeeaa367ec816c2edf358fa0bd10e02174677520fecc7d26764c3444d33f8250c774fe92c6c901b3324c35ff84a1b8eda4c2
+  metadata.gz: 8d35f7a9492d9560a62bdeb05aa271ea2925854d875f1cc0809c992bf7089a4c8744ca26434986e939e4b9d7bfd55b3d025d16fe1112c693bbf2599e54e913cf
+  data.tar.gz: cf7b631bb392d898cd3c737c52ea195720522cfe13b2ed28109557c24e37a2d46182a165702bad545c56d226442285efd151607ec0a7d500cf85ff582c6401cb

data/README.md

@@ -8,6 +8,7 @@ It is noteworthy that this gem never was intended to be 100% compatible with
 the built in scanf library. Some differences are:
 * It deals only with strings and not IO objects.
 * It adds formats for rational, complex, and quoted string data.
+* It adds formats with embedded regular expression specifications.
 * It adopts a more uniform approach to eating (or not eating) superfluous spaces.
 * Unsigned integer data are not allowed to be negative.
 
@@ -27,6 +28,8 @@ Or install it yourself as:
 
     $ gem install ruby_sscanf
 
+The ruby_sscanf gem itself is found at: ( https://rubygems.org/gems/ruby_sscanf )
+
 ## Usage
 
 The basic usage for sscanf is:
@@ -98,8 +101,10 @@ leading '0x' or '0X'.
 * [^chars] - Scan for a contiguous string of characters not in the set [^chars]
 * /regex/ - Scan for a string matching the regular expression. This may be
 followed by one or more optional flags. Supported flags are i, m, and x.
+Limitation: zero width (positive or negative) look behind assertions (?<= )
+and (?<! ) are not supported at this time.
 
-## Examples
+#### Examples
 Here are a few exmaples of the sscanf method in action.
 
 ```ruby
@@ -156,9 +161,12 @@ returns   ["a", "b", "c"]
 
 "a abbccc acbcad".sscanf "%/A/i %/a+b+c+/ %/([ab][cd])+/"
 returns   ["a", "abbccc", "acbcad"]
+
+" 1234i  ".sscanf(" %/\\d+/\\i")
+returns   ["1234"]
 ```
 
-## Getting unparsed text
+#### Getting unparsed text
 When a string is parsed, there may be some text at the end of the string that
 is not parsed. It is possible to retrieve this text using the following:
 
@@ -166,6 +174,13 @@ is not parsed. It is possible to retrieve this text using the following:
 String.sscanf_unparsed
 ```
 
+## Demo
+
+A test bed for experimenting with the ruby_sscanf gem is available as a rake
+task:
+
+    $ rake console
+
 ## Benchmarks
 
 I ran a test just to make sure that ruby_sscanf was not terribly
@@ -174,28 +189,28 @@ pleased to see that in fact ruby_sscanf was faster. Here are the results:
 
     Warming up --------------------------------------
     Scan strings with ruby_sscanf
-                             1.768k i/100ms
+                             1.734k i/100ms
     Scan strings with scanf
-                           310.000  i/100ms
+                           309.000  i/100ms
     Calculating -------------------------------------
     Scan strings with ruby_sscanf
-                             18.355k (± 5.8%) i/s -     91.936k
+                             17.926k (± 0.6%) i/s -     90.168k
     Scan strings with scanf
-                              3.145k (± 7.2%) i/s -     15.810k
+                              3.123k (± 0.6%) i/s -     15.759k
 
     Comparison:
-    Scan strings with ruby_sscanf:    18354.7 i/s
-    Scan strings with scanf:     3145.0 i/s - 5.84x slower
+    Scan strings with ruby_sscanf:    17925.7 i/s
+    Scan strings with scanf:     3123.0 i/s - 5.74x slower
 
 This benchmark test was run under:
 * ruby 2.1.6p336 (2015-04-13 revision 50298) [i386-mingw32]
-* format_engine version = 0.6.0
+* format_engine version = 0.7.2
 
 ## Contributing
 
 #### Plan A
 
-1. Fork it ( https://github.com/PeterCamilleri/format_engine/fork )
+1. Fork it ( https://github.com/PeterCamilleri/ruby_sscanf/fork )
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
@@ -204,8 +219,5 @@ This benchmark test was run under:
 #### Plan B
 
 Go to the GitHub repository and raise an issue calling attention to some
-aspect that could use some TLC or a suggestion or idea. Apply labels to
-the issue that match the point you are trying to make. Then follow your
-issue and keep up-to-date as it is worked on. Or not as pleases you.
-All input are greatly appreciated.
+aspect that could use some TLC or a suggestion or an idea.
 

data/irbt.rb

@@ -0,0 +1,18 @@
+# coding: utf-8
+# An IRB + ruby_sscanf test bed
+
+require 'irb'
+
+puts "Starting an IRB console with ruby_sscanf loaded."
+
+if ARGV[0] == 'local'
+  require_relative 'lib/ruby_sscanf'
+  puts "ruby_sscanf loaded locally: #{RubySscanf::VERSION}"
+
+  ARGV.shift
+else
+  require 'ruby_sscanf'
+  puts "ruby_sscanf loaded from gem: #{RubySscanf::VERSION}"
+end
+
+IRB.start

data/lib/ruby_sscanf/version.rb

@@ -1,5 +1,5 @@
 #The ruby_sscanf doesn't really live here.
 module RubySscanf
   #The gem's version.
-  VERSION = "0.2.3"
+  VERSION = "0.2.4"
 end

data/{Rakefile → rakefile.rb}

@@ -34,16 +34,9 @@ task :reek do |t|
   `reek --no-color lib > reek.txt`
 end
 
-desc "Run an IRB Session with format_engine loaded."
+desc "Fire up an IRB session with ruby_sscanf preloaded."
 task :console do
-  require 'irb'
-  require 'irb/completion'
-  require './lib/ruby_sscanf'
-  puts "Starting an IRB console with ruby_sscanf."
-  puts "Use 'quit' to exit."
-  puts
-  ARGV.clear
-  IRB.start
+  system "ruby irbt.rb local"
 end
 
 desc "What version of code is this?"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby_sscanf
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.4
 platform: ruby
 authors:
 - Peter Camilleri
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-03-23 00:00:00.000000000 Z
+date: 2016-08-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: format_engine
@@ -105,11 +105,12 @@ files:
 - Gemfile
 - LICENSE.txt
 - README.md
-- Rakefile
 - bench/bench.rb
+- irbt.rb
 - lib/ruby_sscanf.rb
 - lib/ruby_sscanf/engine.rb
 - lib/ruby_sscanf/version.rb
+- rakefile.rb
 - ruby_sscanf.gemspec
 - tests/scan_tests.rb
 homepage: http://teuthida-technologies.com/