migajas 0.9.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2224e900cfa8368a0da6bcd4d8b9fed287645e40
+  data.tar.gz: 219915ed490c9a9d5d4f7336e91ced8735b366f6
+SHA512:
+  metadata.gz: 7e00e0bb52756db949d5a02827e466e32e600aaf2164d30eea9be9094c7e145b67937d5bb074f19be4959b97c7a722b66ef9e3cc11e66cbb26a079ff717c6454
+  data.tar.gz: 39489dd99c8ce61f52c0eba3af37a715f8c64930b5c414546bf33809617e19024d755dc5777865713c59a4c3a03d1a20ea959a19be2118c1ef3cb55969527fc6

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2016 Nicolas Sanguinetti <hi@nicolassanguinetti.info>
+
+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,63 @@
+# Migajas
+
+Migajas is a tiny library for adding breadcrumbs to a routing tree framework,
+like Cuba or Roda.
+
+## Usage
+
+First, build up your trail of crumbs as you match your routes:
+
+``` ruby
+Cuba.plugin Migajas
+
+Cuba.define do
+  breacrumbs << "Home"
+
+  on "users" do
+    breadcrumbs << "Users"
+
+    on get do
+      # render the list of users
+    end
+
+    on ":id" do |id|
+      user = User[id]
+      breadcrumbs << user.name
+
+      on get do
+        # render the user profile page
+      end
+    end
+  end
+end
+```
+
+Then, in the view, go over the `breadcrumbs` list:
+
+``` erb
+<ol class="breadcrumbs">
+  <% breadcrumbs.each do |crumb| %>
+    <li class="<%= "active" if crumb.current? %>">
+      <a href="<%= crumb.url %>"><%= crumb.name %></a>
+    </li>
+  <% end %>
+</ol>
+```
+
+That's it :)
+
+## Install
+
+    gem install migajas
+
+## What's in a name?
+
+`Migajas` is the Spanish word for `breadcrumbs`. It's pronounced like you'd
+pronounce `meegahas` in English (or `miˈɣa.xas` if you're a language nerd.)
+
+## License
+
+This project is shared under the MIT license. See the attached [LICENSE][] file
+for details.
+
+[LICENSE]: ./LICENSE

data/lib/migajas.rb

@@ -0,0 +1,82 @@
+module Migajas
+  # Public: List of breadcrumbs encountered in this request. Add to this list
+  # any breadcrumb as you go through your routing tree in the app:
+  #
+  # Example
+  #
+  #   define do
+  #     breadcrumbs << "Home"
+  #
+  #     on "users" do
+  #       breadcrumbs << "Users"
+  #
+  #       on get do
+  #         # render the list
+  #       end
+  #
+  #       on ":id" do |id|
+  #         user = User[id]
+  #         breadcrumbs << user.name
+  #
+  #         # etc
+  #       end
+  #     end
+  #   end
+  #
+  #   This will automatically build a list with the following breadcrumbs:
+  #
+  #   [
+  #     Migajas::Crumb.new("Home", "/"),
+  #     Migajas::Crumb.new("Users", "/users"),
+  #     Migajas::Crumb.new("Profile", "/users/5")
+  #   ]
+  #
+  #   In the view you can, then:
+  #
+  #   <% breadcrumbs.each do |crumb| %>
+  #     <li class="<%= "active" if crumb.current? %>">
+  #       <a href="<%= crumb.url %>"><%= crumb.name %></a>
+  #     </li>
+  #   <% end %>
+  #
+  # Returns a Migajas::Trail.
+  def breadcrumbs
+    env["app.breadcrumbs"] ||= Trail.new(env)
+  end
+
+  # The Trail is just an `env`-aware Array, with some convenient sugar for
+  # adding items to it.
+  class Trail < Array
+    def initialize(env)
+      @env = env
+      super()
+    end
+
+    # Add a new crumb to this trail. This takes care of calculating the URL
+    # from the path currently matched by Cuba, so all you need to provide is
+    # the name.
+    #
+    # Returns self.
+    def add(name, url = @env["SCRIPT_NAME"])
+      push Crumb.new(name, url, @env)
+    end
+    alias_method :<<, :add
+
+    # Crumbs are dumb values that know their #name, their #url, and whether
+    # they match the current URL (according to the `env`, which they inherit
+    # from their trail).
+    class Crumb
+      attr_reader :name, :url
+
+      def initialize(name, url, env)
+        @name = name
+        @url = url
+        @env = env
+      end
+
+      def current?
+        url == (@env["SCRIPT_NAME"] + @env["PATH_INFO"])
+      end
+    end
+  end
+end

data/lib/migajas/version.rb

@@ -0,0 +1,3 @@
+module Migajas
+  VERSION = "0.9.0".freeze
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: migajas
+version: !ruby/object:Gem::Version
+  version: 0.9.0
+platform: ruby
+authors:
+- Nicolas Sanguinetti
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-05-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: cutest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: cuba
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Simple library to add breadcrumbs to your Cuba/Roda app
+email:
+- contacto@nicolassanguinetti.info
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/migajas.rb
+- lib/migajas/version.rb
+homepage: http://github.com/foca/migajas
+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.4.5.1
+signing_key: 
+specification_version: 4
+summary: Breadcrumbs for your Cuba/Roda app
+test_files: []