money-parser

Price and currency parsing utility

These details have not been verified by PyPI

Project links

Homepage

Project description

Money Parser
============

Description
-----------

Money Parser is a price and currency parsing utility.
It provides methods to extract price and currency information from the raw string.
There is a lot of different price and currency formats that present values with separators, spacing etc.
This library may help you to parse such data.

Limitation
----------

- currency with 3 numbers after decimal point (e.g. KWD, see `ISO 4217`_)

Introduction
------------

Extracting price from raw ``str``::

>>> from money_parser import price_str
>>> price_str('₹1,50,087.99 \n')
'150087.99'
>>> price_dec('+12.007')
Decimal('12007')

Installation
------------

::

p i p i n s t a l l m o n e y - p a r s e r T h e l i b r a r y r e q u i r e s P y t h o n >= 3.4 D o c u m e n t a t i o n - - - - - - - - - - - - - - - - - - . . p y : f u n c t i o n :: p r i c e_{s} t r (r a w_{p} r i c e, [d e f a u l t =< n o t_{d} e f i n e d >], [d e c_{p} o i n t =^{'} .^{'}]) S e a r c h a n d c l e a n p r i c e v a l u e . C o n v e r t r a w p r i c e s t r i n g p r e s e n t e d i n a n y l o c a l i z a t i o n a s a v a l i d n u m b e r s t r i n g w i t h a n o p t i o n a l d e c i m a l p o i n t . I f r a w p r i c e d o e s n o t c o n t a i n v a l i d p r i c e v a l u e o r c o n t a i n s m o r e t h a n o n e p r i c e v a l u e, t h e n r e t u r n d e f a u l t v a l u e . I f d e f a u l t v a l u e n o t s e t, t h e n r a i s e V a l u e E r r o r . : p a r a m s t r r a w_{p} r i c e : s t r i n g t h a t c o n t a i n s p r i c e v a l u e . : p a r a m d e f a u l t : v a l u e t h a t w i l l b e r e t u r n e d i f r a w p r i c e n o t v a l i d . : p a r a m d e c_{p} o i n t : s y m b o l t h a t s e p a r a t e i n t e g e r a n d f r a c t i o n a l p a r t s . : r e t u r n : c l e a n e d p r i c e s t r i n g o r d e f a u l t v a l u e . : r a i s e V a l u e E r r o r : e r r o r i f r a w p r i c e n o t v a l i d a n d d e f a u l t v a l u e n o t s e t . ::>>> p r i c e_{s} t r (^{'} + {12.007}^{'})^{'} 12007^{'} >>> p r i c e_{s} t r (^{'} - 520, 05^{'})^{'} - {520.05}^{'} >>> p r i c e_{s} t r (^{'} 1, 000, {777.5}^{'})^{'} {1000777.5}^{'} >>> p r i c e_{s} t r (^{'} 1.777 .000, 99^{'})^{'} {1777000.99}^{'} >>> p r i c e_{s} t r (^{'} 99, 77, 11, {000.1}^{'})^{'} {997711000.1}^{'} >>> p r i c e_{s} t r (^{'} U S D 5, 242 \t \n^{'})^{'} 5242^{'} >>> p r i c e_{s} t r (^{'} 90 {210.42}^{'}, d e c_{p} o i n t =^{'} |^{'})^{'} 90210 | 42^{'} >>> p r i c e_{s} t r (N o n e, d e f a u l t =^{'} 0^{'})^{'} 0^{'} >>> p r i c e_{s} t r (42.333, d e f a u l t = N o n e) i s N o n e T r u e >>> p r i c e_{s} t r (N o n e) T r a c e b a c k (m o s t r e c e n t c a l l l a s t) : . . . V a l u e E r r o r : W r o n g r a w p r i c e t y p e " < c l a s s^{'} N o n e T y p e^{'} > " (e x p e c t e d t y p e " s t r ") >>> p r i c e_{s} t r (^{″}) T r a c e b a c k (m o s t r e c e n t c a l l l a s t) : . . . V a l u e E r r o r : R a w p r i c e v a l u e " " d o e s n o t c o n t a i n v a l i d p r i c e d i g i t s >>> p r i c e_{s} t r (^{'} 1. {.2}^{'}) T r a c e b a c k (m o s t r e c e n t c a l l l a s t) : . . . V a l u e E r r o r : R a w p r i c e v a l u e " 1. .2 " c o n t a i n s m o r e t h a n o n e p r i c e v a l u e . . p y : f u n c t i o n :: p r i c e_{d} e c (r a w_{p} r i c e, [d e f a u l t =< n o t_{d} e f i n e d >]) P r i c e d e c i m a l v a l u e f r o m r a w s t r i n g . E x t r a c t p r i c e v a l u e f r o m i n p u t r a w s t r i n g a n d p r e s e n t a s D e c i m a l n u m b e r . U s e s a p r i c e_{s} t r f u n c t i o n f o r p r i c e p a r s i n g . I f r a w p r i c e d o e s n o t c o n t a i n v a l i d p r i c e v a l u e o r c o n t a i n s m o r e t h a n o n e p r i c e v a l u e, t h e n r e t u r n d e f a u l t v a l u e . I f d e f a u l t v a l u e n o t s e t, t h e n r a i s e V a l u e E r r o r . : p a r a m s t r r a w_{p} r i c e : s t r i n g t h a t c o n t a i n s p r i c e v a l u e . : p a r a m d e f a u l t : v a l u e t h a t w i l l b e r e t u r n e d i f r a w p r i c e n o t v a l i d . : r e t u r n : D e c i m a l p r i c e v a l u e . : r a i s e V a l u e E r r o r : e r r o r i f r a w p r i c e n o t v a l i d a n d d e f a u l t v a l u e n o t s e t . ::>>> p r i c e_{d} e c (^{'} + {12.007}^{'}) D e c i m a l (^{'} 12007^{'}) >>> p r i c e_{d} e c (^{'} : - 10.99

')
Decimal('-10.99')
>>> price_dec('', default=Decimal('0'))
Decimal('0')
>>> price_dec('1..10', default=0)
0
>>> price_dec('410.5 - 555', default=None) is None
True
>>> price_dec(42.3)
Traceback (most recent call last):
...
ValueError: Wrong raw price type "<class 'float'>" (expected type "str")
>>> price_dec('free')
Traceback (most recent call last):
...
ValueError: Raw price value "free" does not contain valid price digits
>>> price_dec('2+2')
Traceback (most recent call last):
...
ValueError: Raw price value "2+2" contains more than one price value

Run Tests
------

Project has tests::

m a k e t e s t A l s o a v a i l a b l e t e s t s w i t h c o v e r a g e ::

make cov

Source code
-----------

The project is hosted on GitHub_

Authors and License
-------------------

The ``money-parser`` package is written by Serhii Kostel.

It's *Apache 2* licensed and freely available.

.. _`ISO 4217`: https://en.wikipedia.org/wiki/ISO_4217
.. _GitHub: https://github.com/kserhii/money-parser

CHANGES
=======

0.0.1 (2017-12-17)
------------------

* The first release.

Algorithm	Hash digest
SHA256	`91fb362ba851d0e789586b6a7aec39df0ee1dcb594e50e2bc60d76b90fc1f764`
MD5	`204ae2762d0a3f627482bf8adf39c262`
BLAKE2b-256	`6bfdf69add6f634dc586d92a2671280d7258f86c0e12f9b03d1f1a04be6c3d85`

Algorithm	Hash digest
SHA256	`93b4f312f214c54d6474052816c3ecaa8dd67a403e18d18c9001c8f4e4b8f67a`
MD5	`7e1976168fbfb476618487d834b4222f`
BLAKE2b-256	`d8c8abf8b7bf6d216c8ed23a8427b7f7db221027254d4ca3e906ac4c6b6d2195`

money-parser 0.0.1

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

Project details

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

File details

File metadata

File hashes