/usr/lib/python2.6/site-packages/babel
Edit: /usr/lib/python2.6/site-packages/babel/numbers.pyc (22375B)
Ñò
zDVc @ sê d Z d d k l Z l Z d d k Z d d k Z d d k l Z l Z d d k
l Z l Z l
Z
d d k l Z e d ƒ Z d e d „ Z e d „ Z d d e e e d
„ Z e d „ Z e d „ Z e d
„ Z e d „ Z e d „ Z e d „ Z d e d „ Z d e d „ Z d e d „ Z d e d „ Z d e! f d „ ƒ YZ" e d „ Z# e d „ Z$ d Z% d Z& d e% Z' d e& Z( d Z) e i* d e' e( e) f ƒ Z+ d „ Z, d d! „ Z- d" „ Z. d# „ Z/ d$ e0 f d% „ ƒ YZ1 d S(& s‚
babel.numbers
~~~~~~~~~~~~~
Locale dependent formatting and parsing of numeric data.
The default locale for the functions in this module is determined by the
following environment variables, in that order:
* ``LC_NUMERIC``,
* ``LC_ALL``, and
* ``LANG``
:copyright: (c) 2013 by the Babel Team.
:license: BSD, see LICENSE for more details.
iÿÿÿÿ( t Decimalt InvalidOperationN( t datet datetime( t default_localet Localet
get_global( t
range_typet
LC_NUMERICc C si t i | ƒ } | d j o: | i | ƒ } | i d } | | j o
| | | Sn | i i | | ƒ S( s‘ Return the name used by the locale for the specified currency.
>>> get_currency_name('USD', locale='en_US')
u'US Dollar'
.. versionadded:: 0.9.4
:param currency: the currency code
:param count: the optional count. If provided the currency name
will be pluralized to that number if possible.
:param locale: the `Locale` object or locale identifier
t currency_names_pluralN( R t parset Nonet plural_formt _datat
currenciest get( t currencyt countt localet locR t plural_names( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt get_currency_name! s
c C s t i | ƒ i i | | ƒ S( sæ Return the symbol used by the locale for the specified currency.
>>> get_currency_symbol('USD', locale='en_US')
u'$'
:param currency: the currency code
:param locale: the `Locale` object or locale identifier
( R R
t currency_symbolsR ( R R ( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt get_currency_symbol7 s c sq t d ƒ } ˆ d j o t i ƒ ‰ n! t ˆ t ƒ o ˆ i ƒ ‰ n ˆ d j o
ˆ ‰ n! t ˆ t ƒ o ˆ i ƒ ‰ n | i | i ƒ d ƒ } ‡ ‡ f d † } g } xº | D]² \ }
} } }
| o t | Π} n | o t | Π} n |
o | p |
o | oU | | | ƒ oE | o- | i h |
d 6| d 6| d 6|
d 6ƒ qi| i |
ƒ q· q· W| S( s3 Returns the list of currencies for the given territory that are valid for
the given date range. In addition to that the currency database
distinguishes between tender and non-tender currencies. By default only
tender currencies are returned.
The return value is a list of all currencies roughly ordered by the time
of when the currency became active. The longer the currency is being in
use the more to the left of the list it will be.
The start date defaults to today. If no end date is given it will be the
same as the start date. Otherwise a range can be defined. For instance
this can be used to find the currencies in use in Austria between 1995 and
2011:
>>> from datetime import date
>>> get_territory_currencies('AT', date(1995, 1, 1), date(2011, 1, 1))
['ATS', 'EUR']
Likewise it's also possible to find all the currencies in use on a
single date:
>>> get_territory_currencies('AT', date(1995, 1, 1))
['ATS']
>>> get_territory_currencies('AT', date(2011, 1, 1))
['EUR']
By default the return value only includes tender currencies. This
however can be changed:
>>> get_territory_currencies('US')
['USD']
>>> get_territory_currencies('US', tender=False, non_tender=True)
['USN', 'USS']
.. versionadded:: 2.0
:param territory: the name of the territory to find the currency fo
:param start_date: the start date. If not given today is assumed.
:param end_date: the end date. If not given the start date is assumed.
:param tender: controls whether tender currencies should be included.
:param non_tender: controls whether non-tender currencies should be
included.
:param include_details: if set to `True`, instead of returning currency
codes the return value will be dictionaries
with detail information. In that case each
dictionary will have the keys ``'currency'``,
``'from'``, ``'to'``, and ``'tender'``.
t territory_currenciesc s1 | d j p
| ˆ j o | d j p
| ˆ j S( N( R ( t startt end( t
start_datet end_date( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt
_is_activeƒ s R t fromt tot tenderN( (
R R t date_t todayt
isinstancet datetime_R R t uppert append( t territoryR R R t
non_tendert include_detailsR t cursR t resultt
currency_codeR R t is_tender( ( R R s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt get_territory_currenciesC s8 3
c C s t i | ƒ i i d d ƒ S( s³ Return the symbol used by the locale to separate decimal fractions.
>>> get_decimal_symbol('en_US')
u'.'
:param locale: the `Locale` object or locale identifier
t decimalu .( R R
t number_symbolsR ( R ( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt get_decimal_symbolœ s c C s t i | ƒ i i d d ƒ S( s© Return the plus sign symbol used by the current locale.
>>> get_plus_sign_symbol('en_US')
u'+'
:param locale: the `Locale` object or locale identifier
t plusSignu +( R R
R0 R ( R ( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt get_plus_sign_symbol§ s c C s t i | ƒ i i d d ƒ S( sª Return the plus sign symbol used by the current locale.
>>> get_minus_sign_symbol('en_US')
u'-'
:param locale: the `Locale` object or locale identifier
t minusSignu -( R R
R0 R ( R ( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt get_minus_sign_symbol² s c C s t i | ƒ i i d d ƒ S( s» Return the symbol used by the locale to separate mantissa and exponent.
>>> get_exponential_symbol('en_US')
u'E'
:param locale: the `Locale` object or locale identifier
t exponentialu E( R R
R0 R ( R ( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt get_exponential_symbol½ s c C s t i | ƒ i i d d ƒ S( s³ Return the symbol used by the locale to separate groups of thousands.
>>> get_group_symbol('en_US')
u','
:param locale: the `Locale` object or locale identifier
t groupu ,( R R
R0 R ( R ( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt get_group_symbolÈ s c C s t | d | ƒS( u Return the given number formatted for a specific locale.
>>> format_number(1099, locale='en_US')
u'1,099'
>>> format_number(1099, locale='de_DE')
u'1.099'
:param number: the number to format
:param locale: the `Locale` object or locale identifier
R ( t format_decimal( t numberR ( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt
format_numberÓ s
c C sH t i | ƒ } | p | i i | ƒ } n t | ƒ } | i | | ƒ S( uŠ Return the given decimal number formatted for a specific locale.
>>> format_decimal(1.2345, locale='en_US')
u'1.234'
>>> format_decimal(1.2346, locale='en_US')
u'1.235'
>>> format_decimal(-1.2346, locale='en_US')
u'-1.235'
>>> format_decimal(1.2345, locale='sv_SE')
u'1,234'
>>> format_decimal(1.2345, locale='de')
u'1,234'
The appropriate thousands grouping and the decimal separator are used for
each locale:
>>> format_decimal(12345.5, locale='en_US')
u'12,345.5'
:param number: the number to format
:param format:
:param locale: the `Locale` object or locale identifier
( R R
t decimal_formatsR t
parse_patternt apply( R; t formatR t pattern( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyR: ã s
c C sN t i | ƒ } | p | i i | ƒ } n t | ƒ } | i | | d | ƒS( u\ Return formatted currency value.
>>> format_currency(1099.98, 'USD', locale='en_US')
u'$1,099.98'
>>> format_currency(1099.98, 'USD', locale='es_CO')
u'1.099,98\xa0US$'
>>> format_currency(1099.98, 'EUR', locale='de_DE')
u'1.099,98\xa0\u20ac'
The pattern can also be specified explicitly. The currency is
placed with the '¤' sign. As the sign gets repeated the format
expands (¤ being the symbol, ¤¤ is the currency abbreviation and
¤¤¤ is the full name of the currency):
>>> format_currency(1099.98, 'EUR', u'¤¤ #,##0.00', locale='en_US')
u'EUR 1,099.98'
>>> format_currency(1099.98, 'EUR', u'#,##0.00 ¤¤¤', locale='en_US')
u'1,099.98 euros'
:param number: the number to format
:param currency: the currency code
:param locale: the `Locale` object or locale identifier
R ( R R
t currency_formatsR R> R? ( R; R R@ R RA ( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt format_currency s
c C sH t i | ƒ } | p | i i | ƒ } n t | ƒ } | i | | ƒ S( s Return formatted percent value for a specific locale.
>>> format_percent(0.34, locale='en_US')
u'34%'
>>> format_percent(25.1234, locale='en_US')
u'2,512%'
>>> format_percent(25.1234, locale='sv_SE')
u'2\xa0512\xa0%'
The format pattern can also be specified explicitly:
>>> format_percent(25.1234, u'#,##0\u2030', locale='en_US')
u'25,123\u2030'
:param number: the percent number to format
:param format:
:param locale: the `Locale` object or locale identifier
( R R
t percent_formatsR R> R? ( R; R@ R RA ( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt format_percent! s
c C sH t i | ƒ } | p | i i | ƒ } n t | ƒ } | i | | ƒ S( s† Return value formatted in scientific notation for a specific locale.
>>> format_scientific(10000, locale='en_US')
u'1E4'
The format pattern can also be specified explicitly:
>>> format_scientific(1234567, u'##0E00', locale='en_US')
u'1.23E06'
:param number: the number to format
:param format:
:param locale: the `Locale` object or locale identifier
( R R
t scientific_formatsR R> R? ( R; R@ R RA ( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt format_scientific; s
t NumberFormatErrorc B s e Z d Z RS( s> Exception raised when a string cannot be parsed into a number.( t __name__t
__module__t __doc__( ( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyRH Q s c C sJ y t | i t | ƒ d ƒ ƒ SWn# t j
o t d | ƒ ‚ n Xd S( sS Parse localized number string into an integer.
>>> parse_number('1,099', locale='en_US')
1099
>>> parse_number('1.099', locale='de_DE')
1099
When the given string cannot be parsed, an exception is raised:
>>> parse_number('1.099,98', locale='de')
Traceback (most recent call last):
...
NumberFormatError: '1.099,98' is not a valid number
:param string: the string to parse
:param locale: the `Locale` object or locale identifier
:return: the parsed number
:raise `NumberFormatError`: if the string can not be converted to a number
t s %r is not a valid numberN( t intt replaceR9 t
ValueErrorRH ( t stringR ( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt parse_numberU s c C sk t i | ƒ } y2 t | i t | ƒ d ƒ i t | ƒ d ƒ ƒ SWn# t j
o t d | ƒ ‚ n Xd S( s„ Parse localized decimal string into a decimal.
>>> parse_decimal('1,099.98', locale='en_US')
Decimal('1099.98')
>>> parse_decimal('1.099,98', locale='de')
Decimal('1099.98')
When the given string cannot be parsed, an exception is raised:
>>> parse_decimal('2,109,998', locale='de')
Traceback (most recent call last):
...
NumberFormatError: '2,109,998' is not a valid decimal number
:param string: the string to parse
:param locale: the `Locale` object or locale identifier
:raise NumberFormatError: if the string can not be converted to a
decimal number
RL t .s %r is not a valid decimal numberN( R R
R RN R9 R1 R RH ( RP R ( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt
parse_decimalo s s
[^0-9@#.,]s [0-9@#.,E+]s (?P
(?:'[^']*'|%s)*)s (?P%s+)s (?P.*)s %s%s%sc
C s— t | t ƒ o | i ƒ \ } } } g } g } t t t | ƒ ƒ } x@ t | ƒ D]1 } | o | i | i ƒ ƒ qT | i d ƒ qT Wx! t | ƒ D] } | i d ƒ q– Wx | o | i | i ƒ ƒ q° Wt | ƒ d j o
d } n | o | i d ƒ n d i
t | ƒ ƒ d i
t | ƒ ƒ f Sd | i d ƒ } d | j o3 | i
d d ƒ \ } } | d j o
d } qn | d } } | | f S( s= Convert a number into a (intasstring, fractionasstring) tuplet 0i t -RL s %.9fRR i ( RT ( R# R t as_tuplet listt mapt strt rangeR& t popt lent joint reversedt rstript split(
t valuet signt digitst expt int_partt frac_partt it textt at b( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt split_number• s8
)
i c
C s t | d j ƒ o d p d } t | ƒ } t | ƒ \ } } | | } d } t | ƒ | } | d j p | t | ƒ j o n¡ | | d j o
d } n† | | d j o | | d d j o
d } nV | | d j oD xA t | d t | ƒ ƒ D]" } | | d j o d } Pqø qø Wn d | } t | t ƒ o! t t | | | ƒ ƒ | | St t | | | ƒ ƒ | | Sd S( sC Round a number to a given precision.
Works like round() except that the round-half-even (banker's rounding)
algorithm is used instead of round-half-up.
>>> bankersround(5.5, 0)
6.0
>>> bankersround(6.5, 0)
6.0
>>> bankersround(-6.5, 0)
-6.0
>>> bankersround(1234.0, -2)
1200.0
i iÿÿÿÿi t 5t 13579RT i
N( RM t absRk R\ R R# R t float(
Ra t ndigitsRb Ri Rj Rc t addRg t jt scale( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt bankersroundÅ s,
&
!c C s‡ t | ƒ } | i d ƒ } | d j o d S| | d } | | d i d ƒ } | d j o | | f S| | | d } | | f S( s¹ Parse primary and secondary digit grouping
>>> parse_grouping('##')
(1000, 1000)
>>> parse_grouping('#,###')
(3, 3)
>>> parse_grouping('#,####,###')
(3, 4)
t ,iÿÿÿÿiè i i ( iè iè ( R\ t rfind( t pt widtht g1t g2( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt parse_groupingî s
c C sÞ t | t ƒ o | Sd „ } d | j oF | i d d ƒ \ } } | | ƒ \ } } } | | ƒ \ } } } n& | | ƒ \ } } } d | } | } d | j o | i d d ƒ \ } } n d
} d | j o. d | j o d | j o t d ƒ ‚ q n d | j o | i d d ƒ \ }
} n
| }
d
} d „ } | |
ƒ }
| | ƒ } | o> | |
| ƒ } | i d ƒ } | i d ƒ } | | ƒ } n
d
} d
} t |
ƒ } t | | | f | | f | |
| | | ƒ S( s Parse number format patternsc S s: t i | ƒ } | d j o t d | ƒ ‚ n | i ƒ S( Ns Invalid number pattern %r( t number_ret searchR RO t groups( RA t rv( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt
_match_number s
t ;i RU t Et @RR RT s5 Significant digit patterns can not contain "@" or "0"RL c S sz d } } xc | D][ } | d j o | d 7} | d 7} q | d j o | d 7} q | d j o q q Pq W| | f S( s( Calculate the min and max allowed digitsi s @0i t #Ru ( ( Rw t mint maxt c( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt parse_precision& s
t +N( R# t
NumberPatternR` R RO t rsplitt
startswitht lstripR{ ( RA R€ t neg_patternt
pos_prefixR; t
pos_suffixt
neg_prefixt _t
neg_suffixRd t integert fractionRˆ t int_prect frac_prect exp_plust exp_prect grouping( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyR> sF
RŠ c B sA e Z d „ Z d „ Z d d „ Z d „ Z d „ Z d „ Z RS( c C s¯ | | _ | | _ | | _ | | _ | | _ | | _ | | _ | | _ d d i | i | i ƒ j o
d | _ n7 d d i | i | i ƒ j o
d | _ n
d | _ d S( Nt %RL id u ‰iè i (
RA t prefixt suffixRš R– R— R™ R˜ R] Rs ( t selfRA Rœ R Rš R– R— R™ R˜ ( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt __init__H s
c C s d t | ƒ i | i f S( Ns <%s %r>( t typeRI RA ( Rž ( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt __repr__Y s c C s¥ t | t ƒ o t t | ƒ ƒ } n | | i 9} t | d j ƒ } | i o t | ƒ } | o% t t i t i
| d ƒ ƒ ƒ } n d } | i d | i d j o | | i d d 8} n5 | i d o& t | | i d ƒ | i d } n t | t ƒ p t | ƒ } n | d j o | d | } n | d | } d } | d j o t | ƒ } n | i
o t | ƒ } n t | ƒ } d | i | | i d | i d ƒ t | ƒ | | i t | ƒ | i d | i d | ƒ f } n0d | i j o¨ | i t | ƒ | i d | i d ƒ } d | j oV | i d ƒ \ } }
| i | d d | ƒ } |
o t | ƒ |
}
n | |
} q | i | d d | ƒ } nx t t t | ƒ | i d ƒ ƒ \ } }
|
p d }
| i | | i d | i d | ƒ } | i |
| ƒ }
| |
} d
| i | | | i | f } d | j oU | i d t | | | ƒ ƒ } | i d
| i ƒ ƒ } | i d t | | ƒ ƒ } n | S( Ni i
i RL u %s%s%s%sRƒ RR iè RT u %s%s%su ¤u ¤¤¤u ¤¤( R# Ro R RY Rs RM R™ Rn t matht floort logR– R5 R˜ R3 t _format_sigdigR— R7 t _format_intRA R` R1 Rk Rt t _format_fracRœ R RN R R% R ( Rž Ra R R t is_negativeRd t exp_signR; Rh Ri Rj t retval( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyR? \ sp
%&
c C s t | ƒ \ } } t | ƒ } | d j oC | d j o6 d } x- | i d ƒ o | d } | d 8} qA Wn t t | | | ƒ ƒ \ } } t | | i d ƒ ƒ } | p
d } n t | ƒ | j o | d j o | S| | j o | d | | 7} n | o d | | f S| S( s‡ Convert value to a string.
The resulting string will contain between (min, max) number of
significant digits.
RT RL i i s %s.%s( Rk R\ RŒ Rt R ( Rž Ra R… R† Ri Rj t ndecimalsRc ( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyR¥ œ s&
c C sœ t | ƒ } | | j o d | | | } n | i d } d } t | ƒ } xC t | ƒ | j o/ | | | | } | | } | i d } qQ W| | S( NRT i RL i ( R\ Rš R9 ( Rž Ra R… R† R Rx t gsizet rett symbol( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyR¦ ¶ s
c C sÀ | i \ } } t | ƒ | j o | d | t | ƒ 7} n | d j p | d j o t | ƒ d j o d St | ƒ } x3 t | ƒ | j o | d d j o | d } q Wt | ƒ | S( NRT i RL iÿÿÿÿ( R— R\ RM R1 ( Rž Ra R R… R† Rx ( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyR§ Ã s - $N( RI RJ RŸ R¡ R R? R¥ R¦ R§ ( ( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyRŠ F s @
(2 RK R/ R R R¢ t reR R R! R$ t
babel.coreR R R t
babel._compatR R R R R t Truet FalseR. R1 R3 R5 R7 R9 R< R: RC RE RG RO RH RQ RS t
PREFIX_ENDt NUMBER_TOKENt PREFIX_PATTERNt NUMBER_PATTERNt SUFFIX_PATTERNt compileR| Rk Rt R{ R> t objectRŠ ( ( ( s, /tmp/pip-build-lt8jXN/Babel/babel/numbers.pyt sJ W
0 ) B