i18n-inflector-rails 0.1.0

data.tar.gz.sig

@@ -0,0 +1,2 @@
+j`�[K�m���� �)�#������@d��w�HH�_Ph���F�a��6��&�M�!
+��s�J��	�/ڂ�\L�������������	nV�=�W���r�.�gdd .�7��#����ҫᦲn��D

data/.rspec

@@ -0,0 +1 @@
+--format nested --color

data/.yardopts

@@ -0,0 +1,10 @@
+--title 'Simple Inflector for I18n'
+--protected
+--readme README.rdoc
+--no-private
+--hide-void-return
+-
+docs/HISTORY
+ChangeLog
+docs/COPYING
+docs/LGPL-LICENSE

data/ChangeLog

@@ -0,0 +1,185 @@
+commit 807a61dea750e19bd52fb350d34609e259557bbd
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Fri Jan 14 18:05:40 2011 +0100
+
+    Version 0.1.0
+
+commit 5cd0488a4c5e4bab9f9719162af599984e83d71f
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Fri Jan 14 13:04:43 2011 +0100
+
+    Adapted to i18n-inflector v.2.0.0
+
+commit 20c389bbb9fcae1d216a22b6df39aebd90210767
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Tue Jan 11 14:17:45 2011 +0100
+
+    Requires stable i18n-inflector
+
+commit 01e743e18f55b8734107124303ed191c60937f99
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Tue Jan 11 14:04:05 2011 +0100
+
+    Version 0.1.0
+
+commit c985de4af92f1d1619cfb228ae378d5ca383babd
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Tue Jan 11 13:55:45 2011 +0100
+
+    Beta
+
+commit f338a6a56f36eed25f831d6fbc3fe0127a08931b
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Tue Jan 11 08:28:52 2011 +0100
+
+    Serious changes that are making it work in a real Rails 3 environment
+
+commit 528fcb11daee63711dae36fa6b3b97bd2ab25370
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Tue Jan 11 08:27:43 2011 +0100
+
+    Added no_inflection_method class method, each added method becomes a helper method
+
+commit 17d35aae4c269663b44277751e2d45260abb3c56
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Jan 9 21:03:50 2011 +0100
+
+    Path fixed
+
+commit 289c85c00008b67584e30eb170ce173c35187e84
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Jan 9 21:00:40 2011 +0100
+
+    Updated Manifest.txt and ChangeLog
+
+commit 75b492579a8d25ab3e48a7795a1f351f2f7b379c
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Jan 9 20:58:49 2011 +0100
+
+    Moved gemspec to root
+
+commit c58191d99e80b28d045fd48e14689b0cf4bc49cb
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Jan 9 20:56:04 2011 +0100
+
+    Added important note to gemspec
+
+commit 7fa840a3522b19bb2db9231acdb21faeaedcbfbd
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Jan 9 20:46:16 2011 +0100
+
+    Specfile fixed: removed non-existent files
+
+commit b660e57b969cdb57248a111585278cd20ebbee7a
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Jan 9 20:13:29 2011 +0100
+
+    Specfile renamed
+
+commit 81cffc37a6b30fc7595bb26643588bce1db62da7
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Jan 9 20:12:24 2011 +0100
+
+    Repository name changed to i18n-inflector-rails
+
+commit cda3edcffe9465e021af8380af3ceae0f98ef0a8
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Jan 9 07:11:22 2011 +0100
+
+    Dependencies fixed
+
+commit c1ce77a843490b21233f0c60b35c64d4df731834
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Jan 9 06:45:48 2011 +0100
+
+    Dependencies back to gemspec
+
+commit 745815d7047d7cc39ec48c9265714c110527fc1e
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Jan 9 06:25:45 2011 +0100
+
+    Call it beta
+
+commit a3bf341ae100885b39e770d7cc91ebe7a9734a22
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Jan 9 06:23:37 2011 +0100
+
+    Dependencies cleaned, gemspec and Rakefile independent from module code (added version.rb for that)
+
+commit 5583b7ac968d999ba2a74b3d8457c29df0afba9d
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Jan 9 02:26:43 2011 +0100
+
+    Gemspec upgraded
+
+commit 2c754d88f34bb41b5a377c8f9108687157dca08a
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Jan 9 02:24:14 2011 +0100
+
+    Added gemspec for compatibility
+
+commit 2eebc9668e1b05ac65342ebf8ebb2ded0ac80589
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Jan 9 01:37:12 2011 +0100
+
+    Deps fixed, Rakefile updated
+
+commit 84e8c52a61642a9d5d4f24aa354ea2384bfbf817
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Jan 9 01:18:07 2011 +0100
+
+    Namespace changed (removed "Backend"), documentation updated
+
+commit 037edac820723b7c7452c2f0eae8f572558bb1ad
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sat Jan 8 16:48:21 2011 +0100
+
+    Deps updated
+
+commit 66c6be2be85b56e88fd27a0cdc0ee34dbbdb846b
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Thu Jan 6 23:15:05 2011 +0100
+
+    Unit tests stubs removed
+
+commit 41e9409414c75f5b5ef77e69ce62a291d321d04f
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Thu Jan 6 23:13:45 2011 +0100
+
+    Added Railtie, added common files for older Rails versions just in case
+
+commit 818027d17d91171499b410e2e7628422e61eb165
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Thu Jan 6 23:12:42 2011 +0100
+
+    Added rspec examples
+
+commit f564dc4c25060961b2838ddae03056fbb9f5fa2a
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Thu Jan 6 23:11:49 2011 +0100
+
+    Method names changed, inflection options extraction fixed, documentation updated.
+
+commit e0f0fd9086b00efec6e1e979c0a8ea2d03904371
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Thu Jan 6 23:09:46 2011 +0100
+
+    Fixed error reporting class: message is more generic
+
+commit fc1c7ea3aa2d4011075d05926fcc8baa5758f322
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Thu Jan 6 23:09:09 2011 +0100
+
+    Dependences changed: railties and rspec-rails added
+
+commit cf63e0e3b0cf0388c11143bbe67868b8fbd5bdd9
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Jan 2 16:03:20 2011 +0100
+
+    Added ChangeLog and Manifest.txt
+
+commit 4dfee2aa8b56922e4bfc8bd8d2a64456cde256c6
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Jan 2 16:01:46 2011 +0100
+
+    Initial revision

data/Gemfile

@@ -0,0 +1,17 @@
+# -*- ruby -*-
+
+source :gemcutter
+
+gem "i18n-inflector", "~>2.0.0"
+gem "railties", "~>3.0.0"
+gem "actionpack", "~>3.0.0"
+
+gem "hoe-yard", ">=0.1.2", :group => [:development, :test]
+gem "rspec", ">=2.3.0", :group => [:development, :test]
+gem "yard", ">=0.6.4", :group => [:development, :test]
+gem "bundler", ">=1.0.7", :group => [:development, :test]
+gem "hoe-bundler", ">=1.0.0", :group => [:development, :test]
+gem "hoe-yard", ">=0.1.2", :group => [:development, :test]
+gem "hoe", ">=2.8.0", :group => [:development, :test]
+
+# vim: syntax=ruby

data/LGPL-LICENSE

@@ -0,0 +1,169 @@
+<tt>
+	
+			  GNU LESSER GENERAL PUBLIC LICENSE
+	                       Version 3, 29 June 2007
+	
+	 Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+	 Everyone is permitted to copy and distribute verbatim copies
+	 of this license document, but changing it is not allowed.
+	
+	
+	  This version of the GNU Lesser General Public License incorporates
+	the terms and conditions of version 3 of the GNU General Public
+	License, supplemented by the additional permissions listed below.
+	
+	  0. Additional Definitions.
+	
+	  As used herein, "this License" refers to version 3 of the GNU Lesser
+	General Public License, and the "GNU GPL" refers to version 3 of the GNU
+	General Public License.
+	
+	  "The Library" refers to a covered work governed by this License,
+	other than an Application or a Combined Work as defined below.
+	
+	  An "Application" is any work that makes use of an interface provided
+	by the Library, but which is not otherwise based on the Library.
+	Defining a subclass of a class defined by the Library is deemed a mode
+	of using an interface provided by the Library.
+	
+	  A "Combined Work" is a work produced by combining or linking an
+	Application with the Library.  The particular version of the Library
+	with which the Combined Work was made is also called the "Linked
+	Version".
+	
+	  The "Minimal Corresponding Source" for a Combined Work means the
+	Corresponding Source for the Combined Work, excluding any source code
+	for portions of the Combined Work that, considered in isolation, are
+	based on the Application, and not on the Linked Version.
+	
+	  The "Corresponding Application Code" for a Combined Work means the
+	object code and/or source code for the Application, including any data
+	and utility programs needed for reproducing the Combined Work from the
+	Application, but excluding the System Libraries of the Combined Work.
+	
+	  1. Exception to Section 3 of the GNU GPL.
+	
+	  You may convey a covered work under sections 3 and 4 of this License
+	without being bound by section 3 of the GNU GPL.
+	
+	  2. Conveying Modified Versions.
+	
+	  If you modify a copy of the Library, and, in your modifications, a
+	facility refers to a function or data to be supplied by an Application
+	that uses the facility (other than as an argument passed when the
+	facility is invoked), then you may convey a copy of the modified
+	version:
+	
+	   a) under this License, provided that you make a good faith effort to
+	   ensure that, in the event an Application does not supply the
+	   function or data, the facility still operates, and performs
+	   whatever part of its purpose remains meaningful, or
+	
+	   b) under the GNU GPL, with none of the additional permissions of
+	   this License applicable to that copy.
+	
+	  3. Object Code Incorporating Material from Library Header Files.
+	
+	  The object code form of an Application may incorporate material from
+	a header file that is part of the Library.  You may convey such object
+	code under terms of your choice, provided that, if the incorporated
+	material is not limited to numerical parameters, data structure
+	layouts and accessors, or small macros, inline functions and templates
+	(ten or fewer lines in length), you do both of the following:
+	
+	   a) Give prominent notice with each copy of the object code that the
+	   Library is used in it and that the Library and its use are
+	   covered by this License.
+	
+	   b) Accompany the object code with a copy of the GNU GPL and this license
+	   document.
+	
+	  4. Combined Works.
+	
+	  You may convey a Combined Work under terms of your choice that,
+	taken together, effectively do not restrict modification of the
+	portions of the Library contained in the Combined Work and reverse
+	engineering for debugging such modifications, if you also do each of
+	the following:
+	
+	   a) Give prominent notice with each copy of the Combined Work that
+	   the Library is used in it and that the Library and its use are
+	   covered by this License.
+	
+	   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+	   document.
+	
+	   c) For a Combined Work that displays copyright notices during
+	   execution, include the copyright notice for the Library among
+	   these notices, as well as a reference directing the user to the
+	   copies of the GNU GPL and this license document.
+	
+	   d) Do one of the following:
+	
+	       0) Convey the Minimal Corresponding Source under the terms of this
+	       License, and the Corresponding Application Code in a form
+	       suitable for, and under terms that permit, the user to
+	       recombine or relink the Application with a modified version of
+	       the Linked Version to produce a modified Combined Work, in the
+	       manner specified by section 6 of the GNU GPL for conveying
+	       Corresponding Source.
+	
+	       1) Use a suitable shared library mechanism for linking with the
+	       Library.  A suitable mechanism is one that (a) uses at run time
+	       a copy of the Library already present on the user's computer
+	       system, and (b) will operate properly with a modified version
+	       of the Library that is interface-compatible with the Linked
+	       Version.
+	
+	   e) Provide Installation Information, but only if you would otherwise
+	   be required to provide such information under section 6 of the
+	   GNU GPL, and only to the extent that such information is
+	   necessary to install and execute a modified version of the
+	   Combined Work produced by recombining or relinking the
+	   Application with a modified version of the Linked Version. (If
+	   you use option 4d0, the Installation Information must accompany
+	   the Minimal Corresponding Source and Corresponding Application
+	   Code. If you use option 4d1, you must provide the Installation
+	   Information in the manner specified by section 6 of the GNU GPL
+	   for conveying Corresponding Source.)
+	
+	  5. Combined Libraries.
+	
+	  You may place library facilities that are a work based on the
+	Library side by side in a single library together with other library
+	facilities that are not Applications and are not covered by this
+	License, and convey such a combined library under terms of your
+	choice, if you do both of the following:
+	
+	   a) Accompany the combined library with a copy of the same work based
+	   on the Library, uncombined with any other library facilities,
+	   conveyed under the terms of this License.
+	
+	   b) Give prominent notice with the combined library that part of it
+	   is a work based on the Library, and explaining where to find the
+	   accompanying uncombined form of the same work.
+	
+	  6. Revised Versions of the GNU Lesser General Public License.
+	
+	  The Free Software Foundation may publish revised and/or new versions
+	of the GNU Lesser General Public License from time to time. Such new
+	versions will be similar in spirit to the present version, but may
+	differ in detail to address new problems or concerns.
+	
+	  Each version is given a distinguishing version number. If the
+	Library as you received it specifies that a certain numbered version
+	of the GNU Lesser General Public License "or any later version"
+	applies to it, you have the option of following the terms and
+	conditions either of that published version or of any later version
+	published by the Free Software Foundation. If the Library as you
+	received it does not specify a version number of the GNU Lesser
+	General Public License, you may choose any version of the GNU Lesser
+	General Public License ever published by the Free Software Foundation.
+	
+	  If the Library as you received it specifies that a proxy can decide
+	whether future versions of the GNU Lesser General Public License shall
+	apply, that proxy's public statement of acceptance of any version is
+	permanent authorization for you to choose that version for the
+	Library.
+
+</tt>

data/Manifest.txt

@@ -0,0 +1,23 @@
+.rspec
+.yardopts
+ChangeLog
+Gemfile
+LGPL-LICENSE
+Manifest.txt
+README.rdoc
+Rakefile
+docs/COPYING
+docs/HISTORY
+docs/LEGAL
+docs/LGPL-LICENSE
+docs/TODO
+docs/rdoc.css
+i18n-inflector-rails.gemspec
+init.rb
+lib/i18n-inflector-rails.rb
+lib/i18n-inflector-rails/errors.rb
+lib/i18n-inflector-rails/inflector.rb
+lib/i18n-inflector-rails/railtie.rb
+lib/i18n-inflector-rails/version.rb
+spec/inflector_spec.rb
+spec/spec_helper.rb

data/README.rdoc

@@ -0,0 +1,154 @@
+= Simple I18n Inflector for Rails
+
+<b>i18n-inflector-rails version <tt>1.0</tt></b> (<b><tt>Sexparty</tt></b>)
+
+
+
+* https://rubygems.org/gems/i18n-inflector-rails
+* https://github.com/siefca/i18n-inflector-rails/tree
+* mailto:pw@gnu.org
+
+== Summary
+
+This Rails plug-in contains bindings for the I18n Inflector module for Ruby's I18n.
+It overwrites the translate() method from Rails in a way that it will
+interpolate additional inflection tokens present in translations.
+These tokens may appear in *patterns* which are contained within
+<tt>@{</tt> and <tt>}</tt> symbols.
+
+== Why?
+
+It's intended to be used in a projects where tranlations are performed
+by many people, yet there is a need to substitute fragments of text
+depending on user's gender, person or other data.
+
+To achieve similar functionality lambdas can be used but including
+proc objects in translations may be considered as the unsafe idea.
+
+If you have a troop of happy translators that shouldn't have the
+ability to execute any code yet you need some simple inflection
+then you should use this module.
+
+== Synopsis
+
+  translate('.welcome')
+
+===== In a YAML file:
+
+  en:
+    welcome:  "Dear @{f:Lady|m:Sir|n:You|All}"
+  
+  en:
+    i18n:
+      inflections:
+        gender:
+          f:        "female"
+          m:        "male"
+          n:        "neuter"
+          @female:  @f
+          @male:    @m
+          @neuter:  @n
+          man:      @male
+          woman:    @female
+          default:  neuter
+
+===== In a controller:
+
+  class ApplicationController < ActionController::Base
+    
+    inflection_method :gender
+    
+    # assuming that @gender is set somewhere
+    def gender
+      @gender || nil
+    end
+  
+  end
+
+  class UsersController < ApplicationController
+    
+    # t() will call method gender() from the current context
+    # to get the inflection token
+    def say_welcome
+      t('welcome')
+      # => "Dear Sir"
+    end
+  
+  end
+  
+== Description
+
+You can choose different kinds (gender, title, person, time, author, etc.)
+of tokens to group them in a meaningful, semantical sets. That means you can
+apply I18n Inflector to do simple inflection by a gender or a person, when some
+language requires it.
+
+This module adds +inflection_method+ clause that can be used
+in controllers and views. Using that clause makes it easy to register
+methods that will be called to obtain mentioned inflection options.
+
+This module uses i18n-inflector[https://rubygems.org/gems/i18n-inflector]
+module which allows passing inflection options to the translate method.
+You may find i18n-inflector default objects very helpful since they
+allow you to read inflection data in many different ways. You may, for
+example, use it to generate forms containing languages that are using inflection,
+all known inflection kinds or tokens assigned to them. To access default inflector
+bound to default I18n backend use:
+  I18n.inflector
+
+See {whole documentation}[http://rubydoc.info/gems/i18n-inflector-rails/] for more info about the usage.
+To understand how the I18n Inflector works please read {I18n Inflector documentation}[http://rubydoc.info/gems/i18n-inflector/file/README.rdoc].
+
+== Requirements
+
+* i18n-inflector[https://rubygems.org/gems/i18n-inflector]
+* actionpack[https://rubygems.org/gems/actionpack]
+* rake[https://rubygems.org/gems/rake]
+* rubygems[http://docs.rubygems.org/]
+
+== Download
+
+==== Source code
+
+* https://github.com/siefca/i18n-inflector-rails/tree
+* <tt>git clone git://github.com/siefca/i18n-inflector-rails.git</tt>
+
+==== Gem
+
+* https://rubygems.org/gems/i18n-inflector-rails
+
+== Installation
+
+* <tt>sudo gem install i18n-inflector-rails</tt>
+
+== Specs
+
+You can run RSpec examples both with
+
+* <tt>rake spec</tt> or just <tt>rake</tt>
+* run a test file directly, e.g. <tt>ruby -Ilib -Ispec spec/inflector_spec.rb</tt>
+
+== More information
+
+See {whole documentation}[http://rubydoc.info/gems/i18n-inflector-rails/] for more info about the usage.
+
+See {I18n::Inflector::Rails} module documentation for detailed information.
+
+== Credits
+
+{Heise Media Polska}[http://www.heise-online.pl/] supports Free Software and has
+contributed to this plug-in by paying for me to eat when I've been coding.
+
+== License
+
+Copyright (c) 2011 by Paweł Wilk.
+
+i18n-inflector-rails is copyrighted software owned by Paweł Wilk (pw@gnu.org).
+You may redistribute and/or modify this software as long as you
+comply with either the terms of the LGPL (see {file:LGPL-LICENSE}),
+or Ruby's license (see {file:COPYING}).
+
+THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS
+OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+FOR A PARTICULAR PURPOSE.