sandbox/infrastructure/releasing-log.txt

   1 Releasing
   2 =========
   3
   4 :Contact: grubert@users.sourceforge.net, docutils-develop@users.sourceforge.net
   5 :Revision: $Revision: 7396 $
   6 :Date: $Date: 2012-04-29 11:18:23 +0200 (So, 29 Apr 2012) $
   7 :Copyright: This document has been placed in the public domain.
   8
   9 Notes on what happend while releasing.
  10
  11 Release 0.12
  12 ============
  13
  14 svn revision: 7749
  15
  16 Tests
  17 -----
  18
  19 Tests are run from svn checkout, only few from install.
  20
  21 Python3 tests are run ::
  22
  23   rm -rf build test3
  24   python3 setup.py build
  25   PYTHONPATH=build/lib python3 test3/alltests.py
  26
  27 * ubuntu 8.04: python 2.4.5, 2.5.2, 2.6.7, 2.7.2 OK
  28
  29   python 2.6.4rc1 6 failure due to change in error message: no such file ...
  30
  31   python 3.2.3 OK
  32
  33 * macosx 10.6.8: python 2.5.4, 2.7.3
  34
  35   python 2.6.1 6 failure due to change in error message: no such file ...
  36
  37   python 3.2, 3.4.1 OK
  38
  39 * ubuntu 14.04: pyton 2.7.6,  python 3.4.0 OK
  40
  41 * windows7: python 2.7.5
  42
  43   Error (filed #256): test_writers/test_html4css1_template.py::
  44
  45       stylesheet = """\
  46     - <link rel="stylesheet" href="/test.css" type="text/css" />"""
  47     + <link rel="stylesheet" href="C:/test.css" type="text/css" />"""
  48     ?                              ++
  49
  50   python 3.4.1
  51
  52   * test.css path error (filed #256)
  53   * test_parsers\test_rst\test_directives\test_include.py::
  54
  55       b'Encoding:\n\n.. include:: test_parsers/test_rst/test_directives/utf-16.csv\n   :encoding: utf-16\n'
  56         File "test3\alltests.py", line 40, in write
  57           string = string.encode('raw_unicode_escape').decode('ascii')
  58       UnicodeDecodeError: 'ascii' codec can't decode byte 0xb0 in position 994: ordinal not in range(128)
  59
  60    fiddling with alltests.py (uncommitted) ::
  61
  62       <system_message level="4" line="1" source="test data" type="SEVERE">
  63         <paragraph>
  64             Problem with "raw" directive:
  65             UnicodeDecodeError: \'utf-16-be\' codec can\'t decode bytes in position 90-91: illegal encoding
  66         <literal_block xml:space="preserve">
  67             .. raw:: html
  68                :file: test_parsers/test_rst/test_directives/utf-16.csv
  69                :encoding: utf-16''' != '''\
  70
  71
  72
  73 Release 0.11
  74 ============
  75
  76 Summary
  77 -------
  78
  79 ``sandbox/infrastructure/release.sh`` tries running ``test/alltests.py`` after
  80 installing the new release, this fails because
  81
  82 * tests depends on e.g. ``../docs/user/rst/images/title.png`` or ``../HISTORY.txt``,
  83   but thess are neither in the test directory tree nor in the installed software.
  84
  85 * there is a lot of code trying to handle varying installation targets ``/usr/lib``
  86   ``/usr/local/lib` and not yet ``/usr/lib/pymodules``.
  87
  88 Change testing to:
  89
  90 1. build and install
  91 2. extract docutils-<release>.tar.gz into tmp
  92 3. remove docutils/docutils directory, just to make shure it is not used.
  93 4. run test/alltest.py in this directory, so all files are where they are
  94    while development.
  95
  96 Following failure becuase docutils-library directory was removed, therefore
  97 docutils/writers/html4css1/html4css1.css is not found::
  98
  99   ======================================================================
 100   FAIL: test_custom_stylesheet_dir (test_writers.test_html4css1_misc.SettingsTestCase)
 101   ----------------------------------------------------------------------
 102   Traceback (most recent call last):
 103     File "/... 0.11/test/test_writers/test_html4css1_misc.py", line 81, in test_custom_stylesheet_dir
 104       self.assertIn('docutils/writers/html4css1/html4css1.css', styles)
 105     File "/... 0.11/test/DocutilsTestSupport.py", line 138, in assertIn
 106       msg or '%s not in %s' % _format_str(a, b))
 107   AssertionError: 'docutils/writers/html4css1/html4css1.css' not in u'''\
 108   <link rel="stylesheet" href="html4css1.css" type="text/css" />
 109   <link rel="stylesheet" href="data/ham.css" type="text/css" />
 110   '''
 111
 112
 113 Tests
 114 -----
 115
 116 * ubuntu 8.04 2.4.5, 2.5.2, 2.6.7, 2.7.2 OK
 117
 118   python 2.6.4rc1 6 failure due to change in error message: no such file ...
 119
 120   Python 3.2.3 : OK (roman.py left over from last release)
 121
 122 * macosx 10.6.8: python 2.5.4, 2.7.3
 123
 124   python 2.6.1 6 failure due to change in error message: no such file ...
 125
 126   python 3.2: roman.py for py3 required.
 127
 128 Release.sh
 129 ----------
 130
 131 release.sh does not work on MacOSX.
 132
 133 installation on ubuntu 10.04 breaks test script::
 134
 135   Working directory: /usr/local/lib/python2.6/site-packages/docutils-test
 136   Docutils package: /usr/local/lib/python2.6/dist-packages/docutils
 137
 138   ======================================================================
 139   FAIL: test_find_file_in_dirs (test_utils.HelperFunctionsTests)
 140   ----------------------------------------------------------------------
 141   Traceback (most recent call last):
 142     File "/usr/local/lib/python2.6/site-packages/docutils-test/test_utils.py", line 295, in test_find_file_in_dirs
 143       '../HISTORY.txt')
 144   AssertionError: 'HISTORY.txt' != '../HISTORY.txt'
 145
 146 Stopping for now.
 147
 148
 149
 150 Release 0.10
 151 ============
 152
 153 * same failures for some python2.6 versions ::
 154
 155               Problems with "raw" directive path:
 156        -      InputError: [Errno 2] No such file or directory: 'non-existent.file'.
 157        +      InputError: (2, 'No such file or directory').
 158
 159 * testing release tarball ::
 160
 161     ======================================================================
 162     FAIL: test_dependencies (__main__.RecordDependenciesTests)
 163     ----------------------------------------------------------------------
 164     Traceback (most recent call last):
 165       File "docutils-test/test_dependencies.py", line 61, in test_dependencies
 166         self.assertEqual(record, expected)
 167     AssertionError: [u'data/include.txt', u'data/raw.txt'] != [u'../docs/user/rst/images/title.png',
 168     u'data/include.txt', u'data/raw.txt']
 169
 170     ...
 171
 172   because ../docs is not there if run from /usr/../pythonx.x/site-packages/docutils-test.
 173
 174 Release 0.9.1
 175 =============
 176
 177 same failures as for 0.9 plus
 178
 179 * python 2.3: twice, ignored ::
 180
 181   -             [Errno 2] No such file or directory: 'bogus.csv'.
 182   +             [Errno 2] No such file or directory: u'bogus.csv'.
 183
 184   python 2.3 ::
 185
 186     ======================================================================
 187     ERROR: test_unicode (test_error_reporting.ErrorStringTests)
 188     ----------------------------------------------------------------------
 189     Traceback (most recent call last):
 190       File "/usr/local/lib/python2.3/site-packages/docutils-test/test_error_reporting.py", line 153, in test_unicode
 191         self.assertEqual(u'ImportError: %s' % SafeString(self.bs),
 192     UnicodeDecodeError: 'ascii' codec can't decode byte 0xfc in position 0: ordinal not in range(128)
 193
 194 Note: sf takes some considerable time till the downlods are visible for normal users.
 195   More than 1 hour , the folder files/docutils/0.9.1 exists and the webinterface
 196   correctly summarizes "Totals: 2 Items         1.6 MB" but nothing is shown.
 197
 198 Release 0.9
 199 ===========
 200
 201 * python 2.3 unittest.TestCase has no assertTrue
 202 * python 2.3 keyword dictionaries update method does not support kwargs
 203
 204 Ignored test errors
 205
 206 * python 2.3: unicode problems. 2.3 support is likely to be ended soon.
 207   Systems with only 2.3 might not even know of unicode.
 208
 209 * PIL ``AttributeError: 'module' object has no attribute 'Image'``
 210
 211   A problem in PIL ?
 212   Tested and failiing on
 213
 214   - ubuntu8.04, python 2.4, 2.5
 215   - ubuntu10.04, python 2.6
 216   - ubuntu11.10, python 2.7
 217
 218 * python 2.6.4rc1 has a different error message format::
 219
 220               Problems with "raw" directive path:
 221        -      InputError: [Errno 2] No such file or directory: 'non-existent.file'.
 222        +      InputError: (2, 'No such file or directory').
 223
 224   but not in python 2.6.7