xlwt3 package

1 files changed, 196 insertions, 0 deletions

diff --git a/tablib/packages/xlwt3/Utils.py b/tablib/packages/xlwt3/Utils.py
new file mode 100644
index 0000000..3509f03
--- /dev/null
+++ b/tablib/packages/xlwt3/Utils.py
@@ -0,0 +1,196 @@
+# pyXLWriter: A library for generating Excel Spreadsheets

+# Copyright (c) 2004 Evgeny Filatov <fufff@users.sourceforge.net>

+# Copyright (c) 2002-2004 John McNamara (Perl Spreadsheet::WriteExcel)

+#

+# This library is free software; you can redistribute it and/or modify it

+# under the terms of the GNU Lesser General Public License as published by

+# the Free Software Foundation; either version 2.1 of the License, or

+# (at your option) any later version.

+#

+# This library is distributed in the hope that it will be useful, but

+# WITHOUT ANY WARRANTY; without even the implied warranty of

+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser

+# General Public License for more details.

+#

+# You should have received a copy of the GNU Lesser General Public License

+# along with this library; if not, write to the Free Software Foundation,

+# Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

+#----------------------------------------------------------------------------

+# This module was written/ported from PERL Spreadsheet::WriteExcel module

+# The author of the PERL Spreadsheet::WriteExcel module is John McNamara

+# <jmcnamara@cpan.org>

+#----------------------------------------------------------------------------

+# See the README.txt distributed with pyXLWriter for more details.

+

+# Portions are (C) Roman V. Kiseliov, 2005

+

+

+# Utilities for work with reference to cells and with sheetnames

+

+

+__rev_id__ = """$Id: Utils.py 3844 2009-05-20 01:02:54Z sjmachin $"""

+

+import re

+from struct import pack

+from .ExcelMagic import MAX_ROW, MAX_COL

+

+

+_re_cell_ex = re.compile(r"(\$?)([A-I]?[A-Z])(\$?)(\d+)", re.IGNORECASE)

+_re_row_range = re.compile(r"\$?(\d+):\$?(\d+)")

+_re_col_range = re.compile(r"\$?([A-I]?[A-Z]):\$?([A-I]?[A-Z])", re.IGNORECASE)

+_re_cell_range = re.compile(r"\$?([A-I]?[A-Z]\$?\d+):\$?([A-I]?[A-Z]\$?\d+)", re.IGNORECASE)

+_re_cell_ref = re.compile(r"\$?([A-I]?[A-Z]\$?\d+)", re.IGNORECASE)

+

+

+def col_by_name(colname):

+    """

+    """

+    col = 0

+    pow = 1

+    for i in range(len(colname)-1, -1, -1):

+        ch = colname[i]

+        col += (ord(ch) - ord('A') + 1) * pow

+        pow *= 26

+    return col - 1

+

+

+def cell_to_rowcol(cell):

+    """Convert an Excel cell reference string in A1 notation

+    to numeric row/col notation.

+

+    Returns: row, col, row_abs, col_abs

+

+    """

+    m = _re_cell_ex.match(cell)

+    if not m:

+        raise Exception("Ill-formed single_cell reference: %s" % cell)

+    col_abs, col, row_abs, row = m.groups()

+    row_abs = bool(row_abs)

+    col_abs = bool(col_abs)

+    row = int(row) - 1

+    col = col_by_name(col.upper())

+    return row, col, row_abs, col_abs

+

+

+def cell_to_rowcol2(cell):

+    """Convert an Excel cell reference string in A1 notation

+    to numeric row/col notation.

+

+    Returns: row, col

+

+    """

+    m = _re_cell_ex.match(cell)

+    if not m:

+        raise Exception("Error in cell format")

+    col_abs, col, row_abs, row = m.groups()

+    # Convert base26 column string to number

+    # All your Base are belong to us.

+    row = int(row) - 1

+    col = col_by_name(col.upper())

+    return row, col

+

+

+def rowcol_to_cell(row, col, row_abs=False, col_abs=False):

+    """Convert numeric row/col notation to an Excel cell reference string in

+    A1 notation.

+

+    """

+    assert 0 <= row < MAX_ROW # MAX_ROW counts from 1

+    assert 0 <= col < MAX_COL # MAX_COL counts from 1

+    d = col // 26

+    m = col % 26

+    chr1 = ""    # Most significant character in AA1

+    if row_abs:

+        row_abs = '$'

+    else:

+        row_abs = ''

+    if col_abs:

+        col_abs = '$'

+    else:

+        col_abs = ''

+    if d > 0:

+        chr1 = chr(ord('A') + d  - 1)

+    chr2 = chr(ord('A') + m)

+    # Zero index to 1-index

+    return col_abs + chr1 + chr2 + row_abs + str(row + 1)

+

+def rowcol_pair_to_cellrange(row1, col1, row2, col2,

+    row1_abs=False, col1_abs=False, row2_abs=False, col2_abs=False):

+    """Convert two (row,column) pairs

+    into a cell range string in A1:B2 notation.

+

+    Returns: cell range string

+    """

+    assert row1 <= row2

+    assert col1 <= col2

+    return (

+        rowcol_to_cell(row1, col1, row1_abs, col1_abs)

+        + ":"

+        + rowcol_to_cell(row2, col2, row2_abs, col2_abs)

+        )

+

+def cellrange_to_rowcol_pair(cellrange):

+    """Convert cell range string in A1 notation to numeric row/col

+    pair.

+

+    Returns: row1, col1, row2, col2

+

+    """

+    cellrange = cellrange.upper()

+    # Convert a row range: '1:3'

+    res = _re_row_range.match(cellrange)

+    if res:

+        row1 = int(res.group(1)) - 1

+        col1 = 0

+        row2 = int(res.group(2)) - 1

+        col2 = -1

+        return row1, col1, row2, col2

+    # Convert a column range: 'A:A' or 'B:G'.

+    # A range such as A:A is equivalent to A1:A16384, so add rows as required

+    res = _re_col_range.match(cellrange)

+    if res:

+        col1 = col_by_name(res.group(1).upper())

+        row1 = 0

+        col2 = col_by_name(res.group(2).upper())

+        row2 = -1

+        return row1, col1, row2, col2

+    # Convert a cell range: 'A1:B7'

+    res = _re_cell_range.match(cellrange)

+    if res:

+        row1, col1 = cell_to_rowcol2(res.group(1))

+        row2, col2 = cell_to_rowcol2(res.group(2))

+        return row1, col1, row2, col2

+    # Convert a cell reference: 'A1' or 'AD2000'

+    res = _re_cell_ref.match(cellrange)

+    if res:

+        row1, col1 = cell_to_rowcol2(res.group(1))

+        return row1, col1, row1, col1

+    raise Exception("Unknown cell reference %s" % (cell))

+

+

+def cell_to_packed_rowcol(cell):

+    """ pack row and column into the required 4 byte format """

+    row, col, row_abs, col_abs = cell_to_rowcol(cell)

+    if col >= MAX_COL:

+        raise Exception("Column %s greater than IV in formula" % cell)

+    if row >= MAX_ROW: # this for BIFF8. for BIFF7 available 2^14

+        raise Exception("Row %s greater than %d in formula" % (cell, MAX_ROW))

+    col |= int(not row_abs) << 15

+    col |= int(not col_abs) << 14

+    return row, col

+

+# === sheetname functions ===

+

+def valid_sheet_name(sheet_name):

+    if sheet_name == "" or sheet_name[0] == "'" or len(sheet_name) > 31:

+        return False

+    for c in sheet_name:

+        if c in "[]:\\?/*\x00":

+            return False

+    return True

+

+def quote_sheet_name(unquoted_sheet_name):

+    if not valid_sheet_name(unquoted_sheet_name):

+        raise Exception(

+            'attempt to quote an invalid worksheet name %r' % unquoted_sheet_name)

+    return "'" + unquoted_sheet_name.replace("'", "''") + "'"