summaryrefslogtreecommitdiff
path: root/sandbox/delza/parsers/rst/directives/misc.py
diff options
context:
space:
mode:
authorwiemann <wiemann@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2006-01-09 20:44:25 +0000
committerwiemann <wiemann@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2006-01-09 20:44:25 +0000
commitd77fdfef70e08114f57cbef5d91707df8717ea9f (patch)
tree49444e3486c0c333cb7b33dfa721296c08ee4ece /sandbox/delza/parsers/rst/directives/misc.py
parent53cd16ca6ca5f638cbe5956988e88f9339e355cf (diff)
parent3993c4097756e9885bcfbd07cb1cc1e4e95e50e4 (diff)
downloaddocutils-0.4.tar.gz
Release 0.4: tagging released revisiondocutils-0.4
git-svn-id: http://svn.code.sf.net/p/docutils/code/tags/docutils-0.4@4268 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
Diffstat (limited to 'sandbox/delza/parsers/rst/directives/misc.py')
-rw-r--r--sandbox/delza/parsers/rst/directives/misc.py246
1 files changed, 0 insertions, 246 deletions
diff --git a/sandbox/delza/parsers/rst/directives/misc.py b/sandbox/delza/parsers/rst/directives/misc.py
deleted file mode 100644
index 40e908b83..000000000
--- a/sandbox/delza/parsers/rst/directives/misc.py
+++ /dev/null
@@ -1,246 +0,0 @@
-# Authors: David Goodger, Dethe Elza
-# Contact: goodger@users.sourceforge.net
-# Revision: $Revision$
-# Date: $Date$
-# Copyright: This module has been placed in the public domain.
-
-"""Miscellaneous directives."""
-
-__docformat__ = 'reStructuredText'
-
-import sys
-import os.path
-import re
-from urllib2 import urlopen, URLError
-from docutils import io, nodes, statemachine, utils
-from docutils.parsers.rst import directives, states
-from docutils.transforms import misc
-
-include_registry = {}
-def include(name, arguments, options, content, lineno,
- content_offset, block_text, state, state_machine):
- """Include a reST file as part of the content of this reST file."""
- try:
- source = state_machine.input_lines.source(
- lineno - state_machine.input_offset - 1)
- source_dir = os.path.dirname(os.path.abspath(source))
- except AttributeError:
- # It might be that we're not actually reading from a file
- # right now; so just read the first line of block_text
- # instead and grab the filename from that
- process_me=block_text
- lines=re.compile("\n").split(process_me)
- path=re.sub(re.compile("..\s+include::\s+"),"",lines[0])
- source_dir = os.path.dirname(os.path.abspath(path))
-
- path = ''.join(arguments[0].splitlines())
- if path.find(' ') != -1:
- error = state_machine.reporter.error(
- '"%s" directive path contains whitespace.' % name,
- nodes.literal_block(block_text, block_text), line=lineno)
- return [error]
- path = os.path.normpath(os.path.join(source_dir, path))
- path = utils.relative_path(None, path)
- if include_registry.has_key(path): return []
- include_registry[path] = True
- try:
- include_file = io.FileInput(
- source_path=path, encoding=state.document.settings.input_encoding,
- handle_io_errors=None)
- except IOError, error:
- severe = state_machine.reporter.severe(
- 'Problems with "%s" directive path:\n%s: %s.'
- % (name, error.__class__.__name__, error),
- nodes.literal_block(block_text, block_text), line=lineno)
- return [severe]
- include_text = include_file.read()
- if options.has_key('literal'):
- literal_block = nodes.literal_block(include_text, include_text,
- source=path)
- literal_block.line = 1
- return literal_block
- else:
- include_lines = statemachine.string2lines(include_text,
- convert_whitespace=1)
- state_machine.insert_input(include_lines, path)
- return []
-
-include.arguments = (1, 0, 1)
-include.options = {'literal': directives.flag}
-
-def raw(name, arguments, options, content, lineno,
- content_offset, block_text, state, state_machine):
- """
- Pass through content unchanged
-
- Content is included in output based on type argument
-
- Content may be included inline (content section of directive) or
- imported from a file or url.
- """
- attributes = {'format': arguments[0]}
- if content:
- if options.has_key('file') or options.has_key('url'):
- error = state_machine.reporter.error(
- '"%s" directive may not both specify an external file and '
- 'have content.' % name,
- nodes.literal_block(block_text, block_text), line=lineno)
- return [error]
- text = '\n'.join(content)
- elif options.has_key('file'):
- if options.has_key('url'):
- error = state_machine.reporter.error(
- 'The "file" and "url" options may not be simultaneously '
- 'specified for the "%s" directive.' % name,
- nodes.literal_block(block_text, block_text), line=lineno)
- return [error]
- source_dir = os.path.dirname(
- os.path.abspath(state.document.current_source))
- path = os.path.normpath(os.path.join(source_dir, options['file']))
- path = utils.relative_path(None, path)
- try:
- raw_file = open(path)
- except IOError, error:
- severe = state_machine.reporter.severe(
- 'Problems with "%s" directive path:\n%s.' % (name, error),
- nodes.literal_block(block_text, block_text), line=lineno)
- return [severe]
- text = raw_file.read()
- raw_file.close()
- attributes['source'] = path
- elif options.has_key('url'):
- try:
- raw_file = urlopen(options['url'])
- except (URLError, IOError, OSError), error:
- severe = state_machine.reporter.severe(
- 'Problems with "%s" directive URL "%s":\n%s.'
- % (name, options['url'], error),
- nodes.literal_block(block_text, block_text), line=lineno)
- return [severe]
- text = raw_file.read()
- raw_file.close()
- attributes['source'] = options['file']
- else:
- error = state_machine.reporter.warning(
- 'The "%s" directive requires content; none supplied.' % (name),
- nodes.literal_block(block_text, block_text), line=lineno)
- return [error]
- raw_node = nodes.raw('', text, **attributes)
- return [raw_node]
-
-raw.arguments = (1, 0, 1)
-raw.options = {'file': directives.path,
- 'url': directives.path}
-raw.content = 1
-
-def replace(name, arguments, options, content, lineno,
- content_offset, block_text, state, state_machine):
- if not isinstance(state, states.SubstitutionDef):
- error = state_machine.reporter.error(
- 'Invalid context: the "%s" directive can only be used within a '
- 'substitution definition.' % (name),
- nodes.literal_block(block_text, block_text), line=lineno)
- return [error]
- text = '\n'.join(content)
- element = nodes.Element(text)
- if text:
- state.nested_parse(content, content_offset, element)
- if len(element) != 1 or not isinstance(element[0], nodes.paragraph):
- messages = []
- for node in element:
- if isinstance(node, nodes.system_message):
- if node.has_key('backrefs'):
- del node['backrefs']
- messages.append(node)
- error = state_machine.reporter.error(
- 'Error in "%s" directive: may contain a single paragraph '
- 'only.' % (name), line=lineno)
- messages.append(error)
- return messages
- else:
- return element[0].children
- else:
- error = state_machine.reporter.error(
- 'The "%s" directive is empty; content required.' % (name),
- line=lineno)
- return [error]
-
-replace.content = 1
-
-def unicode_directive(name, arguments, options, content, lineno,
- content_offset, block_text, state, state_machine):
- r"""
- Convert Unicode character codes (numbers) to characters. Codes may be
- decimal numbers, hexadecimal numbers (prefixed by ``0x``, ``x``, ``\x``,
- ``U+``, ``u``, or ``\u``; e.g. ``U+262E``), or XML-style numeric character
- entities (e.g. ``&#x262E;``). Text following ".." is a comment and is
- ignored. Spaces are ignored, and any other text remains as-is.
- """
- if not isinstance(state, states.SubstitutionDef):
- error = state_machine.reporter.error(
- 'Invalid context: the "%s" directive can only be used within a '
- 'substitution definition.' % (name),
- nodes.literal_block(block_text, block_text), line=lineno)
- return [error]
- codes = arguments[0].split('.. ')[0].split()
- element = nodes.Element()
- for code in codes:
- try:
- if code.isdigit():
- element += nodes.Text(unichr(int(code)))
- else:
- match = unicode_pattern.match(code)
- if match:
- value = match.group(1) or match.group(2)
- element += nodes.Text(unichr(int(value, 16)))
- else:
- element += nodes.Text(code)
- except (ValueError, OverflowError), err:
- error = state_machine.reporter.error(
- 'Invalid character code: %s\n%s: %s'
- % (code, err.__class__.__name__, err),
- nodes.literal_block(block_text, block_text), line=lineno)
- return [error]
- return element.children
-
-unicode_directive.arguments = (1, 0, 1)
-unicode_pattern = re.compile(
- r'(?:0x|x|\x00x|U\+?|\x00u)([0-9a-f]+)$|&#x([0-9a-f]+);$', re.IGNORECASE)
-
-def class_directive(name, arguments, options, content, lineno,
- content_offset, block_text, state, state_machine):
- """"""
- class_value = nodes.make_id(arguments[0])
- if class_value:
- pending = nodes.pending(misc.ClassAttribute,
- {'class': class_value, 'directive': name},
- block_text)
- state_machine.document.note_pending(pending)
- return [pending]
- else:
- error = state_machine.reporter.error(
- 'Invalid class attribute value for "%s" directive: %s'
- % (name, arguments[0]),
- nodes.literal_block(block_text, block_text), line=lineno)
- return [error]
-
-class_directive.arguments = (1, 0, 0)
-class_directive.content = 1
-
-def directive_test_function(name, arguments, options, content, lineno,
- content_offset, block_text, state, state_machine):
- if content:
- text = '\n'.join(content)
- info = state_machine.reporter.info(
- 'Directive processed. Type="%s", arguments=%r, options=%r, '
- 'content:' % (name, arguments, options),
- nodes.literal_block(text, text), line=lineno)
- else:
- info = state_machine.reporter.info(
- 'Directive processed. Type="%s", arguments=%r, options=%r, '
- 'content: None' % (name, arguments, options), line=lineno)
- return [info]
-
-directive_test_function.arguments = (0, 1, 1)
-directive_test_function.options = {'option': directives.unchanged_required}
-directive_test_function.content = 1