sugarcube 3.0.8 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d1180cac9c7130d667692fac0aca24ab8ec5519e
-  data.tar.gz: 62a74a7e943af82a9824956e798b4a762d83d4c0
+  metadata.gz: 4a745c8ca1508da0db8c5282c8e467a95da3c764
+  data.tar.gz: 3dd4c5bdaf1344b81d1c530692213410c4336eae
 SHA512:
-  metadata.gz: 57df49d17693debd01a9837381892c9274245bb85ba25742c68b014e2a8ee1e84ca0f7d27d3959c19d5093d227fb07abb7dccd6c68fc17719bf0e2589612417f
-  data.tar.gz: 1edec4a066fa9bd9543cc61342bbcff2364c8cbca4afe593b1e15e59648f93c4c3f62e15620337e1ca93b8d7021a48c662879de1f212726afa82e7f5725323fe
+  metadata.gz: 2b708aa93d0816e2d7d49b0bc5855927492e59f98301d52ef4438200c6b31fd0ee3db126661d14c7785da237cd194636a963ee4d65b9d19e36c987a2489d2fca
+  data.tar.gz: 29df8410a6f249ada0716b5babbebadf1d94d575dc706cf4f9afa7b77b5b975adab882ff1e7096a5c2129cd650270eb3696e5a16f63fc98288e548fa4336c9a8

data/README.md

@@ -1585,8 +1585,7 @@ NSUserDefaults['test'] = test  # saved
 CoreGraphics
 --------------
 
-*This package is installed automatically, because so many other packages depend
-on it. It does not add any methods to built-in classes.*
+*This package is included by a few of the other packages, like repl, animations, and image.*
 
 ###### Is it `CGMakeRect` or `CGRectMake`?  What arguments does `CGRect.new` take?
 
@@ -1625,6 +1624,36 @@ f = Rect(p, [w, h])
 f = Rect([x, y], s)
 ```
 
+Base64
+------
+
+> `require 'sugarcube-base64'`
+
+**Todo: add UIImage/NSImage support**
+**Todo: add Android support?**
+
+Uses the `NSData#base64EncodedStringWithOptions` and
+`NSData#initWithBase64EncodedData` methods to encode/decode base64 data.  Normal
+use is to convert your image/binary data into an `NSData` instance, and then
+call `to_base64` on that object.
+
+There is a helper on `NSString`, so you can convert an `NSString` instance
+directly to base-64, using UTF8 encoding (or any encoding Apple supports).
+
+```ruby
+base64_str = 'test string'.to_base64
+...
+NSString.from_base64(base64_str) == 'test string'
+
+# require 'sugarcube-nsdata'
+image = 'some_image'.uiimage
+data = image.nsdata  # defaults to PNG data
+base64_str = data.to_base64
+...
+data = NSData.from_base64(base64_str)
+image = data.uiimage  # defaults to reading PNG data
+```
+
 Pointer
 -----
 

data/lib/cocoa/sugarcube-base64/nsdata.rb

@@ -0,0 +1,16 @@
+class NSData
+
+  # converts an NSData instance into a base64 string.
+  # @todo Support NSDataBase64EncodingOptions options - easy to add, but I want
+  # to add specs, too, and a hash format (e.g. line_length: 64 =>
+  # NSDataBase64Encoding64CharacterLineLength).
+  def to_base64
+    self.base64EncodedStringWithOptions(0)
+  end
+
+  # factory method to convert a base64 string into NSData.
+  def self.from_base64(base64_data)
+    NSData.alloc.initWithBase64EncodedData(base64_data, options: 0)
+  end
+
+end

data/lib/cocoa/sugarcube-base64/nsstring.rb

@@ -0,0 +1,20 @@
+class NSString
+
+  # converts an NSString instance into a base64 string, using UTF8 encoding or
+  # a user specified encoding.
+  # @todo Support NSDataBase64EncodingOptions options - easy to add, but I want
+  # to add specs, too, and a hash format (e.g. line_length: 64 =>
+  # NSDataBase64Encoding64CharacterLineLength).
+  def to_base64(enc=NSUTF8StringEncoding)
+    encoded = self.dataUsingEncoding(enc)
+    encoded.to_base64
+  end
+
+  # factory method to convert a base64 string into NSString, using UTF8 or a
+  # user specified encoding.
+  def self.from_base64(base64_str, enc=NSUTF8StringEncoding)
+    data = NSData.from_base64(base64_str.dataUsingEncoding(NSASCIIStringEncoding))
+    NSString.alloc.initWithData(data, encoding:enc)
+  end
+
+end

data/lib/ios/sugarcube-base64/uiimage.rb

@@ -0,0 +1,9 @@
+class UIImage
+
+  def to_base64
+  end
+
+  def self.from_base64
+  end
+
+end

data/lib/osx/sugarcube-base64/nsimage.rb

@@ -0,0 +1,9 @@
+class NSImage
+
+  def to_base64
+  end
+
+  def self.from_base64
+  end
+
+end

data/lib/sugarcube-base64.rb

@@ -0,0 +1,10 @@
+unless defined?(Motion::Project::Config)
+  raise "The sugarcube gem must be required within a RubyMotion project Rakefile."
+end
+
+
+require 'sugarcube'
+
+Motion::Project::App.pre_setup do |app|
+  SugarCube.add_app_files(app, 'sugarcube-base64')
+end

data/lib/version.rb

@@ -1,3 +1,3 @@
 module SugarCube
-  Version = '3.0.8'
+  Version = '3.1.0'
 end

data/spec/cocoa/base64_spec.rb

@@ -0,0 +1,41 @@
+describe 'Base64' do
+
+  describe 'NSData' do
+    it 'should encode data' do
+      str = 'testing'
+      str_data = str.nsdata
+      str_data.to_base64.should == 'dGVzdGluZw=='
+    end
+
+    it 'should decode data' do
+      str_data = NSData.from_base64('dGVzdGluZw==')
+      str = NSString.alloc.initWithData(str_data, encoding:NSUTF8StringEncoding)
+      str.should == 'testing'
+    end
+  end
+
+  describe 'NSString' do
+    it 'should encode data' do
+      'testing'.to_base64.should == 'dGVzdGluZw=='
+    end
+    it 'should encode data with encoding' do
+      'testing'.to_base64(NSUnicodeStringEncoding).should == '//50AGUAcwB0AGkAbgBnAA=='
+    end
+
+    it 'should decode data' do
+      NSString.from_base64('dGVzdGluZw==').should == 'testing'
+    end
+    it 'should decode data with encoding' do
+      NSString.from_base64('//50AGUAcwB0AGkAbgBnAA==', NSUnicodeStringEncoding).should == 'testing'
+    end
+  end
+
+  describe 'UIImage' do
+
+    it 'should convert image data (PNG) to base64' do
+      'test'.uiimage.nsdata.to_base64.should == 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAHgCAIAAADrGJBNAAAAAXNSR0IArs4c6QAAABxpRE9UAAAAAgAAAAAAAADwAAAAKAAAAPAAAADwAAAAS9r5uVEAAAAXSURBVEgNYrhrxMAwikfDYDQNDMk0AAAAAP//6TQa9AAAABVJREFUY7hrxMAwikfDYDQNDMk0AACNnfwwqs717AAAAABJRU5ErkJggg=='
+    end
+
+  end
+
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sugarcube
 version: !ruby/object:Gem::Version
-  version: 3.0.8
+  version: 3.1.0
 platform: ruby
 authors:
 - Colin T.A. Gray
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-01-23 00:00:00.000000000 Z
+date: 2015-01-25 00:00:00.000000000 Z
 dependencies: []
 description: |
   == Description
@@ -50,6 +50,8 @@ files:
 - lib/cocoa/sugarcube-anonymous/anonymous_array.rb
 - lib/cocoa/sugarcube-attributedstring/nsattributedstring.rb
 - lib/cocoa/sugarcube-awesome/awesome_exts.rb
+- lib/cocoa/sugarcube-base64/nsdata.rb
+- lib/cocoa/sugarcube-base64/nsstring.rb
 - lib/cocoa/sugarcube-corelocation/core_location.rb
 - lib/cocoa/sugarcube-files/nsarray.rb
 - lib/cocoa/sugarcube-files/nsdata.rb
@@ -98,6 +100,7 @@ files:
 - lib/ios/sugarcube-animations/animation_chain.rb
 - lib/ios/sugarcube-animations/uiview.rb
 - lib/ios/sugarcube-attributedstring/nsattributedstring.rb
+- lib/ios/sugarcube-base64/uiimage.rb
 - lib/ios/sugarcube-color/fixnum.rb
 - lib/ios/sugarcube-color/nsarray.rb
 - lib/ios/sugarcube-color/nsstring.rb
@@ -155,6 +158,7 @@ files:
 - lib/ios/sugarcube-ui/uiwebview.rb
 - lib/osx/sugarcube-animations/nsview.rb
 - lib/osx/sugarcube-attributedstring/nsattributedstring.rb
+- lib/osx/sugarcube-base64/nsimage.rb
 - lib/osx/sugarcube-color/fixnum.rb
 - lib/osx/sugarcube-color/nsarray.rb
 - lib/osx/sugarcube-color/nscolor.rb
@@ -181,6 +185,7 @@ files:
 - lib/sugarcube-appkit.rb
 - lib/sugarcube-attributedstring.rb
 - lib/sugarcube-awesome.rb
+- lib/sugarcube-base64.rb
 - lib/sugarcube-classic.rb
 - lib/sugarcube-color.rb
 - lib/sugarcube-common.rb
@@ -218,6 +223,7 @@ files:
 - README.md
 - spec/all/anonymous_spec.rb
 - spec/all/numeric_spec.rb
+- spec/cocoa/base64_spec.rb
 - spec/cocoa/caanimation_spec.rb
 - spec/cocoa/calayer_spec.rb
 - spec/cocoa/nsarray_files_spec.rb
@@ -318,6 +324,7 @@ summary: Extensions for Ruby to make Rubymotion development more enjoyable, and
 test_files:
 - spec/all/anonymous_spec.rb
 - spec/all/numeric_spec.rb
+- spec/cocoa/base64_spec.rb
 - spec/cocoa/caanimation_spec.rb
 - spec/cocoa/calayer_spec.rb
 - spec/cocoa/nsarray_files_spec.rb