motion-strscan 0.5.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6ce76e9365737a21abf4825e2750832c950a6e8f
+  data.tar.gz: 9e8c604e70652a9886190f92548debf544a66778
+SHA512:
+  metadata.gz: e427425d5b1525c59ccbdc14a540c36f11f741991f5fe867cc5f9dc84a2004b17b2d8917f5fc1122278555d17e1a407017e30ce25f7dc2782a4b1d7fd7e69422
+  data.tar.gz: 867b7c8b34e89a51c54ed66a0696174f6f3e23f187e6549d0cccef4e797d98f486782435ed07b9f9436b8cd608a2f43bf76993a0e62a94c4934514086dad9b58

data/README.md

@@ -0,0 +1,63 @@
+# Implementation of Ruby `strscan` module
+
+This gems implements the `StringScanner` class from the `strscan.rb` Ruby standard library for use with RubyMotion.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'motion-strscan'
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install motion-strscan
+
+## Implementation details
+
+This is a pure Ruby implementation of `StringScanner` (no Cocoa apis), borrowed from the MacRuby project, with some minor modifications to handle multibyte strings correctly.
+
+**Note:**  While Ruby uses the Oniguruma regular expression library, RubyMotion uses the ICU library on iOS/OSX, and the Java library on Andriod.  There are minor differences, particularly in the handling of `^` 
+
+For example, ICU will match a `^` only at the beginning of the input, unless you add the `m` flag; then it will match the beginning of the line as well. In Oniguruma, `^` matches the beginning of the line by default.
+
+So if you're porting a Ruby libary that uses regular expressions, you need to be aware of these differences.
+
+### Supported Platforms
+
+Bot iOS and OS X are supported targets.  Will accept contibutions for Andriod support
+
+## Contributing
+
+1. Fork it
+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`
+5. Create new Pull Request
+
+## License
+
+The MIT License (MIT)
+
+Copyright (c) 2015 digitalMoksha
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/lib/motion-strscan/string.rb

@@ -0,0 +1,20 @@
+# Implementation of String#byteslice since RubyMotion (at least as of 3.6)
+# does not implement it.
+#------------------------------------------------------------------------------
+class String
+
+  # To get a byte range out of a possible multibyte string, force encoding to 
+  # ASCII-8BIT and use regular string slice, then restore the original encoding
+  #------------------------------------------------------------------------------
+  def byteslice(*args)
+    result = nil
+    begin
+      enc = self.encoding
+      self.force_encoding('ASCII-8BIT')
+      result = self.slice(*args)
+    ensure
+      self.force_encoding(enc)
+    end
+    result ? result.force_encoding(enc) : nil
+  end
+end