i18n-inflector-3 3.0.0

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/README.md

@@ -0,0 +1,259 @@
+# i18n-inflector
+
+**i18n-inflector-3 version `3.0.0`** (Ruby 3.4+ compatible fork)
+
+* https://github.com/slbug/i18n-inflector
+* mailto:sl.bug.sl@gmail.com
+
+## Summary
+
+This library contains a backend module for I18n that adds extra functionality to the standard backend. It overwrites the translate method to interpolate additional inflection tokens present in translations.
+
+This is a modernized fork of the original i18n-inflector gem, updated to work with Ruby 3.4+ and Ruby 4.0.0-preview2.
+
+## Synopsis
+
+```ruby
+require 'i18n-inflector'
+
+I18n.translate('to_be', number: :singular,
+                        tense: :past,
+                        person: 2)
+#=> You were here
+
+I18n.translate('welcome', gender: :female)
+#=> Dear Lady
+```
+
+## Why?
+
+You can use I18n Inflector to create translations for highly inflected languages (like those belonging to Slavic language family). You can also use it in translation services that may operate on sentences instead of exact words.
+
+## When?
+
+It is intended to be used in web projects or other projects where translations are performed by many people, yet there is a need to inflect sentences with external variables. To achieve similar functionality lambdas can be used, but including many Proc objects might be considered unsafe or memory consuming.
+
+See [i18n-inflector-rails](https://rubygems.org/gems/i18n-inflector-rails) if you need Rails integration.
+
+## How?
+
+I18n Inflector lets you build your own inflection patterns contained in translation entries. The patterns may contain simple conditions and tokens, which combined with parameters passed to `I18n.translate` method can produce inflected strings.
+
+* See [USAGE](docs/USAGE) for detailed information about the usage.
+* See [EXAMPLES](docs/EXAMPLES) for examples.
+* See [whole documentation](http://rubydoc.info/gems/i18n-inflector-3/) to browse all documents.
+
+## Features
+
+* Inline inflection using patterns in translation data
+* Key-based inflection using individual inflection keys
+* Definable inflection kinds and tokens
+* Easy to use public API for inflection data
+* Configurable using special scope of translation data
+* Lazily evaluated Proc and Method objects as inflection options
+* Complex patterns support; inflection by more than one kind at a time
+* Negative matching, aliases, default tokens, token groups and more…
+
+## Description
+
+The I18n Inflector extends the translate method from I18n to interpolate additional inflection tokens present in translations. These tokens may appear in **patterns** which are contained within `@{` and `}` symbols. Configuration is stored in translation data, in a scope `<locale>.i18n.inflections`, where `locale` is a locale subtree.
+
+You can create your own inflection kinds (gender, title, person, time, author, etc.) to group tokens in meaningful, semantical sets. That means you can apply Inflector to do simple inflection by gender or person when a language requires it.
+
+It adds the `inflector` object to the default backend so you can use many methods for accessing loaded inflection data at runtime, or to set up global switches that control the engine.
+
+## Short example
+
+Example configuration using translation data:
+
+```yaml
+en:
+  i18n:
+    inflections:
+      gender:
+        f: "female"
+        m: "male"
+        n: "neuter"
+        female: :@f
+        male: :@m
+        default: :n
+```
+
+Example translation data:
+
+```yaml
+en:
+  welcome: "Dear @{f:Lady|m:Sir|n:You|All}!"
+  
+  '@same_but_as_key':
+    f: "Lady"
+    m: "Sir"
+    n: "You"
+    '@prefix': "Dear "
+    '@suffix': "!"
+    '@free': "All"
+```
+
+### Note about YAML parsing
+
+The examples use symbol notation (`:@f`) for special values to ensure compatibility with modern YAML parsers including Psych.
+
+## New features
+
+From version 2.1.0 the Inflector supports **named patterns**, which can be used when there is a need to be strict and/or to use the same token names but assigned to different kinds. Example:
+
+```yaml
+welcome: "Dear @gender{f:Lady|m:Sir|n:You|All}"
+```
+
+From version 2.2.0 the Inflector supports **complex patterns**, which can be used to inflect a sentence or word by more than one kind. This is very helpful for highly inflected languages. Example:
+
+```yaml
+welcome: "Dear @gender+number{f+s:Lady|f+p:Ladies|m+s:Sir|m+p:Gentlemen|All}"
+```
+
+## Modernization (v3.0.0)
+
+This fork has been modernized for Ruby 3.4+ and Ruby 4.0.0-preview2:
+
+### Breaking Changes
+
+* **Minimum Ruby version**: 3.4+ (was 1.9+)
+* **Gem name**: Changed to `i18n-inflector-3` to avoid conflicts
+* **Build system**: Migrated from Hoe to standard Bundler/Gemspec
+* **Test framework**: Migrated from Test::Unit to Minitest
+
+### Technical Improvements
+
+* **Frozen string literals**: All files use `frozen_string_literal: true`
+* **HSet implementation**: Updated to use public `Set#include?` API instead of internal `@hash`
+* **Dependencies**: Updated to modern versions
+* **Code style**: Modernized Ruby idioms and syntax
+
+### Migration from v2.6.7
+
+No API changes - this is a drop-in replacement. Just update your Gemfile:
+
+```ruby
+# Old
+gem 'i18n-inflector', '~> 2.6'
+
+# New
+gem 'i18n-inflector-3', '~> 3.0'
+```
+
+The require statement remains the same:
+
+```ruby
+require 'i18n-inflector'  # Still works!
+```
+
+## Requirements
+
+* [i18n](https://rubygems.org/gems/i18n) >= 0.6.0
+* [rake](https://rubygems.org/gems/rake) >= 13.0
+* Ruby >= 3.4
+
+## Download
+
+### Source code
+
+* https://github.com/slbug/i18n-inflector
+* `git clone git://github.com/slbug/i18n-inflector.git`
+
+### Gem
+
+* https://rubygems.org/gems/i18n-inflector-3
+
+## Installation
+
+```bash
+gem install i18n-inflector-3
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem 'i18n-inflector-3', '~> 3.0', require: 'i18n-inflector'
+```
+
+## Detailed example
+
+**YAML:**
+
+```yaml
+en:
+  i18n:
+    inflections:
+      gender:
+        f: "female"
+        m: "male"
+        n: "neuter"
+        o: "other"
+        default: :n
+ 
+  welcome: "Dear @{f:Lady|m:Sir|n:You|All}"
+```
+
+**Code:**
+
+```ruby
+I18n.t('welcome')
+# => "Dear You"
+
+I18n.t('welcome', gender: :m)
+# => "Dear Sir"
+
+I18n.t('welcome', gender: :unknown)
+# => "Dear You"
+
+I18n.inflector.options.unknown_defaults = false
+I18n.t('welcome', gender: :unknown)
+# => "Dear All"
+
+I18n.t('welcome', gender: :o)
+# => "Dear All"
+
+I18n.inflector.options.excluded_defaults = true
+I18n.t('welcome', gender: :o)
+# => "Dear You"
+```
+
+## More information
+
+* See `I18n::Inflector::API` class documentation for detailed information about the API
+* See `I18n::Backend::Inflector` module documentation for detailed information about the internals
+
+## Tests
+
+You can run tests with:
+
+```bash
+bundle exec rake test
+# or
+./bin/test
+```
+
+## Common rake tasks
+
+* `bundle exec rake test` – performs tests
+* `bundle exec rake gem` – builds package (output in the subdirectory `pkg`)
+* `bundle exec rake docs` – render the documentation (output in the subdirectory `doc`)
+
+## Credits
+
+Original gem by Paweł Wilk (pw@gnu.org).
+
+[Heise Media Polska](http://www.heise-online.pl/) supports Free Software and contributed to the original library.
+
+Modernization for Ruby 3.4+ by Alexander Grebennik.
+
+## License
+
+Copyright (c) 2011-2013 by Paweł Wilk.
+Copyright (c) 2025 by Alexander Grebennik (modernization).
+
+i18n-inflector 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 [LGPL](docs/LGPL)), or Ruby's license (see [COPYING](docs/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.

data/docs/COPYING

@@ -0,0 +1,57 @@
+i18n-inflector is copyrighted free software owned by Paweł Wilk (pw@gnu.org). The Owner of this software permits you to redistribute and/or modify the software under either the terms of the LGPL version 3 (see the file {file:docs/LGPL LGPL-LICENSE}), or the conditions below ("Ruby License").
+
+== 1.
+
+You may make and give away verbatim copies of the source form of this software without restriction, provided that you retain ALL of the
+original copyright notices and associated disclaimers.
+
+== 2.
+
+You may modify your copy of the software in any way, provided that you do at least ONE of the following:
+
+a) place your modifications in the Public Domain or otherwise make them Freely Available, such as by posting said
+modifications to Usenet or an equivalent medium, or by allowing
+the author to include your modifications in the software.
+
+b) use the modified software only within your corporation or
+organization.
+
+c) give non-standard binaries non-standard names, with
+instructions on where to get the original software distribution.
+
+d) make other distribution arrangements with the Owner.
+
+== 3.
+
+You may distribute the software in object code or binary form, provided that you do at least ONE of the following:
+
+a) distribute the binaries and library files of the software,
+together with instructions (in a manual page or equivalent)
+on where to get the original distribution.
+
+b) accompany the distribution with the machine-readable source of
+the software.
+
+c) give non-standard binaries non-standard names, with
+instructions on where to get the original software distribution.
+
+d) make other distribution arrangements with the Owner.
+
+== 4.
+
+You may modify and include parts of the software into any other software (possibly commercial), provided you comply with the terms in
+Sections 1, 2, and 3 above. But some files in the distribution are not written by the Owner, so they may be made available to you
+under different terms.
+
+For the list of those files and their copying conditions, see the
+file LEGAL.
+
+== 5.
+
+The scripts and library files supplied as input to or produced as output from the software do not automatically fall under the
+copyright of the software, but belong to whoever generated them, and may be sold commercially, and may be aggregated with this software.
+
+== 6.
+
+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.
+