From 98dbe6f0d2edfff3a1f5785504504b4a6e5dd4eb Mon Sep 17 00:00:00 2001 From: "ctrlaltca@gmail.com" <> Date: Sat, 19 Nov 2011 11:33:31 +0000 Subject: updating phpDocumentor, part 2: add new version --- .../phpDocumentor/XMLpackagePageParser.inc | 644 +++++++++++++++++++++ 1 file changed, 644 insertions(+) create mode 100755 buildscripts/PhpDocumentor/phpDocumentor/XMLpackagePageParser.inc (limited to 'buildscripts/PhpDocumentor/phpDocumentor/XMLpackagePageParser.inc') diff --git a/buildscripts/PhpDocumentor/phpDocumentor/XMLpackagePageParser.inc b/buildscripts/PhpDocumentor/phpDocumentor/XMLpackagePageParser.inc new file mode 100755 index 00000000..95740f2a --- /dev/null +++ b/buildscripts/PhpDocumentor/phpDocumentor/XMLpackagePageParser.inc @@ -0,0 +1,644 @@ + + * @copyright 2002-2007 Gregory Beaver + * @license http://www.opensource.org/licenses/lgpl-license.php LGPL + * @version CVS: $Id: XMLpackagePageParser.inc 246143 2007-11-14 01:31:24Z ashnazg $ + * @tutorial tutorials.pkg + * @link http://www.phpdoc.org + * @link http://pear.php.net/PhpDocumentor + * @since 1.2 + * @todo CS cleanup - change package to PhpDocumentor + * @todo CS cleanup - PHPCS needs to ignore CVS Id length + */ +/** + * when is found + */ +define('PHPDOCUMENTOR_PDP_EVENT_PROGRAMLISTING', 600); +/** + * when is found + */ +define('PHPDOCUMENTOR_PDP_STATE_PROGRAMLISTING', 700); +/** + * when a DocBook is found + */ +define('PHPDOCUMENTOR_PDP_EVENT_TAG', 601); +/** + * when a DocBook is found + */ +define('PHPDOCUMENTOR_PDP_STATE_TAG', 701); +/** + * when is found + */ +define('PHPDOCUMENTOR_PDP_EVENT_CDATA', 602); +/** + * when is found + */ +define('PHPDOCUMENTOR_PDP_STATE_CDATA', 702); +/** + * when tag attributes name="value" are found + */ +define('PHPDOCUMENTOR_PDP_EVENT_ATTRIBUTES', 603); +/** + * when tag attributes name="value" are found + */ +define('PHPDOCUMENTOR_PDP_STATE_ATTRIBUTES', 703); +/** + * when tag attributes name="value" are found + */ +define('PHPDOCUMENTOR_PDP_EVENT_ENTITY', 604); +/** + * when tag attributes name="value" are found + */ +define('PHPDOCUMENTOR_PDP_STATE_ENTITY', 704); + +/** + * Used to parse XML DocBook-based tutorials + * + * @category ToolsAndUtilities + * @package phpDocumentor + * @subpackage Parsers + * @author Gregory Beaver + * @copyright 2002-2007 Gregory Beaver + * @license http://www.opensource.org/licenses/lgpl-license.php LGPL + * @version Release: 1.4.3 + * @link http://www.phpdoc.org + * @link http://pear.php.net/PhpDocumentor + * @since 1.2 + * @todo CS cleanup - change package to PhpDocumentor + */ +class XMLPackagePageParser extends Parser +{ + /** + * @var array + */ + var $eventHandlers = array( + PHPDOCUMENTOR_PDP_EVENT_TAG => 'handleTag', + PHPDOCUMENTOR_PDP_EVENT_ATTRIBUTES => 'handleAttributes', + PHPDOCUMENTOR_PDP_EVENT_CDATA => 'handleCData', + PARSER_EVENT_NOEVENTS => 'defaultHandler', + PARSER_EVENT_COMMENTBLOCK => 'ignoreHandler', + PARSER_EVENT_OUTPHP => 'ignoreHandler', + PARSER_EVENT_QUOTE => 'handleQuote', + PHPDOCUMENTOR_PDP_EVENT_ENTITY => 'handleEntity', + ); + + /** + * @var array + */ + var $pars = array(); + + var $refsect1id = false; + var $refsect2id = false; + var $refsect3id = false; + /** + * @var array the tag stack + */ + var $context; + /**#@+ @access private */ + var $_gettoc = false; + var $_toc = array(); + var $_cursection = 0; + /**#@-*/ + /** + * Set up the wordparser + * + * {@source} + * + * @uses ObjectWordParser + */ + function XMLPackagePageParser() + { + $this->wp = new ObjectWordParser(true); + } + /** + * Parse a new file + * + * @param string $parse_data the parse data + * @param array $tutorial for format, see {@link Io::getTutorials()} + * + * @return bool + * @staticvar integer used for recursion limiting + * if a handler for an event is not found + * @uses parserTutorial using {@link Publisher::PublishEvent()}, a new tutorial + * is created from the file parsed, and passed to the + * Intermediate Parser + */ + function parse ($parse_data, $tutorial) + { + $tempparse = new ppageParser; + $parse_data = $tempparse-> + parse($parse_data, true, $tutorial['package'], + $tutorial['subpackage'], basename($tutorial['path']), + $tutorial['category'], $tutorial['path']); + unset($tempparse); + static $endrecur = 0; + if (!is_array($parse_data) || count($parse_data) == 0) { + return false; + } + $this->setupStates(); + + // initialize variables so E_ALL error_reporting doesn't complain + $pevent = 0; + $word = 0; + $this->p_vars['start'] = true; + $this->p_vars['event_stack'] = new EventStack; + + $this->wp->setup($parse_data, false); + $this->wp->setWhitespace(true); + $this->context = array(); + if (isset($this->curtag)) { + unset($this->curtag); + } + + do { + $lpevent = $pevent; + $pevent = $this->p_vars['event_stack']->getEvent(); + if ($lpevent != $pevent) { + $this->p_vars['last_pevent'] = $lpevent; + } + + if ($this->p_vars['last_pevent'] != $pevent) { + // its a new event so the word parser needs to be reconfigured + $this->configWordParser($pevent); + } + + + $this->p_vars['last_word'] = $word; + $word = $this->wp->getWord(); + + if (PHPDOCUMENTOR_DEBUG == true) { + echo "----------------\n"; + echo "LAST: |" . $this->p_vars['last_word'] . "|\n"; + echo "INDEX: ".$this->p_vars['curpar']."\n"; + echo "PEVENT: " . $this->getParserEventName($pevent) . "\n"; + echo "LASTPEVENT: " . + $this->getParserEventName($this->p_vars['last_pevent']) . "\n"; + echo $this->wp->getPos() . " WORD: |$word|\n\n"; + echo '"'.$this->p_vars['quote_data']."\"\n"; + } + if (isset($this->eventHandlers[$pevent])) { + $handle = $this->eventHandlers[$pevent]; + if ($word !== false) { + $this->$handle($word, $pevent); + } + } else { + debug('WARNING: possible error, ' . + 'no XMLPackagePageParser handler for event number '. $pevent); + if ($endrecur++ == 25) { + die("FATAL ERROR, recursion limit reached"); + } + } + $this->p_vars['start'] = false; + } while (!($word === false)); + if (count($this->_toc) && isset($this->p_vars['toc'])) { + $a = $this->curtag->getTOC($this->p_vars['toc']); + $a->setTOC($this->_toc); + $a->setPath($tutorial['path']); + $this->curtag->setTOC($this->p_vars['toc'], $a); + } + $this->PublishEvent(PHPDOCUMENTOR_EVENT_TUTORIAL, + new parserTutorial($this->curtag, $tutorial)); + return $this->curtag; + } + + /**#@+ + * @param string|parserInlineTag $word token + * @param integer $token parser event + * @return void + * @access private + * @todo CS cleanup - PHPCS needs to recognize docblock template tags + */ + /** + * handler for default events + */ + function defaultHandler($word, $pevent) + { + if (is_string($word) && $this->checkEventPush($word, $pevent)) { + return; + } + } + + /** + * handler for ignore events + */ + function ignoreHandler($word, $pevent) + { + $this->checkEventPop($word, $pevent); + } + + /** + * handler for QUOTE + * + * this handler recognizes strings defined with + * double quotation marks (") and handles them correctly + * in any place that they legally appear in php code + */ + function handleQuote($word, $pevent) + { + if ($this->p_flags['reset_quote_data'] === true) { + $this->p_flags['reset_quote_data'] = false; + $this->p_vars['quote_data'] = ""; + } + if (!is_object($word)) { + $this->checkEventPush($word, $pevent); + } + if (is_object($word)) { + $this->p_vars['quote_data'] = $word; + } else { + if ($word != "\"") { + if (!is_object($this->p_vars['quote_data'])) { + $this->p_vars['quote_data'] .= $word; + } + } + if ($word == '>') { + if (is_object($this->p_vars['quote_data'])) { + $this->p_vars['quote_data'] = + '{@id '.$this->p_vars['quote_data']->id.'}'; + } + addErrorDie(PDERROR_UNTERMINATED_ATTRIB, $this->curtag->name, + $this->p_vars['attrname'], $this->p_vars['quote_data']); + } + if ($this->checkEventPop($word, $pevent)) { + $this->p_flags['reset_quote_data'] = true; + } + } + } + + /** + * Handles all XML DocBook tags + * + * @todo replace commented-out debug lines with debug() func + */ + function handleTag($word, $pevent) + { + if (isset($this->curtag) && $this->curtag->hasTitle() && + $this->_gettoc && $this->_gettoc->name == $this->curtag->name + ) { + if (isset($this->_toc[$this->_cursection])) { + $this->_toc[$this->_cursection]['title'] = $this->curtag->_title; + $this->_cursection++; + } + $this->_gettoc = false; + } + if ($this->p_vars['last_word'] == '<') { + // get tag name + $this->p_flags['begin_tag'] = true; + array_push($this->context, $word); + //DEBUG if (isset($this->curtag)) debug("pushed " . $this->curtag->name); + if (isset($this->curtag)) { + array_push($this->pars, $this->curtag); + } + $this->curtag = new parserXMLDocBookTag($word); + } elseif ($this->p_vars['last_word'] == '') { + $tag = array_pop($this->context); + if ($word == '/>') { + // all is OK + $this->checkEventPop($word, $pevent); + $word = $tag; + } + if ($tag != $word) { + addErrorDie(PDERROR_UNMATCHED_TUTORIAL_TAG, + $tag, $word, $this->curtag->getString()); + } + if (in_array($this->curtag->name, + array('refentry', 'refsect1', 'refsect2', 'refsect3')) + ) { + if (!isset($this->curtag->_id)) { + $title = ''; + if (isset($this->curtag->_title)) { + $title = $this->curtag->_title->getString(); + } + addWarning(PDERROR_NO_DOCBOOK_ID, $this->curtag->name, $title); + } + } + $this->p_flags['begin_tag'] = false; + $curtag = @array_pop($this->pars); + //DEBUG debug("popped $tag ".$curtag->name.' I am '.$this->curtag->name); + if ($curtag) { + if ($this->curtag->name == 'refsect1') $this->refsect1id = false; + if ($this->curtag->name == 'refsect2') $this->refsect2id = false; + if ($this->curtag->name == 'refsect3') $this->refsect3id = false; + $curtag->add($this->curtag); + //DEBUG debug("added " . $this->curtag->name . + //DEBUG " to " . $curtag->name . ' ' . $curtag->id); + $this->curtag = $curtag; + } else { + //DEBUG debug("here"); + } + } elseif (is_string($word)) { + if (!($e = $this->checkEventPush($word, $pevent))) { + if ($this->checkEventPop($word, $pevent)) { + if ($this->p_flags['begin_tag']) { + $this->p_vars['event_stack']-> + pushEvent(PHPDOCUMENTOR_PDP_EVENT_TAG); + $this->p_vars['event_stack']-> + pushEvent(PHPDOCUMENTOR_PDP_EVENT_CDATA); + $this->p_vars['last_tag'] = array_pop($this->context); + array_push($this->context, $this->p_vars['last_tag']); + $this->p_flags['in_cdata'] = false; + } + return; + } + } else { + $this->p_flags['start_attr'] = true; + $this->p_flags['end_attr'] = false; + } + } else { + addErrorDie(PDERROR_CANT_HAVE_INLINE_IN_TAGNAME); + } + } + + /** + * Handle CData sections + */ + function handleCData($word, $pevent) + { + if ($this->curtag->name == 'refentry' && + phpDocumentor_get_class($word) == 'parsertocinlinetag' + ) { + $this->p_vars['toc'] = $this->curtag->getTOC(); + } + if (is_string($word) && !$this->p_flags['in_cdata']) { + if ($this->checkEventPop($word, $pevent)) { + return; + } + if ($this->checkEventPush($word, $pevent)) { + return; + } + } + if (is_string($word) && $word == 'curtag->startCData(); + $this->p_flags['in_cdata'] = true; + } elseif ($this->p_flags['in_cdata'] && + is_string($word) && $word == ']]>' + ) { + $this->curtag->endCData(); + $this->p_flags['in_cdata'] = false; + } else { + if ($this->p_flags['in_cdata']) { + $this->curtag->addCData($word); + } else { + $this->curtag->add($word); + } + } + } + + /** + * Handle Entities like ” + */ + function handleEntity($word, $pevent) + { + if (!$word) { + if (!isset($this->p_vars['entity_name'])) { + $this->p_vars['entity_name'] = ''; + } + addErrorDie(PDERROR_UNTERMINATED_ENTITY, $this->p_vars['entity_name']); + } + $e = $this->checkEventPop($word, $pevent); + if ($word && !$e) { + $this->p_vars['entity_name'] = $word; + } + if ($e) { + $entity = new parserEntity($this->p_vars['entity_name']); + unset($this->p_vars['entity_name']); + $this->curtag->add($entity); + } + } + + /** + * Handle Tag attributes name="value" + * + * @todo replace commented-out debug lines with debug() func + */ + function handleAttributes($word, $pevent) + { + if ($this->checkEventPush($word, $pevent)) { + return; + } + if ($word == '=') { + $this->p_flags['start_attr'] = false; + $this->p_vars['end_attr'] = true; + } else { + if ($this->p_flags['start_attr']) { + $this->p_vars['attrname'] = $word; + } else { + if (isset($this->p_vars['attrname'])) { + $value = $this->p_vars['quote_data']; + if (phpDocumentor_get_class($value) == 'parseridinlinetag') { + // "inherit" the parent section's id, so + + // + // + // ... + // + // + // ... + // + // + // ... + // + // + + $a = ($this->refsect1id ? $this->refsect1id . '.' : ''); + $a .= ($this->refsect2id ? $this->refsect2id . '.' : ''); + $a .= ($this->refsect3id ? $this->refsect3id . '.' : ''); + if ($this->curtag->name == 'refsect1') { + $this->refsect1id = $value->id; + } + if ($this->curtag->name == 'refsect2') { + $this->refsect2id = $value->id; + } + if ($this->curtag->name == 'refsect3') { + $this->refsect3id = $value->id; + } + //DEBUG debug($value->id . ' is now ' . $a . $value->id); + $value->id = $a . $value->id; + if ($value->id != '') { + if (isset($this->_toc[$this->_cursection])) { + $this->_cursection++; + } + $this->_toc[$this->_cursection]['id'] = $value; + $this->_toc[$this->_cursection]['tag'] = + new parserXMLDocBookTag($this->curtag->name); + //DEBUG debug("set gettoc to " . $this->curtag->name . + //DEBUG ' ' . $value->id); + $this->_gettoc = $this->curtag; + } + } + $this->curtag->addAttribute($this->p_vars['attrname'], $value); + unset($this->p_vars['attrname']); + if (is_string($word) && $this->checkEventPop($word, $pevent)) { + $this->p_flags['start_attr'] = true; + $this->p_flags['end_attr'] = false; + $this->wp->setPos($this->wp->getPos() - strlen($word)); + } else { + $this->wp->setPos($this->wp->getPos() - strlen($word)); + } + return; + } + } + } + if (is_string($word) && $this->checkEventPop($word, $pevent)) { + $this->p_flags['start_attr'] = true; + $this->p_flags['end_attr'] = false; + $this->wp->setPos($this->wp->getPos() - strlen($word)); + } + } + /**#@-*/ + + /** + * setup the parser tokens, and the pushEvent/popEvent arrays + * + * @return void + * @see $tokens, $pushEvent, $popEvent + */ + function setupStates() + { + $this->_gettoc = false; + $this->_toc = array(); + $this->_cursection = 0; + if (isset($this->p_vars['toc'])) { + unset($this->p_vars['toc']); + } + + $this->tokens[STATE_NOEVENTS] + = array('tokens[STATE_COMMENTBLOCK] + = array('-->'); + $this->tokens[STATE_OUTPHP] + = array('?>','>'); + $this->tokens[STATE_QUOTE] + = array("\\\"","\\\\","\"",'>'); + $this->tokens[STATE_ESCAPE] + = false;// this tells the word parser to just cycle + $this->tokens[PHPDOCUMENTOR_PDP_STATE_TAG] + = array('>',' ','/>'); + $this->tokens[PHPDOCUMENTOR_PDP_STATE_CDATA] + = array('&','"); + //########################## + $this->pushEvent[PARSER_EVENT_QUOTE] = + array( + "\\" => PARSER_EVENT_ESCAPE + ); + $this->popEvent[PARSER_EVENT_QUOTE] = array("\""); + //########################## + + $this->popEvent[PARSER_EVENT_OUTPHP] = array("?>",">"); + //########################## + + $this->popEvent[PHPDOCUMENTOR_PDP_EVENT_ENTITY] = array(";"); + //########################## + + $this->pushEvent[PHPDOCUMENTOR_PDP_EVENT_CDATA] = + array( + "<" => PHPDOCUMENTOR_PDP_EVENT_TAG, + '