jqm_helper 0.1.1

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/Gemfile

@@ -0,0 +1,13 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+#  gem "shoulda", ">= 0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.6.4"
+  gem "rcov", ">= 0"
+end

data/Gemfile.lock

@@ -0,0 +1,18 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    git (1.2.5)
+    jeweler (1.6.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    rake (0.9.2.2)
+    rcov (0.9.11)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  jeweler (~> 1.6.4)
+  rcov

data/LICENSE.txt

@@ -0,0 +1,24 @@
+Copyright (c) 2011 Peter Ehrlich
+
+tl;dr: DIY!
+
+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/README.md

@@ -0,0 +1,123 @@
+= jqm_helper
+
+**ALPHA**
+
+A quick and dirty, but functional, collection of tools for speeding up development with jquery mobile.
+
+Enforces a number of sensible defaults, reducing iritable bugs.
+
+Includes view helpers and will soon include some handy javascript tools (such as for handling json data).
+
+
+## Install
+
+    gem install streama
+
+
+## Usage
+
+### buttons
+
+```ruby
+    jqm_button 'Open Refridgerator', open_fridge_path
+    # <a data-role="button" data-prefetch="true" href="/fridge/open">
+
+    back_button
+    # <a data-role="button" data-prefetch="true" data-rel="back" >
+
+    backwards_button('Close Refridgerator', close_fridge_path, {class: 'sears'})
+    # <a data-role="button" data-prefetch="true" href="/fridge/close" class="sears"
+         data-icon="arrow-l" data-direction="reverse">
+
+    forwards_button('Make Sandwitch', sandwitch_path, {data: {prefetch: false} })
+    # <a data-role="button" href="/sandwitch/make"
+             data-icon="arrow-r" data-iconpos="right">
+
+    # and even:
+    dialog_button 'rm -fr /', '/doom'
+    # <a data-role="button" data-prefetch="true" href="/doom"
+                data-rel="dialog" data-transition="slidedown">
+```
+
+Every method has optional arguments.  They can overwrite the sensible defaults.
+
+A very cool syntax can be used:
+
+```ruby
+    { data: { icon: 'star', prefetch: false } }
+    # typing that beats the pants off these keyboard gymnastics:
+    # { :'data-icon' => 'star, :'data-prefetch' => false }
+```
+
+### slider tag
+
+```ruby
+     def slider_tag(name, label)
+       raw %Q{
+      <div data-role="fieldcontain" style="border: 0; margin: 0; padding: 1em 0 0 0;">
+                  <label style="" for="#{name}">#{label}</label>
+                  <select name="#{name}" id="#{name}" data-role="slider">
+                    <option value="no">Off</option>
+                    <option value="yes">On</option>
+                  </select>
+                </div>
+      }
+     end
+```
+
+     This could be made more flexible
+
+### page builder
+
+```ruby
+    jqm_page 'discovery' do
+    # it generates:
+    # <div class="discovery_page" data-role="page" data-title="Discovery" id="discovery_page">
+    # <meta content="authenticity_token" name="csrf-param">
+    # <meta content="Oegb/DVSrtDYKJNdXtjQo63eGCBUwtpW83Bysz8h/nQ=" name="csrf-token">
+```
+
+
+### nav builder
+
+ - Adds class to active page
+ - Reverses animation direction as appropriate (very handy)
+
+```ruby
+    nav_for :discover do |n| # discover will be the active button
+      # any buttons before it will display the reverse animation, any after will be forwards
+      n.button('discover',
+                   {
+                           :href => discover_path,
+                           :data =>{
+                                   :icon => :search,
+                           }
+                   })
+    end
+
+    # <div data-role="controlgroup" data-type="horizontal" class="ui-corner-all ui-controlgroup ui-controlgroup-horizontal">
+    #  <a class="ui-btn-active" data-icon="search" data-prefetch="true" data-role="button" href="/discover">
+    #   Discover
+    #  </a>
+    # </div>
+```
+
+
+= Contributing
+
+
+Once you've made your great commits
+
+1. Fork
+1. Create a topic branch - git checkout -b my_branch
+1. Push to your branch - git push origin my_branch
+1. Create a Pull Request from your branch
+1. That's it!
+
+
+
+= Contributors
+
+Peter Ehrlich [http://www.twitter.com/ehrlicp](@ehrlicp)
+
+

data/Rakefile

@@ -0,0 +1,54 @@
+# encoding: utf-8
+# https://github.com/technicalpickles/jeweler
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "jqm_helper"
+  gem.homepage = "http://github.com/pehrlich/jqm_helper"
+  gem.license = "MIT"
+  gem.summary = %q{big conveniences for jquery mobile}
+  gem.description = %Q{helper methods for generating markup, soon: javascript helpers}
+  gem.email = "peter.i.ehrlich@gmail.com"
+  gem.authors = ["Peter Ehrlich"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+require 'rcov/rcovtask'
+Rcov::RcovTask.new do |test|
+  test.libs << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+  test.rcov_opts << '--exclude "gems/*"'
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "jqm_helper #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.1

data/jqm_helper.gemspec

@@ -0,0 +1,59 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "jqm_helper"
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Peter Ehrlich"]
+  s.date = "2011-12-22"
+  s.description = "helper methods for generating markup, soon: javascript helpers"
+  s.email = "peter.i.ehrlich@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    ".document",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "jqm_helper.gemspec",
+    "lib/jqm_helper.rb",
+    "lib/jqm_helper/nav_builder.rb",
+    "lib/jqm_helper/railtie.rb",
+    "lib/jqm_helper/tag_helpers.rb",
+    "test/helper.rb",
+    "test/test_jqm_helper.rb"
+  ]
+  s.homepage = "http://github.com/pehrlich/jqm_helper"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.13"
+  s.summary = "big conveniences for jquery mobile"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+    else
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+  end
+end
+

data/lib/jqm_helper/nav_builder.rb

@@ -0,0 +1,52 @@
+module JqmHelper
+
+  def nav_for(page, &block) # someday: options
+    builder = NavBuilder.new(page)
+    content_tag :div, capture(builder, &block), make_options({data: {role: 'controlgroup', type: 'horizontal'}}, {})
+  end
+
+
+  class NavBuilder
+    include JqmHelper # heh.. this is not circular.. how?
+    # someday: why don't these get included by including JqmHelper
+    include ActionView::Helpers::OutputSafetyHelper # raw include ActionView::Helpers::OutputSafetyHelper # raw
+    include ActionView::Helpers::TagHelper # content_tag
+
+    #include ActionView::Helpers::UrlHelper
+    #include ActionDispatch::Routing
+    # lib/jqm_helper.rb:23:in `<module:JqmHelper>': undefined method `routes' for nil:NilClass (NoMethodError)
+    #include Rails.application.routes.url_helpers
+
+
+    ACTIVE_CLASS = 'ui-btn-active'
+    cattr_accessor :reverse_animation_direction
+
+    def initialize(active_action = '')
+      self.reverse_animation_direction = true
+      @active_action = active_action.to_s
+      # someday: we may be able to replace with rails current_page helper
+    end
+
+    def button(action, options, title = nil)
+
+      if active = action.to_s == @active_action
+        self.reverse_animation_direction = false
+      end
+
+      defaults = {
+          :class => active ? ACTIVE_CLASS : '',
+          :data => {
+              :icon => action,
+          }
+      }
+
+      # commented from trouble including named routes =/
+      #defaults[:href] = method("#{action}_path").call unless options[:href] # incase method 404
+
+      defaults[:data][:direction] = 'reverse' if self.reverse_animation_direction
+
+      jqm_button(title || action.capitalize, '', make_options(defaults, options))
+    end
+  end
+
+end

data/lib/jqm_helper/railtie.rb

@@ -0,0 +1,8 @@
+module JqmHelper
+  class Railtie < Rails::Railtie
+    ActiveSupport.on_load(:action_view) do
+      include JqmHelper
+    end
+  end
+end
+

data/lib/jqm_helper/tag_helpers.rb

@@ -0,0 +1,122 @@
+module JqmHelper
+
+  def jqm_page(title, options = {}, &block)
+    defaults = {
+        :class => "#{title.downcase}_page",
+        :id => "#{title.downcase}_page",
+        :data => {
+            :role => 'page',
+            :title => title.capitalize,
+        }
+    }
+
+    script = ''
+
+    #session.delete('load_resource') { [] }.each do |name, resource|
+    #  o = {}
+    #  logger.warn "loading resource: #{name}, #{resource.last}. #{resource.first}"
+    #  o[name] = resource.first.where({_id: resource.last})
+    #  script << "window.load_resource(#{resource.to_json}');\n"
+    #end
+
+    # todo: assets version gemified
+    content_tag(:div, raw(%Q{
+                  <meta name="assets_version" content="#{1 || Brickbook::Application.config.assets.version}"/>
+                  #{csrf_meta_tags}
+                  <!--<script type='text/javascript'>#{script}</script>-->
+                  #{capture(&block)}
+                          }), make_options(defaults, options))
+  end
+
+#def jqm_list(collection, options, &block)
+#  defaults ={
+#      data: {
+#          role: :listview
+#      }
+#  }
+#  contents = ''
+#  collection.each do |item|
+#    contents << capture( &block )
+#  end
+#  out = content_tag(:div, contents, make_options(defaults, options))
+#end
+
+
+  def jqm_button(text, href_or_options, options = {})
+    defaults = {
+        data: {
+            role: :button,
+            prefetch: :true
+        }
+    }
+    if href_or_options.is_a? Hash
+      options = href_of_options
+    else
+      # we allow href to be overridden by options.  Convenient or a pain?
+      defaults[:href] = href_or_options
+    end
+
+    defaults[:class] = 'notext' if text.blank? || text=='&nbsp;'
+
+    content_tag(:a, raw(text), make_options(defaults, options))
+  end
+
+  def dialog_button(text, href, options = {})
+    defaults = {
+        data: {
+            rel: :dialog,
+            transition: :slidedown,
+        }
+    }
+    jqm_button(text, href, make_options(defaults, options))
+  end
+
+  def forward_button(text, href, options = {})
+    defaults = {
+        :href => href,
+        :data => {
+            :role => :button,
+            :icon => 'arrow-r',
+            :iconpos => 'right'
+        }
+    }
+
+    content_tag(:a, raw(text), make_options(defaults, options))
+  end
+  alias_method :forwards_button, :forward_button
+
+  def backward_button(text, href, options = {})
+    defaults = {
+        :href => href,
+        :data => {
+            :role => :button,
+            :icon => 'arrow-l',
+            :direction => 'reverse'
+        }
+    }
+
+    content_tag(:a, raw(text), make_options(defaults, options))
+  end
+  alias_method :backwards_button, :backward_button
+
+  def back_button(options = {})
+    defaults = {
+        data: {
+            rel: :back
+        }
+    }
+    backwards_button('Back', '#', make_options(defaults, options))
+  end
+
+  def slider_tag(name, label)
+    raw %Q{
+   <div data-role="fieldcontain" style="border: 0; margin: 0; padding: 1em 0 0 0;">
+               <label style="" for="#{name}">#{label}</label>
+               <select name="#{name}" id="#{name}" data-role="slider">
+                 <option value="no">Off</option>
+                 <option value="yes">On</option>
+               </select>
+             </div>
+   }
+  end
+end

data/lib/jqm_helper.rb

@@ -0,0 +1,39 @@
+# automatically reload on each request: (and add to application_controller)
+#require_dependency 'jqm_helper/railtie' if defined?(Rails)
+#require_dependency 'jqm_helper/tag_helpers' if defined?(Rails)
+#require_dependency 'jqm_helper/nav_builder' if defined?(Rails)
+
+require 'jqm_helper/railtie' if defined?(Rails)
+require 'jqm_helper/tag_helpers' if defined?(Rails)
+require 'jqm_helper/nav_builder' if defined?(Rails)
+
+
+
+module JqmHelper
+  include ActionView::Helpers::OutputSafetyHelper # raw
+  include ActionView::Helpers::TagHelper # content_tag
+
+  def make_options(defaults, custom)
+
+    [defaults, custom].each do |options|
+      # standardize keys:
+      if data = options.delete(:data)
+        data.each do |k, v|
+          options[:"data-#{k}"] = v
+        end
+      end
+    end
+
+    options = defaults.merge(custom)
+    options.delete(:'data-prefetch') if options[:'data-prefetch'] == false
+    options
+  end
+
+end
+
+
+# doc:
+# https://github.com/justinfrench/formtastic/tree/master/lib/formtastic
+# http://edgeapi.rubyonrails.org/classes/Rails/Railtie.html
+# http://www.igvita.com/2010/08/04/rails-3-internals-railtie-creating-plugins/
+# http://www.engineyard.com/blog/2010/extending-rails-3-with-railties/

data/test/helper.rb

@@ -0,0 +1,18 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'jqm_helper'
+
+class Test::Unit::TestCase
+end

data/test/test_jqm_helper.rb

@@ -0,0 +1,7 @@
+require 'helper'
+
+class TestJqmHelper < Test::Unit::TestCase
+  should "probably rename this file and start testing for real" do
+    flunk "hey buddy, you should probably rename this file and start testing for real"
+  end
+end

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification
+name: jqm_helper
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+  prerelease: 
+platform: ruby
+authors:
+- Peter Ehrlich
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-12-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &70189261795260 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: *70189261795260
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: &70189261794020 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.4
+  type: :development
+  prerelease: false
+  version_requirements: *70189261794020
+- !ruby/object:Gem::Dependency
+  name: rcov
+  requirement: &70189261792320 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70189261792320
+description: ! 'helper methods for generating markup, soon: javascript helpers'
+email: peter.i.ehrlich@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.md
+files:
+- .document
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- VERSION
+- jqm_helper.gemspec
+- lib/jqm_helper.rb
+- lib/jqm_helper/nav_builder.rb
+- lib/jqm_helper/railtie.rb
+- lib/jqm_helper/tag_helpers.rb
+- test/helper.rb
+- test/test_jqm_helper.rb
+homepage: http://github.com/pehrlich/jqm_helper
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -3746104091147986666
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.13
+signing_key: 
+specification_version: 3
+summary: big conveniences for jquery mobile
+test_files: []