menu-motion 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 934a02195b3c68b51b5bcfdf5f0907d7d3717995
+  data.tar.gz: 5f6f318336f94e483f9cc58d2d7c17f1e42583f6
+SHA512:
+  metadata.gz: 833c111856c289a0c5b3d977640e3d65cb92b9d02daeb6385164349b79d03582b3925b3ad1ca19888579d38039db043bd2715b6bdeefc21d46449555e5630555
+  data.tar.gz: 815b050b4d22bbbda7601e30417897d897e75a268dd1235b03f6cde46ad4e1a773f0bfe47b5cc0088851d926fb9ee9c1d036f964c45e0fcd93b6293f2dc58adf

data/README.md

@@ -0,0 +1,185 @@
+# MenuMotion
+
+MenuMotion is a RubyMotion wrapper inspired by Formotion for creating OS X status bar menus with a syntax that should feel familiar if you've used Formotion.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem "menu-motion"
+```
+
+And then execute:
+
+```sh
+$ bundle
+```
+
+Or install it yourself as:
+
+```sh
+$ gem install menu-motion
+```
+
+## Usage
+
+Here's an awesome graphic of a menu:
+
+```
+|‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾|
+| [icon] First Item > |‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾|
+|---------------------| First Subitem > |‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾|
+| About MenuMotion    |-----------------| First Action  |
+| Quit                | Some Action     | Second Action |
+|_____________________|_________________|_______________|
+```
+
+And the Ruby to generate this menu:
+
+```ruby
+menu = MenuMotion::Menu.new({
+  sections: [{
+    rows: [{
+      icon: "icon.png",
+      title: "First Item",
+      sections: [{
+        rows: [{
+          title: "First Subitem",
+          rows: [{
+            title: "First Action",
+            target: self,
+            action: "first_action"
+          }, {
+            title: "Second Action",
+            target: self,
+            action: "second_action"
+          }]
+        }]
+      }, {
+        rows: [{
+          title: "Some Action",
+          target: self,
+          action: "some_action"
+        }]
+      }]
+    }]
+  }, {
+    rows: [{
+      title: "About MenuMotion",
+      target: self,
+      action: "about"
+    }, {
+      title: "Quit",
+      target: self,
+      action: "quit"
+    }]
+  }]
+})
+```
+
+### Sections
+
+Sections are used to add dividers between sets of "rows" (menu items).
+
+```ruby
+menu = MenuMotion::Menu.new({
+  sections: [{
+    rows: []
+  }, {
+    rows: []
+  }
+})
+```
+
+### Submenus
+
+To link a menu item to a submenu, simply define sections
+or rows within the row item that should display the submenu.
+
+```ruby
+menu = MenuMotion::Menu.new({
+  rows: [{
+    title: "Menu item",
+    rows: [{
+      title: "Submenu item 1"
+    }, {
+      title: "Submenu item 2"
+    }]
+  }]
+})
+```
+
+### Actions
+
+Adding an action to a menu item is easy. Just define the
+target and action.
+
+```ruby
+menu = MenuMotion::Menu.new({
+  rows: [{
+    title: "Basic Action",
+    target: self,
+    action: "basic_action"
+  }, {
+    title: "Pass the menu item to the action",
+    target: self,
+    action: "action_with_sender:"
+  }]
+})
+
+def basic_action
+  puts "Hello World"
+end
+
+def action_with_sender(sender)
+  puts "Hello from #{sender}"
+end
+```
+
+### Updating Menu Items
+
+Assign keys to menu items that will need to be updated.
+
+```ruby
+menu = MenuMotion::Menu.new({
+  rows: [{
+    title: "Menu item",
+    key: :main_item
+    rows: [{
+      title: "Submenu item 1",
+      key: :submenu_item1,
+      target: self,
+      action: "do_something:"
+    }, {
+      title: "Submenu item 2",
+      key: :submenu_item2,
+      target: self,
+      action: "do_something:"
+    }]
+  }]
+})
+
+# Let's update the first item's title:
+menu.update(:main_item, {
+  title: "Hello World"
+})
+
+# And give the first submenu item a submenu.
+# The target and action will not be used if a submenu is defined.
+menu.update(:submenu_item1, {
+  rows: [{
+    title: "Click me",
+    target: self,
+    action: "clicked"
+  }]
+})
+```
+
+## 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

data/lib/menu_motion.rb

@@ -0,0 +1,10 @@
+# encoding: utf-8
+
+unless defined?(Motion::Project::Config)
+  raise "This file must be required within a RubyMotion project Rakefile."
+end
+
+lib_dir_path = File.dirname(File.expand_path(__FILE__))
+Motion::Project::App.setup do |app|
+  app.files.unshift(Dir.glob(File.join(lib_dir_path, "menu_motion/**/*.rb")))
+end

data/lib/menu_motion/menu.rb

@@ -0,0 +1,88 @@
+module MenuMotion
+
+  class Menu < NSMenu
+
+    attr_accessor :menu_items
+    attr_accessor :root_menu
+
+    def add_rows_to_menu(menu, rows)
+      rows.each do |row|
+        menu_item = NSMenuItem.alloc.initWithTitle(row[:title], action: row[:action], keyEquivalent:"")
+        menu_item.target = row[:target]
+
+        # Add sections and/or rows to a submenu
+        if row[:sections]
+          submenu = MenuMotion::Menu.new({
+            sections: row[:sections]
+          }, self.root_menu || self)
+          menu_item.setSubmenu(submenu)
+        elsif row[:rows]
+          submenu = MenuMotion::Menu.new({
+            rows: row[:rows]
+          }, self.root_menu || self)
+          menu_item.setSubmenu(submenu)
+        end
+
+        if row[:key]
+          if self.root_menu
+            self.root_menu.menu_items ||= {}
+            self.root_menu.menu_items[row[:key].to_sym] = WeakRef.new(menu_item)
+          else
+            self.menu_items ||= {}
+            self.menu_items[row[:key].to_sym] = WeakRef.new(menu_item)
+          end
+        end
+
+        menu.addItem(menu_item)
+      end
+    end
+
+    def add_sections_to_menu(menu, sections)
+      sections.each_with_index do |section, index|
+        if section[:rows]
+          if index > 0
+            # Add the separator before the new section,
+            # skipping the first section
+            menu.addItem(NSMenuItem.separatorItem)
+          end
+          add_rows_to_menu(menu, section[:rows])
+        end
+      end
+    end
+
+    def build_menu_from_params(menu, params)
+      if params[:sections]
+        add_sections_to_menu(menu, params[:sections])
+      elsif params[:rows]
+        add_rows_to_menu(menu, params[:rows])
+      end
+    end
+
+    def initialize(params = {}, root_menu = nil)
+      super()
+
+      self.root_menu = root_menu
+      self.build_menu_from_params(self, params)
+
+      self
+    end
+
+    def item_with_key(key)
+      @menu_items ||= {}
+      @menu_items[key.to_sym]
+    end
+
+    def update(key, params)
+      menu_item = self.item_with_key(key)
+
+      menu_item.title  = params[:title]  if params[:title]
+      menu_item.target = params[:target] if params[:target]
+      menu_item.action = params[:action] if params[:action]
+
+      self
+    end
+
+  end
+
+end
+

data/lib/menu_motion/version.rb

@@ -0,0 +1,3 @@
+module MenuMotion
+  VERSION = "0.0.2"
+end

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification
+name: menu-motion
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Brian Pattison
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-05-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: MenuMotion is a RubyMotion wrapper inspired by Formotion for creating
+  OS X status bar menus with a syntax that should feel familiar if you've used Formotion.
+email:
+- brian@brianpattison.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/menu_motion.rb
+- lib/menu_motion/menu.rb
+- lib/menu_motion/version.rb
+homepage: https://github.com/codelation/menu-motion
+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.2.2
+signing_key: 
+specification_version: 4
+summary: A RubyMotion wrapper for creating OS X status bar menus
+test_files: []
+has_rdoc: