Commits

Takayuki Shimizukawa committed f5c4555

add python-dev-remove-2to3 blog

Comments (0)

Files changed (2)

site/build/rss_entry_fragments/2014-05-25T19%3A00%3A00---%23%23%23---blog%2Fsphinx-dev-remove-2to3%2Findex

+(dp0
+S'pubdate'
+p1
+cdatetime
+datetime
+p2
+(S'\x07\xde\x05\x19\x13\x00\x00\x00\x00\x00'
+p3
+tp4
+Rp5
+sS'link'
+p6
+Vhttp://www.freia.jp/taka/blog/sphinx-dev-remove-2to3/index.html
+p7
+sS'description'
+p8
+V<div id=sphinx-2to3six class=section>\u000a<h1>2014/5/25 Sphinx\u30e1\u30f3\u30c6\u30ca\u65e5\u8a18: 2to3\u3084\u3081\u3066six\u306b\u5207\u308a\u63db\u3048\u307e\u3057\u305f<a class=headerlink href=http://www.freia.jp/taka/blog/sphinx-dev-remove-2to3/index.html#sphinx-2to3six title=\u3053\u306e\u30d8\u30c3\u30c9\u30e9\u30a4\u30f3\u3078\u306e\u30d1\u30fc\u30de\u30ea\u30f3\u30af>ś</a></h1>\u000a<p><em>Category: 'Python', 'Sphinx'</em></p>\u000a<p>\u524d\u7f6e\u304d: \u3053\u306e\u30a8\u30f3\u30c8\u30ea\u3092\u8aad\u3080\u3068\u3001\u65e2\u5b58\u306ePython2\u5b9f\u88c5\u306e\u4f55\u304b\u3092Python3\u306b\u79fb\u884c\u3059\u308b\u6642\u306e\u53c2\u8003\u306b\u306a\u308b\u304b\u3082\u3057\u308c\u307e\u305b\u3093\u3002\u524d\u7f6e\u304d\u304a\u308f\u308a\u3002</p>\u000a<div id=sphinx-1-2python3 class=section>\u000a<h2>Sphinx-1.2\u306ePython3\u5bfe\u5fdc<a class=headerlink href=http://www.freia.jp/taka/blog/sphinx-dev-remove-2to3/index.html#sphinx-1-2python3 title=\u3053\u306e\u30d8\u30c3\u30c9\u30e9\u30a4\u30f3\u3078\u306e\u30d1\u30fc\u30de\u30ea\u30f3\u30af>ś</a></h2>\u000a<p>Sphinx\u306f\u30d0\u30fc\u30b8\u30e7\u30f31.1\u304b\u3089Python3\u5bfe\u5fdc\u3057\u3066\u3044\u307e\u3057\u305f\u3002\u3057\u304b\u3057Sphinx-1.1\u30681.2\u306fPython2\u3067\u66f8\u304b\u308c\u3066\u3044\u3066\u3001\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u6642\u306b <a class="reference external" href=http://docs.python.jp/2/library/2to3.html#to3-reference title="(in Python v2.7)"><em>2to3 - Python 2 \u304b\u3089 3 \u3078\u306e\u81ea\u52d5\u30b3\u30fc\u30c9\u5909\u63db</em></a> \u3067\u30b3\u30fc\u30c9\u3092\u5909\u63db\u3057\u3066Python3\u3067\u52d5\u4f5c\u3055\u305b\u3066\u3044\u307e\u3059\u3002\u000a\u3057\u304b\u3057\u30012to3\u3092\u4f7f\u3063\u305f\u305f\u3081\u306bSphinx\u306e\u6a5f\u80fd\u4ee5\u5916\u306e\u3068\u3053\u308d\u3067\u3044\u304f\u3064\u304b\u306e\u554f\u984c\u304c\u8d77\u304d\u3066\u3044\u307e\u3057\u305f\u3002</p>\u000a<ul>\u000a<li><p class=first>\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u306b\u6642\u9593\u304c\u304b\u304b\u308b</p>\u000a<p>\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u6642\u306b2to3\u304c\u5b9f\u884c\u3055\u308c\u307e\u3059\u304c\u3001\u591a\u304f\u306e\u5909\u63db\u3092\u884c\u3046\u305f\u3081\u3001\u5bfe\u8c61\u30bd\u30fc\u30b9\u306e\u30b3\u30fc\u30c9\u884c\u6570\u306b\u6bd4\u4f8b\u3057\u3066\u6642\u9593\u304c\u304b\u304b\u308a\u307e\u3059\u3002\u000aSphinx-1.2.2\u3092\u30ed\u30fc\u30ab\u30eb\u306e\u30bd\u30fc\u30b9\u304b\u3089\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u3057\u305f\u5834\u5408:</p>\u000a<ul class=simple>\u000a<li>Python2.7: 7 \u79d2</li>\u000a<li>Python3.3: 41 \u79d2</li>\u000a</ul>\u000a</li>\u000a<li><p class=first>Python3\u306e\u30c6\u30b9\u30c8\u5b9f\u884c\u306b\u6642\u9593\u304c\u304b\u304b\u308b</p>\u000a<p>Sphinx\u306ftox\u3067\u30c6\u30b9\u30c8\u3092\u884c\u3063\u3066\u3044\u307e\u3059\u304c\u3001\u30c6\u30b9\u30c8\u5bfe\u8c61\u30d1\u30c3\u30b1\u30fc\u30b8\u306f\u30c6\u30b9\u30c8\u6bce\u306bvirtualenv\u74b0\u5883\u306b\u518d\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u3055\u308c\u308b\u305f\u3081\u3001\u524d\u8ff0\u306e\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u6642\u9593\u304c\u30c6\u30b9\u30c8\u6bce\u306b2\u56de(py32,py33)\u304b\u304b\u308a\u307e\u3059\u3002</p>\u000a</li>\u000a<li><p class=first>Python3\u3067\u306e\u30c7\u30d0\u30c3\u30b0\u306b\u624b\u9593\u304c\u304b\u304b\u308b</p>\u000a<p>Python3\u3067\u306e\u307f\u767a\u751f\u3059\u308b\u30d0\u30b0\u306e\u4fee\u6b63\u3084Python3\u306e\u65b0\u3057\u3044\u30d0\u30fc\u30b8\u30e7\u30f3\u3067\u52d5\u4f5c\u3057\u306a\u3044\u5834\u5408\u30012to3\u5909\u63db\u5f8c\u306e\u30b3\u30fc\u30c9\u306b\u5bfe\u3057\u3066\u4fee\u6b63\u3092\u884c\u3044\u3001\u305d\u306e\u3088\u3046\u306b\u5909\u63db\u3055\u308c\u308b\u3088\u3046\u306b2to3\u5909\u63db\u524d\u306e\u30ea\u30dd\u30b8\u30c8\u30ea\u306e\u30b3\u30fc\u30c9\u3092\u4fee\u6b63\u3059\u308b\u5fc5\u8981\u304c\u3042\u308a\u307e\u3059\u3002\u000a\u3046\u307e\u304f\u66f8\u3051\u305f\u304b\u78ba\u8a8d\u3059\u308b\u305f\u3081\u306b2to3\u3092\u4f55\u5ea6\u3082\u5b9f\u884c\u3059\u308b\u305f\u3081\u3001\u524d\u8ff0\u306e\u5909\u63db\u30b3\u30b9\u30c8\u304c\u304b\u304b\u308a\u307e\u3059\u3002</p>\u000a</li>\u000a</ul>\u000a<p>\u3082\u3061\u308d\u3093\u30012to3\u81ea\u4f53\u306fPython2\u304c\u4e3b\u6d41\u3060\u3063\u305f\u3053\u308c\u307e\u3067\u306f\u3001Python3\u306b\u3082\u697d\u306b\u5bfe\u5fdc\u3057\u305f\u3044\u5834\u5408\u306e\u9053\u5177\u3068\u3057\u3066\u3068\u3066\u3082\u5f79\u7acb\u3064\u7269\u3067\u3057\u305f\u304c\u3001Python3.4\u3082\u30ea\u30ea\u30fc\u30b9\u3055\u308c <a class="reference external" href=http://python3wos.appspot.com/>Python3\u304c\u4e00\u822c\u7684\u306b\u306a\u3063\u3066\u304d\u305f</a> \u73fe\u72b6\u3067\u306f\u3001\u958b\u767a\u3084\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u306b\u6642\u9593\u304c\u304b\u304b\u308b2to3\u306f\u826f\u3044\u9078\u629e\u3068\u306f\u8a00\u3048\u306a\u304f\u306a\u308a\u307e\u3057\u305f\u3002</p>\u000a</div>\u000a<div id=sphinx-1-3python3 class=section>\u000a<h2>Sphinx-1.3\u306ePython3\u5bfe\u5fdc<a class=headerlink href=http://www.freia.jp/taka/blog/sphinx-dev-remove-2to3/index.html#sphinx-1-3python3 title=\u3053\u306e\u30d8\u30c3\u30c9\u30e9\u30a4\u30f3\u3078\u306e\u30d1\u30fc\u30de\u30ea\u30f3\u30af>ś</a></h2>\u000a<p>Sphinx-1.3\u306f\u73fe\u5728\u958b\u767a\u4e2d\u3067\u3059\u304c\u3001\u65e2\u306b2to3\u3092\u4f7f\u308f\u306a\u3044\u5b9f\u88c5\u306b\u5207\u308a\u66ff\u3048\u304c\u307b\u307c\u7d42\u4e86\u3057\u3066\u304a\u308a\u3001Sphinx-1.3\u304b\u3089\u306f2to3\u306b\u3088\u308b\u5909\u63db\u306a\u3057\u3067Python3\u3067\u52d5\u4f5c\u3057\u307e\u3059\u3002</p>\u000a<div id=sphinx2to3 class=section>\u000a<h3>Sphinx\u306f\u3069\u306e\u3088\u3046\u306b\u3057\u30662to3\u304b\u3089\u8131\u5374\u3057\u305f\u304b<a class=headerlink href=http://www.freia.jp/taka/blog/sphinx-dev-remove-2to3/index.html#sphinx2to3 title=\u3053\u306e\u30d8\u30c3\u30c9\u30e9\u30a4\u30f3\u3078\u306e\u30d1\u30fc\u30de\u30ea\u30f3\u30af>ś</a></h3>\u000a<p>\u30c1\u30b1\u30c3\u30c8 <a class="reference external" href=https://bitbucket.org/birkenfeld/sphinx/issue/1350/drop-2to3-mechanism>#1350</a> \u3067\u3044\u304f\u3064\u304b\u306e\u65b9\u6cd5\u3092\u691c\u8a0e\u3057\u307e\u3057\u305f\u3002</p>\u000a<ul class=simple>\u000a<li><a class="reference external" href=https://pypi.python.org/pypi/six>six</a> \u3092\u4f7f\u3046</li>\u000a<li><a class="reference external" href=https://pypi.python.org/pypi/future>python-future</a> \u3092\u4f7f\u3046</li>\u000a<li>\u30d4\u30e5\u30a2Python\u30b3\u30fc\u30c9\u3067\u66f8\u304f</li>\u000a</ul>\u000a<p>\u3053\u308c\u3089\u306e\u3046\u3061\u3001Georg\u306e\u30b3\u30e1\u30f3\u30c8\u304b\u3089\u3001python-future\u3088\u308a\u3082six\u3092\u4f7f\u3046\u3001\u51fa\u6765\u308c\u3070six\u3082\u7121\u3057\u3067\u5b9f\u88c5\u3059\u308b\u3001\u3068\u3044\u3046\u65b9\u91dd\u306b\u306a\u308a\u3001\u6700\u7d42\u7684\u306b\u306fsix\u3092\u4f7f\u3063\u305f\u5b9f\u88c5\u3092\u63a1\u7528\u3057\u307e\u3057\u305f\u3002\u000a\u307e\u305f\u3001#1350\u306e\u3084\u308a\u3068\u308a\u3092\u901a\u3057\u3066\u3001 <a class="reference external" href=https://pypi.python.org/pypi/Pygments>Pygments</a> \u3082\u30b7\u30f3\u30b0\u30eb\u30bd\u30fc\u30b9\u3067\u306e\u5b9f\u88c5\u306b\u79fb\u884c\u3057\u3001\u305d\u306e\u7d50\u679c\u3001Pygments-2.0\u306fPython-2.6, 2.7, Python-3.3+ \u3067\u52d5\u4f5c\u3059\u308b\u3053\u3068\u306b\u306a\u3063\u305f\u3088\u3046\u3067\u3059 (<a class="reference external" href=https://bitbucket.org/birkenfeld/pygments-main/src/2ba9b53c/CHANGES#cl-13>Pygments\u306eCHANGES\u3088\u308a</a>)\u3002</p>\u000a<p>\u3061\u306a\u307f\u306b\u3001python-future\u306f <a class="reference external" href=http://python-future.org/standard_library_imports.html#comparing-future-moves-and-six-moves>Comparing future.moves and six.moves</a> \u306e\u4e2d\u3067\u300csix.moves\u306e\u5b9f\u88c5\u306e\u305f\u3081\u306bDjango\u306e\u30aa\u30fc\u30c8\u30ea\u30ed\u30fc\u30c9\u3084\u3001py2exe\u3084cx_freeze\u306a\u3069\u306e\u30c4\u30fc\u30eb\u3067\u554f\u984c\u304c\u3042\u308b\u300d\u3068\u3044\u3046\u4e8b\u3092\u6307\u6458\u3057\u3066\u3044\u307e\u3059\u3002Sphinx\u3082six\u3092\u63a1\u7528\u3057\u305f\u3053\u3068\u306b\u3088\u308a\u3001\u3053\u3046\u3044\u3063\u305f\u554f\u984c\u306b\u906d\u9047\u3059\u308b\u53ef\u80fd\u6027\u306f\u3042\u308a\u307e\u3059\u3002</p>\u000a</div>\u000a<div id=sphinx class=section>\u000a<h3>Sphinx\u306e\u30b7\u30f3\u30b0\u30eb\u30bd\u30fc\u30b9\u79fb\u884c<a class=headerlink href=http://www.freia.jp/taka/blog/sphinx-dev-remove-2to3/index.html#sphinx title=\u3053\u306e\u30d8\u30c3\u30c9\u30e9\u30a4\u30f3\u3078\u306e\u30d1\u30fc\u30de\u30ea\u30f3\u30af>ś</a></h3>\u000a<p>\u79fb\u884c\u306f\u4ee5\u4e0b\u306e3\u3064\u306ePull Request\u3067\u884c\u308f\u308c\u307e\u3057\u305f\uff083\u3064\u3081\u306f\u73fe\u5728\u30ec\u30d3\u30e5\u30fc\u4e2d\u3067\u3059\uff09\u3002</p>\u000a<ul class=simple>\u000a<li><a class="reference external" href=https://bitbucket.org/birkenfeld/sphinx/pull-request/208/modernize-the-code-now-that-python-25-is>Pull Request #208</a> python-future\u306e <tt class="docutils literal"><span class=pre>futurize</span> <span class=pre>--stage1</span></tt> \u306b\u3088\u308bexcept\u6587\u3084print\u6587\u306e\u5909\u63db</li>\u000a<li><a class="reference external" href=https://bitbucket.org/birkenfeld/sphinx/pull-request/238/using-six-package-for-py2-3-compatibility>Pull Request #238</a> six\u30d1\u30c3\u30b1\u30fc\u30b8\u3092\u63a1\u7528\u3057\u3001Py2/3\u3067\u79fb\u52d5\u3057\u305f\u30d1\u30c3\u30b1\u30fc\u30b8\u306b\u5bfe\u5fdc\u3001bytes/str/unicode\u306e\u8abf\u6574\u3001iter\u306e\u8abf\u6574</li>\u000a<li><a class="reference external" href=https://bitbucket.org/birkenfeld/sphinx/pull-request/243/native-py2-py3-support-without-2to3-refs/diff>Pull Request #243</a> next()\u306e\u8abf\u6574\u3001map\u306e\u8abf\u6574\u3001<tt class="docutils literal"><span class=pre>ur""</span></tt> \u30ea\u30c6\u30e9\u30eb\u306e\u8abf\u6574\u30012to3\u306e\u524a\u9664</li>\u000a</ul>\u000a<p>3\u3064\u3081\u306e <a class="reference external" href=https://bitbucket.org/birkenfeld/sphinx/pull-request/243/native-py2-py3-support-without-2to3-refs/diff>Pull Request #243</a> \u3067\u306f\u3001\u90e8\u5206\u7684\u306b <tt class="docutils literal"><span class=pre>from</span> <span class=pre>__future__</span> <span class=pre>import</span> <span class=pre>unicode_literals</span></tt> \u3092\u4f7f\u3063\u3066\u3044\u307e\u3059\u304c\u3001\u5168\u4f53\u7684\u306b\u306f <tt class="docutils literal"><span class=pre>u""</span></tt> \u30ea\u30c6\u30e9\u30eb\u3092\u6b8b\u3057\u3066\u3042\u308a\u307e\u3059\u3002\u000aSphinx\u3067\u591a\u304f\u5229\u7528\u3055\u308c\u3066\u3044\u308b <tt class="docutils literal"><span class=pre>u""</span></tt> \u30ea\u30c6\u30e9\u30eb\u3092 <tt class="docutils literal"><span class=pre>unicode_literals</span></tt> \u3067\u66f8\u304d\u63db\u3048\u308b\u306e\u306f\u591a\u304f\u306e\u624b\u9593\u3068\u6c17\u3092\u9063\u3046\u4f5c\u696d\u306e\u305f\u3081\u3001\u3084\u308a\u307e\u305b\u3093\u3067\u3057\u305f\u3002\u000a\u3057\u304b\u3057\u3001 <tt class="docutils literal"><span class=pre>u""</span></tt> \u30ea\u30c6\u30e9\u30eb\u304c\u5fa9\u6d3b\u3057\u305fPython-3.3\u4ee5\u964d\u3067\u3082 <tt class="docutils literal"><span class=pre>ur""</span></tt> \u30ea\u30c6\u30e9\u30eb\u306f\u4f7f\u7528\u3067\u304d\u306a\u3044\u305f\u3081\u3001\u305d\u306e\u90e8\u5206\u306b\u3064\u3044\u3066\u3060\u3051unicode_literals\u3067\u5bfe\u51e6\u3057\u3066\u3042\u308a\u307e\u3059\u3002</p>\u000a<p>\u3068\u3053\u308d\u3067\u3001Python3.2\u3067\u306f <tt class="docutils literal"><span class=pre>u""</span></tt> \u30ea\u30c6\u30e9\u30eb\u304c\u4f7f\u7528\u3067\u304d\u307e\u305b\u3093\u3002\u3053\u306e\u305f\u3081\u3001Sphinx-1.3\u3082Python-3.2\u3067\u306f\u52d5\u4f5c\u3057\u306a\u304f\u306a\u308b\u4e88\u5b9a\u3067\u3059\u3002</p>\u000a<p>\u306a\u304a\u3001Sphinx-1.2\u304c\u4f9d\u5b58\u3057\u3066\u3044\u308b <a class="reference external" href=https://pypi.python.org/pypi/Pygments>Pygments</a> (Georg\u4f5c)\u3068 <a class="reference external" href=https://pypi.python.org/pypi/snowballstemmer>snowballstemmer</a> (shibu\u4f5c)\u3082Python-3.2\u3067\u306f\u52d5\u4f5c\u3057\u307e\u305b\u3093\u3002\u4eca\u5f8c\u306fPython-3.2\u5bfe\u5fdc\u306f\u3069\u3093\u3069\u3093\u53b3\u3057\u304f\u306a\u3063\u3066\u3044\u304d\u305d\u3046\u3067\u3059\u306d\u3002</p>\u000a</div>\u000a<div id=id2 class=section>\u000a<h3>\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u6642\u9593\u306e\u6539\u5584<a class=headerlink href=http://www.freia.jp/taka/blog/sphinx-dev-remove-2to3/index.html#id2 title=\u3053\u306e\u30d8\u30c3\u30c9\u30e9\u30a4\u30f3\u3078\u306e\u30d1\u30fc\u30de\u30ea\u30f3\u30af>ś</a></h3>\u000a<p>Sphinx-1.3\u306e\u30bd\u30fc\u30b9\u304b\u3089\u306e\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u6642\u9593\u3092\u8a08\u3063\u3066\u307f\u307e\u3057\u305f:</p>\u000a<ul class=simple>\u000a<li>Python2.7: 6 \u79d2</li>\u000a<li>Python3.3: 6 \u79d2</li>\u000a</ul>\u000a<p>\u3068\u3053\u308d\u3067\u6700\u8fd1\u306eSphinx\u306fwheel\u30d1\u30c3\u30b1\u30fc\u30b8\u3082\u30ea\u30ea\u30fc\u30b9\u3057\u3066\u3044\u308b\u306e\u3067\u3001pip-1.5\u4ee5\u964d\u3092\u4f7f\u3063\u3066\u3044\u308c\u3070wheel\u30d1\u30c3\u30b1\u30fc\u30b8\u3067\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u3055\u308c\u308b\u306e\u3067\u3001\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u6642\u9593\u306f\u3082\u3063\u3068\u77ed\u304b\u3063\u305f\u308a\u3057\u307e\u3059\u3002\u000awheel\u304c\u3069\u306e\u304f\u3089\u3044\u901f\u3044\u304b\u306b\u3064\u3044\u3066\u306f@aodag\u306b\u3088\u308b <a class="reference external" href=http://pelican.aodag.jp/20140502-pip-wheel-speedup.html>pip\u3068wheel\u3067\u30c6\u30b9\u30c8\u74b0\u5883\u69cb\u7bc9\u3092\u30b9\u30d4\u30fc\u30c9\u30a2\u30c3\u30d7</a> \u304c\u8a73\u3057\u3044\u3067\u3059\u3002\u000aSphinx\u306e\u30c6\u30b9\u30c8\u306bwheel\u3092\u6d3b\u7528\u3057\u305f\u3089\u3081\u3061\u3083\u901f\u304f\u306a\u308a\u307e\u3057\u305f( <a class="reference external" href=https://drone.io/bitbucket.org/shimizukawa/sphinx-py3-native/18>https://drone.io/bitbucket.org/shimizukawa/sphinx-py3-native/18</a> )\u3002@aodag\u3001\u826f\u3044\u8a18\u4e8b\u3092\u3042\u308a\u304c\u3068\u3046\u30fc\u3002</p>\u000a</div>\u000a</div>\u000a<div id=id3 class=section>\u000a<h2>\u307e\u3068\u3081<a class=headerlink href=http://www.freia.jp/taka/blog/sphinx-dev-remove-2to3/index.html#id3 title=\u3053\u306e\u30d8\u30c3\u30c9\u30e9\u30a4\u30f3\u3078\u306e\u30d1\u30fc\u30de\u30ea\u30f3\u30af>ś</a></h2>\u000a<ul class=simple>\u000a<li>\u305d\u308d\u305d\u308d 2to3 \u3084\u3081\u3088\u3046</li>\u000a<li><a class="reference external" href=https://pypi.python.org/pypi/future>python-future</a> \u306efuturize\u306f\u4fbf\u5229</li>\u000a<li><a class="reference external" href=https://pypi.python.org/pypi/six>six</a> \u3068 <a class="reference external" href=https://pypi.python.org/pypi/future>python-future</a> \u3069\u3061\u3089\u304c\u826f\u3044\u304b\u8ab0\u304b\u8abf\u67fb\u3057\u3066</li>\u000a<li><tt class="docutils literal"><span class=pre>u""</span></tt> \u30ea\u30c6\u30e9\u30eb\u3081\u3093\u3069\u304f\u3055\u3044</li>\u000a<li>Python-3.2 \u306fDrop\u3057\u3088\u3046</li>\u000a<li>wheel\u901f\u3044\u3088\u3001\u958b\u767a\u306b\u6d3b\u7528\u3059\u308b\u3068\u826f\u3044\u3088</li>\u000a</ul>\u000a</div>\u000a<div id=id4 class=section>\u000a<h2>\u53c2\u8003<a class=headerlink href=http://www.freia.jp/taka/blog/sphinx-dev-remove-2to3/index.html#id4 title=\u3053\u306e\u30d8\u30c3\u30c9\u30e9\u30a4\u30f3\u3078\u306e\u30d1\u30fc\u30de\u30ea\u30f3\u30af>ś</a></h2>\u000a<ul class=simple>\u000a<li><a class="reference external" href=http://lucumr.pocoo.org/2011/1/22/forwards-compatible-python/>Writing Forwards Compatible Python Code | Armin Ronacher's Thoughts and Writings</a></li>\u000a<li><a class="reference external" href=http://docs.python.jp/3.3/howto/pyporting.html>Python 2 \u304b\u3089 Python 3 \u3078\u306e\u79fb\u690d &amp;mdash; Python 3.3.3 \u30c9\u30ad\u30e5\u30e1\u30f3\u30c8</a></li>\u000a<li><a class="reference external" href=http://python3porting.com/differences.html>Language differences and workarounds &amp;mdash; Porting to Python 3 - The Book Site</a></li>\u000a<li><a class="reference external" href=http://pythonhosted.org//six/>Six: Python 2 and 3 Compatibility Library &amp;mdash; six 1.6.1 documentation</a></li>\u000a<li><a class="reference external" href=https://bitbucket.org/gutworth/six/src/4420499da495/six.py>https://bitbucket.org/gutworth/six/src/4420499da495/six.py</a></li>\u000a</ul>\u000a</div>\u000a</div>\u000a
+p9
+sS'unique_id'
+p10
+g7
+sS'title'
+p11
+V2014/5/25 Sphinx\u30e1\u30f3\u30c6\u30ca\u65e5\u8a18: 2to3\u3084\u3081\u3066six\u306b\u5207\u308a\u63db\u3048\u307e\u3057\u305f
+p12
+s.

site/source/blog/sphinx-dev-remove-2to3/index.rst

+:date: 2014-5-25 19:00
+:categories: ['Python', 'Sphinx']
+:body type: text/x-rst
+
+============================================================
+2014/5/25 Sphinxメンテナ日記: 2to3やめてsixに切り換えました
+============================================================
+
+*Category: 'Python', 'Sphinx'*
+
+前置き: このエントリを読むと、既存のPython2実čŁ
+
+
+Sphinx-1.2のPython3対応
+========================
+
+Sphinxはバージョン1.1からPython3対応していました。しかしSphinx-1.1と1.2はPython2で書かれていて、インストール時に :ref:`2to3-reference` でコードを変換してPython3で動作させています。
+しかし、2to3を使ったためにSphinxの機能以外のところでいくつかの問題が起きていました。
+
+* インストールに時間がかかる
+
+  インストール時に2to3が実行されますが、多くの変換を行うため、対象ソースのコード行数に比例して時間がかかります。
+  Sphinx-1.2.2をローカルのソースからインストールした場合:
+
+  * Python2.7: 7 秒
+  * Python3.3: 41 秒
+
+* Python3のテスト実行に時間がかかる
+
+  Sphinxはtoxでテストを行っていますが、テスト対象パッケージはテスト毎にvirtualenv環境に再インストールされるため、前述のインストール時間がテスト毎に2回(py32,py33)かかります。
+
+* Python3でのデバッグに手間がかかる
+
+  Python3でのみ発生するバグの修正やPython3の新しいバージョンで動作しない場合、2to3変換後のコードに対して修正を行い、そのように変換されるように2to3変換前のリポジトリのコードを修正するĺż
+  うまく書けたか確認するために2to3を何度も実行するため、前述の変換コストがかかります。
+
+
+もちろん、2to3自体はPython2が主流だったこれまでは、Python3にも楽に対応したい場合の道ĺ
+
+
+.. __: http://python3wos.appspot.com/
+
+Sphinx-1.3のPython3対応
+=========================
+
+Sphinx-1.3は現在開発中ですが、既に2to3を使わない実čŁ
+
+
+
+Sphinxはどのようにして2to3から脱却したか
+------------------------------------------
+
+チケット `#1350`_ でいくつかの方法を検討しました。
+
+* six_ を使う
+* python-future_ を使う
+* ピュアPythonコードで書く
+
+これらのうち、Georgのコメントから、python-futureよりもsixを使う、出来ればsixも無しで実čŁ
+また、#1350のやりとりを通して、 Pygments_ もシングルソースでの実čŁ
+
+ちなみに、python-futureは `Comparing future.moves and six.moves`_ の中で「six.movesの実čŁ
+
+
+Sphinxのシングルソース移行
+---------------------------
+
+移行は以下の3つのPull Requestで行われました(3つめは現在レビュー中です)。
+
+* `Pull Request #208`_ python-futureの ``futurize --stage1`` によるexcept文やprint文の変換
+* `Pull Request #238`_ sixパッケージを採用し、Py2/3で移動したパッケージに対応、bytes/str/unicodeの調整、iterの調整
+* `Pull Request #243`_ next()の調整、mapの調整、``ur""`` リテラルの調整、2to3の削除
+
+3つめの `Pull Request #243`_ では、部分的に ``from __future__ import unicode_literals`` を使っていますが、ĺ
+Sphinxで多く利用されている ``u""`` リテラルを ``unicode_literals`` で書き換えるのは多くの手間と気を遣う作業のため、やりませんでした。
+しかし、 ``u""`` リテラルが復活したPython-3.3以降でも ``ur""`` リテラルは使用できないため、その部分についてだけunicode_literalsで対処してあります。
+
+ところで、Python3.2では ``u""`` リテラルが使用できません。このため、Sphinx-1.3もPython-3.2では動作しなくなる予定です。
+
+なお、Sphinx-1.2が依存している Pygments_ (Georg作)と snowballstemmer_ (shibu作)もPython-3.2では動作しません。今後はPython-3.2対応はどんどん厳しくなっていきそうですね。
+
+
+インストール時間の改善
+------------------------
+
+Sphinx-1.3のソースからのインストール時間を計ってみました:
+
+* Python2.7: 6 秒
+* Python3.3: 6 秒
+
+ところで最近のSphinxはwheelパッケージもリリースしているので、pip-1.5以降を使っていればwheelパッケージでインストールされるので、インストール時間はもっと短かったりします。
+wheelがどのくらい速いかについては@aodagによる `pipとwheelでテスト環境構築をスピードアップ`_ が詳しいです。
+Sphinxのテストにwheelを活用したらめちゃ速くなりました( https://drone.io/bitbucket.org/shimizukawa/sphinx-py3-native/18 )。@aodag、良い記事をありがとうー。
+
+
+まとめ
+========
+
+* そろそろ 2to3 やめよう
+* python-future_ ぎfuturizeは䞿刊
+* six_ と python-future_ どちらが良いか誰か調査して
+* ``u""`` リテラルめんどくさい
+* Python-3.2 はDropしよう
+* wheel速いよ、開発に活用すると良いよ
+
+
+参考
+=====
+
+* `Writing Forwards Compatible Python Code | Armin Ronacher's Thoughts and Writings`_
+* `Python 2 から Python 3 への移植 &mdash; Python 3.3.3 ドキュメント`_
+* `Language differences and workarounds &mdash; Porting to Python 3 - The Book Site`_
+* `Six: Python 2 and 3 Compatibility Library &mdash; six 1.6.1 documentation`_
+* https://bitbucket.org/gutworth/six/src/4420499da495/six.py
+
+.. _#1350: https://bitbucket.org/birkenfeld/sphinx/issue/1350/drop-2to3-mechanism
+.. _six: https://pypi.python.org/pypi/six
+.. _python-future: https://pypi.python.org/pypi/future
+.. _PygmentsのCHANGESより: https://bitbucket.org/birkenfeld/pygments-main/src/2ba9b53c/CHANGES#cl-13
+.. _Comparing future.moves and six.moves: http://python-future.org/standard_library_imports.html#comparing-future-moves-and-six-moves
+.. _Pull Request #208: https://bitbucket.org/birkenfeld/sphinx/pull-request/208/modernize-the-code-now-that-python-25-is
+.. _Pull Request #238: https://bitbucket.org/birkenfeld/sphinx/pull-request/238/using-six-package-for-py2-3-compatibility
+.. _Pull Request #243: https://bitbucket.org/birkenfeld/sphinx/pull-request/243/native-py2-py3-support-without-2to3-refs/diff
+.. _pipとwheelでテスト環境構築をスピードアップ: http://pelican.aodag.jp/20140502-pip-wheel-speedup.html
+.. _Pygments: https://pypi.python.org/pypi/Pygments
+.. _snowballstemmer: https://pypi.python.org/pypi/snowballstemmer
+.. _Writing Forwards Compatible Python Code | Armin Ronacher's Thoughts and Writings: http://lucumr.pocoo.org/2011/1/22/forwards-compatible-python/
+.. _Python 2 から Python 3 への移植 &mdash; Python 3.3.3 ドキュメント: http://docs.python.jp/3.3/howto/pyporting.html
+.. _Language differences and workarounds &mdash; Porting to Python 3 - The Book Site: http://python3porting.com/differences.html
+.. _`Six: Python 2 and 3 Compatibility Library &mdash; six 1.6.1 documentation`: http://pythonhosted.org//six/
+