docs/dev/wheeling.txt

   1 ===========================
   2  Docutils_ Building Wheels
   3 ===========================
   4
   5 :Authors: engelbert gruber; open to all Docutils developers
   6 :Contact: docutils-develop@lists.sourceforge.net
   7 :Date: $Date$
   8 :Revision: $Revision$
   9 :Copyright: This document has been placed in the public domain.
  10
  11 .. _Docutils: http://docutils.sourceforge.net/
  12
  13 .. contents::
  14
  15 This document documents my trial to build python wheels from
  16 docutils. Once it is finished it might be driven into distribution or
  17 release documentation.
  18
  19 There is `feature request 43`_ :  Make setup.py build wheels.
  20
  21   Just add this to setup.cfg:
  22
  23   [bdist_wheel]
  24   universal = 1
  25
  26   See https://packaging.python.org/en/latest/distributing.html#universal-wheels
  27
  28   -.-.-
  29
  30   Docutils is not fit for Universal Wheels. Docutils supports both Python 2 and
  31   3, but with different code (we use “2to3”). This would make it a candidate
  32   for "Pure Python wheels".
  33
  34
  35 and bugs275_ : Upload wheels to pypi
  36
  37   Currently docutils does not publish any wheels on pypi. Wheels make docutils
  38   faster to install (no need to run setup.py, which for a large number of
  39   packages can take some time), and is no more difficult than uploading an
  40   sdist (see https://packaging.python.org/en/latest/distributing.html#wheels
  41   for instructions).
  42
  43 .. _bugs275: https://sourceforge.net/p/docutils/bugs/275/
  44 .. _feature request 43: https://sourceforge.net/p/docutils/feature-requests/43/
  45