README.txt 5.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145
  1. pyExcelerator
  2. --------------------
  3. Dedicated to Olya.
  4. With you it can be reality.
  5. 0x0000. What's this?
  6. --------------------
  7. This is a library for generating Excel 97/2000/XP/2003 and
  8. OpenOffice Calc compatible spreadsheets. pyExcelerator has
  9. full-blown support for UNICODE in Excel and Calc spreadsheets, allows
  10. using variety of formatting features, provides interface to printing
  11. options of Excel and OpenOffice Calc. pyExcelerator contains also
  12. Excel BIFF8 dumper and MS compound documents dumper. Main advantage is
  13. possibility of generating Excel spreadsheets without MS Windows and/or
  14. COM servers. The only requirement -- Python 2.4a3 or higher.
  15. 0x0001. Why?
  16. --------------------
  17. I had need to generate .xls with UNICODE under FreeBSD.
  18. 0x0002. Requirements.
  19. --------------------
  20. Python 2.4 up and running. I've tested pyExcelerator under
  21. Win32 (Python compiled with MS C compiler and Intel
  22. C compiler), Win64-x86 (MS C compiler), FreeBSD/i386 (GCC
  23. 3.4.2), FreeBSD/amd64 (GCC 3.4.2). Fastest was Python under
  24. FreeBSD/amd64.
  25. 0x0003. Installation.
  26. --------------------
  27. As usually: python ./setup.py install
  28. 0x0004. Documentation.
  29. --------------------
  30. In progress. At the present time you can use examples and sources (I hope
  31. I commented sources well and gave variables good names).
  32. 0x0005. Extra features.
  33. --------------------
  34. See ./tools/*.py. You'll find there BIFF8 dumper and MS Compound doc
  35. dumper. In ./hrc you can take my python.hrc for Colorer plug-in for FAR
  36. manager.
  37. 0x0006. Reporting bugs.
  38. --------------------
  39. Please!
  40. 0x0008. Future.
  41. --------------------
  42. Support for Esher layer and (maybe) charts.
  43. 0x0009. Useful links.
  44. --------------------
  45. http://www.python.org --
  46. Python's home.
  47. http://sf.net/pyXLWriter --
  48. port of the first version Spreadsheet-WriteExcel.
  49. This library can write only BIFF5/7 spreadsheets
  50. and therefore can't use UNICODE in spreadsheets.
  51. pyXLWriter however can write formulas with help
  52. of PLY. IMHO, PLY and ambiguous grammar used by
  53. author for formulas support are too power tools.
  54. But in this case power was equals to simplicity.
  55. I want overcome these restrictions and (strictly
  56. IMHO) misfeatures.
  57. http://www.openoffice.org --
  58. OpenOffice home.
  59. About 650 Mb sources -- the best teachers.
  60. 0x000A. Legality.
  61. --------------------
  62. With help from lawyers pyExcelerator is protect by Russian Federation's
  63. laws and international treaties and can be used iff you agreed following
  64. BSD-like agreement.
  65. Copyright (C) 2005 Roman V. Kiseliov
  66. All rights reserved.
  67. Redistribution and use in source and binary forms, with or without
  68. modification, are permitted provided that the following conditions
  69. are met:
  70. 1. Redistributions of source code must retain the above copyright
  71. notice, this list of conditions and the following disclaimer.
  72. 2. Redistributions in binary form must reproduce the above copyright
  73. notice, this list of conditions and the following disclaimer in
  74. the documentation and/or other materials provided with the
  75. distribution.
  76. 3. All advertising materials mentioning features or use of this
  77. software must display the following acknowledgment:
  78. "This product includes software developed by
  79. Roman V. Kiseliov <roman@kiseliov.ru>."
  80. 4. Redistributions of any form whatsoever must retain the following
  81. acknowledgment:
  82. "This product includes software developed by
  83. Roman V. Kiseliov <roman@kiseliov.ru>."
  84. THIS SOFTWARE IS PROVIDED BY Roman V. Kiseliov ``AS IS'' AND ANY
  85. EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  86. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  87. PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL Roman V. Kiseliov OR
  88. ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  89. SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  90. NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  91. LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  92. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  93. STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  94. ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
  95. OF THE POSSIBILITY OF SUCH DAMAGE.
  96. 0xFFFF. Contacting author.
  97. --------------------
  98. Feel free to send me feedback and bug reports.
  99. Roman V. Kiseliov
  100. Russia
  101. Kursk
  102. Libknecht St., 4
  103. +7(0712)56-09-83
  104. <roman@kiseliov.ru>
  105. subject *must* be
  106. "pyExcelerator-bug" (without quotes)
  107. or
  108. "pyExcelerator-feedback" (without quotes)