sinatra-ghetto_i18n 0.1.0

data/.gitignore

@@ -0,0 +1 @@
+*.gem

data/LICENSE

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2011 Nicolas Sanguinetti, http://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.rdoc

@@ -0,0 +1,17 @@
+= Ghetto I18N
+
+This is the simplest, hackiest way to add translations to your Sinatra
+application.
+
+== How do I use it?
+
+The code is (or should be) fairly well documented. Read it :)
+
+If you want a live demo, we use it at http://rubyconfuruguay.org
+
+And that's open source, so you can see its code[http://github.com/foca/rubyconfuruguay-website].
+
+== Credits
+
+Author::  Nicolas Sanguinetti (foca[http://github.com/foca])
+License:: MIT (Check LICENSE for details)

data/lib/sinatra/ghetto_i18n.rb

@@ -0,0 +1,174 @@
+# -*- encoding: utf-8 -*-
+
+module Sinatra
+  # Extension that provides simplified I18N for your Sinatra applications.
+  #
+  # When you register this extension you gain access to 3 application settings,
+  # a couple of useful methods, and new options when definining routes and
+  # rendering views.
+  #
+  # The idea behind this is that all the routes in your application are
+  # namespaced by the language you want to use.
+  #
+  # So for example, if you want to provide the "/events" URL in english,
+  # spanish, and portuguese, using this extension you would have:
+  #
+  #   GET /en/events
+  #   GET /es/events
+  #   GET /pt/events
+  #
+  # Then, when you render a view (by passing a symbol to erb etc), the view is
+  # automatically looked up in a way that will include the language.
+  #
+  # This assumes you want a separate view file for each language. This means
+  # more work maintaining the site, yes, but for very simple websites this is
+  # often easier than keeping a translations file.
+  #
+  # This also helps when you have two widely different languages in which the
+  # design is affected by the translation (for example, an LTR and a RTL
+  # language.)
+  #
+  # = Options =
+  #
+  # When using this extension, you have access to the following settings:
+  #
+  # == +:languages+ ==
+  #
+  # You *must* set this to an enumerable that has the language codes your
+  # application supports. Any object that responds to #include? and #each works.
+  #
+  # For example:
+  #
+  #     set :languages, ["en", "es", "pt"]
+  #     set :languages, "en" => "English", "es" => "Español"
+  #
+  # (The rationale for this is that you might want to use a hash for setting
+  # names in order to build links to switch languages, but you can just pass an
+  # array if you don't need that)
+  #
+  # == +:default_language+ ==
+  #
+  # A string with the 2-letter language code of the default language for your
+  # application. Defaults to English.
+  #
+  # == +:i18n_view_format: ==
+  #
+  # The path to the internationalized view files. This should be a block that
+  # takes two arguments (the original view file, and the language) and must
+  # return a symbol.
+  #
+  # For example:
+  #
+  #     set :i18n_view_format do |view, lang|
+  #       :"#{lang}_#{view}"
+  #     end
+  #
+  # That means when you render the ":some_view" view, you are actually rendering
+  # the ":en_some_view" if the user is browsing the English site, or the
+  # ":fr_some_view" file if the user is browsing the French site.
+  #
+  # The default is +lang/view+, so your typical sinatra application will look
+  # like this (in case the languages you support are English and Spanish ("en"
+  # and "es"):
+  #
+  #     .
+  #     |- website.rb
+  #     \- views
+  #        |- en
+  #        |  |- view_a.erb
+  #        |  \- view_b.erb
+  #        \- es
+  #           |- view_a.erb
+  #           \- view_b.erb
+  #
+  module GhettoI18n
+    def self.registered(app) # :nodoc:
+      app.helpers Sinatra::GhettoI18n::Helpers
+      app.get("/", :skip_i18n => true) { redirect "/#{language}" }
+
+      unless app.respond_to? :i18n_view_format
+        app.set(:i18n_view_format) { |view, lang| :"#{lang}/#{view}" }
+      end
+
+      unless app.respond_to? :languages
+        app.set(:languages, {})
+      end
+
+      unless app.respond_to? :default_language
+        app.set(:default_language, "en")
+      end
+    end
+
+    # Define an internationalized GET route for the root. For example:
+    #
+    #     home do
+    #       erb :home
+    #     end
+    #
+    # is equivalent to defining:
+    #
+    #     get "/:lang", :skip_i18n => true do
+    #       erb :home
+    #     end
+    def home(&block)
+      check_language!
+      route("GET", "/:lang", { :skip_i18n => true }, &block)
+    end
+
+    # Define a condition that makes sure the language provided in the parameters
+    # matches the languages defined as an option.
+    def check_language!
+      condition { self.class.languages.include?(params[:lang]) }
+    end
+
+    def route(method, path, options={}, &block) # :nodoc:
+      return super if options.delete(:skip_i18n)
+
+      path.gsub! /^\//, ''
+
+      if %W(GET HEAD).include? method
+        super method, path, options do
+          redirect "/#{language}/#{path}"
+        end
+      end
+
+      super method, "/:lang/#{path}", options, &block
+    end
+
+    module Helpers
+      # The language for the current request. If the user is browsing to a
+      # language specific URL (ie, :lang is included in the params), then use
+      # that.
+      #
+      # If not, try to figure it out from the Accept-Language HTTP header.
+      #
+      # If that fails as well, resort to the +default_language+ setting.
+      def language
+        @_lang ||= params[:lang] || language_from_http ||
+          self.class.default_language
+      end
+
+      private
+
+      def language_from_http # :nodoc:
+        env["HTTP_ACCEPT_LANGUAGE"].to_s.split(",").each do |lang|
+          self.class.languages.each do |code, *|
+            return code if lang =~ /^#{code}/
+          end
+        end
+        nil
+      end
+
+      def render(engine, data, options={}, locals={}, &block) # :nodoc:
+        skip_i18n = options.delete(:skip_i18n)
+
+        if Symbol === data && !skip_i18n
+          view = self.class.i18n_view_format(data, language)
+          super(engine, view, options, locals, &block)
+        else
+          super
+        end
+      end
+    end
+  end
+end

data/sinatra-ghetto_i18n.gemspec

@@ -0,0 +1,26 @@
+Gem::Specification.new do |s|
+  s.name    = "sinatra-ghetto_i18n"
+  s.version = "0.1.0"
+  s.date    = "2011-07-04"
+
+  s.description = "Oversimplified I18N for your Sinatra application."
+  s.summary     = "I18n for simple apps."
+  s.homepage    = "http://github.com/foca/sinatra-ghetto_i18n"
+
+  s.authors = ["Nicolas Sanguinetti"]
+  s.email   = "contacto@nicolassanguinetti.info"
+
+  s.require_paths     = ["lib"]
+  s.has_rdoc          = true
+  s.rubygems_version  = "1.3.5"
+
+  s.add_dependency "sinatra"
+
+  s.files = %w[
+    .gitignore
+    LICENSE
+    README.rdoc
+    sinatra-ghetto_i18n.gemspec
+    lib/sinatra/ghetto_i18n.rb
+  ]
+end

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification 
+name: sinatra-ghetto_i18n
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Nicolas Sanguinetti
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-07-04 00:00:00 -03:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: sinatra
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+description: Oversimplified I18N for your Sinatra application.
+email: contacto@nicolassanguinetti.info
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- LICENSE
+- README.rdoc
+- sinatra-ghetto_i18n.gemspec
+- lib/sinatra/ghetto_i18n.rb
+has_rdoc: true
+homepage: http://github.com/foca/sinatra-ghetto_i18n
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.5.2
+signing_key: 
+specification_version: 3
+summary: I18n for simple apps.
+test_files: []
+