Fixed Broken Shit

This commit is contained in:
2022-10-30 14:32:20 -07:00
parent 7335796263
commit 4dabf5a6bf
635 changed files with 74885 additions and 17688 deletions

52
includes/vendor/pomo/pomo/README.md vendored Normal file
View File

@ -0,0 +1,52 @@
POMO
====
[![Latest Release](https://img.shields.io/packagist/v/pomo/pomo.svg)](https://packagist.org/packages/pomo/pomo)
[![Build Status](https://travis-ci.org/LeoColomb/pomo.svg?branch=master)](https://travis-ci.org/LeoColomb/pomo)
[![Code Climate](https://img.shields.io/codeclimate/github/LeoColomb/pomo.svg)](https://codeclimate.com/github/LeoColomb/pomo)
**Gettext library to translate with I18n**.
[Why use it](http://codex.wordpress.org/I18n_for_WordPress_Developers).
Usage
-----
```php
<?php
use POMO\MO;
// Create MO object
$translations = new MO();
// Import MO file
$translations->import_from_file($the_mo_filepath);
// Translate
$translations->translate($text);
```
Installation
------------
The easiest way to install POMO is via [composer](http://getcomposer.org/).
Create the following `composer.json` file and run the `php composer.phar install` command to install it.
```json
{
"require": {
"pomo/pomo": "*"
}
}
```
```php
<?php
require 'vendor/autoload.php';
use POMO\MO;
...
```
Requirements
------------
POMO works with PHP 5.3 or above.
License
-------
POMO is licensed under the [GPLv2 License](LICENSE).

385
includes/vendor/pomo/pomo/src/MO.php vendored Normal file
View File

@ -0,0 +1,385 @@
<?php
/**
* This file is part of the POMO package.
*
* @copyright 2014 POMO
* @license GPL
*/
namespace POMO;
use POMO\Streams\FileReader;
use POMO\Streams\NOOPReader;
use POMO\Translations\EntryTranslations;
use POMO\Translations\GettextTranslations;
/**
* Class for working with MO files.
*/
class MO extends GettextTranslations
{
public $_nplurals = 2;
/**
* Loaded MO file.
*
* @var string
*/
private $filename = '';
/**
* Returns the loaded MO file.
*
* @return string The loaded MO file.
*/
public function get_filename()
{
return $this->filename;
}
/**
* Fills up with the entries from MO file $filename.
*
* @param string $filename MO file to load
*
* @return bool Success
*/
public function import_from_file($filename)
{
$reader = new FileReader($filename);
if (!$reader->is_resource()) {
return false;
}
$this->filename = (string) $filename;
return $this->import_from_reader($reader);
}
/**
* @param string $filename
*
* @return bool
*/
public function export_to_file($filename)
{
$fh = fopen($filename, 'wb');
if (!$fh) {
return false;
}
$res = $this->export_to_file_handle($fh);
fclose($fh);
return $res;
}
/**
* @return string|false
*/
public function export()
{
$tmp_fh = fopen('php://temp', 'r+');
if (!$tmp_fh) {
return false;
}
$this->export_to_file_handle($tmp_fh);
rewind($tmp_fh);
return stream_get_contents($tmp_fh);
}
/**
* @param EntryTranslations $entry
*
* @return bool
*/
public function is_entry_good_for_export(EntryTranslations $entry)
{
if (empty($entry->translations)) {
return false;
}
if (!array_filter($entry->translations)) {
return false;
}
return true;
}
/**
* @param resource $fh
*
* @return true
*/
public function export_to_file_handle($fh)
{
$entries = array_filter(
$this->entries,
array($this, 'is_entry_good_for_export')
);
ksort($entries);
$magic = 0x950412de;
$revision = 0;
$total = count($entries) + 1; // all the headers are one entry
$originals_lenghts_addr = 28;
$translations_lenghts_addr = $originals_lenghts_addr + 8 * $total;
$size_of_hash = 0;
$hash_addr = $translations_lenghts_addr + 8 * $total;
$current_addr = $hash_addr;
fwrite($fh, pack(
'V*',
$magic,
$revision,
$total,
$originals_lenghts_addr,
$translations_lenghts_addr,
$size_of_hash,
$hash_addr
));
fseek($fh, $originals_lenghts_addr);
// headers' msgid is an empty string
fwrite($fh, pack('VV', 0, $current_addr));
$current_addr++;
$originals_table = chr(0);
$reader = new NOOPReader();
foreach ($entries as $entry) {
$originals_table .= $this->export_original($entry).chr(0);
$length = $reader->strlen($this->export_original($entry));
fwrite($fh, pack('VV', $length, $current_addr));
$current_addr += $length + 1; // account for the NULL byte after
}
$exported_headers = $this->export_headers();
fwrite($fh, pack(
'VV',
$reader->strlen($exported_headers),
$current_addr
));
$current_addr += strlen($exported_headers) + 1;
$translations_table = $exported_headers.chr(0);
foreach ($entries as $entry) {
$translations_table .= $this->export_translations($entry).chr(0);
$length = $reader->strlen($this->export_translations($entry));
fwrite($fh, pack('VV', $length, $current_addr));
$current_addr += $length + 1;
}
fwrite($fh, $originals_table);
fwrite($fh, $translations_table);
return true;
}
/**
* @param EntryTranslations $entry
*
* @return string
*/
public function export_original(EntryTranslations $entry)
{
//TODO: warnings for control characters
$exported = $entry->singular;
if ($entry->is_plural) {
$exported .= chr(0).$entry->plural;
}
if (!is_null($entry->context)) {
$exported = $entry->context.chr(4).$exported;
}
return $exported;
}
/**
* @param EntryTranslations $entry
*
* @return string
*/
public function export_translations(EntryTranslations $entry)
{
//TODO: warnings for control characters
return $entry->is_plural ? implode(chr(0), $entry->translations) : $entry->translations[0];
}
/**
* @return string
*/
public function export_headers()
{
$exported = '';
foreach ($this->headers as $header => $value) {
$exported .= "$header: $value\n";
}
return $exported;
}
/**
* @param int $magic
*
* @return string|false
*/
public function get_byteorder($magic)
{
// The magic is 0x950412de
$magic_little = (int) -1794895138;
$magic_little_64 = (int) 2500072158;
// 0xde120495
$magic_big = ((int) -569244523) & 0xFFFFFFFF;
if ($magic_little == $magic || $magic_little_64 == $magic) {
return 'little';
} elseif ($magic_big == $magic) {
return 'big';
} else {
return false;
}
}
/**
* @param FileReader $reader
*
* @return bool
*/
public function import_from_reader(FileReader $reader)
{
$endian_string = $this->get_byteorder($reader->readint32());
if (false === $endian_string) {
return false;
}
$reader->setEndian($endian_string);
$endian = ('big' == $endian_string) ? 'N' : 'V';
$header = $reader->read(24);
if ($reader->strlen($header) != 24) {
return false;
}
// parse header
$header = unpack("{$endian}revision/{$endian}total/{$endian}originals_lenghts_addr/{$endian}translations_lenghts_addr/{$endian}hash_length/{$endian}hash_addr", $header);
if (!is_array($header)) {
return false;
}
// support revision 0 of MO format specs, only
if ($header['revision'] != 0) {
return false;
}
// seek to data blocks
$reader->seekto($header['originals_lenghts_addr']);
// read originals' indices
$originals_lengths_length = $header['translations_lenghts_addr'] - $header['originals_lenghts_addr'];
if ($originals_lengths_length != $header['total'] * 8) {
return false;
}
$originals = $reader->read($originals_lengths_length);
if ($reader->strlen($originals) != $originals_lengths_length) {
return false;
}
// read translations' indices
$translations_lenghts_length = $header['hash_addr'] - $header['translations_lenghts_addr'];
if ($translations_lenghts_length != $header['total'] * 8) {
return false;
}
$translations = $reader->read($translations_lenghts_length);
if ($reader->strlen($translations) != $translations_lenghts_length) {
return false;
}
// transform raw data into set of indices
$originals = $reader->str_split($originals, 8);
$translations = $reader->str_split($translations, 8);
// skip hash table
$strings_addr = $header['hash_addr'] + $header['hash_length'] * 4;
$reader->seekto($strings_addr);
$strings = $reader->read_all();
$reader->close();
for ($i = 0; $i < $header['total']; $i++) {
$o = unpack("{$endian}length/{$endian}pos", $originals[$i]);
$t = unpack("{$endian}length/{$endian}pos", $translations[$i]);
if (!$o || !$t) {
return false;
}
// adjust offset due to reading strings to separate space before
$o['pos'] -= $strings_addr;
$t['pos'] -= $strings_addr;
$original = $reader->substr($strings, $o['pos'], $o['length']);
$translation = $reader->substr($strings, $t['pos'], $t['length']);
if ('' === $original) {
$this->set_headers($this->make_headers($translation));
} else {
$entry = &static::make_entry($original, $translation);
$this->entries[$entry->key()] = &$entry;
}
}
return true;
}
/**
* Build a from original string and translation strings,
* found in a MO file.
*
* @param string $original original string to translate from MO file.
* Might contain 0x04 as context separator or
* 0x00 as singular/plural separator
* @param string $translation translation string from MO file.Might contain
* 0x00 as a plural translations separator
*
* @return EntryTranslations New entry
*/
public static function &make_entry($original, $translation)
{
$entry = new EntryTranslations();
// look for context
$parts = explode(chr(4), $original);
if (isset($parts[1])) {
$original = $parts[1];
$entry->context = $parts[0];
}
// look for plural original
$parts = explode(chr(0), $original);
$entry->singular = $parts[0];
if (isset($parts[1])) {
$entry->is_plural = true;
$entry->plural = $parts[1];
}
// plural translations are also separated by \0
$entry->translations = explode(chr(0), $translation);
return $entry;
}
/**
* @param int $count
*
* @return string
*/
public function select_plural_form($count)
{
return $this->gettext_select_plural_form($count);
}
/**
* @return int
*/
public function get_plural_forms_count()
{
return $this->_nplurals;
}
}

587
includes/vendor/pomo/pomo/src/PO.php vendored Normal file
View File

@ -0,0 +1,587 @@
<?php
/**
* This file is part of the POMO package.
*
* @copyright 2014 POMO
* @license GPL
*/
namespace POMO;
use POMO\Translations\EntryTranslations;
use POMO\Translations\GettextTranslations;
ini_set('auto_detect_line_endings', 1);
/**
* Class for working with PO files.
*/
class PO extends GettextTranslations
{
const MAX_LINE_LEN = 79;
public $comments_before_headers = '';
/**
* Exports headers to a PO entry.
*
* @return string msgid/msgstr PO entry for this PO file headers, doesn't
* contain newline at the end
*/
public function export_headers()
{
$header_string = '';
foreach ($this->headers as $header => $value) {
$header_string .= "$header: $value\n";
}
$poified = self::poify($header_string);
if ($this->comments_before_headers) {
$before_headers = self::prepend_each_line(
rtrim($this->comments_before_headers)."\n",
'# '
);
} else {
$before_headers = '';
}
return rtrim("{$before_headers}msgid \"\"\nmsgstr $poified");
}
/**
* Exports all entries to PO format.
*
* @return string sequence of mgsgid/msgstr PO strings, doesn't containt
* newline at the end
*/
public function export_entries()
{
//TODO: sorting
return implode("\n\n", array_map(
array(__NAMESPACE__.'\PO', 'export_entry'),
$this->entries
));
}
/**
* Exports the whole PO file as a string.
*
* @param bool $include_headers whether to include the headers in the
* export
*
* @return string ready for inclusion in PO file string for headers and all
* the enrtries
*/
public function export($include_headers = true)
{
$res = '';
if ($include_headers) {
$res .= $this->export_headers();
$res .= "\n\n";
}
$res .= $this->export_entries();
return $res;
}
/**
* Same as {@link export}, but writes the result to a file.
*
* @param string $filename where to write the PO string
* @param bool $include_headers whether to include tje headers in the
* export
*
* @return bool true on success, false on error
*/
public function export_to_file($filename, $include_headers = true)
{
$fh = fopen($filename, 'w');
if (false === $fh) {
return false;
}
$export = $this->export($include_headers);
$res = fwrite($fh, $export);
if (false === $res) {
return false;
}
return fclose($fh);
}
/**
* Text to include as a comment before the start of the PO contents.
*
* Doesn't need to include # in the beginning of lines, these are added
* automatically
*
* @param string $text Comment text
*/
public function set_comment_before_headers($text)
{
$this->comments_before_headers = $text;
}
/**
* Formats a string in PO-style.
*
* @param string $string the string to format
*
* @return string the poified string
*/
public static function poify($string)
{
$quote = '"';
$slash = '\\';
$newline = "\n";
$replaces = array(
"$slash" => "$slash$slash",
"$quote" => "$slash$quote",
"\t" => '\t',
);
$string = str_replace(
array_keys($replaces),
array_values($replaces),
$string
);
$po = $quote.implode(
"${slash}n$quote$newline$quote",
explode($newline, $string)
).$quote;
// add empty string on first line for readbility
if (false !== strpos($string, $newline) &&
(substr_count($string, $newline) > 1 ||
!($newline === substr($string, -strlen($newline))))) {
$po = "$quote$quote$newline$po";
}
// remove empty strings
$po = str_replace("$newline$quote$quote", '', $po);
return $po;
}
/**
* Gives back the original string from a PO-formatted string.
*
* @param string $string PO-formatted string
*
* @return string enascaped string
*/
public static function unpoify($string)
{
$escapes = array('t' => "\t", 'n' => "\n", 'r' => "\r", '\\' => '\\');
$lines = array_map('trim', explode("\n", $string));
$lines = array_map(array(__NAMESPACE__.'\PO', 'trim_quotes'), $lines);
$unpoified = '';
$previous_is_backslash = false;
foreach ($lines as $line) {
preg_match_all('/./u', $line, $chars);
$chars = $chars[0];
foreach ($chars as $char) {
if (!$previous_is_backslash) {
if ('\\' == $char) {
$previous_is_backslash = true;
} else {
$unpoified .= $char;
}
} else {
$previous_is_backslash = false;
$unpoified .= isset($escapes[$char]) ? $escapes[$char] : $char;
}
}
}
// Standardise the line endings on imported content, technically PO files shouldn't contain \r
$unpoified = str_replace(array("\r\n", "\r"), "\n", $unpoified);
return $unpoified;
}
/**
* Inserts $with in the beginning of every new line of $string and
* returns the modified string.
*
* @param string $string prepend lines in this string
* @param string $with prepend lines with this string
*
* @return string The modified string
*/
public static function prepend_each_line($string, $with)
{
$lines = explode("\n", $string);
$append = '';
if ("\n" === substr($string, -1) && '' === end($lines)) {
// Last line might be empty because $string was terminated
// with a newline, remove it from the $lines array,
// we'll restore state by re-terminating the string at the end
array_pop($lines);
$append = "\n";
}
foreach ($lines as &$line) {
$line = $with.$line;
}
unset($line);
return implode("\n", $lines).$append;
}
/**
* Prepare a text as a comment -- wraps the lines and prepends #
* and a special character to each line.
*
* @param string $text the comment text
* @param string $char character to denote a special PO comment,
* like :, default is a space
*
* @return string The modified string
*/
private static function comment_block($text, $char = ' ')
{
$text = wordwrap($text, self::MAX_LINE_LEN - 3);
return self::prepend_each_line($text, "#$char ");
}
/**
* Builds a string from the entry for inclusion in PO file.
*
* @static
*
* @param EntryTranslations &$entry the entry to convert to po string
*
* @return false|string PO-style formatted string for the entry or
* false if the entry is empty
*/
public static function export_entry(EntryTranslations &$entry)
{
if (null === $entry->singular || '' === $entry->singular) {
return false;
}
$po = array();
if (!empty($entry->translator_comments)) {
$po[] = self::comment_block($entry->translator_comments);
}
if (!empty($entry->extracted_comments)) {
$po[] = self::comment_block($entry->extracted_comments, '.');
}
if (!empty($entry->references)) {
$po[] = self::comment_block(implode(' ', $entry->references), ':');
}
if (!empty($entry->flags)) {
$po[] = self::comment_block(implode(', ', $entry->flags), ',');
}
if (!is_null($entry->context)) {
$po[] = 'msgctxt '.self::poify($entry->context);
}
$po[] = 'msgid '.self::poify($entry->singular);
if (!$entry->is_plural) {
$translation = empty($entry->translations) ?
'' :
$entry->translations[0];
$translation = self::match_begin_and_end_newlines($translation, $entry->singular);
$po[] = 'msgstr '.self::poify($translation);
} else {
$po[] = 'msgid_plural '.self::poify($entry->plural);
$translations = empty($entry->translations) ?
array('', '') :
$entry->translations;
foreach ($translations as $i => $translation) {
$translation = self::match_begin_and_end_newlines($translation, $entry->plural);
$po[] = "msgstr[$i] ".self::poify($translation);
}
}
return implode("\n", $po);
}
/**
* @param $translation
* @param $original
*
* @return string
*/
public static function match_begin_and_end_newlines($translation, $original)
{
if ('' === $translation) {
return $translation;
}
$original_begin = "\n" === substr($original, 0, 1);
$original_end = "\n" === substr($original, -1);
$translation_begin = "\n" === substr($translation, 0, 1);
$translation_end = "\n" === substr($translation, -1);
if ($original_begin) {
if (!$translation_begin) {
$translation = "\n".$translation;
}
} elseif ($translation_begin) {
$translation = ltrim($translation, "\n");
}
if ($original_end) {
if (!$translation_end) {
$translation .= "\n";
}
} elseif ($translation_end) {
$translation = rtrim($translation, "\n");
}
return $translation;
}
/**
* @param string $filename
*
* @return bool
*/
public function import_from_file($filename)
{
$f = fopen($filename, 'r');
if (!$f) {
return false;
}
$lineno = 0;
$res = false;
while (true) {
$res = $this->read_entry($f, $lineno);
if (!$res) {
break;
}
if ($res['entry']->singular == '') {
$this->set_headers(
$this->make_headers($res['entry']->translations[0])
);
} else {
$this->add_entry($res['entry']);
}
}
self::read_line($f, 'clear');
if (false === $res) {
return false;
}
if (!$this->headers && !$this->entries) {
return false;
}
return true;
}
/**
* Helper function for read_entry.
*
* @param string $context
*
* @return bool
*/
protected static function is_final($context)
{
return ($context === 'msgstr') || ($context === 'msgstr_plural');
}
/**
* @param resource $f
* @param int $lineno
*
* @return null|false|array
*/
public function read_entry($f, $lineno = 0)
{
$entry = new EntryTranslations();
// where were we in the last step
// can be: comment, msgctxt, msgid, msgid_plural, msgstr, msgstr_plural
$context = '';
$msgstr_index = 0;
while (true) {
$lineno++;
$line = self::read_line($f);
if (!$line) {
if (feof($f)) {
if (self::is_final($context)) {
break;
} elseif (!$context) { // we haven't read a line and eof came
return;
} else {
return false;
}
} else {
return false;
}
}
if ($line == "\n") {
continue;
}
$line = trim($line);
if (preg_match('/^#/', $line, $m)) {
// the comment is the start of a new entry
if (self::is_final($context)) {
self::read_line($f, 'put-back');
$lineno--;
break;
}
// comments have to be at the beginning
if ($context && $context != 'comment') {
return false;
}
// add comment
$this->add_comment_to_entry($entry, $line);
} elseif (preg_match('/^msgctxt\s+(".*")/', $line, $m)) {
if (self::is_final($context)) {
self::read_line($f, 'put-back');
$lineno--;
break;
}
if ($context && $context != 'comment') {
return false;
}
$context = 'msgctxt';
$entry->context .= self::unpoify($m[1]);
} elseif (preg_match('/^msgid\s+(".*")/', $line, $m)) {
if (self::is_final($context)) {
self::read_line($f, 'put-back');
$lineno--;
break;
}
if ($context &&
$context != 'msgctxt' &&
$context != 'comment') {
return false;
}
$context = 'msgid';
$entry->singular .= self::unpoify($m[1]);
} elseif (preg_match('/^msgid_plural\s+(".*")/', $line, $m)) {
if ($context != 'msgid') {
return false;
}
$context = 'msgid_plural';
$entry->is_plural = true;
$entry->plural .= self::unpoify($m[1]);
} elseif (preg_match('/^msgstr\s+(".*")/', $line, $m)) {
if ($context != 'msgid') {
return false;
}
$context = 'msgstr';
$entry->translations = array(self::unpoify($m[1]));
} elseif (preg_match('/^msgstr\[(\d+)\]\s+(".*")/', $line, $m)) {
if ($context != 'msgid_plural' && $context != 'msgstr_plural') {
return false;
}
$context = 'msgstr_plural';
$msgstr_index = $m[1];
$entry->translations[$m[1]] = self::unpoify($m[2]);
} elseif (preg_match('/^".*"$/', $line)) {
$unpoified = self::unpoify($line);
switch ($context) {
case 'msgid':
$entry->singular .= $unpoified;
break;
case 'msgctxt':
$entry->context .= $unpoified;
break;
case 'msgid_plural':
$entry->plural .= $unpoified;
break;
case 'msgstr':
$entry->translations[0] .= $unpoified;
break;
case 'msgstr_plural':
$entry->translations[$msgstr_index] .= $unpoified;
break;
default:
return false;
}
} else {
return false;
}
}
$have_translations = false;
foreach ($entry->translations as $t) {
if ($t || ('0' === $t)) {
$have_translations = true;
break;
}
}
if (false === $have_translations) {
$entry->translations = array();
}
return array('entry' => $entry, 'lineno' => $lineno);
}
/**
* @param resource $f
* @param string $action
*
* @return bool
*/
public static function read_line($f, $action = 'read')
{
static $last_line = '';
static $use_last_line = false;
if ('clear' == $action) {
$last_line = '';
return true;
}
if ('put-back' == $action) {
$use_last_line = true;
return true;
}
$line = $use_last_line ? $last_line : fgets($f);
$line = ("\r\n" == substr($line, -2)) ?
rtrim($line, "\r\n")."\n" :
$line;
$last_line = $line;
$use_last_line = false;
return $line;
}
/**
* @param EntryTranslations $entry
* @param string $po_comment_line
*/
public function add_comment_to_entry(EntryTranslations &$entry, $po_comment_line)
{
$first_two = substr($po_comment_line, 0, 2);
$comment = trim(substr($po_comment_line, 2));
if ('#:' == $first_two) {
$entry->references = array_merge(
$entry->references,
preg_split('/\s+/', $comment)
);
} elseif ('#.' == $first_two) {
$entry->extracted_comments = trim(
$entry->extracted_comments."\n".$comment
);
} elseif ('#,' == $first_two) {
$entry->flags = array_merge(
$entry->flags,
preg_split('/,\s*/', $comment)
);
} else {
$entry->translator_comments = trim(
$entry->translator_comments."\n".$comment
);
}
}
/**
* @param string $s
*
* @return string
*/
public static function trim_quotes($s)
{
if (substr($s, 0, 1) == '"') {
$s = substr($s, 1);
}
if (substr($s, -1, 1) == '"') {
$s = substr($s, 0, -1);
}
return $s;
}
}

View File

@ -0,0 +1,347 @@
<?php
/**
* This file is part of the POMO package.
*/
namespace POMO\Parser;
use Exception;
/**
* A gettext Plural-Forms parser.
*/
class PluralForms
{
/**
* Operator characters.
*
* @var string OP_CHARS Operator characters.
*/
const OP_CHARS = '|&><!=%?:';
/**
* Valid number characters.
*
* @var string NUM_CHARS Valid number characters.
*/
const NUM_CHARS = '0123456789';
/**
* Operator precedence.
*
* Operator precedence from highest to lowest. Higher numbers indicate
* higher precedence, and are executed first.
*
* @see https://en.wikipedia.org/wiki/Operators_in_C_and_C%2B%2B#Operator_precedence
*
* @var array Operator precedence from highest to lowest.
*/
protected static $op_precedence = array(
'%' => 6,
'<' => 5,
'<=' => 5,
'>' => 5,
'>=' => 5,
'==' => 4,
'!=' => 4,
'&&' => 3,
'||' => 2,
'?:' => 1,
'?' => 1,
'(' => 0,
')' => 0,
);
/**
* Tokens generated from the string.
*
* @var array List of tokens.
*/
protected $tokens = array();
/**
* Cache for repeated calls to the function.
*
* @var array Map of [int => PluralForms form value]
*/
protected $cache = array();
/**
* Constructor.
*
* @param string $str PluralForms function (just the bit after `plural=` from Plural-Forms)
* @throws Exception
*/
public function __construct($str)
{
$this->parse($str);
}
/**
* Parse a Plural-Forms string into tokens.
*
* Uses the shunting-yard algorithm to convert the string to Reverse Polish
* Notation tokens.
*
* @param string $str String to parse.
*
* @throws Exception
*/
protected function parse($str)
{
$pos = 0;
$len = strlen($str);
// Convert infix operators to postfix using the shunting-yard algorithm.
$output = array();
$stack = array();
while ($pos < $len) {
$next = substr($str, $pos, 1);
switch ($next) {
// Ignore whitespace
case ' ':
case "\t":
$pos++;
break;
// Variable (n)
case 'n':
$output[] = array('var');
$pos++;
break;
// Parentheses
case '(':
$stack[] = $next;
$pos++;
break;
case ')':
$found = false;
while (!empty($stack)) {
$o2 = $stack[count($stack) - 1];
if ($o2 !== '(') {
$output[] = array('op', array_pop($stack));
continue;
}
// Discard open paren.
array_pop($stack);
$found = true;
break;
}
if (!$found) {
throw new Exception('Mismatched parentheses');
}
$pos++;
break;
// Operators
case '|':
case '&':
case '>':
case '<':
case '!':
case '=':
case '%':
case '?':
$end_operator = strspn($str, self::OP_CHARS, $pos);
$operator = substr($str, $pos, $end_operator);
if (!array_key_exists($operator, self::$op_precedence)) {
throw new Exception(sprintf('Unknown operator "%s"', $operator));
}
while (!empty($stack)) {
$o2 = $stack[count($stack) - 1];
// Ternary is right-associative in C
if ($operator === '?:' || $operator === '?') {
if (self::$op_precedence[$operator] >= self::$op_precedence[$o2]) {
break;
}
} elseif (self::$op_precedence[$operator] > self::$op_precedence[$o2]) {
break;
}
$output[] = array('op', array_pop($stack));
}
$stack[] = $operator;
$pos += $end_operator;
break;
// Ternary "else"
case ':':
$found = false;
$s_pos = count($stack) - 1;
while ($s_pos >= 0) {
$o2 = $stack[$s_pos];
if ($o2 !== '?') {
$output[] = array('op', array_pop($stack));
$s_pos--;
continue;
}
// Replace.
$stack[$s_pos] = '?:';
$found = true;
break;
}
if (!$found) {
throw new Exception('Missing starting "?" ternary operator');
}
$pos++;
break;
// Default - number or invalid
default:
if ($next >= '0' && $next <= '9') {
$span = strspn($str, self::NUM_CHARS, $pos);
$output[] = array('value', intval(substr($str, $pos, $span)));
$pos += $span;
break;
}
throw new Exception(sprintf('Unknown symbol "%s"', $next));
}
}
while (!empty($stack)) {
$o2 = array_pop($stack);
if ($o2 === '(' || $o2 === ')') {
throw new Exception('Mismatched parentheses');
}
$output[] = array('op', $o2);
}
$this->tokens = $output;
}
/**
* Get the plural form for a number.
* Caches the value for repeated calls.
*
* @param int $num Number to get plural form for.
* @return int PluralForms form value.
* @throws Exception
*/
public function get($num)
{
if (isset($this->cache[$num])) {
return $this->cache[$num];
}
return $this->cache[$num] = $this->execute($num);
}
/**
* Execute the plural form function.
*
* @param int $n Variable "n" to substitute.
*
* @throws Exception
*
* @return int PluralForms form value.
*/
public function execute($n)
{
$stack = array();
$i = 0;
$total = count($this->tokens);
while ($i < $total) {
$next = $this->tokens[$i];
$i++;
if ($next[0] === 'var') {
$stack[] = $n;
continue;
} elseif ($next[0] === 'value') {
$stack[] = $next[1];
continue;
}
// Only operators left.
switch ($next[1]) {
case '%':
$v2 = array_pop($stack);
$v1 = array_pop($stack);
$stack[] = $v1 % $v2;
break;
case '||':
$v2 = array_pop($stack);
$v1 = array_pop($stack);
$stack[] = $v1 || $v2;
break;
case '&&':
$v2 = array_pop($stack);
$v1 = array_pop($stack);
$stack[] = $v1 && $v2;
break;
case '<':
$v2 = array_pop($stack);
$v1 = array_pop($stack);
$stack[] = $v1 < $v2;
break;
case '<=':
$v2 = array_pop($stack);
$v1 = array_pop($stack);
$stack[] = $v1 <= $v2;
break;
case '>':
$v2 = array_pop($stack);
$v1 = array_pop($stack);
$stack[] = $v1 > $v2;
break;
case '>=':
$v2 = array_pop($stack);
$v1 = array_pop($stack);
$stack[] = $v1 >= $v2;
break;
case '!=':
$v2 = array_pop($stack);
$v1 = array_pop($stack);
$stack[] = $v1 != $v2;
break;
case '==':
$v2 = array_pop($stack);
$v1 = array_pop($stack);
$stack[] = $v1 == $v2;
break;
case '?:':
$v3 = array_pop($stack);
$v2 = array_pop($stack);
$v1 = array_pop($stack);
$stack[] = $v1 ? $v2 : $v3;
break;
default:
throw new Exception(sprintf('Unknown operator "%s"', $next[1]));
}
}
if (count($stack) !== 1) {
throw new Exception('Too many values remaining on the stack');
}
return (int) $stack[0];
}
}

View File

@ -0,0 +1,24 @@
<?php
/**
* This file is part of the POMO package.
*/
namespace POMO\Streams;
/**
* Reads the contents of the file in the beginning.
*
* @author Danilo Segan <danilo@kvota.net>
*/
class CachedFileReader extends StringReader implements StreamInterface
{
public function __construct($filename)
{
parent::__construct();
$this->_str = file_get_contents($filename);
if (false === $this->_str) {
return false;
}
$this->_pos = 0;
}
}

View File

@ -0,0 +1,15 @@
<?php
/**
* This file is part of the POMO package.
*/
namespace POMO\Streams;
/**
* Reads the contents of the file in the beginning.
*
* @author Danilo Segan <danilo@kvota.net>
*/
class CachedIntFileReader extends CachedFileReader implements StreamInterface
{
}

View File

@ -0,0 +1,68 @@
<?php
/**
* This file is part of the POMO package.
*/
namespace POMO\Streams;
/**
* Classes, which help reading streams of data from files.
*
* @property bool|resource $_f
*
* @author Danilo Segan <danilo@kvota.net>
*/
class FileReader extends Reader implements StreamInterface
{
/**
* @param string $filename
*/
public function __construct($filename)
{
parent::__construct();
$this->_f = fopen($filename, 'rb');
}
public function read($bytes)
{
return fread($this->_f, $bytes);
}
public function seekto($pos)
{
if (-1 == fseek($this->_f, $pos, SEEK_SET)) {
return false;
}
$this->_pos = $pos;
return true;
}
public function is_resource()
{
return is_resource($this->_f);
}
/**
* @return bool
*/
public function feof()
{
return feof($this->_f);
}
public function close()
{
return fclose($this->_f);
}
public function read_all()
{
$all = '';
while (!$this->feof()) {
$all .= $this->read(4096);
}
return $all;
}
}

View File

@ -0,0 +1,24 @@
<?php
/**
* This file is part of the POMO package.
*/
namespace POMO\Streams;
/**
* Concrete Reader doing nothing.
*/
class NOOPReader extends Reader implements StreamInterface
{
public function read($bytes)
{
}
public function read_all()
{
}
public function seekto($pos)
{
}
}

View File

@ -0,0 +1,102 @@
<?php
/**
* This file is part of the POMO package.
*/
namespace POMO\Streams;
/**
* Classes, which help reading streams of data from files.
*
* @property bool $is_overloaded
* @property int $_pos
* @author Danilo Segan <danilo@kvota.net>
*/
abstract class Reader implements StreamInterface
{
public $endian = 'little';
public $_post = '';
public function __construct()
{
$this->is_overloaded = ((ini_get('mbstring.func_overload') & 2) != 0) &&
function_exists('mb_substr');
$this->_pos = 0;
}
public function setEndian($endian)
{
$this->endian = $endian;
}
public function readint32()
{
$bytes = $this->read(4);
if (4 != $this->strlen($bytes)) {
return false;
}
$endian_letter = ('big' == $this->endian) ? 'N' : 'V';
$int = unpack($endian_letter, $bytes);
return reset($int);
}
public function readint32array($count)
{
$bytes = $this->read(4 * $count);
if (4 * $count != $this->strlen($bytes)) {
return false;
}
$endian_letter = ('big' == $this->endian) ? 'N' : 'V';
return unpack($endian_letter.$count, $bytes);
}
public function substr($string, $start, $length)
{
if ($this->is_overloaded) {
return mb_substr($string, $start, $length, 'ascii');
} else {
return substr($string, $start, $length);
}
}
public function strlen($string)
{
if ($this->is_overloaded) {
return mb_strlen($string, 'ascii');
} else {
return strlen($string);
}
}
public function str_split($string, $chunk_size)
{
if (!function_exists('str_split')) {
$length = $this->strlen($string);
$out = array();
for ($i = 0; $i < $length; $i += $chunk_size) {
$out[] = $this->substr($string, $i, $chunk_size);
}
return $out;
} else {
return str_split($string, $chunk_size);
}
}
public function pos()
{
return $this->_pos;
}
public function is_resource()
{
return true;
}
public function close()
{
return true;
}
}

View File

@ -0,0 +1,92 @@
<?php
/**
* This file is part of the POMO package.
*/
namespace POMO\Streams;
interface StreamInterface
{
/**
* Sets the endianness of the file.
*
* @param $endian string 'big' or 'little'
*/
public function setEndian($endian);
/**
* Reads a 32bit Integer from the Stream.
*
* @return mixed The integer, corresponding to the next 32 bits from the
* stream of false if there are not enough bytes or on error
*/
public function readint32();
/**
* Reads an array of 32-bit Integers from the Stream.
*
* @param int $count How many elements should be read
*
* @return mixed Array of integers or false if there isn't
* enough data or on error
*/
public function readint32array($count);
/**
* @param string $bytes
*
* @return string
*/
public function read($bytes);
/**
* @return string
*/
public function read_all();
/**
* @param string $string
* @param int $start
* @param int $length
*
* @return string
*/
public function substr($string, $start, $length);
/**
* @param string $string
*
* @return int
*/
public function strlen($string);
/**
* @param string $string
* @param int $chunk_size
*
* @return array
*/
public function str_split($string, $chunk_size);
/**
* @return int
*/
public function pos();
/**
* @param int $pos
*
* @return int
*/
public function seekto($pos);
/**
* @return true
*/
public function is_resource();
/**
* @return true
*/
public function close();
}

View File

@ -0,0 +1,62 @@
<?php
/**
* This file is part of the POMO package.
*/
namespace POMO\Streams;
/**
* Provides file-like methods for manipulating a string instead
* of a physical file.
*
* @author Danilo Segan <danilo@kvota.net>
*/
class StringReader extends Reader implements StreamInterface
{
public $_str = '';
public function __construct($str = '')
{
parent::__construct();
$this->_str = $str;
$this->_pos = 0;
}
public function read($bytes)
{
$data = $this->substr($this->_str, $this->_pos, $bytes);
$this->_pos += $bytes;
if ($this->strlen($this->_str) < $this->_pos) {
$this->_pos = $this->strlen($this->_str);
}
return $data;
}
public function seekto($pos)
{
$this->_pos = $pos;
if ($this->strlen($this->_str) < $this->_pos) {
$this->_pos = $this->strlen($this->_str);
}
return $this->_pos;
}
/**
* @return int
*/
public function length()
{
return $this->strlen($this->_str);
}
public function read_all()
{
return $this->substr(
$this->_str,
$this->_pos,
$this->strlen($this->_str)
);
}
}

View File

@ -0,0 +1,98 @@
<?php
/**
* This file is part of the POMO package.
*
* @copyright 2014 POMO
* @license GPL
*/
namespace POMO\Translations;
/**
* Contains EntryTranslations class
* EntryTranslations class encapsulates a translatable string.
*/
class EntryTranslations
{
/**
* Whether the entry contains a string and its plural form, default is false.
*
* @var bool
*/
public $is_plural = false;
public $context = null;
public $singular = null;
public $plural = null;
public $translations = array();
public $translator_comments = '';
public $extracted_comments = '';
public $references = array();
public $flags = array();
/**
* @param array $args associative array, support following keys:
* - singular (string) -- the string to translate, if omitted and empty entry will be created
* - plural (string) -- the plural form of the string, setting this will set {@link $is_plural} to true
* - translations (array) -- translations of the string and possibly -- its plural forms
* - context (string) -- a string differentiating two equal strings used in different contexts
* - translator_comments (string) -- comments left by translators
* - extracted_comments (string) -- comments left by developers
* - references (array) -- places in the code this strings is used, in relative_to_root_path/file.php:linenum form
* - flags (array) -- flags like php-format
*/
public function __construct($args = array())
{
// if no singular -- empty object
if (!isset($args['singular'])) {
return;
}
// get member variable values from args hash
foreach ($args as $varname => $value) {
$this->$varname = $value;
}
if (isset($args['plural']) && $args['plural']) {
$this->is_plural = true;
}
if (!is_array($this->translations)) {
$this->translations = array();
}
if (!is_array($this->references)) {
$this->references = array();
}
if (!is_array($this->flags)) {
$this->flags = array();
}
}
/**
* Generates a unique key for this entry.
*
* @return string|bool the key or false if the entry is empty
*/
public function key()
{
if (null === $this->singular || '' === $this->singular) {
return false;
}
// Prepend context and EOT, like in MO files
$key = !$this->context ? $this->singular : $this->context.chr(4).$this->singular;
// Standardize on \n line endings
$key = str_replace(array("\r\n", "\r"), "\n", $key);
return $key;
}
/**
* @param object $other
*/
public function merge_with(&$other)
{
$this->flags = array_unique(array_merge($this->flags, $other->flags));
$this->references = array_unique(array_merge($this->references, $other->references));
if ($this->extracted_comments != $other->extracted_comments) {
$this->extracted_comments .= $other->extracted_comments;
}
}
}

View File

@ -0,0 +1,148 @@
<?php
/**
* This file is part of the POMO package.
*
* @copyright 2014 POMO
* @license GPL
*/
namespace POMO\Translations;
use POMO\Parser\PluralForms;
/**
* Class for a set of entries for translation and their associated headers.
*
* @property mixed $_nplurals
* @property callable $_gettext_select_plural_form
*/
class GettextTranslations extends Translations implements TranslationsInterface
{
/**
* The gettext implementation of select_plural_form.
*
* It lives in this class, because there are more than one descendand,
* which will use it and they can't share it effectively.
*
* @param int $count Items count
*
* @return mixed
*/
public function gettext_select_plural_form($count)
{
if (!isset($this->_gettext_select_plural_form)
|| is_null($this->_gettext_select_plural_form)) {
list($nplurals, $expression) = $this->nplurals_and_expression_from_header($this->get_header('Plural-Forms'));
$this->_nplurals = $nplurals;
$this->_gettext_select_plural_form = $this->make_plural_form_function($nplurals, $expression);
}
return call_user_func($this->_gettext_select_plural_form, $count);
}
/**
* @param $header
*
* @return array
*/
public function nplurals_and_expression_from_header($header)
{
if (preg_match('/^\s*nplurals\s*=\s*(\d+)\s*;\s+plural\s*=\s*(.+)$/', $header, $matches)) {
$nplurals = (int) $matches[1];
$expression = trim($matches[2]);
return array($nplurals, $expression);
} else {
return array(2, 'n != 1');
}
}
/**
* Makes a function, which will return the right translation index,
* according to the plural forms header.
*
* @param int $nplurals
* @param string $expression
*
* @return callable The right translation index
*/
public function make_plural_form_function($nplurals, $expression)
{
try {
$handler = new PluralForms(rtrim($expression, ';'));
return array($handler, 'get');
} catch (\Exception $e) {
// Fall back to default plural-form function.
return $this->make_plural_form_function(2, 'n != 1');
}
}
/**
* Adds parentheses to the inner parts of ternary operators in
* plural expressions, because PHP evaluates ternary operators
* from left to right.
*
* @param string $expression the expression without parentheses
*
* @return string the expression with parentheses added
*/
public function parenthesize_plural_exression($expression)
{
$expression .= ';';
$res = '';
$depth = 0;
for ($i = 0; $i < strlen($expression); ++$i) {
$char = $expression[$i];
switch ($char) {
case '?':
$res .= ' ? (';
$depth++;
break;
case ':':
$res .= ') : (';
break;
case ';':
$res .= str_repeat(')', $depth).';';
$depth = 0;
break;
default:
$res .= $char;
}
}
return rtrim($res, ';');
}
/**
* @param string $translation
*
* @return array
*/
public function make_headers($translation)
{
$headers = array();
// sometimes \ns are used instead of real new lines
$translation = str_replace('\n', "\n", $translation);
$lines = explode("\n", $translation);
foreach ($lines as $line) {
$parts = explode(':', $line, 2);
if (!isset($parts[1])) {
continue;
}
$headers[trim($parts[0])] = trim($parts[1]);
}
return $headers;
}
public function set_header($header, $value)
{
parent::set_header($header, $value);
if ('Plural-Forms' == $header) {
list($nplurals, $expression) = $this->nplurals_and_expression_from_header($this->get_header('Plural-Forms'));
$this->_nplurals = $nplurals;
$this->_gettext_select_plural_form = $this->make_plural_form_function($nplurals, $expression);
}
}
}

View File

@ -0,0 +1,69 @@
<?php
/**
* This file is part of the POMO package.
*
* @copyright 2014 POMO
* @license GPL
*/
namespace POMO\Translations;
/**
* Provides the same interface as Translations, but doesn't do anything.
*/
class NOOPTranslations implements TranslationsInterface
{
public $entries = array();
public $headers = array();
public function add_entry($entry)
{
return true;
}
public function set_header($header, $value)
{
}
public function set_headers($headers)
{
}
public function get_header($header)
{
return false;
}
public function translate_entry(EntryTranslations &$entry)
{
return false;
}
public function translate($singular, $context = null)
{
return $singular;
}
public function select_plural_form($count)
{
return 1 == $count ? 0 : 1;
}
public function get_plural_forms_count()
{
return 2;
}
public function translate_plural(
$singular,
$plural,
$count,
$context = null
) {
return 1 == $count ? $singular : $plural;
}
public function merge_with(TranslationsInterface &$other)
{
}
}

View File

@ -0,0 +1,146 @@
<?php
/**
* This file is part of the POMO package.
*
* @copyright 2014 POMO
* @license GPL
*/
namespace POMO\Translations;
/**
* Class for a set of entries for translation and their associated headers.
*/
class Translations implements TranslationsInterface
{
public $entries = array();
public $headers = array();
public function add_entry($entry)
{
if (is_array($entry)) {
$entry = new EntryTranslations($entry);
}
$key = $entry->key();
if (false === $key) {
return false;
}
$this->entries[$key] = &$entry;
return true;
}
/**
* @param array|EntryTranslations $entry
*
* @return bool
*/
public function add_entry_or_merge($entry)
{
if (is_array($entry)) {
$entry = new EntryTranslations($entry);
}
$key = $entry->key();
if (false === $key) {
return false;
}
if (isset($this->entries[$key])) {
$this->entries[$key]->merge_with($entry);
} else {
$this->entries[$key] = &$entry;
}
return true;
}
public function set_header($header, $value)
{
$this->headers[$header] = $value;
}
public function set_headers($headers)
{
foreach ($headers as $header => $value) {
$this->set_header($header, $value);
}
}
public function get_header($header)
{
return isset($this->headers[$header]) ? $this->headers[$header] : false;
}
public function translate_entry(EntryTranslations &$entry)
{
$key = $entry->key();
return isset($this->entries[$key]) ? $this->entries[$key] : false;
}
public function translate($singular, $context = null)
{
$entry = new EntryTranslations(array(
'singular' => $singular,
'context' => $context,
));
$translated = $this->translate_entry($entry);
return ($translated && !empty($translated->translations)) ?
$translated->translations[0] :
$singular;
}
public function select_plural_form($count)
{
return 1 == $count ? 0 : 1;
}
public function get_plural_forms_count()
{
return 2;
}
public function translate_plural(
$singular,
$plural,
$count,
$context = null
) {
$entry = new EntryTranslations(array(
'singular' => $singular,
'plural' => $plural,
'context' => $context,
));
$translated = $this->translate_entry($entry);
$index = $this->select_plural_form($count);
$total_plural_forms = $this->get_plural_forms_count();
if ($translated && 0 <= $index && $index < $total_plural_forms &&
is_array($translated->translations) &&
isset($translated->translations[$index])) {
return $translated->translations[$index];
} else {
return 1 == $count ? $singular : $plural;
}
}
public function merge_with(TranslationsInterface &$other)
{
foreach ($other->entries as $entry) {
$this->entries[$entry->key()] = $entry;
}
}
/**
* @param Translations $other
*/
public function merge_originals_with(Translations &$other)
{
foreach ($other->entries as $entry) {
if (!isset($this->entries[$entry->key()])) {
$this->entries[$entry->key()] = $entry;
} else {
$this->entries[$entry->key()]->merge_with($entry);
}
}
}
}

View File

@ -0,0 +1,119 @@
<?php
/**
* This file is part of the POMO package.
*
* @copyright 2014 POMO
* @license GPL
*/
namespace POMO\Translations;
/**
* Translations Interface that all POMO Translators must implement.
*
* @author Léo Colombaro <git@colombaro.fr>
*/
interface TranslationsInterface
{
/**
* Add entry to the PO structure.
*
* @param array|EntryTranslations &$entry
*
* @return bool true on success, false if the entry doesn't have a key
*/
public function add_entry($entry);
/**
* Sets $header PO header to $value.
*
* If the header already exists, it will be overwritten
*
* @todo This should be out of this class, it is gettext specific
*
* @param string $header header name, without trailing :
* @param string $value header value, without trailing \n
*/
public function set_header($header, $value);
/**
* @param array $headers
*/
public function set_headers($headers);
/**
* @param string $header
*
* @return false|string
*/
public function get_header($header);
/**
* @param EntryTranslations $entry
*
* @return mixed
*/
public function translate_entry(EntryTranslations &$entry);
/**
* Translate an entry in the singular way.
*
* @param string $singular Singular form of the entry
* @param mixed $context
*
* @return string The translation
*/
public function translate($singular, $context = null);
/**
* Given the number of items, returns the 0-based index of the plural form
* to use.
*
* Here, in the base Translations class, the common logic for English is
* implemented:
* 0 if there is one element, 1 otherwise
*
* This function should be overrided by the sub-classes. For example MO/PO
* can derive the logic from their headers.
*
* @param int $count number of items
*
* @return int
*/
public function select_plural_form($count);
/**
* @return int
*/
public function get_plural_forms_count();
/**
* Plural sensitive tranlation of an entry.
*
* Same behavior as {@link translate()} but with plural analyser, provide by
* {@link select_plural_form()} parser.
*
* @param string $singular Singular form of the entry
* @param string $plural Plural form of the entry
* @param int $count Number of items for the plural context
* @param mixed $context
*
* @return string The correct translation
*/
public function translate_plural(
$singular,
$plural,
$count,
$context = null
);
/**
* Merge $other in the current object.
*
* @param TranslationsInterface &$other Another Translation object, whose translations
* will be merged in this one
*
* @return void
**/
public function merge_with(TranslationsInterface &$other);
}