New language variant 'en-x-piglatin' for easier variant testing
authorLiangent <liangent@gmail.com>
Sat, 27 Jul 2013 23:01:54 +0000 (01:01 +0200)
committerC. Scott Ananian <cscott@cscott.net>
Mon, 12 Jun 2017 20:59:57 +0000 (16:59 -0400)
Guarded by the $wgUsePigLatinVariant variable, off by default.

Pig Latin is a language game where words in English are altered
according to the following rules:

* Words starting with a vowel have a '-way' suffix appended.
* Words starting with a consonant have the initial consonants (or 'qu'
  group) moved to the end and an '-ay' suffix appended.

https://en.wikipedia.org/wiki/Pig_Latin

* Added 'en-x-piglatin' as a language name.
* Added 'en' to LanguageConverter::$languagesWithVariants.
* Added LanguageEn class and its corresponding EnConverter which
  provides one-way translation from English to Pig Latin.
* Some minor internal changes in code that assumed that English
  doesn't have a language class or converter.

Bug: T45547
Depends-On: I1d9691c784032669979f8109c9a5f65cbf4122c9
Change-Id: I7fa2d85d6364958c5138366e8b4504a2697a8731

RELEASE-NOTES-1.30
autoload.php
includes/DefaultSettings.php
languages/Language.php
languages/LanguageConverter.php
languages/classes/LanguageEn.php [new file with mode: 0644]
languages/data/Names.php
tests/phpunit/includes/auth/AuthManagerTest.php
tests/phpunit/languages/LanguageTest.php

index f2cb871..0f5cb47 100644 (file)
@@ -27,6 +27,7 @@ production.
   ParserOptions would pollute the parser cache. Callers should use
   WikiPage::makeParserOptions() to create the ParserOptions object and only
   change options that affect the parser cache key.
+* (T45547) $wgUsePigLatinVariant added (off by default).
 
 === New features in 1.30 ===
 * (T37247) Output from Parser::parse() will now be wrapped in a div with
@@ -36,6 +37,10 @@ production.
   specific tags to be added by users.
 * Added a 'ParserOptionsRegister' hook to allow extensions to register
   additional parser options.
+* (T45547) Included Pig Latin, a language game in English, as a
+  LanguageConverter variant.  This allows English-speaking developers
+  to develop and test LanguageConverter more easily.  Pig Latin can be
+  enabled by setting $wgUsePigLatinVariant to true.
 
 === Languages updated in 1.30 ===
 
@@ -76,6 +81,11 @@ changes to languages because of Phabricator reports.
 
 * …
 
+==== Pig Latin added ====
+* (T45547) Added Pig Latin, a made-up English variant (en-x-piglatin),
+  for easier variant development and testing. Disabled by default. It can be
+  enabled by setting $wgUsePigLatinVariant to true.
+
 === Other changes in 1.30 ===
 * The use of an associative array for $wgProxyList, where the IP address is in
   the key instead of the value, is deprecated (e.g. [ '127.0.0.1' => 'value' ]).
index 6c5aff5..849df4d 100644 (file)
@@ -426,6 +426,7 @@ $wgAutoloadLocalClasses = [
        'EmailNotification' => __DIR__ . '/includes/mail/EmailNotification.php',
        'EmaillingJob' => __DIR__ . '/includes/jobqueue/jobs/EmaillingJob.php',
        'EmptyBagOStuff' => __DIR__ . '/includes/libs/objectcache/EmptyBagOStuff.php',
+       'EnConverter' => __DIR__ . '/languages/classes/LanguageEn.php',
        'EncryptedPassword' => __DIR__ . '/includes/password/EncryptedPassword.php',
        'EnhancedChangesList' => __DIR__ . '/includes/changes/EnhancedChangesList.php',
        'EnotifNotifyJob' => __DIR__ . '/includes/jobqueue/jobs/EnotifNotifyJob.php',
@@ -701,6 +702,7 @@ $wgAutoloadLocalClasses = [
        'LanguageConverter' => __DIR__ . '/languages/LanguageConverter.php',
        'LanguageCu' => __DIR__ . '/languages/classes/LanguageCu.php',
        'LanguageDsb' => __DIR__ . '/languages/classes/LanguageDsb.php',
+       'LanguageEn' => __DIR__ . '/languages/classes/LanguageEn.php',
        'LanguageEs' => __DIR__ . '/languages/classes/LanguageEs.php',
        'LanguageEt' => __DIR__ . '/languages/classes/LanguageEt.php',
        'LanguageFi' => __DIR__ . '/languages/classes/LanguageFi.php',
index 9436aa6..920e2e8 100644 (file)
@@ -3056,6 +3056,12 @@ $wgDisableTitleConversion = false;
  */
 $wgDefaultLanguageVariant = false;
 
+/**
+ * Whether to enable the pig latin variant of English (en-x-piglatin),
+ * used to ease variant development work.
+ */
+$wgUsePigLatinVariant = false;
+
 /**
  * Disabled variants array of language variant conversion.
  *
index fb45cf7..f84e21e 100644 (file)
@@ -203,10 +203,11 @@ class Language {
        /**
         * Create a language object for a given language code
         * @param string $code
+        * @param $fallback boolean Whether we're going through language fallback chain
         * @throws MWException
         * @return Language
         */
-       protected static function newFromCode( $code ) {
+       protected static function newFromCode( $code, $fallback = false ) {
                if ( !Language::isValidCode( $code ) ) {
                        throw new MWException( "Invalid language code \"$code\"" );
                }
@@ -220,7 +221,7 @@ class Language {
                }
 
                // Check if there is a language class for the code
-               $class = self::classFromCode( $code );
+               $class = self::classFromCode( $code, $fallback );
                if ( class_exists( $class ) ) {
                        $lang = new $class;
                        return $lang;
@@ -4338,10 +4339,11 @@ class Language {
 
        /**
         * @param string $code
+        * @param boolean $fallback Whether we're going through language fallback chain
         * @return string Name of the language class
         */
-       public static function classFromCode( $code ) {
-               if ( $code == 'en' ) {
+       public static function classFromCode( $code, $fallback = true ) {
+               if ( $fallback && $code == 'en' ) {
                        return 'Language';
                } else {
                        return 'Language' . str_replace( '-', '_', ucfirst( $code ) );
index 5382df4..19d644c 100644 (file)
@@ -36,6 +36,7 @@ class LanguageConverter {
         * @var array
         */
        static public $languagesWithVariants = [
+               'en',
                'gan',
                'iu',
                'kk',
diff --git a/languages/classes/LanguageEn.php b/languages/classes/LanguageEn.php
new file mode 100644 (file)
index 0000000..dcb7a91
--- /dev/null
@@ -0,0 +1,85 @@
+<?php
+/**
+ * English specific code.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ * http://www.gnu.org/copyleft/gpl.html
+ *
+ * @file
+ * @ingroup Language
+ */
+
+class EnConverter extends LanguageConverter {
+       /**
+        * Dummy methods required by base class.
+        */
+       function loadDefaultTables() {
+               $this->mTables = [
+                       'en' => new ReplacementArray(),
+                       'en-x-piglatin' => new ReplacementArray(),
+               ];
+       }
+
+       /**
+        * Translates text into Pig Latin. This allows developers to test the language variants
+        * functionality and user interface without having to switch wiki language away from default.
+        *
+        * @param $text string
+        * @param $toVariant string
+        * @return string
+        */
+       function translate( $text, $toVariant ) {
+               if ( $toVariant === 'en-x-piglatin' ) {
+                       // Only process words composed of standard English alphabet, leave the rest unchanged.
+                       // This skips some English words like 'naïve' or 'résumé', but we can live with that.
+                       // Ignore single letters and words which aren't lowercase or uppercase-first.
+                       return preg_replace_callback( '/[A-Za-z][a-z]+/', function ( $matches ) {
+                               $word = $matches[0];
+                               if ( preg_match( '/^[aeiou]/i', $word ) ) {
+                                       return $word . 'way';
+                               } else {
+                                       return preg_replace_callback( '/^(qu|[^aeiou][^aeiouy]*)(.*)$/i', function ( $m ) {
+                                               $ucfirst = strtoupper( $m[1][0] ) === $m[1][0];
+                                               if ( $ucfirst ) {
+                                                       return ucfirst( $m[2] ) . lcfirst( $m[1] ) . 'ay';
+                                               } else {
+                                                       return $m[2] . $m[1] . 'ay';
+                                               }
+                                       }, $word );
+                               }
+                       }, $text );
+               } else {
+                       return $text;
+               }
+       }
+}
+
+/**
+ * English
+ *
+ * @ingroup Language
+ */
+class LanguageEn extends Language {
+       function __construct() {
+               global $wgUsePigLatinVariant, $wgHooks;
+
+               parent::__construct();
+
+               if ( $wgUsePigLatinVariant ) {
+                       $this->mConverter = new EnConverter( $this, 'en', [ 'en', 'en-x-piglatin' ] );
+                       $wgHooks['PageContentSaveComplete'][] = $this->mConverter;
+               }
+       }
+}
index 76ced3e..21479f1 100644 (file)
@@ -146,6 +146,7 @@ class Names {
                'en' => 'English', # English
                'en-ca' => 'Canadian English', # Canadian English
                'en-gb' => 'British English', # British English
+               'en-x-piglatin' => 'Igpay Atinlay', # Pig Latin (for variant development)
                'eo' => 'Esperanto', # Esperanto
                'es' => 'español', # Spanish
                'et' => 'eesti', # Estonian
index 015fb3e..a840599 100644 (file)
@@ -611,7 +611,7 @@ class AuthManagerTest extends \MediaWikiTestCase {
                $this->assertSame( 'de', $user->getOption( 'language' ) );
                $this->assertSame( 'zh', $user->getOption( 'variant' ) );
 
-               $this->setMwGlobals( 'wgContLang', \Language::factory( 'en' ) );
+               $this->setMwGlobals( 'wgContLang', \Language::factory( 'fr' ) );
 
                $user = \User::newFromName( self::usernameForCreation() );
                $user->addToDatabase();
index 22fd7b8..a474f20 100644 (file)
@@ -1739,9 +1739,8 @@ class LanguageTest extends LanguageClassesTestCase {
                        [ 'zh', 'zh', 'zh is defined as the parent language of zh, '
                                . 'because zh converter can convert zh-cn to zh' ],
                        [ 'zh-invalid', null, 'do not be fooled by arbitrarily composed language codes' ],
-                       [ 'en-gb', null, 'en does not have converter' ],
-                       [ 'en', null, 'en does not have converter. Although FakeConverter '
-                                       . 'handles en -> en conversion but it is useless' ],
+                       [ 'de-formal', null, 'de does not have converter' ],
+                       [ 'de', null, 'de does not have converter' ],
                ];
        }