[Python-modules-commits] [xlwt] 01/13: New upstream version 1.3.0

Thomas Goirand zigo at moszumanska.debian.org
Wed Oct 25 17:57:24 UTC 2017


This is an automated email from the git hooks/post-receive script.

zigo pushed a commit to branch new-upstream-1.3.0
in repository xlwt.

commit 8b9766acb7abe370e25382287717d20c06205a1c
Author: Thomas Goirand <thomas at goirand.fr>
Date:   Wed Oct 25 17:00:18 2017 +0000

    New upstream version 1.3.0
---
 .gitignore                                         |   11 +
 .travis.yml                                        |   34 +
 HISTORY.html                                       |   87 -
 PKG-INFO                                           |  103 +-
 README.html                                        |   95 -
 README.rst                                         |   83 +
 docs/Makefile                                      |  153 ++
 docs/api.rst                                       |   29 +
 docs/changes.rst                                   |  173 ++
 docs/conf.py                                       |   22 +
 docs/development.rst                               |   65 +
 docs/index.rst                                     |   35 +
 docs/installation.rst                              |   18 +
 docs/licenses.rst                                  |  118 +
 docs/make.bat                                      |  190 ++
 {xlwt/examples => examples}/big-16Mb.py            |   13 +-
 {xlwt/examples => examples}/big-35Mb.py            |    7 +-
 {xlwt/examples => examples}/blanks.py              |    0
 {xlwt/examples => examples}/col_width.py           |    0
 {xlwt/examples => examples}/country.py             |    0
 {xlwt/examples => examples}/dates.py               |    0
 {xlwt/examples => examples}/format.py              |    0
 {xlwt/examples => examples}/formula_names.py       |    7 +-
 {xlwt/examples => examples}/formulas.py            |    0
 {xlwt/examples => examples}/hyperlinks.py          |    2 +-
 {xlwt/examples => examples}/image.py               |    6 +-
 examples/image_chg_col_wid.py                      |   27 +
 {xlwt/examples => examples}/merged.py              |    0
 {xlwt/examples => examples}/merged0.py             |    0
 {xlwt/examples => examples}/merged1.py             |    0
 {xlwt/examples => examples}/mini.py                |    0
 {xlwt/examples => examples}/num_formats.py         |    0
 examples/numbers_demo.py                           |   25 +
 {xlwt/examples => examples}/outline.py             |    0
 {xlwt/examples => examples}/panes.py               |   12 +-
 examples/panes2.py                                 |   60 +
 examples/panes3.py                                 |   42 +
 {xlwt/examples => examples}/parse-fmla.py          |    0
 examples/pattern_examples.xls                      |  Bin 0 -> 21504 bytes
 {xlwt/examples => examples}/protection.py          |    0
 {xlwt/examples => examples}/python.bmp             |  Bin
 {xlwt/examples => examples}/row_styles.py          |    0
 {xlwt/examples => examples}/row_styles_empty.py    |    0
 {xlwt/examples => examples}/simple.py              |    0
 {xlwt/examples => examples}/sst.py                 |    0
 {xlwt/examples => examples}/unicode0.py            |    0
 {xlwt/examples => examples}/unicode1.py            |    0
 {xlwt/examples => examples}/unicode2.py            |   13 +-
 {xlwt/examples => examples}/wsprops.py             |  139 +-
 .../xlwt_easyxf_simple_demo.py                     |    0
 examples/zoom_magnification.py                     |   14 +
 licences.py                                        |  114 -
 requirements.txt                                   |   15 +
 setup.cfg                                          |    7 +
 setup.py                                           |   61 +-
 tests/RKbug.py                                     |  147 -
 tests/RKbug1.xls                                   |  Bin 13824 -> 0 bytes
 xlwt/examples/python.bmp => tests/bitmaps.xls      |  Bin 37446 -> 42496 bytes
 tests/less_simple.xls                              |  Bin 0 -> 17920 bytes
 tests/mini.xls                                     |  Bin 0 -> 5632 bytes
 {xlwt/examples => tests}/python.bmp                |  Bin
 tests/simple.xls                                   |  Bin 0 -> 5632 bytes
 tests/test_biff_records.py                         |   24 +
 tests/test_bitmaps.py                              |   41 +
 tests/test_by_name_functions.py                    |   30 +
 tests/test_compound_doc.py                         |   41 +
 tests/test_easyxf.py                               |   55 +
 tests/test_mini.py                                 |   21 +
 tests/test_simple.py                               |   67 +
 tests/test_unicode1.py                             |   40 +
 tests/test_unicodeutils.py                         |   37 +
 tests/unicode1.xls                                 |  Bin 0 -> 5632 bytes
 tests/utils.py                                     |   11 +
 tests/xlwt_easyxf_simple_demo.xls                  |  Bin 0 -> 17920 bytes
 tox.ini                                            |   13 +
 xlwt.egg-info/PKG-INFO                             |  111 +
 xlwt.egg-info/SOURCES.txt                          |   94 +
 xlwt.egg-info/dependency_links.txt                 |    1 +
 xlwt.egg-info/not-zip-safe                         |    1 +
 xlwt.egg-info/top_level.txt                        |    1 +
 xlwt/BIFFRecords.py                                |   64 +-
 xlwt/Bitmap.py                                     |   31 +-
 xlwt/Cell.py                                       |    9 +-
 xlwt/Column.py                                     |    2 +-
 xlwt/CompoundDoc.py                                |   47 +-
 xlwt/ExcelFormula.py                               |   10 +-
 xlwt/ExcelFormulaLexer.py                          |   17 +-
 xlwt/ExcelFormulaParser.py                         |   22 +-
 xlwt/Formatting.py                                 |   10 +-
 xlwt/Row.py                                        |   27 +-
 xlwt/Style.py                                      |   63 +-
 xlwt/UnicodeUtils.py                               |   10 +-
 xlwt/Utils.py                                      |    3 +-
 xlwt/Workbook.py                                   |  168 +-
 xlwt/Worksheet.py                                  |  174 +-
 xlwt/__init__.py                                   |   16 +-
 xlwt/antlr.py                                      | 2864 ++++++++++++++++++++
 xlwt/compat.py                                     |   28 +
 xlwt/doc/xlwt.html                                 |  199 --
 99 files changed, 5241 insertions(+), 1038 deletions(-)

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..d1d329e
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,11 @@
+*.pyc
+/dist
+*.egg-info
+/build
+/tests/output
+.coverage
+/docs/_build
+.tox
+/bin
+/include
+/lib
diff --git a/.travis.yml b/.travis.yml
new file mode 100644
index 0000000..cd6f9db
--- /dev/null
+++ b/.travis.yml
@@ -0,0 +1,34 @@
+# for container-y goodness:
+sudo: false
+
+language: python
+
+python:
+  - "3.6"
+  - "3.5"
+  - "3.4"
+  - "3.3"
+  - "2.7"
+
+# command to install dependencies
+install: 
+- "pip install -U pip setuptools"
+- "pip install -Ur requirements.txt"
+
+# command to run tests, e.g. python setup.py test
+script: nosetests --with-cov --cov=xlwt
+
+after_success:
+  - coveralls
+
+deploy:
+  provider: pypi
+  user: chrisw
+  password:
+    secure: HZ9DRsLpeNMBZc3Sjj2X/KF/fJxaDjINqbeUzJ7FnqcJ5A5ECDHZ/2Bxx/crdpfXwqHDPEcZvatu+LhtpBFu+HCUFAc00V0qvmq34RZDes9WNmnh5Kx97kXxdN0scoM1V7JXeDffhEUZJkL6EQJfJqUWvl9nq4SnC5wOlJBR3QE=
+  on:
+    tags: true
+    repo: python-excel/xlwt
+    python: "3.5"
+  skip_cleanup: true
+  distributions: "sdist bdist_wheel"
diff --git a/HISTORY.html b/HISTORY.html
deleted file mode 100644
index 760599d..0000000
--- a/HISTORY.html
+++ /dev/null
@@ -1,87 +0,0 @@
-<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Strict//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd'>
-<html>
-<head>
-<meta http-equiv='Content-Type' content='text/html; charset=us-ascii' />
-<title>xlwt HISTORY</title>
-</head>
-<body>
-<p>  Version 0.7.2, released to the general public via PyPI -- 2009-06-01
-</p>
-<code><br /> Revision: 3844
-<br /> Author: sjmachin
-<br /> Date: 11:02:54 AM, Wednesday, 20 May 2009
-<br /> Message:
-<br /> Added function Utils.rowcol_pair_to_cellrange. (0, 0, 65535, 255) -> "A1:IV65536"
-<br /> ----
-<br /> Modified : /xlwt/trunk/xlwt/Utils.py
-<br />
-<br /> Revision: 3843
-<br /> Author: sjmachin
-<br /> Date: 1:46:05 AM, Tuesday, 19 May 2009
-<br /> Message:
-<br /> Removed Worksheet property show_empty_as_zero,
-<br /> and added attribute show_zero_values (default: 1 == True).
-<br /> ----
-<br /> Modified : /xlwt/trunk/xlwt/Worksheet.py
-<br />
-<br /> Revision: 3841
-<br /> Author: sjmachin
-<br /> Date: 11:58:51 AM, Wednesday, 13 May 2009
-<br /> Message:
-<br /> Fixed formula code generation problem with formulas
-<br /> including MAX/SUM/etc functions with arguments like A1+123.
-<br /> Updated version to 0.7.2alpha.
-<br /> ----
-<br /> Modified : /xlwt/trunk/README.html
-<br /> Modified : /xlwt/trunk/setup.py
-<br /> Modified : /xlwt/trunk/xlwt/ExcelFormulaParser.py
-<br /> Modified : /xlwt/trunk/xlwt/ExcelMagic.py
-<br /> Modified : /xlwt/trunk/xlwt/__init__.py
-<br /> Modified : /xlwt/trunk/xlwt/excel-formula.g
-<br />
-<br /> Revision: 3816
-<br /> Author: sjmachin
-<br /> Date: 8:31:39 PM, Tuesday, 24 March 2009
-<br /> Message:
-<br /> Added .../doc/pattern_examples.xls and put a pointer to it
-<br /> in the easyxf part of Style.py.
-<br /> ----
-<br /> Modified : /xlwt/trunk/xlwt/Style.py
-<br /> Added : /xlwt/trunk/xlwt/doc/pattern_examples.xls
-<br />
-<br /> Revision: 3815
-<br /> Author: sjmachin
-<br /> Date: 7:54:52 PM, Tuesday, 24 March 2009
-<br /> Message:
-<br /> Fixed Row.set_cell_formula() bug introduced in 0.7.1.
-<br /> Fixed bug(?) with SCL/magnification handling causing(?) Excel
-<br /> to raise a dialogue box if sheet is set to open in page preview mode
-<br /> and user then switches to normal view.
-<br /> Added color and colour as synonyms for font.colour_index in easyxf.
-<br /> Removed unused attribute Row.__has_default_format.
-<br /> ----
-<br /> Modified : /xlwt/trunk/xlwt/Row.py
-<br /> Modified : /xlwt/trunk/xlwt/Style.py
-<br /> Modified : /xlwt/trunk/xlwt/Worksheet.py
-</code>
-
-
-
-
-
-
-<p>  Version 0.7.1, released to the general public via PyPI -- 2009-03-04
-</p>
-<p>  Version 0.7.0, released to the general public via PyPI
-</p>
-<ul>
-     <li> Fixed more bugs and added more various new bits of functionality </li>
-</ul>
-
-
-<p>  Version 0.7.0a4, fork of pyExcelerator, released to python-excel.
-</p>
-<ul>
-     <li> Fixed various bugs in pyExcelerator and added various new bits of functionality </li>
-</ul>
-</body></html>
diff --git a/PKG-INFO b/PKG-INFO
index 2139291..6f0fe6a 100644
--- a/PKG-INFO
+++ b/PKG-INFO
@@ -1,17 +1,95 @@
-Metadata-Version: 1.0
+Metadata-Version: 1.1
 Name: xlwt
-Version: 0.7.5
-Summary: Library to create spreadsheet files compatible with MS Excel 97/2000/XP/2003 XLS files, on any platform, with Python 2.3 to 2.7
+Version: 1.3.0
+Summary: Library to create spreadsheet files compatible with MS Excel 97/2000/XP/2003 XLS files, on any platform, with Python 2.6, 2.7, 3.3+
 Home-page: http://www.python-excel.org/
 Author: John Machin
 Author-email: sjmachin at lexicon.net
 License: BSD
-Download-URL: http://pypi.python.org/pypi/xlwt
-Description: xlwt is a library for generating spreadsheet files that are compatible
-        with Excel 97/2000/XP/2003, OpenOffice.org Calc, and Gnumeric. xlwt has
-        full support for Unicode. Excel spreadsheets can be generated on any
-        platform without needing Excel or a COM server. The only requirement is
-        Python 2.3 to 2.7.
+Download-URL: https://pypi.python.org/pypi/xlwt
+Description: |Travis|_ |Coveralls|_ |Docs|_ |PyPI|_
+        
+        .. |Travis| image:: https://api.travis-ci.org/python-excel/xlwt.svg?branch=master
+        .. _Travis: https://travis-ci.org/python-excel/xlwt
+        
+        .. |Coveralls| image:: https://coveralls.io/repos/python-excel/xlwt/badge.svg?branch=master
+        .. _Coveralls: https://coveralls.io/r/python-excel/xlwt?branch=master
+        
+        .. |Docs| image:: https://readthedocs.org/projects/xlwt/badge/?version=latest
+        .. _Docs: https://xlwt.readthedocs.org/en/latest/
+        
+        .. |PyPI| image:: https://badge.fury.io/py/xlwt.svg
+        .. _PyPI: https://badge.fury.io/py/xlwt
+            
+        xlwt
+        ====
+        
+        This is a library for developers to use to generate
+        spreadsheet files compatible with Microsoft Excel versions 95 to 2003.
+        
+        The package itself is pure Python with no dependencies on modules or packages
+        outside the standard Python distribution.
+        
+        Please read this before using this package:
+        https://groups.google.com/d/msg/python-excel/P6TjJgFVjMI/g8d0eWxTBQAJ
+        
+        Installation
+        ============
+        
+        Do the following in your virtualenv::
+        
+          pip install xlwt
+        
+        Quick start
+        ===========
+        
+        .. code-block:: python
+        
+            import xlwt
+            from datetime import datetime
+        
+            style0 = xlwt.easyxf('font: name Times New Roman, color-index red, bold on',
+                num_format_str='#,##0.00')
+            style1 = xlwt.easyxf(num_format_str='D-MMM-YY')
+        
+            wb = xlwt.Workbook()
+            ws = wb.add_sheet('A Test Sheet')
+        
+            ws.write(0, 0, 1234.56, style0)
+            ws.write(1, 0, datetime.now(), style1)
+            ws.write(2, 0, 1)
+            ws.write(2, 1, 1)
+            ws.write(2, 2, xlwt.Formula("A3+B3"))
+        
+            wb.save('example.xls')
+        
+        
+        Documentation
+        =============
+        
+        Documentation can be found in the ``docs`` directory of the xlwt package.
+        If these aren't sufficient, please consult the code in the
+        examples directory and the source code itself.
+        
+        The latest documentation can also be found at:
+        https://xlwt.readthedocs.org/en/latest/
+        
+        Problems?
+        =========
+        Try the following in this order:
+        
+        - Read the source
+        
+        - Ask a question on https://groups.google.com/group/python-excel/
+        
+        Acknowledgements
+        ================
+        
+        xlwt is a fork of the pyExcelerator package, which was developed by
+        Roman V. Kiseliov. This product includes software developed by
+        Roman V. Kiseliov <roman at kiseliov.ru>.
+        
+        xlwt uses ANTLR v 2.7.7 to generate its formula compiler.
         
 Keywords: xls excel spreadsheet workbook worksheet pyExcelerator
 Platform: Platform Independent
@@ -24,3 +102,10 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Office/Business :: Financial :: Spreadsheet
 Classifier: Topic :: Database
 Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content :: CGI Tools/Libraries
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
diff --git a/README.html b/README.html
deleted file mode 100644
index d7c9bb9..0000000
--- a/README.html
+++ /dev/null
@@ -1,95 +0,0 @@
-<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Strict//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd'>
-<html>
-<head>
-<meta http-equiv='Content-Type' content='text/html; charset=us-ascii' />
-<title>xlwt README</title>
-</head>
-<body>
-<p><h3>Python package "xlwt"</h3>
-</p>
-<p><b>Purpose:</b> Provide a library for developers to use to generate
-    spreadsheet files compatible with Microsoft Excel versions 95 to 2003.
-</p>
-<p><b>Maintainer:</b> John Machin, Lingfo Pty Ltd (sjmachin at lexicon.net)
-</p>
-<p><b>Licence:</b> BSD-style (see licences.py)
-</p>
-<p><b>Version of xlwt:</b> 0.7.2
-</p>
-<p><b>Version of Python required:</b> 2.3 to 2.6
-</p>
-<p><b>External modules required:</b> None
-</p>
-<p>
-The package itself is pure Python with no dependencies on modules or packages
-outside the standard Python distribution.
-</p>
-<p><b>Quick start:</b>
-</p>
-<pre><code>import xlwt
-from datetime import datetime
-
-style0 = xlwt.easyxf('font: name Times New Roman, color-index red, bold on',
-	num_format_str='#,##0.00')
-style1 = xlwt.easyxf(num_format_str='D-MMM-YY')
-
-wb = xlwt.Workbook()
-ws = wb.add_sheet('A Test Sheet')
-
-ws.write(0, 0, 1234.56, style0)
-ws.write(1, 0, datetime.now(), style1)
-ws.write(2, 0, 1)
-ws.write(2, 1, 1)
-ws.write(2, 2, xlwt.Formula("A3+B3"))
-
-wb.save('example.xls')
-</code></pre><p>
-</p>
-<p><b>Installation:</b>
-</p>
-<ul>
-<li> Any OS: Unzip the .zip file into a suitable directory,
-    chdir to that directory, then do "python setup.py install".
-</li>
-<li> If PYDIR is your Python installation directory:
-    the main files are in PYDIR/Lib/site-packages/xlwt,
-    docs are in the doc subdirectory.
-</li>
-<li> If os.sep != "/": make the appropriate adjustments.
-</li>
-</ul>
-<p><b>Download URLs:</b>
-</p>
-<ul><li>Packaged: http://pypi.python.org/pypi/xlwt
-</li>
-<li>SVN: https://secure.simplistix.co.uk/svn/xlwt/trunk
-</li>
-</ul>
-<p><b>Documentation:</b>
-</p>
-<p>
-Documentation can be found in the 'doc' directory of the xlwt package.
-If these aren't sufficient, please consult the code in the
-examples directory and the source code itself.
-</p>
-<p><b>Problems:</b>
-</p>
-<p>Try the following in this order:</p>
-<ol>
-<li>Read the source</li>
-<li>Ask a question on http://groups.google.com/group/python-excel/</li>
-<li>E-mail the xlwt maintainer (sjmachin at lexicon.net), including
-    "[xlwt]" as part of the message subject.</li>
-</ol>
-<p><b>Acknowledgements:</b>
-</p>
-<ul><li> xlwt is a fork of the pyExcelerator package, which was developed by
-Roman V. Kiseliov.
-"This product includes software developed by Roman V. Kiseliov <roman at kiseliov.ru>."
-</li>
-<li> xlwt uses ANTLR v 2.7.7 to generate its formula compiler.
-</li>
-<li> << a growing list of names; see HISTORY.html >>: feedback, testing, test files, ...
-</li></ul>
-</body>
-</html>
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..2da3f0d
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,83 @@
+|Travis|_ |Coveralls|_ |Docs|_ |PyPI|_
+
+.. |Travis| image:: https://api.travis-ci.org/python-excel/xlwt.svg?branch=master
+.. _Travis: https://travis-ci.org/python-excel/xlwt
+
+.. |Coveralls| image:: https://coveralls.io/repos/python-excel/xlwt/badge.svg?branch=master
+.. _Coveralls: https://coveralls.io/r/python-excel/xlwt?branch=master
+
+.. |Docs| image:: https://readthedocs.org/projects/xlwt/badge/?version=latest
+.. _Docs: https://xlwt.readthedocs.org/en/latest/
+
+.. |PyPI| image:: https://badge.fury.io/py/xlwt.svg
+.. _PyPI: https://badge.fury.io/py/xlwt
+    
+xlwt
+====
+
+This is a library for developers to use to generate
+spreadsheet files compatible with Microsoft Excel versions 95 to 2003.
+
+The package itself is pure Python with no dependencies on modules or packages
+outside the standard Python distribution.
+
+Please read this before using this package:
+https://groups.google.com/d/msg/python-excel/P6TjJgFVjMI/g8d0eWxTBQAJ
+
+Installation
+============
+
+Do the following in your virtualenv::
+
+  pip install xlwt
+
+Quick start
+===========
+
+.. code-block:: python
+
+    import xlwt
+    from datetime import datetime
+
+    style0 = xlwt.easyxf('font: name Times New Roman, color-index red, bold on',
+        num_format_str='#,##0.00')
+    style1 = xlwt.easyxf(num_format_str='D-MMM-YY')
+
+    wb = xlwt.Workbook()
+    ws = wb.add_sheet('A Test Sheet')
+
+    ws.write(0, 0, 1234.56, style0)
+    ws.write(1, 0, datetime.now(), style1)
+    ws.write(2, 0, 1)
+    ws.write(2, 1, 1)
+    ws.write(2, 2, xlwt.Formula("A3+B3"))
+
+    wb.save('example.xls')
+
+
+Documentation
+=============
+
+Documentation can be found in the ``docs`` directory of the xlwt package.
+If these aren't sufficient, please consult the code in the
+examples directory and the source code itself.
+
+The latest documentation can also be found at:
+https://xlwt.readthedocs.org/en/latest/
+
+Problems?
+=========
+Try the following in this order:
+
+- Read the source
+
+- Ask a question on https://groups.google.com/group/python-excel/
+
+Acknowledgements
+================
+
+xlwt is a fork of the pyExcelerator package, which was developed by
+Roman V. Kiseliov. This product includes software developed by
+Roman V. Kiseliov <roman at kiseliov.ru>.
+
+xlwt uses ANTLR v 2.7.7 to generate its formula compiler.
diff --git a/docs/Makefile b/docs/Makefile
new file mode 100644
index 0000000..dbe5a4f
--- /dev/null
+++ b/docs/Makefile
@@ -0,0 +1,153 @@
+# Makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+PAPER         =
+BUILDDIR      = _build
+
+# Internal variables.
+PAPEROPT_a4     = -D latex_paper_size=a4
+PAPEROPT_letter = -D latex_paper_size=letter
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+# the i18n builder cannot share the environment and doctrees with the others
+I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+
+.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
+
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  html       to make standalone HTML files"
+	@echo "  dirhtml    to make HTML files named index.html in directories"
+	@echo "  singlehtml to make a single large HTML file"
+	@echo "  pickle     to make pickle files"
+	@echo "  json       to make JSON files"
+	@echo "  htmlhelp   to make HTML files and a HTML help project"
+	@echo "  qthelp     to make HTML files and a qthelp project"
+	@echo "  devhelp    to make HTML files and a Devhelp project"
+	@echo "  epub       to make an epub"
+	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
+	@echo "  text       to make text files"
+	@echo "  man        to make manual pages"
+	@echo "  texinfo    to make Texinfo files"
+	@echo "  info       to make Texinfo files and run them through makeinfo"
+	@echo "  gettext    to make PO message catalogs"
+	@echo "  changes    to make an overview of all changed/added/deprecated items"
+	@echo "  linkcheck  to check all external links for integrity"
+	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
+
+clean:
+	-rm -rf $(BUILDDIR)/*
+
+html:
+	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
+
+dirhtml:
+	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
+
+singlehtml:
+	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
+	@echo
+	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
+
+pickle:
+	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
+	@echo
+	@echo "Build finished; now you can process the pickle files."
+
+json:
+	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
+	@echo
+	@echo "Build finished; now you can process the JSON files."
+
+htmlhelp:
+	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
+	@echo
+	@echo "Build finished; now you can run HTML Help Workshop with the" \
+	      ".hhp project file in $(BUILDDIR)/htmlhelp."
+
+qthelp:
+	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
+	@echo
+	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
+	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
+	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/xlwt.qhcp"
+	@echo "To view the help file:"
+	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/xlwt.qhc"
+
+devhelp:
+	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
+	@echo
+	@echo "Build finished."
+	@echo "To view the help file:"
+	@echo "# mkdir -p $$HOME/.local/share/devhelp/xlwt"
+	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/xlwt"
+	@echo "# devhelp"
+
+epub:
+	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
+	@echo
+	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
+
+latex:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo
+	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
+	@echo "Run \`make' in that directory to run these through (pdf)latex" \
+	      "(use \`make latexpdf' here to do that automatically)."
+
+latexpdf:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Running LaTeX files through pdflatex..."
+	$(MAKE) -C $(BUILDDIR)/latex all-pdf
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
+
+text:
+	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
+	@echo
+	@echo "Build finished. The text files are in $(BUILDDIR)/text."
+
+man:
+	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
+	@echo
+	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
+
+texinfo:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo
+	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
+	@echo "Run \`make' in that directory to run these through makeinfo" \
+	      "(use \`make info' here to do that automatically)."
+
+info:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo "Running Texinfo files through makeinfo..."
+	make -C $(BUILDDIR)/texinfo info
+	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
+
+gettext:
+	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
+	@echo
+	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
+
+changes:
+	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
+	@echo
+	@echo "The overview file is in $(BUILDDIR)/changes."
+
+linkcheck:
+	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
+	@echo
+	@echo "Link check complete; look for any errors in the above output " \
+	      "or in $(BUILDDIR)/linkcheck/output.txt."
+
+doctest:
+	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
+	@echo "Testing of doctests in the sources finished, look at the " \
+	      "results in $(BUILDDIR)/doctest/output.txt."
diff --git a/docs/api.rst b/docs/api.rst
new file mode 100644
index 0000000..3d8570c
--- /dev/null
+++ b/docs/api.rst
@@ -0,0 +1,29 @@
+API Reference
+=============
+
+.. automodule:: xlwt.Workbook
+   :members:
+
+.. automodule:: xlwt.Worksheet
+   :members:
+
+.. automodule:: xlwt.Row
+   :members:
+
+.. automodule:: xlwt.Column
+   :members:
+
+.. automodule:: xlwt.Cell
+   :members:
+
+.. automodule:: xlwt.Formatting
+   :members:
+
+.. automodule:: xlwt.Style
+   :members:
+
+.. automodule:: xlwt.Bitmap
+   :members:
+
+.. automodule:: xlwt.CompoundDoc
+   :members:
diff --git a/docs/changes.rst b/docs/changes.rst
new file mode 100644
index 0000000..9fa12c4
--- /dev/null
+++ b/docs/changes.rst
@@ -0,0 +1,173 @@
+Changes
+=======
+
+.. currentmodule:: xlwt
+
+1.3.0 (22 August 2017)
+----------------------
+
+- Officially support Python 3.6, drop support for 2.6.
+
+- Fix bytes/string type mismatch in :func:`upack2rt` on python 3.
+
+- Packaging and code style tweaks.
+
+- Use generator expressions to avoid unnecessary lists in memory.
+
+Thanks to the following for their contributions to this release:
+
+- Jon Dufresne
+- Bill Adams
+
+1.2.0 (4 January 2017)
+----------------------
+
+- Remove ``LOCALE`` from regular expression that caused
+  :class:`DeprecationWarning` that become an exception in Python 3.6
+
+- Add :meth:`Workbook.sheet_index` helper.
+
+- :meth:`Workbook.get_sheet` now takes either a string name or an integer
+  index.
+
+1.1.2 (9 June 2016)
+-------------------
+
+- Fix failure in style compression under Python 3.
+
+- Officially support Python 3.5
+
+- Documentation tweaks.
+
+1.1.1 (2 June 2016)
+-------------------
+
+- Fix release problems.
+
+1.1.0 (2 June 2016)
+-------------------
+
+- Fix SST BIFF record in Python 3.
+
+- Fix for writing :class:`ExternSheetRecord` in Python 3.
+
+- Add the ability to insert bitmap images from buffers as well as files.
+
+- Official support for Python 3.5.
+
+Thanks to "thektulu" and Lele Gaifax for the Python 3 fixes.
+Thanks to Ross Golder for the support for inserting images from buffers.
+
+1.0.0 (15 April 2015)
+---------------------
+
+- Python 3 support.
+
+- Initial set of unit tests.
+
+- An initial set of Sphinx documentation.
+
+- Move to setuptools for packaging.
+
+- Wire up Travis, Coveralls and ReadTheDocs.
+
+- Allow longs as row indexes.
+
+Big thanks to Thomas Kluyver for his work on Python 3 support, Manfred Moitzi
+for donating his unit tests.
+
+Belated thanks to Landon Jurgens for his help on converting the documentation
+to Sphinx.
+
+0.7.5 (5 April 2013)
+--------------------
+
+- Fixes a bug that could cause a corrupt SST in .xls files written by a
+  wide-unicode Python build.
+
+- A :class:`ValueError` is now raised immediately if an attempt is made to set
+  column width to other than an int in ``range(65536)``
+
+- Added the ability to set a custom RGB colour in the palette to use for
+  colours. Thanks to Alan Rotman for the work, although this could really
+  use an example in the examples folder...
+
+- Fixed an issue trying to set a diagonal border using easyxf. Thanks to
+  Neil Etheridge for the fix.
+
+- Fixed a regression from 0.7.2 when writing sheets with frozen panes.
+
+0.7.4 (13 April 2012)
+---------------------
+
+- Python 2.3 to 2.7 are now the officially supported versions, no Python
+  3 yet, sorry.
+
+- The ``datemode`` in an xlwt :class:`Workbook` can be set to 1904 by doing
+  ``workbook.dates_1904 = 1`` and is written to the output file. However the
+  datemode was not being reflected in conversions from
+  :class:`datetime.datetime` and :class:`datetime.date` objects to floats for
+  output, resulting in dates that were 4 years too high when seen in Excel.
+
+0.7.3 (21 February 2012)
+------------------------
+
+- Added user_set and best_fit attributes to Column class.
+
+- Fixed an ``[Errno 0] Error`` raised when :meth:`Worksheet.flush_row_data` was
+  called after :meth:`Workbook.save`
+
+- Fixed an error on Windows that occurred when writing large blocks to
+  files.
+
+- Added the ability to write rich text cells
+
+- Fixed a bug when writing ``MULBLANK`` records on big-endian platforms.
+
+- allow the ``active_pane`` on worksheets to be specified
+
+- added support for zoom (magn) factors and improved possibilities when
+  generating split panes
+
+0.7.2 (1 June 2009)
+-------------------
+
+- Added function Utils.rowcol_pair_to_cellrange.
+  ``(0, 0, 65535, 255) -> "A1:IV65536"``
+
+- Removed :class:`Worksheet` property ``show_empty_as_zero``,
+  and added attribute :attr:`~Worksheet.show_zero_values`
+  (default: ``1 == True``).
+
+- Fixed formula code generation problem with formulas
+  including MAX/SUM/etc functions with arguments like A1+123.
+
+- Added .pattern_examples.xls and put a pointer to it
+  in the easyxf part of Style.py.
+
+- Fixed Row.set_cell_formula() bug introduced in 0.7.1.
+
+- Fixed bug(?) with SCL/magnification handling causing(?) Excel
+  to raise a dialogue box if sheet is set to open in page preview mode
+  and user then switches to normal view.
+
+- Added color and colour as synonyms for font.colour_index in easyxf.
+
+- Removed unused attribute Row.__has_default_format.
+
+0.7.1 (4 March 2009)
+--------------------
+
+See source control for changes made.
+
+0.7.0 (19 September 2008)
+-------------------------
+
+- Fixed more bugs and added more various new bits of functionality
+
+0.7.0a4 (8 October 2007)
+------------------------
+
+- fork of pyExcelerator, released to python-excel.
+
+- Fixed various bugs in pyExcelerator and added various new bits of functionality
diff --git a/docs/conf.py b/docs/conf.py
new file mode 100644
index 0000000..c55fa2f
--- /dev/null
+++ b/docs/conf.py
@@ -0,0 +1,22 @@
+import datetime
+import os, pkginfo
+
+on_rtd = os.environ.get('READTHEDOCS', None) == 'True'
+pkg_info = pkginfo.Develop(os.path.join(os.path.dirname(__file__), os.pardir))
+
+extensions = ['sphinx.ext.autodoc', 'sphinx.ext.intersphinx']
+source_suffix = '.rst'
+master_doc = 'index'
+project = u'xlwt'
+copyright = '2002-%s xlwt contributors' % datetime.datetime.now().year
+version = release = pkg_info.version
+exclude_patterns = ['_build']
+pygments_style = 'sphinx'
+
+if on_rtd:
+    html_theme = 'default'
+else:
+    html_theme = 'classic'
+
+htmlhelp_basename = project+'doc'
+intersphinx_mapping = {'python': ('https://docs.python.org', None)}
diff --git a/docs/development.rst b/docs/development.rst
new file mode 100644
index 0000000..0f52807
--- /dev/null
+++ b/docs/development.rst
@@ -0,0 +1,65 @@
+Development
+===========
+
+.. highlight:: bash
+
+This package is developed using continuous integration which can be
+found here:
+
+https://travis-ci.org/python-excel/xlwt
+
+If you wish to contribute to this project, then you should fork the
+repository found here:
+
+https://github.com/python-excel/xlwt
+
+Once that has been done and you have a checkout, you can follow these
+instructions to perform various development tasks:
+
+Setting up a virtualenv
+-----------------------
+
+The recommended way to set up a development environment is to turn
+your checkout into a virtualenv and then install the package in
+editable form as follows::
+
+  $ virtualenv .
... 6726 lines suppressed ...

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/python-modules/packages/xlwt.git



More information about the Python-modules-commits mailing list