better_toolbar 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6d75afd49bb39c9b29f4e52ed42b8b27de23308d
-  data.tar.gz: f54a6a0133fa3a03f8fabbbe691152ccf807baef
+  metadata.gz: 2086594670a6ce1c7eda06198a5256b2ee7e0df4
+  data.tar.gz: 7861f94bbd8479fcbd33b4c639d512ada9adedec
 SHA512:
-  metadata.gz: 47c6b4774395d3721b71f374265e855ddf56152d02c7f35b6493fcd79038ef0421623cc5d5aaa04fa3623d8f3731304f9ba985d983adfbe29d3d2d09be500fc7
-  data.tar.gz: f332fdaa7e9e7fd9cfc8c0809046bf5f2ea41bdc323948a55d591f1bdd6f9c52fac21ad09ade1c8895fe4a953b1dc6a0b95a39d990dc280e38eef6bd26fd53d1
+  metadata.gz: 683365b451401de4057705b3d0c556e23f6d009596891e670305161b7219d6516bc9f989b4103e3525b33f9c6685f122663389b20b512c0fba04ab126d4d5e04
+  data.tar.gz: c009f94a248737b6d170113b29de8a565f07f7c840b155aa89e9038507f33db36569b44c72d79af1608b4a9458737590134b697f3282ab158a8217409557ed27

data/README.md

@@ -1,6 +1,6 @@
-# better_toolbar
+# BetterToolbar
 
-TODO: Write a gem description
+No Ruby developer likes all those crazy constants thay Apple makes us try and remember, and creating a toolbar is full of that, plus extra crazy stuff that is basically just left over from the history of iOS. BetterToolbar helps you create toolbars and toolbar items in a more Ruby-esque way.
 
 ## Installation
 
@@ -18,12 +18,37 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+In version 0.0.1, you can create a `UIBarButtonItem` using a nicer factory style (yes, factories make you think of Java, but the fact is factories are useful).
+
+```ruby
+toolbar = UIToolbar.new
+item = BetterToolbar::Item.create(title: "Item 1", target: the_target, action: 'method_on_the_target:')
+toolbar.setItems([item], animated: false)
+```
+
+In later versions, the plan is to have a nicer factory for a whole toolbar, but this works well for now. A preview is it might look something like this though.
+
+**NOT REAL CODE**
+
+```ruby
+toolbar = BetterToolbar.create({
+  target: self,
+  items: [
+    { title: "Item 1", action: "item_one_pressed:" },
+    { image: "sun", action: "sun_pressed:" },
+    :flexible_space,
+    { title: "Item 3", target: different_target, action: "some_action:" }
+  ]
+})
+```
+
+That looks much nicer than what it would usually take to make a toolbar, and that's where it would be nice to get to.
 
 ## 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
+3. Make sure your tests pass
+4. Commit your changes (`git commit -am 'Add some feature'`)
+5. Push to the branch (`git push origin my-new-feature`)
+6. Create new Pull Request

data/lib/better_toolbar/better_toolbar.rb

@@ -0,0 +1,14 @@
+module BetterToolbar
+  def self.create(options = {})
+    toolbar = UIToolbar.new
+    items = options.fetch(:items, []).map { |i| item_options_to_item(options.merge(i)) }
+    toolbar.setItems(items, animated: false)
+    toolbar
+  end
+
+  private
+
+  def self.item_options_to_item(item_options)
+    Item.create(item_options)
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: better_toolbar
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Jack Dean Watson-Hamblin
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-08-03 00:00:00.000000000 Z
+date: 2014-08-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -33,6 +33,7 @@ extra_rdoc_files: []
 files:
 - README.md
 - lib/better_toolbar.rb
+- lib/better_toolbar/better_toolbar.rb
 - lib/better_toolbar/item.rb
 homepage: https://github.com/FluffyJack/better_toolbar
 licenses: