price-parser
price-parser is a small library for extracting price and currency from raw text strings.
Features:
- robust price amount and currency symbol extraction
- zero-effort handling of thousand and decimal separators
The main use case is parsing prices extracted from web pages. For example, you can write a CSS/XPath selector which targets an element with a price, and then use this library for cleaning it up, instead of writing custom site-specific regex or Python code.
License is BSD 3-clause.
Installation
pip install price-parser
price-parser requires Python 3.6+.
Usage
Basic usage
>>> from price_parser import Price
>>> price = Price.fromstring("22,90 €")
>>> price
Price(amount=Decimal('22.90'), currency='€')
>>> price.amount # numeric price amount
Decimal('22.90')
>>> price.currency # currency symbol, as appears in the string
'€'
>>> price.amount_text # price amount, as appears in the string
'22,90'
>>> price.amount_float # price amount as float, not Decimal
22.9
If you prefer, Price.fromstring has an alias price_parser.parse_price, they do the same:
>>> from price_parser import parse_price
>>> parse_price("22,90 €")
Price(amount=Decimal('22.90'), currency='€')
The library has extensive tests (900+ real-world examples of price strings). Some of the supported cases are described below.
Supported cases
Unclean price strings with various currencies are supported; thousand separators and decimal separators are handled:
>>> Price.fromstring("Price: $119.00")
Price(amount=Decimal('119.00'), currency='$')
>>> Price.fromstring("15 130 Р")
Price(amount=Decimal('15130'), currency='Р')
>>> Price.fromstring("151,200 تومان")
Price(amount=Decimal('151200'), currency='تومان')
>>> Price.fromstring("Rp 1.550.000")
Price(amount=Decimal('1550000'), currency='Rp')
>>> Price.fromstring("Běžná cena 75 990,00 Kč")
Price(amount=Decimal('75990.00'), currency='Kč')
Euro sign is used as a decimal separator in a wild:
>>> Price.fromstring("1,235€ 99")
Price(amount=Decimal('1235.99'), currency='€')
>>> Price.fromstring("99 € 95 €")
Price(amount=Decimal('99'), currency='€')
>>> Price.fromstring("35€ 999")
Price(amount=Decimal('35'), currency='€')
Some special cases are handled:
>>> Price.fromstring("Free")
Price(amount=Decimal('0'), currency=None)
When price or currency can't be extracted, corresponding attribute values are set to None:
>>> Price.fromstring("")
Price(amount=None, currency=None)
>>> Price.fromstring("Foo")
Price(amount=None, currency=None)
>>> Price.fromstring("50% OFF")
Price(amount=None, currency=None)
>>> Price.fromstring("50")
Price(amount=Decimal('50'), currency=None)
>>> Price.fromstring("R$")
Price(amount=None, currency='R$')
Currency hints
currency_hint argument allows to pass a text string which may (or may not) contain currency information. This feature is most useful for automated price extraction.
>>> Price.fromstring("34.99", currency_hint="руб. (шт)")
Price(amount=Decimal('34.99'), currency='руб.')
Note that currency mentioned in the main price string may be preferred over currency specified in currency_hint argument; it depends on currency symbols found there. If you know the correct currency, you can set it directly:
>>> price = Price.fromstring("1 000")
>>> price.currency = 'EUR'
>>> price
Price(amount=Decimal('1000'), currency='EUR')
Decimal separator
If you know which symbol is used as a decimal separator in the input string, pass that symbol in the decimal_separator argument to prevent price-parser from guessing the wrong decimal separator symbol.
>>> Price.fromstring("Price: $140.600", decimal_separator=".")
Price(amount=Decimal('140.600'), currency='$')
>>> Price.fromstring("Price: $140.600", decimal_separator=",")
Price(amount=Decimal('140600'), currency='$')
Contributing
- Source code: https://github.com/scrapinghub/price-parser
- Issue tracker: https://github.com/scrapinghub/price-parser/issues
Use tox to run tests with different Python versions:
tox
The command above also runs type checks; we use mypy.
3 Nov 21, 2022
1 Jan 12, 2022
2 Feb 12, 2022
117 Dec 29, 2022
5 Jul 26, 2022
16 Sep 13, 2022
1 Jan 06, 2022
12 Nov 06, 2022
8 Dec 20, 2022
2 Dec 14, 2022
1 Jan 06, 2022
2 Jul 04, 2022
1 Nov 26, 2021
16 Sep 15, 2022
59 Oct 10, 2022
68 Dec 29, 2022
4 Jan 22, 2022
5 Nov 06, 2021
3 Jun 14, 2022
18 Dec 19, 2022