twitter-bootstrap-components-rails 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 944fea1ebbc771146073c0158384ada4d0145eb8
+  data.tar.gz: 39b1912b49d393ef66a3c914015f58fd1f9e3345
+SHA512:
+  metadata.gz: f7f9170999f4632ac844d14ba3338acb82b4a50739d7c00a410b64e4b45929c4704e00b493888f4c11dcc10977c38501b3a24e71bf3bc3d5e267583eedd2bb52
+  data.tar.gz: 92f82c9dc717fbfc87ac3634e77fc3309d2988598b674fbfbeb76c580ca165fbfef2009ee884cf33b99e37da3f338c033b66e6409d18c5b4cf5df36547cdc299

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2017 Roberto Vasquez Angel
+
+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,44 @@
+# Twitter::Bootstrap::Components::Rails
+Short description and motivation.
+
+## Usage
+Add the helper to your application controller.
+
+Bootstrap v3
+
+```ruby
+class ApplicationController < ActionController::Base
+  helper Twitter::Bootstrap::Components::Rails::V3::ComponentsHelper
+end
+```
+
+Bootstrap v4
+
+```ruby
+class ApplicationController < ActionController::Base
+  helper Twitter::Bootstrap::Components::Rails::V4::ComponentsHelper
+end
+```
+
+## Installation
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'twitter-bootstrap-components-rails'
+```
+
+And then execute:
+```bash
+$ bundle
+```
+
+Or install it yourself as:
+```bash
+$ gem install twitter-bootstrap-components-rails
+```
+
+## Contributing
+Contribution directions go here.
+
+## License
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,26 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rdoc/task'
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Twitter::Bootstrap::Components::Rails'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.md')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+APP_RAKEFILE = File.expand_path("../spec/dummy/Rakefile", __FILE__)
+load 'rails/tasks/engine.rake'
+
+
+load 'rails/tasks/statistics.rake'
+
+
+
+require 'bundler/gem_tasks'
+

data/app/assets/config/twitter_bootstrap_components_rails_manifest.js

@@ -0,0 +1,2 @@
+//= link_directory ../javascripts/twitter/bootstrap/components/rails .js
+//= link_directory ../stylesheets/twitter/bootstrap/components/rails .css

data/app/assets/javascripts/twitter/bootstrap/components/rails/application.js

@@ -0,0 +1,13 @@
+// This is a manifest file that'll be compiled into application.js, which will include all the files
+// listed below.
+//
+// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, vendor/assets/javascripts,
+// or any plugin's vendor/assets/javascripts directory can be referenced here using a relative path.
+//
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// compiled file. JavaScript code in this file should be added after the last require_* statement.
+//
+// Read Sprockets README (https://github.com/rails/sprockets#sprockets-directives) for details
+// about supported directives.
+//
+//= require_tree .

data/app/assets/stylesheets/twitter/bootstrap/components/rails/application.css

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
+ * files in this directory. Styles in this file should be added after the last require_* statement.
+ * It is generally better to create a new file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/app/components/twitter/bootstrap/components/v3/alert.rb

@@ -0,0 +1,34 @@
+module Twitter
+  module Bootstrap
+    module Components
+      module V3
+        class Alert < Base
+          private
+
+          def view_locals
+            { 
+              block_output:      @block_output,
+              context:           context,
+              dismissible:       dismissible?,
+              div_alert_classes: div_alert_classes
+            }
+          end
+
+          def dismissible?
+            !!@options[:dismissible]
+          end
+
+          def div_alert_classes
+            classes = ["alert", "alert-#{context}"]
+            classes << ["alert-dismissible"] if @options[:dismissible]
+            classes
+          end
+
+          def context
+            @options[:context]
+          end
+        end
+      end
+    end
+  end
+end

data/app/components/twitter/bootstrap/components/v3/badge.rb

@@ -0,0 +1,32 @@
+module Twitter
+  module Bootstrap
+    module Components
+      module V3
+        class Badge < Base
+
+          private
+
+          def view_locals
+            { 
+              block_output:       @block_output,
+              context:            context,
+              span_badge_classes: span_badge_classes
+            }
+          end
+
+          def pill?
+            !!@options[:pill]
+          end
+
+          def span_badge_classes
+            ["badge", "badge-#{context}"]
+          end
+
+          def context
+            @options[:context]
+          end
+        end
+      end
+    end
+  end
+end

data/app/components/twitter/bootstrap/components/v3/base.rb

@@ -0,0 +1,30 @@
+module Twitter
+  module Bootstrap
+    module Components
+      module V3
+        class Base
+          def initialize(view, options = {}, &block)
+            @view        = view
+            @options     = options
+            @block       = block
+            @view_locals = {}
+          end
+
+          def perform
+            @block_output = block_output
+            @view.render partial: self.class.name.underscore, locals: view_locals
+          end
+
+          private
+
+          attr_reader :view_locals
+
+          def block_output
+            return unless @block.present?
+            @view.capture { @block.call(self) }
+          end
+        end
+      end
+    end
+  end
+end

data/app/components/twitter/bootstrap/components/v3/button_group.rb

@@ -0,0 +1,49 @@
+module Twitter
+  module Bootstrap
+    module Components
+      module V3
+        class ButtonGroup < Base
+          SIZE_MAP = {
+            default:     nil,
+            extra_small: :xs,
+            small:       :sm,
+            large:       :lg
+          }.freeze
+
+          private
+
+          def view_locals
+            { 
+              block_output:    @block_output,
+              div_css_classes: div_css_classes
+            }
+          end
+
+          def div_css_classes
+            [group_css_class, size_css_class, justified_css_class, drop_up_css_class].compact
+          end
+
+          def size
+            @options[:size] || :default
+          end
+
+          def size_css_class
+            SIZE_MAP[size]
+          end
+
+          def group_css_class
+            @options[:vertical] ? 'btn-group-vertical' : 'btn-group'
+          end
+
+          def justified_css_class
+            @options[:justified] ? 'btn-group-justified' : nil
+          end
+
+          def drop_up_css_class
+            @options[:drop_up] ? 'dropup' : nil
+          end
+        end
+      end
+    end
+  end
+end

data/app/components/twitter/bootstrap/components/v3/media_object.rb

@@ -0,0 +1,56 @@
+module Twitter
+  module Bootstrap
+    module Components
+      module V3
+        class MediaObject < Base
+          DEFAULT_IMAGE_SRC = "https://placeholdit.imgix.net/~text?txtsize=16&txt=64x64&w=64&h=64".freeze
+
+          private
+
+          def view_locals
+            { 
+              block_output:             @block_output,
+              context:                  context,
+              div_media_object_classes: div_media_object_classes,
+              image_options:            image_options,
+              link_target:              link_target,
+              horizontal_alignment:     horizontal_alignment
+            }
+          end
+
+          def div_media_object_classes
+            ["media-#{horizontal_alignment}", "media-#{vertical_alignment}"]
+          end
+
+          def context
+            @options[:context]
+          end
+
+          def horizontal_alignment
+            @horizontal_alignment = @options[:horizontal_alignment] || :left
+            unless [:left, :right].include?(@horizontal_alignment)
+              raise "horizontal_alignment must be either :left or :right, but #{@horizontal_alignment} was given."
+            end
+            @horizontal_alignment
+          end
+
+          def vertical_alignment
+            @vertical_alignment = @options[:vertical_alignment] || :top
+            unless [:top, :middle, :bottom].include?(@vertical_alignment)
+              raise "vertical_alignment must be either :top, :middle or :bottom, but #{@vertical_alignment} was given."
+            end
+            @vertical_alignment
+          end
+
+          def image_options
+            @image_options ||= (@options[:image_options] || {}).reverse_merge!(alt: nil, src: DEFAULT_IMAGE_SRC)
+          end
+
+          def link_target
+            @options[:link_target]
+          end
+        end
+      end
+    end
+  end
+end

data/app/components/twitter/bootstrap/components/v3/thumbnail.rb

@@ -0,0 +1,40 @@
+module Twitter
+  module Bootstrap
+    module Components
+      module V3
+        class Thumbnail < Base
+          DEFAULT_IMAGE_SRC = "https://placeholdit.imgix.net/~text?txtsize=16&txt=242x200&w=242&h=200".freeze
+          DEFAULT_CONTAINER_CLASSES = "col-xs-6 col-md-3".freeze
+
+          private
+
+          def view_locals
+            { 
+              block_output:      @block_output,
+              context:           context,
+              container_classes: container_classes,
+              image_options:     image_options,
+              link_options:      link_options
+            }
+          end
+
+          def context
+            @options[:context]
+          end
+
+          def container_classes
+             @options[:container_classes] || DEFAULT_CONTAINER_CLASSES
+          end
+
+          def image_options
+            (@options[:image_options] || {}).reverse_merge!(alt: nil, src: DEFAULT_IMAGE_SRC)
+          end
+
+          def link_options
+            @options[:link_options] || {}
+          end
+        end
+      end
+    end
+  end
+end

data/app/components/twitter/bootstrap/components/v4/alert.rb

@@ -0,0 +1,39 @@
+module Twitter
+  module Bootstrap
+    module Components
+      module V4
+        class Alert < Base
+          private
+
+          def view_locals
+            { 
+              block_output:      @block_output,
+              context:           context,
+              dismissible:       dismissible?,
+              div_alert_classes: div_alert_classes
+            }
+          end
+
+          def dismissible?
+            !!@options[:dismissible]
+          end
+
+          def div_alert_classes
+            classes = ["alert", "alert-#{context}"]
+            classes << ["alert-dismissible", *@options[:dismissible]] if @options[:dismissible].respond_to?(:join)
+            classes << additional_css_classes
+            classes
+          end
+
+          def context
+            @options[:context]
+          end
+
+          def additional_css_classes
+            @options[:class]
+          end
+        end
+      end
+    end
+  end
+end

data/app/components/twitter/bootstrap/components/v4/badge.rb

@@ -0,0 +1,34 @@
+module Twitter
+  module Bootstrap
+    module Components
+      module V4
+        class Badge < Base
+
+          private
+
+          def view_locals
+            { 
+              block_output:       @block_output,
+              context:            context,
+              span_badge_classes: span_badge_classes
+            }
+          end
+
+          def pill?
+            !!@options[:pill]
+          end
+
+          def span_badge_classes
+            classes = ["badge", "badge-#{context}"]
+            classes << 'badge-pill' if pill?
+            classes
+          end
+
+          def context
+            @options[:context]
+          end
+        end
+      end
+    end
+  end
+end