WebSVN – lars-tiefland.cakephp – /cake/console/libs/tasks/extract.php

<?php
/* SVN FILE: $Id: extract.php 7945 2008-12-19 02:16:01Z gwoo $ */
/**
 * Short description for file.
 *
 * Long description for file
 *
 * PHP versions 4 and 5
 *
 * CakePHP(tm) :  Rapid Development Framework (http://www.cakephp.org)
 * Copyright 2005-2008, Cake Software Foundation, Inc. (http://www.cakefoundation.org)
 *
 * Licensed under The MIT License
 * Redistributions of files must retain the above copyright notice.
 *
 * @filesource
 * @copyright     Copyright 2005-2008, Cake Software Foundation, Inc. (http://www.cakefoundation.org)
 * @link          http://www.cakefoundation.org/projects/info/cakephp CakePHP(tm) Project
 * @package       cake
 * @subpackage    cake.cake.console.libs
 * @since         CakePHP(tm) v 1.2.0.5012
 * @version       $Revision: 7945 $
 * @modifiedby    $LastChangedBy: gwoo $
 * @lastmodified  $Date: 2008-12-18 18:16:01 -0800 (Thu, 18 Dec 2008) $
 * @license       http://www.opensource.org/licenses/mit-license.php The MIT License
 */
/**
 * Only used when -debug option
 */
        ob_start();

        $singularReturn = __('Singular string  return __()', true);
        $singularEcho = __('Singular string  echo __()');

        $pluralReturn = __n('% apple in the bowl (plural string return __n())', '% apples in the blowl (plural string 2 return __n())', 3, true);
        $pluralEcho = __n('% apple in the bowl (plural string 2 echo __n())', '% apples in the blowl (plural string 2 echo __n()', 3);

        $singularDomainReturn = __d('controllers', 'Singular string domain lookup return __d()', true);
        $singularDomainEcho = __d('controllers', 'Singular string domain lookup echo __d()');

        $pluralDomainReturn = __dn('controllers', '% pears in the bowl (plural string domain lookup return __dn())', '% pears in the blowl (plural string domain lookup return __dn())', 3, true);
        $pluralDomainEcho = __dn('controllers', '% pears in the bowl (plural string domain lookup echo __dn())', '% pears in the blowl (plural string domain lookup echo __dn())', 3);

        $singularDomainCategoryReturn = __dc('controllers', 'Singular string domain and category lookup return __dc()', 5, true);
        $singularDomainCategoryEcho = __dc('controllers', 'Singular string domain and category lookup echo __dc()', 5);

        $pluralDomainCategoryReturn = __dcn('controllers', '% apple in the bowl (plural string 1 domain and category lookup return __dcn())', '% apples in the blowl (plural string 2 domain and category lookup return __dcn())', 3, 5, true);
        $pluralDomainCategoryEcho = __dcn('controllers', '% apple in the bowl (plural string 1 domain and category lookup echo __dcn())', '% apples in the blowl (plural string 2 domain and category lookup echo __dcn())', 3, 5);

        $categoryReturn = __c('Category string lookup line return __c()', 5, true);
        $categoryEcho = __c('Category string  lookup line echo __c()', 5);

        ob_end_clean();
/**
 * Language string extractor
 *
 * @package       cake
 * @subpackage    cake.cake.console.libs
 */
class ExtractTask extends Shell{
/**
 * Path to use when looking for strings
 *
 * @var string
 * @access public
 */
        var $path = null;
/**
 * Files from where to extract
 *
 * @var array
 * @access public
 */
        var $files = array();
/**
 * Filename where to deposit translations
 *
 * @var string
 * @access private
 */
        var $__filename = 'default';
/**
 * True if all strings should be merged into one file
 *
 * @var boolean
 * @access private
 */
        var $__oneFile = true;
/**
 * Current file being processed
 *
 * @var string
 * @access private
 */
        var $__file = null;
/**
 * Extracted tokens
 *
 * @var array
 * @access private
 */
        var $__tokens = array();
/**
 * Extracted strings
 *
 * @var array
 * @access private
 */
        var $__strings = array();
/**
 * History of file versions
 *
 * @var array
 * @access private
 */
        var $__fileVersions = array();
/**
 * Destination path
 *
 * @var string
 * @access private
 */
        var $__output = null;
/**
 * Execution method always used for tasks
 *
 * @access public
 */
        function execute() {
                if (isset($this->params['files']) && !is_array($this->params['files'])) {
                        $this->files = explode(',', $this->params['files']);
                }
                if (isset($this->params['path'])) {
                        $this->path = $this->params['path'];
                } else {
                        $response = '';
                        while ($response == '') {
                                $response = $this->in("What is the full path you would like to extract?\nExample: " . $this->params['root'] . DS . "myapp\n[Q]uit", null, 'Q');
                                if (strtoupper($response) === 'Q') {
                                        $this->out('Extract Aborted');
                                        $this->_stop();
                                }
                        }

                        if (is_dir($response)) {
                                $this->path = $response;
                        } else {
                                $this->err('The directory path you supplied was not found. Please try again.');
                                $this->execute();
                        }
                }

                if (isset($this->params['debug'])) {
                        $this->path = ROOT;
                        $this->files = array(__FILE__);
                }

                if (isset($this->params['output'])) {
                        $this->__output = $this->params['output'];
                } else {
                        $response = '';
                        while ($response == '') {
                                $response = $this->in("What is the full path you would like to output?\nExample: " . $this->path . DS . "locale\n[Q]uit", null, $this->path . DS . "locale");
                                if (strtoupper($response) === 'Q') {
                                        $this->out('Extract Aborted');
                                        $this->_stop();
                                }
                        }

                        if (is_dir($response)) {
                                $this->__output = $response . DS;
                        } else {
                                $this->err('The directory path you supplied was not found. Please try again.');
                                $this->execute();
                        }
                }

                if (empty($this->files)) {
                        $this->files = $this->__searchDirectory();
                }
                $this->__extract();
        }
/**
 * Extract text
 *
 * @access private
 */
        function __extract() {
                $this->out('');
                $this->out('');
                $this->out(__('Extracting...', true));
                $this->hr();
                $this->out(__('Path: ', true). $this->path);
                $this->out(__('Output Directory: ', true). $this->__output);
                $this->hr();

                $response = '';
                $filename = '';
                while ($response == '') {
                        $response = $this->in(__('Would you like to merge all translations into one file?', true), array('y','n'), 'y');
                        if (strtolower($response) == 'n') {
                                $this->__oneFile = false;
                        } else {
                                while ($filename == '') {
                                        $filename = $this->in(__('What should we name this file?', true), null, $this->__filename);
                                        if ($filename == '') {
                                                $this->out(__('The filesname you supplied was empty. Please try again.', true));
                                        }
                                }
                                $this->__filename = $filename;
                        }
                }
                $this->__extractTokens();
        }
/**
 * Show help options
 *
 * @access public
 */
        function help() {
                $this->out(__('CakePHP Language String Extraction:', true));
                $this->hr();
                $this->out(__('The Extract script generates .pot file(s) with translations', true));
                $this->out(__('By default the .pot file(s) will be place in the locale directory of -app', true));
                $this->out(__('By default -app is ROOT/app', true));
                $this->hr();
                $this->out(__('usage: cake i18n extract [command] [path...]', true));
                $this->out('');
                $this->out(__('commands:', true));
                $this->out(__('   -app [path...]: directory where your application is located', true));
                $this->out(__('   -root [path...]: path to install', true));
                $this->out(__('   -core [path...]: path to cake directory', true));
                $this->out(__('   -path [path...]: Full path to directory to extract strings', true));
                $this->out(__('   -output [path...]: Full path to output directory', true));
                $this->out(__('   -files: [comma separated list of files, full path to file is needed]', true));
                $this->out(__('   cake i18n extract help: Shows this help message.', true));
                $this->out(__('   -debug: Perform self test.', true));
                $this->out('');
        }
/**
 * Extract tokens out of all files to be processed
 *
 * @access private
 */
        function __extractTokens() {
                foreach ($this->files as $file) {
                        $this->__file = $file;
                        $this->out(sprintf(__('Processing %s...', true), $file));

                        $code = file_get_contents($file);

                        $this->__findVersion($code, $file);
                        $allTokens = token_get_all($code);
                        $this->__tokens = array();
                        $lineNumber = 1;

                        foreach ($allTokens as $token) {
                                if ((!is_array($token)) || (($token[0] != T_WHITESPACE) && ($token[0] != T_INLINE_HTML))) {
                                        if (is_array($token)) {
                                                $token[] = $lineNumber;
                                        }
                                        $this->__tokens[] = $token;
                                }

                                if (is_array($token)) {
                                        $lineNumber += count(split("\n", $token[1])) - 1;
                                } else {
                                        $lineNumber += count(split("\n", $token)) - 1;
                                }
                        }
                        unset($allTokens);
                        $this->basic();
                        $this->basic('__c');
                        $this->extended();
                        $this->extended('__dc', 2);
                        $this->extended('__n', 0, true);
                        $this->extended('__dn', 2, true);
                        $this->extended('__dcn', 4, true);
                }
                $this->__buildFiles();
                $this->__writeFiles();
                $this->out('Done.');
        }
/**
 * Will parse  __(), __c() functions
 *
 * @param string $functionName Function name that indicates translatable string (e.g: '__')
 * @access public
 */
        function basic($functionName = '__') {
                $count = 0;
                $tokenCount = count($this->__tokens);

                while (($tokenCount - $count) > 3) {
                        list($countToken, $parenthesis, $middle, $right) = array($this->__tokens[$count], $this->__tokens[$count + 1], $this->__tokens[$count + 2], $this->__tokens[$count + 3]);
                        if (!is_array($countToken)) {
                                $count++;
                                continue;
                        }

                        list($type, $string, $line) = $countToken;
                        if (($type == T_STRING) && ($string == $functionName) && ($parenthesis == '(')) {

                                if (in_array($right, array(')', ','))
                                && (is_array($middle) && ($middle[0] == T_CONSTANT_ENCAPSED_STRING))) {

                                        if ($this->__oneFile === true) {
                                                $this->__strings[$this->__formatString($middle[1])][$this->__file][] = $line;
                                        } else {
                                                $this->__strings[$this->__file][$this->__formatString($middle[1])][] = $line;
                                        }
                                } else {
                                        $this->__markerError($this->__file, $line, $functionName, $count);
                                }
                        }
                        $count++;
                }
        }
/**
 * Will parse __d(), __dc(), __n(), __dn(), __dcn()
 *
 * @param string $functionName Function name that indicates translatable string (e.g: '__')
 * @param integer $shift Number of parameters to shift to find translateable string
 * @param boolean $plural Set to true if function supports plural format, false otherwise
 * @access public
 */
        function extended($functionName = '__d', $shift = 0, $plural = false) {
                $count = 0;
                $tokenCount = count($this->__tokens);

                while (($tokenCount - $count) > 7) {
                        list($countToken, $firstParenthesis) = array($this->__tokens[$count], $this->__tokens[$count + 1]);
                        if (!is_array($countToken)) {
                                $count++;
                                continue;
                        }

                        list($type, $string, $line) = $countToken;
                        if (($type == T_STRING) && ($string == $functionName) && ($firstParenthesis == '(')) {
                                $position = $count;
                                $depth = 0;

                                while ($depth == 0) {
                                        if ($this->__tokens[$position] == '(') {
                                                $depth++;
                                        } elseif ($this->__tokens[$position] == ')') {
                                                $depth--;
                                        }
                                        $position++;
                                }

                                if ($plural) {
                                        $end = $position + $shift + 7;

                                        if ($this->__tokens[$position + $shift + 5] === ')') {
                                                $end = $position + $shift + 5;
                                        }

                                        if (empty($shift)) {
                                                list($singular, $firstComma, $plural, $seoncdComma, $endParenthesis) = array($this->__tokens[$position], $this->__tokens[$position + 1], $this->__tokens[$position + 2], $this->__tokens[$position + 3], $this->__tokens[$end]);
                                                $condition = ($seoncdComma == ',');
                                        } else {
                                                list($domain, $firstComma, $singular, $seoncdComma, $plural, $comma3, $endParenthesis) = array($this->__tokens[$position], $this->__tokens[$position + 1], $this->__tokens[$position + 2], $this->__tokens[$position + 3], $this->__tokens[$position + 4], $this->__tokens[$position + 5], $this->__tokens[$end]);
                                                $condition = ($comma3 == ',');
                                        }
                                        $condition = $condition &&
                                                (is_array($singular) && ($singular[0] == T_CONSTANT_ENCAPSED_STRING)) &&
                                                (is_array($plural) && ($plural[0] == T_CONSTANT_ENCAPSED_STRING));
                                } else {
                                        if ($this->__tokens[$position + $shift + 5] === ')') {
                                                $comma = $this->__tokens[$position + $shift + 3];
                                                $end = $position + $shift + 5;
                                        } else {
                                                $comma = null;
                                                $end = $position + $shift + 3;
                                        }

                                        list($domain, $firstComma, $text, $seoncdComma, $endParenthesis) = array($this->__tokens[$position], $this->__tokens[$position + 1], $this->__tokens[$position + 2], $comma, $this->__tokens[$end]);
                                        $condition = ($seoncdComma == ',' || $seoncdComma === null) &&
                                                (is_array($domain) && ($domain[0] == T_CONSTANT_ENCAPSED_STRING)) &&
                                                (is_array($text) && ($text[0] == T_CONSTANT_ENCAPSED_STRING));
                                }

                                if (($endParenthesis == ')') && $condition) {
                                        if ($this->__oneFile === true) {
                                                if ($plural) {
                                                        $this->__strings[$this->__formatString($singular[1]) . "\0" . $this->__formatString($plural[1])][$this->__file][] = $line;
                                                } else {
                                                        $this->__strings[$this->__formatString($text[1])][$this->__file][] = $line;
                                                }
                                        } else {
                                                if ($plural) {
                                                        $this->__strings[$this->__file][$this->__formatString($singular[1]) . "\0" . $this->__formatString($plural[1])][] = $line;
                                                } else {
                                                        $this->__strings[$this->__file][$this->__formatString($text[1])][] = $line;
                                                }
                                        }
                                } else {
                                        $this->__markerError($this->__file, $line, $functionName, $count);
                                }
                        }
                        $count++;
                }
        }
/**
 * Build the translate template file contents out of obtained strings
 *
 * @access private
 */
        function __buildFiles() {
                foreach ($this->__strings as $str => $fileInfo) {
                        $output = '';
                        $occured = $fileList = array();

                        if ($this->__oneFile === true) {
                                foreach ($fileInfo as $file => $lines) {
                                        $occured[] = "$file:" . join(';', $lines);

                                        if (isset($this->__fileVersions[$file])) {
                                                $fileList[] = $this->__fileVersions[$file];
                                        }
                                }
                                $occurances = join("\n#: ", $occured);
                                $occurances = str_replace($this->path, '', $occurances);
                                $output = "#: $occurances\n";
                                $filename = $this->__filename;

                                if (strpos($str, "\0") === false) {
                                        $output .= "msgid \"$str\"\n";
                                        $output .= "msgstr \"\"\n";
                                } else {
                                        list($singular, $plural) = explode("\0", $str);
                                        $output .= "msgid \"$singular\"\n";
                                        $output .= "msgid_plural \"$plural\"\n";
                                        $output .= "msgstr[0] \"\"\n";
                                        $output .= "msgstr[1] \"\"\n";
                                }
                                $output .= "\n";
                        } else {
                                foreach ($fileInfo as $file => $lines) {
                                        $filename = $str;
                                        $occured = array("$str:" . join(';', $lines));

                                        if (isset($this->__fileVersions[$str])) {
                                                $fileList[] = $this->__fileVersions[$str];
                                        }
                                        $occurances = join("\n#: ", $occured);
                                        $occurances = str_replace($this->path, '', $occurances);
                                        $output .= "#: $occurances\n";

                                        if (strpos($file, "\0") === false) {
                                                $output .= "msgid \"$file\"\n";
                                                $output .= "msgstr \"\"\n";
                                        } else {
                                                list($singular, $plural) = explode("\0", $file);
                                                $output .= "msgid \"$singular\"\n";
                                                $output .= "msgid_plural \"$plural\"\n";
                                                $output .= "msgstr[0] \"\"\n";
                                                $output .= "msgstr[1] \"\"\n";
                                        }
                                        $output .= "\n";
                                }
                        }
                        $this->__store($filename, $output, $fileList);
                }
        }
/**
 * Prepare a file to be stored
 *
 * @param string $file Filename
 * @param string $input What to store
 * @param array $fileList File list
 * @param integer $get Set to 1 to get files to store, false to set
 * @return mixed If $get == 1, files to store, otherwise void
 * @access private
 */
        function __store($file = 0, $input = 0, $fileList = array(), $get = 0) {
                static $storage = array();

                if (!$get) {
                        if (isset($storage[$file])) {
                                $storage[$file][1] = array_unique(array_merge($storage[$file][1], $fileList));
                                $storage[$file][] = $input;
                        } else {
                                $storage[$file] = array();
                                $storage[$file][0] = $this->__writeHeader();
                                $storage[$file][1] = $fileList;
                                $storage[$file][2] = $input;
                        }
                } else {
                        return $storage;
                }
        }
/**
 * Write the files that need to be stored
 *
 * @access private
 */
        function __writeFiles() {
                $output = $this->__store(0, 0, array(), 1);
                $output = $this->__mergeFiles($output);

                foreach ($output as $file => $content) {
                        $tmp = str_replace(array($this->path, '.php','.ctp','.thtml', '.inc','.tpl' ), '', $file);
                        $tmp = str_replace(DS, '.', $tmp);
                        $file = str_replace('.', '-', $tmp) .'.pot';
                        $fileList = $content[1];

                        unset($content[1]);

                        $fileList = str_replace(array($this->path), '', $fileList);

                        if (count($fileList) > 1) {
                                $fileList = "Generated from files:\n#  " . join("\n#  ", $fileList);
                        } elseif (count($fileList) == 1) {
                                $fileList = 'Generated from file: ' . join('', $fileList);
                        } else {
                                $fileList = 'No version information was available in the source files.';
                        }

                        if (is_file($this->__output . $file)) {
                                $response = '';
                                while ($response == '') {
                                        $response = $this->in("\n\nError: ".$file . ' already exists in this location. Overwrite?', array('y','n', 'q'), 'n');
                                        if (strtoupper($response) === 'Q') {
                                                $this->out('Extract Aborted');
                                                $this->_stop();
                                        } elseif (strtoupper($response) === 'N') {
                                                $response = '';
                                                while ($response == '') {
                                                        $response = $this->in("What would you like to name this file?\nExample: new_" . $file, null, "new_" . $file);
                                                        $file = $response;
                                                }
                                        }
                                }
                        }
                        $fp = fopen($this->__output . $file, 'w');
                        fwrite($fp, str_replace('--VERSIONS--', $fileList, join('', $content)));
                        fclose($fp);
                }
        }
/**
 * Merge output files
 *
 * @param array $output Output to merge
 * @return array Merged output
 * @access private
 */
        function __mergeFiles($output) {
                foreach ($output as $file => $content) {
                        if (count($content) <= 1 && $file != $this->__filename) {
                                @$output[$this->__filename][1] = array_unique(array_merge($output[$this->__filename][1], $content[1]));

                                if (!isset($output[$this->__filename][0])) {
                                        $output[$this->__filename][0] = $content[0];
                                }
                                unset($content[0]);
                                unset($content[1]);

                                foreach ($content as $msgid) {
                                        $output[$this->__filename][] = $msgid;
                                }
                                unset($output[$file]);
                        }
                }
                return $output;
        }
/**
 * Build the translation template header
 *
 * @return string Translation template header
 * @access private
 */
        function __writeHeader() {
                $output  = "# LANGUAGE translation of CakePHP Application\n";
                $output .= "# Copyright YEAR NAME <EMAIL@ADDRESS>\n";
                $output .= "# --VERSIONS--\n";
                $output .= "#\n";
                $output .= "#, fuzzy\n";
                $output .= "msgid \"\"\n";
                $output .= "msgstr \"\"\n";
                $output .= "\"Project-Id-Version: PROJECT VERSION\\n\"\n";
                $output .= "\"POT-Creation-Date: " . date("Y-m-d H:iO") . "\\n\"\n";
                $output .= "\"PO-Revision-Date: YYYY-mm-DD HH:MM+ZZZZ\\n\"\n";
                $output .= "\"Last-Translator: NAME <EMAIL@ADDRESS>\\n\"\n";
                $output .= "\"Language-Team: LANGUAGE <EMAIL@ADDRESS>\\n\"\n";
                $output .= "\"MIME-Version: 1.0\\n\"\n";
                $output .= "\"Content-Type: text/plain; charset=utf-8\\n\"\n";
                $output .= "\"Content-Transfer-Encoding: 8bit\\n\"\n";
                $output .= "\"Plural-Forms: nplurals=INTEGER; plural=EXPRESSION;\\n\"\n\n";
                return $output;
        }
/**
 * Find the version number of a file looking for SVN commands
 *
 * @param string $code Source code of file
 * @param string $file File
 * @access private
 */
        function __findVersion($code, $file) {
                $header = '$Id' . ':';
                if (preg_match('/\\' . $header . ' [\\w.]* ([\\d]*)/', $code, $versionInfo)) {
                        $version = str_replace(ROOT, '', 'Revision: ' . $versionInfo[1] . ' ' .$file);
                        $this->__fileVersions[$file] = $version;
                }
        }
/**
 * Format a string to be added as a translateable string
 *
 * @param string $string String to format
 * @return string Formatted string
 * @access private
 */
        function __formatString($string) {
                $quote = substr($string, 0, 1);
                $string = substr($string, 1, -1);
                if ($quote == '"') {
                        $string = stripcslashes($string);
                } else {
                        $string = strtr($string, array("\\'" => "'", "\\\\" => "\\"));
                }
                $string = str_replace("\r\n", "\n", $string);
                return addcslashes($string, "\0..\37\\\"");
        }
/**
 * Indicate an invalid marker on a processed file
 *
 * @param string $file File where invalid marker resides
 * @param integer $line Line number
 * @param string $marker Marker found
 * @param integer $count Count
 * @access private
 */
        function __markerError($file, $line, $marker, $count) {
                $this->out("Invalid marker content in $file:$line\n* $marker(", true);
                $count += 2;
                $tokenCount = count($this->__tokens);
                $parenthesis = 1;

                while ((($tokenCount - $count) > 0) && $parenthesis) {
                        if (is_array($this->__tokens[$count])) {
                                $this->out($this->__tokens[$count][1], false);
                        } else {
                                $this->out($this->__tokens[$count], false);
                                if ($this->__tokens[$count] == '(') {
                                        $parenthesis++;
                                }

                                if ($this->__tokens[$count] == ')') {
                                        $parenthesis--;
                                }
                        }
                        $count++;
                }
                $this->out("\n", true);
        }
/**
 * Search the specified path for files that may contain translateable strings
 *
 * @param string $path Path (or set to null to use current)
 * @return array Files
 * @access private
 */
        function __searchDirectory($path = null) {
                if ($path === null) {
                        $path = $this->path .DS;
                }
                $files = glob("$path*.{php,ctp,thtml,inc,tpl}", GLOB_BRACE);
                $dirs = glob("$path*", GLOB_ONLYDIR);

                foreach ($dirs as $dir) {
                        if (!preg_match("!(^|.+/)(CVS|.svn)$!", $dir)) {
                                $files = array_merge($files, $this->__searchDirectory("$dir" . DS));
                                if (($id = array_search($dir . DS . 'extract.php', $files)) !== FALSE) {
                                        unset($files[$id]);
                                }
                        }
                }
                return $files;
        }
}
?>
Subversion-Projekte lars-tiefland.cakephp

(root)/cake/console/libs/tasks/extract.php – Revision 1
