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

13 files changed, 177 insertions, 0 deletions

diff --git a/test/functional/tests/_default.py b/test/functional/tests/_default.py
new file mode 100644
index 000000000..2835c5b2e
--- /dev/null
+++ b/test/functional/tests/_default.py
@@ -0,0 +1,7 @@
+# Default settings for all tests.
+
+settings_overrides['report_level'] = 2
+settings_overrides['halt_level'] = 5
+settings_overrides['warning_stream'] = ''
+settings_overrides['input_encoding'] = 'utf-8'
+settings_overrides['embed_stylesheet'] = 0
diff --git a/test/functional/tests/_standalone_rst_defaults.py b/test/functional/tests/_standalone_rst_defaults.py
new file mode 100644
index 000000000..b51704929
--- /dev/null
+++ b/test/functional/tests/_standalone_rst_defaults.py
@@ -0,0 +1,6 @@
+# Keyword parameters passed to publish_file.
+reader_name = "standalone"
+parser_name = "rst"
+
+# Settings.
+settings_overrides['sectsubtitle_xform'] = 1
diff --git a/test/functional/tests/compact_lists.py b/test/functional/tests/compact_lists.py
new file mode 100644
index 000000000..3ac4c3f8b
--- /dev/null
+++ b/test/functional/tests/compact_lists.py
@@ -0,0 +1,11 @@
+# Source and destination file names.
+test_source = "compact_lists.txt"
+test_destination = "compact_lists.html"
+
+# Keyword parameters passed to publish_file.
+reader_name = "standalone"
+parser_name = "rst"
+writer_name = "html"
+
+# Settings
+#settings_overrides['key'] = 
diff --git a/test/functional/tests/dangerous.py b/test/functional/tests/dangerous.py
new file mode 100644
index 000000000..620a927ba
--- /dev/null
+++ b/test/functional/tests/dangerous.py
@@ -0,0 +1,12 @@
+# Source and destination file names.
+test_source = "dangerous.txt"
+test_destination = "dangerous.html"
+
+# Keyword parameters passed to publish_file.
+reader_name = "standalone"
+parser_name = "rst"
+writer_name = "html"
+
+# Settings
+settings_overrides['file_insertion_enabled'] = 0
+settings_overrides['raw_enabled'] = 0
diff --git a/test/functional/tests/field_name_limit.py b/test/functional/tests/field_name_limit.py
new file mode 100644
index 000000000..db79d4c67
--- /dev/null
+++ b/test/functional/tests/field_name_limit.py
@@ -0,0 +1,12 @@
+# Source and destination file names.
+test_source = "field_list.txt"
+test_destination = "field_name_limit.html"
+
+# Keyword parameters passed to publish_file.
+reader_name = "standalone"
+parser_name = "rst"
+writer_name = "html"
+
+# Settings
+settings_overrides['field_name_limit'] = 0 # no limit
+settings_overrides['docinfo_xform'] = 0
diff --git a/test/functional/tests/latex_docinfo.py b/test/functional/tests/latex_docinfo.py
new file mode 100644
index 000000000..3f9c34455
--- /dev/null
+++ b/test/functional/tests/latex_docinfo.py
@@ -0,0 +1,12 @@
+# Source and destination file names.
+test_source = "latex_docinfo.txt"
+test_destination = "latex_docinfo.tex"
+
+# Keyword parameters passed to publish_file.
+reader_name = "standalone"
+parser_name = "rst"
+writer_name = "latex"
+
+# Extra setting we need
+
+settings_overrides['use_latex_docinfo'] = 1
diff --git a/test/functional/tests/misc_rst_html4css1.py b/test/functional/tests/misc_rst_html4css1.py
new file mode 100644
index 000000000..861a9e9c5
--- /dev/null
+++ b/test/functional/tests/misc_rst_html4css1.py
@@ -0,0 +1,14 @@
+# Source and destination file names.
+test_source = "simple.txt"
+test_destination = "misc_rst_html4css1.html"
+
+# Keyword parameters passed to publish_file.
+reader_name = "standalone"
+parser_name = "rst"
+writer_name = "html4css1"
+
+# Settings
+# test for encoded attribute value:
+settings_overrides['stylesheet'] = 'foo&bar.css'
+settings_overrides['stylesheet_path'] = ''
+settings_overrides['embed_stylesheet'] = 0
diff --git a/test/functional/tests/pep_html.py b/test/functional/tests/pep_html.py
new file mode 100644
index 000000000..00e127ba7
--- /dev/null
+++ b/test/functional/tests/pep_html.py
@@ -0,0 +1,14 @@
+# Source and destination file names.
+test_source = "pep_html.txt"
+test_destination = "pep_html.html"
+
+# Keyword parameters passed to publish_file.
+reader_name = "pep"
+parser_name = "rst"
+writer_name = "pep_html"
+
+# Settings
+settings_overrides['python_home'] = "http://www.python.org"
+settings_overrides['pep_home'] = "http://www.python.org/peps"
+settings_overrides['no_random'] = 1
+settings_overrides['cloak_email_addresses'] = 1
diff --git a/test/functional/tests/standalone_rst_html4css1.py b/test/functional/tests/standalone_rst_html4css1.py
new file mode 100644
index 000000000..c34298eab
--- /dev/null
+++ b/test/functional/tests/standalone_rst_html4css1.py
@@ -0,0 +1,10 @@
+execfile('functional/tests/_standalone_rst_defaults.py')
+
+# Source and destination file names.
+test_source = "standalone_rst_html4css1.txt"
+test_destination = "standalone_rst_html4css1.html"
+
+# Keyword parameters passed to publish_file.
+writer_name = "html4css1"
+
+# Settings: settings_overrides['setting'] = value
diff --git a/test/functional/tests/standalone_rst_latex.py b/test/functional/tests/standalone_rst_latex.py
new file mode 100644
index 000000000..f0c40b75a
--- /dev/null
+++ b/test/functional/tests/standalone_rst_latex.py
@@ -0,0 +1,8 @@
+execfile('functional/tests/_standalone_rst_defaults.py')
+
+# Source and destination file names.
+test_source = "standalone_rst_latex.txt"
+test_destination = "standalone_rst_latex.tex"
+
+# Keyword parameters passed to publish_file.
+writer_name = "latex"
diff --git a/test/functional/tests/standalone_rst_pseudoxml.py b/test/functional/tests/standalone_rst_pseudoxml.py
new file mode 100644
index 000000000..b9b2df309
--- /dev/null
+++ b/test/functional/tests/standalone_rst_pseudoxml.py
@@ -0,0 +1,8 @@
+execfile('functional/tests/_standalone_rst_defaults.py')
+
+# Source and destination file names.
+test_source = "standalone_rst_pseudoxml.txt"
+test_destination = "standalone_rst_pseudoxml.txt"
+
+# Keyword parameters passed to publish_file.
+writer_name = "pseudoxml"
diff --git a/test/functional/tests/standalone_rst_s5_html_1.py b/test/functional/tests/standalone_rst_s5_html_1.py
new file mode 100755
index 000000000..ce27f687a
--- /dev/null
+++ b/test/functional/tests/standalone_rst_s5_html_1.py
@@ -0,0 +1,56 @@
+execfile('functional/tests/_standalone_rst_defaults.py')
+
+# Source and destination file names:
+test_source = 'standalone_rst_s5_html.txt'
+test_destination = 'standalone_rst_s5_html_1.html'
+
+# Keyword parameters passed to publish_file:
+writer_name = 's5_html'
+
+# Settings:
+settings_overrides['theme'] = 'small-black'
+
+
+# Extra functional tests.
+# Prefix all names with '_' to avoid confusing `docutils.core.publish_file`.
+
+import filecmp as _filecmp
+
+def _test_more(expected_dir, output_dir, test_case, parameters):
+    """Compare ``ui/<theme>`` directories."""
+    theme = settings_overrides.get('theme', 'default')
+    expected = '%s/%s/%s' % (expected_dir, 'ui', theme)
+    output = '%s/%s/%s' % (output_dir, 'ui', theme)
+    differences, uniques = _compare_directories(expected, output)
+    parts = []
+    if differences:
+        parts.append('The following files differ from the expected output:')
+        parts.extend(differences)
+        expected = [path.replace('functional/output/', 'functional/expected/')
+                    for path in differences]
+        parts.append('Please compare the expected and actual output files:')
+        parts.extend(['  diff %s %s' % tup
+                      for tup in zip(expected, differences)])
+        parts.append('If the actual output is correct, please replace the '
+                     'expected output files:')
+        parts.extend(['  mv %s %s' % tup
+                      for tup in zip(differences, expected)])
+        parts.append('and check them in to Subversion:')
+        parts.extend(['  svn commit -m "<comment>" %s' % path
+                      for path in expected])
+    if uniques:
+        parts.append('The following paths are unique:')
+        parts.extend(uniques)
+    test_case.assert_(not parts, '\n'.join(parts))
+
+def _compare_directories(expected, output):
+    dircmp = _filecmp.dircmp(expected, output, ['.svn', 'CVS'])
+    differences = ['%s/%s' % (output, name) for name in dircmp.diff_files]
+    uniques = (['%s/%s' % (expected, name) for name in dircmp.left_only]
+               + ['%s/%s' % (output, name) for name in dircmp.right_only])
+    for subdir in dircmp.common_dirs:
+        diffs, uniqs = _compare_directories('%s/%s' % (expected, subdir),
+                                            '%s/%s' % (output, subdir))
+        differences.extend(diffs)
+        uniques.extend(uniqs)
+    return differences, uniques
diff --git a/test/functional/tests/standalone_rst_s5_html_2.py b/test/functional/tests/standalone_rst_s5_html_2.py
new file mode 100755
index 000000000..aea7a9207
--- /dev/null
+++ b/test/functional/tests/standalone_rst_s5_html_2.py
@@ -0,0 +1,7 @@
+# initialize with the settings & definitions from test 1:
+execfile('functional/tests/standalone_rst_s5_html_1.py')
+
+# overrides specific to this test:
+test_destination = 'standalone_rst_s5_html_2.html'
+del settings_overrides['theme']         # use the default
+settings_overrides['current_slide'] = 1