annotate babel3/babel/numbers.py @ 493:0b228ee775fe experimental

Copy over trunk.
author jruigrok
date Thu, 15 Apr 2010 05:54:28 +0000
parents
children cddcd04db33e
rev   line source
493
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
1 # -*- coding: utf-8 -*-
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
2 #
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
3 # Copyright (C) 2007 Edgewall Software
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
4 # All rights reserved.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
5 #
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
6 # This software is licensed as described in the file COPYING, which
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
7 # you should have received as part of this distribution. The terms
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
8 # are also available at http://babel.edgewall.org/wiki/License.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
9 #
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
10 # This software consists of voluntary contributions made by many
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
11 # individuals. For the exact contribution history, see the revision
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
12 # history and logs, available at http://babel.edgewall.org/log/.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
13
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
14 """Locale dependent formatting and parsing of numeric data.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
15
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
16 The default locale for the functions in this module is determined by the
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
17 following environment variables, in that order:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
18
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
19 * ``LC_NUMERIC``,
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
20 * ``LC_ALL``, and
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
21 * ``LANG``
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
22 """
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
23 # TODO:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
24 # Padding and rounding increments in pattern:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
25 # - http://www.unicode.org/reports/tr35/ (Appendix G.6)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
26 import math
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
27 import re
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
28 try:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
29 from decimal import Decimal
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
30 have_decimal = True
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
31 except ImportError:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
32 have_decimal = False
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
33
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
34 from babel.core import default_locale, Locale
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
35
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
36 __all__ = ['format_number', 'format_decimal', 'format_currency',
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
37 'format_percent', 'format_scientific', 'parse_number',
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
38 'parse_decimal', 'NumberFormatError']
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
39 __docformat__ = 'restructuredtext en'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
40
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
41 LC_NUMERIC = default_locale('LC_NUMERIC')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
42
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
43 def get_currency_name(currency, locale=LC_NUMERIC):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
44 """Return the name used by the locale for the specified currency.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
45
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
46 >>> get_currency_name('USD', 'en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
47 u'US Dollar'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
48
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
49 :param currency: the currency code
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
50 :param locale: the `Locale` object or locale identifier
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
51 :return: the currency symbol
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
52 :rtype: `unicode`
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
53 :since: version 0.9.4
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
54 """
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
55 return Locale.parse(locale).currencies.get(currency, currency)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
56
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
57 def get_currency_symbol(currency, locale=LC_NUMERIC):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
58 """Return the symbol used by the locale for the specified currency.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
59
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
60 >>> get_currency_symbol('USD', 'en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
61 u'$'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
62
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
63 :param currency: the currency code
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
64 :param locale: the `Locale` object or locale identifier
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
65 :return: the currency symbol
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
66 :rtype: `unicode`
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
67 """
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
68 return Locale.parse(locale).currency_symbols.get(currency, currency)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
69
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
70 def get_decimal_symbol(locale=LC_NUMERIC):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
71 """Return the symbol used by the locale to separate decimal fractions.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
72
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
73 >>> get_decimal_symbol('en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
74 u'.'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
75
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
76 :param locale: the `Locale` object or locale identifier
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
77 :return: the decimal symbol
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
78 :rtype: `unicode`
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
79 """
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
80 return Locale.parse(locale).number_symbols.get('decimal', u'.')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
81
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
82 def get_plus_sign_symbol(locale=LC_NUMERIC):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
83 """Return the plus sign symbol used by the current locale.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
84
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
85 >>> get_plus_sign_symbol('en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
86 u'+'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
87
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
88 :param locale: the `Locale` object or locale identifier
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
89 :return: the plus sign symbol
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
90 :rtype: `unicode`
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
91 """
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
92 return Locale.parse(locale).number_symbols.get('plusSign', u'+')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
93
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
94 def get_minus_sign_symbol(locale=LC_NUMERIC):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
95 """Return the plus sign symbol used by the current locale.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
96
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
97 >>> get_minus_sign_symbol('en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
98 u'-'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
99
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
100 :param locale: the `Locale` object or locale identifier
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
101 :return: the plus sign symbol
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
102 :rtype: `unicode`
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
103 """
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
104 return Locale.parse(locale).number_symbols.get('minusSign', u'-')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
105
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
106 def get_exponential_symbol(locale=LC_NUMERIC):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
107 """Return the symbol used by the locale to separate mantissa and exponent.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
108
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
109 >>> get_exponential_symbol('en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
110 u'E'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
111
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
112 :param locale: the `Locale` object or locale identifier
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
113 :return: the exponential symbol
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
114 :rtype: `unicode`
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
115 """
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
116 return Locale.parse(locale).number_symbols.get('exponential', u'E')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
117
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
118 def get_group_symbol(locale=LC_NUMERIC):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
119 """Return the symbol used by the locale to separate groups of thousands.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
120
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
121 >>> get_group_symbol('en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
122 u','
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
123
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
124 :param locale: the `Locale` object or locale identifier
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
125 :return: the group symbol
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
126 :rtype: `unicode`
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
127 """
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
128 return Locale.parse(locale).number_symbols.get('group', u',')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
129
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
130 def format_number(number, locale=LC_NUMERIC):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
131 u"""Return the given number formatted for a specific locale.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
132
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
133 >>> format_number(1099, locale='en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
134 u'1,099'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
135 >>> format_number(1099, locale='de_DE')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
136 u'1.099'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
137
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
138
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
139 :param number: the number to format
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
140 :param locale: the `Locale` object or locale identifier
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
141 :return: the formatted number
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
142 :rtype: `unicode`
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
143 """
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
144 # Do we really need this one?
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
145 return format_decimal(number, locale=locale)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
146
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
147 def format_decimal(number, format=None, locale=LC_NUMERIC):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
148 u"""Return the given decimal number formatted for a specific locale.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
149
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
150 >>> format_decimal(1.2345, locale='en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
151 u'1.234'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
152 >>> format_decimal(1.2346, locale='en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
153 u'1.235'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
154 >>> format_decimal(-1.2346, locale='en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
155 u'-1.235'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
156 >>> format_decimal(1.2345, locale='sv_SE')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
157 u'1,234'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
158 >>> format_decimal(1.2345, locale='de')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
159 u'1,234'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
160
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
161 The appropriate thousands grouping and the decimal separator are used for
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
162 each locale:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
163
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
164 >>> format_decimal(12345.5, locale='en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
165 u'12,345.5'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
166
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
167 :param number: the number to format
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
168 :param format:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
169 :param locale: the `Locale` object or locale identifier
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
170 :return: the formatted decimal number
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
171 :rtype: `unicode`
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
172 """
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
173 locale = Locale.parse(locale)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
174 if not format:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
175 format = locale.decimal_formats.get(format)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
176 pattern = parse_pattern(format)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
177 return pattern.apply(number, locale)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
178
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
179 def format_currency(number, currency, format=None, locale=LC_NUMERIC):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
180 u"""Return formatted currency value.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
181
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
182 >>> format_currency(1099.98, 'USD', locale='en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
183 u'$1,099.98'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
184 >>> format_currency(1099.98, 'USD', locale='es_CO')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
185 u'US$\\xa01.099,98'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
186 >>> format_currency(1099.98, 'EUR', locale='de_DE')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
187 u'1.099,98\\xa0\\u20ac'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
188
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
189 The pattern can also be specified explicitly:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
190
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
191 >>> format_currency(1099.98, 'EUR', u'\xa4\xa4 #,##0.00', locale='en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
192 u'EUR 1,099.98'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
193
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
194 :param number: the number to format
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
195 :param currency: the currency code
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
196 :param locale: the `Locale` object or locale identifier
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
197 :return: the formatted currency value
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
198 :rtype: `unicode`
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
199 """
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
200 locale = Locale.parse(locale)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
201 if not format:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
202 format = locale.currency_formats.get(format)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
203 pattern = parse_pattern(format)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
204 return pattern.apply(number, locale, currency=currency)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
205
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
206 def format_percent(number, format=None, locale=LC_NUMERIC):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
207 """Return formatted percent value for a specific locale.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
208
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
209 >>> format_percent(0.34, locale='en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
210 u'34%'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
211 >>> format_percent(25.1234, locale='en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
212 u'2,512%'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
213 >>> format_percent(25.1234, locale='sv_SE')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
214 u'2\\xa0512\\xa0%'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
215
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
216 The format pattern can also be specified explicitly:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
217
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
218 >>> format_percent(25.1234, u'#,##0\u2030', locale='en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
219 u'25,123\u2030'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
220
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
221 :param number: the percent number to format
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
222 :param format:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
223 :param locale: the `Locale` object or locale identifier
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
224 :return: the formatted percent number
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
225 :rtype: `unicode`
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
226 """
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
227 locale = Locale.parse(locale)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
228 if not format:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
229 format = locale.percent_formats.get(format)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
230 pattern = parse_pattern(format)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
231 return pattern.apply(number, locale)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
232
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
233 def format_scientific(number, format=None, locale=LC_NUMERIC):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
234 """Return value formatted in scientific notation for a specific locale.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
235
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
236 >>> format_scientific(10000, locale='en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
237 u'1E4'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
238
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
239 The format pattern can also be specified explicitly:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
240
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
241 >>> format_scientific(1234567, u'##0E00', locale='en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
242 u'1.23E06'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
243
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
244 :param number: the number to format
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
245 :param format:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
246 :param locale: the `Locale` object or locale identifier
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
247 :return: value formatted in scientific notation.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
248 :rtype: `unicode`
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
249 """
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
250 locale = Locale.parse(locale)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
251 if not format:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
252 format = locale.scientific_formats.get(format)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
253 pattern = parse_pattern(format)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
254 return pattern.apply(number, locale)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
255
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
256
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
257 class NumberFormatError(ValueError):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
258 """Exception raised when a string cannot be parsed into a number."""
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
259
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
260
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
261 def parse_number(string, locale=LC_NUMERIC):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
262 """Parse localized number string into a long integer.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
263
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
264 >>> parse_number('1,099', locale='en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
265 1099L
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
266 >>> parse_number('1.099', locale='de_DE')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
267 1099L
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
268
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
269 When the given string cannot be parsed, an exception is raised:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
270
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
271 >>> parse_number('1.099,98', locale='de')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
272 Traceback (most recent call last):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
273 ...
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
274 NumberFormatError: '1.099,98' is not a valid number
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
275
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
276 :param string: the string to parse
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
277 :param locale: the `Locale` object or locale identifier
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
278 :return: the parsed number
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
279 :rtype: `long`
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
280 :raise `NumberFormatError`: if the string can not be converted to a number
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
281 """
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
282 try:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
283 return long(string.replace(get_group_symbol(locale), ''))
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
284 except ValueError:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
285 raise NumberFormatError('%r is not a valid number' % string)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
286
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
287 def parse_decimal(string, locale=LC_NUMERIC):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
288 """Parse localized decimal string into a float.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
289
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
290 >>> parse_decimal('1,099.98', locale='en_US')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
291 1099.98
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
292 >>> parse_decimal('1.099,98', locale='de')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
293 1099.98
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
294
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
295 When the given string cannot be parsed, an exception is raised:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
296
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
297 >>> parse_decimal('2,109,998', locale='de')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
298 Traceback (most recent call last):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
299 ...
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
300 NumberFormatError: '2,109,998' is not a valid decimal number
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
301
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
302 :param string: the string to parse
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
303 :param locale: the `Locale` object or locale identifier
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
304 :return: the parsed decimal number
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
305 :rtype: `float`
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
306 :raise `NumberFormatError`: if the string can not be converted to a
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
307 decimal number
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
308 """
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
309 locale = Locale.parse(locale)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
310 try:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
311 return float(string.replace(get_group_symbol(locale), '')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
312 .replace(get_decimal_symbol(locale), '.'))
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
313 except ValueError:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
314 raise NumberFormatError('%r is not a valid decimal number' % string)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
315
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
316
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
317 PREFIX_END = r'[^0-9@#.,]'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
318 NUMBER_TOKEN = r'[0-9@#.\-,E+]'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
319
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
320 PREFIX_PATTERN = r"(?P<prefix>(?:'[^']*'|%s)*)" % PREFIX_END
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
321 NUMBER_PATTERN = r"(?P<number>%s+)" % NUMBER_TOKEN
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
322 SUFFIX_PATTERN = r"(?P<suffix>.*)"
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
323
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
324 number_re = re.compile(r"%s%s%s" % (PREFIX_PATTERN, NUMBER_PATTERN,
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
325 SUFFIX_PATTERN))
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
326
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
327 def split_number(value):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
328 """Convert a number into a (intasstring, fractionasstring) tuple"""
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
329 if have_decimal and isinstance(value, Decimal):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
330 text = str(value)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
331 else:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
332 text = ('%.9f' % value).rstrip('0')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
333 if '.' in text:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
334 a, b = text.split('.', 1)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
335 if b == '0':
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
336 b = ''
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
337 else:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
338 a, b = text, ''
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
339 return a, b
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
340
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
341 def bankersround(value, ndigits=0):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
342 """Round a number to a given precision.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
343
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
344 Works like round() except that the round-half-even (banker's rounding)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
345 algorithm is used instead of round-half-up.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
346
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
347 >>> bankersround(5.5, 0)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
348 6.0
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
349 >>> bankersround(6.5, 0)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
350 6.0
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
351 >>> bankersround(-6.5, 0)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
352 -6.0
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
353 >>> bankersround(1234.0, -2)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
354 1200.0
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
355 """
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
356 sign = int(value < 0) and -1 or 1
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
357 value = abs(value)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
358 a, b = split_number(value)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
359 digits = a + b
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
360 add = 0
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
361 i = len(a) + ndigits
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
362 if i < 0 or i >= len(digits):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
363 pass
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
364 elif digits[i] > '5':
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
365 add = 1
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
366 elif digits[i] == '5' and digits[i-1] in '13579':
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
367 add = 1
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
368 scale = 10**ndigits
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
369 if have_decimal and isinstance(value, Decimal):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
370 return Decimal(int(value * scale + add)) / scale * sign
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
371 else:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
372 return float(int(value * scale + add)) / scale * sign
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
373
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
374 def parse_pattern(pattern):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
375 """Parse number format patterns"""
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
376 if isinstance(pattern, NumberPattern):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
377 return pattern
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
378
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
379 # Do we have a negative subpattern?
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
380 if ';' in pattern:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
381 pattern, neg_pattern = pattern.split(';', 1)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
382 pos_prefix, number, pos_suffix = number_re.search(pattern).groups()
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
383 neg_prefix, _, neg_suffix = number_re.search(neg_pattern).groups()
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
384 else:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
385 pos_prefix, number, pos_suffix = number_re.search(pattern).groups()
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
386 neg_prefix = '-' + pos_prefix
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
387 neg_suffix = pos_suffix
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
388 if 'E' in number:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
389 number, exp = number.split('E', 1)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
390 else:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
391 exp = None
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
392 if '@' in number:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
393 if '.' in number and '0' in number:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
394 raise ValueError('Significant digit patterns can not contain '
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
395 '"@" or "0"')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
396 if '.' in number:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
397 #integer, fraction = number.rsplit('.', 1)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
398 # 2.3 compat: this is rsplit
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
399 parts = number.split('.')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
400 integer, fraction = '.'.join(parts[:-1]), parts[-1]
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
401 else:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
402 integer = number
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
403 fraction = ''
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
404 min_frac = max_frac = 0
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
405
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
406 def parse_precision(p):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
407 """Calculate the min and max allowed digits"""
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
408 min = max = 0
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
409 for c in p:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
410 if c in '@0':
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
411 min += 1
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
412 max += 1
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
413 elif c == '#':
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
414 max += 1
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
415 elif c == ',':
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
416 continue
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
417 else:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
418 break
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
419 return min, max
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
420
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
421 def parse_grouping(p):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
422 """Parse primary and secondary digit grouping
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
423
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
424 >>> parse_grouping('##')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
425 0, 0
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
426 >>> parse_grouping('#,###')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
427 3, 3
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
428 >>> parse_grouping('#,####,###')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
429 3, 4
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
430 """
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
431 width = len(p)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
432 g1 = p.rfind(',')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
433 if g1 == -1:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
434 return 1000, 1000
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
435 g1 = width - g1 - 1
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
436 g2 = p[:-g1 - 1].rfind(',')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
437 if g2 == -1:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
438 return g1, g1
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
439 g2 = width - g1 - g2 - 2
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
440 return g1, g2
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
441
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
442 int_prec = parse_precision(integer)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
443 frac_prec = parse_precision(fraction)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
444 if exp:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
445 frac_prec = parse_precision(integer+fraction)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
446 exp_plus = exp.startswith('+')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
447 exp = exp.lstrip('+')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
448 exp_prec = parse_precision(exp)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
449 else:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
450 exp_plus = None
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
451 exp_prec = None
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
452 grouping = parse_grouping(integer)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
453 return NumberPattern(pattern, (pos_prefix, neg_prefix),
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
454 (pos_suffix, neg_suffix), grouping,
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
455 int_prec, frac_prec,
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
456 exp_prec, exp_plus)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
457
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
458
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
459 class NumberPattern(object):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
460
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
461 def __init__(self, pattern, prefix, suffix, grouping,
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
462 int_prec, frac_prec, exp_prec, exp_plus):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
463 self.pattern = pattern
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
464 self.prefix = prefix
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
465 self.suffix = suffix
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
466 self.grouping = grouping
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
467 self.int_prec = int_prec
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
468 self.frac_prec = frac_prec
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
469 self.exp_prec = exp_prec
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
470 self.exp_plus = exp_plus
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
471 if '%' in ''.join(self.prefix + self.suffix):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
472 self.scale = 100
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
473 elif u'‰' in ''.join(self.prefix + self.suffix):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
474 self.scale = 1000
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
475 else:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
476 self.scale = 1
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
477
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
478 def __repr__(self):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
479 return '<%s %r>' % (type(self).__name__, self.pattern)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
480
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
481 def apply(self, value, locale, currency=None):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
482 value *= self.scale
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
483 is_negative = int(value < 0)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
484 if self.exp_prec: # Scientific notation
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
485 value = abs(value)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
486 if value:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
487 exp = int(math.floor(math.log(value, 10)))
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
488 else:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
489 exp = 0
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
490 # Minimum number of integer digits
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
491 if self.int_prec[0] == self.int_prec[1]:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
492 exp -= self.int_prec[0] - 1
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
493 # Exponent grouping
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
494 elif self.int_prec[1]:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
495 exp = int(exp) / self.int_prec[1] * self.int_prec[1]
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
496 if not have_decimal or not isinstance(value, Decimal):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
497 value = float(value)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
498 if exp < 0:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
499 value = value * 10**(-exp)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
500 else:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
501 value = value / 10**exp
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
502 exp_sign = ''
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
503 if exp < 0:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
504 exp_sign = get_minus_sign_symbol(locale)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
505 elif self.exp_plus:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
506 exp_sign = get_plus_sign_symbol(locale)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
507 exp = abs(exp)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
508 number = u'%s%s%s%s' % \
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
509 (self._format_sigdig(value, self.frac_prec[0],
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
510 self.frac_prec[1]),
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
511 get_exponential_symbol(locale), exp_sign,
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
512 self._format_int(str(exp), self.exp_prec[0],
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
513 self.exp_prec[1], locale))
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
514 elif '@' in self.pattern: # Is it a siginificant digits pattern?
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
515 text = self._format_sigdig(abs(value),
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
516 self.int_prec[0],
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
517 self.int_prec[1])
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
518 if '.' in text:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
519 a, b = text.split('.')
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
520 a = self._format_int(a, 0, 1000, locale)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
521 if b:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
522 b = get_decimal_symbol(locale) + b
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
523 number = a + b
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
524 else:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
525 number = self._format_int(text, 0, 1000, locale)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
526 else: # A normal number pattern
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
527 a, b = split_number(bankersround(abs(value),
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
528 self.frac_prec[1]))
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
529 b = b or '0'
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
530 a = self._format_int(a, self.int_prec[0],
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
531 self.int_prec[1], locale)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
532 b = self._format_frac(b, locale)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
533 number = a + b
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
534 retval = u'%s%s%s' % (self.prefix[is_negative], number,
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
535 self.suffix[is_negative])
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
536 if u'¤' in retval:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
537 retval = retval.replace(u'¤¤', currency.upper())
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
538 retval = retval.replace(u'¤', get_currency_symbol(currency, locale))
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
539 return retval
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
540
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
541 def _format_sigdig(self, value, min, max):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
542 """Convert value to a string.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
543
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
544 The resulting string will contain between (min, max) number of
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
545 significant digits.
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
546 """
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
547 a, b = split_number(value)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
548 ndecimals = len(a)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
549 if a == '0' and b != '':
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
550 ndecimals = 0
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
551 while b.startswith('0'):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
552 b = b[1:]
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
553 ndecimals -= 1
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
554 a, b = split_number(bankersround(value, max - ndecimals))
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
555 digits = len((a + b).lstrip('0'))
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
556 if not digits:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
557 digits = 1
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
558 # Figure out if we need to add any trailing '0':s
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
559 if len(a) >= max and a != '0':
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
560 return a
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
561 if digits < min:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
562 b += ('0' * (min - digits))
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
563 if b:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
564 return '%s.%s' % (a, b)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
565 return a
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
566
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
567 def _format_int(self, value, min, max, locale):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
568 width = len(value)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
569 if width < min:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
570 value = '0' * (min - width) + value
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
571 gsize = self.grouping[0]
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
572 ret = ''
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
573 symbol = get_group_symbol(locale)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
574 while len(value) > gsize:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
575 ret = symbol + value[-gsize:] + ret
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
576 value = value[:-gsize]
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
577 gsize = self.grouping[1]
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
578 return value + ret
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
579
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
580 def _format_frac(self, value, locale):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
581 min, max = self.frac_prec
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
582 if len(value) < min:
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
583 value += ('0' * (min - len(value)))
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
584 if max == 0 or (min == 0 and int(value) == 0):
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
585 return ''
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
586 width = len(value)
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
587 while len(value) > min and value[-1] == '0':
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
588 value = value[:-1]
0b228ee775fe Copy over trunk.
jruigrok
parents:
diff changeset
589 return get_decimal_symbol(locale) + value
Copyright (C) 2012-2017 Edgewall Software