Price Parser is a Python library created by reworkd team that provides Pydantic-compatible data types for parsing and extracting price-related information from strings. It allows you to effortlessly handle numeric values, currency symbols, and currency names in a structured and validated way using Pydantic models.
Install the library via pip:
pip install price-parser-reworkd- Extract numeric price values from strings.
- Detect currency symbols and convert them into readable currency names.
- Built on Pydantic for easy integration with modern Python projects.
- Lightweight and production-ready.
Extract both the numeric price value and the currency details (symbol and name).
from pydantic import BaseModel
from price_parser import ParserTypeCurrency
class PriceModel(BaseModel):
price: ParserTypeCurrency
# Example 1: Valid input with currency symbol
price_info = PriceModel(price="$19.99")
print(price_info.price)
# Output: {'currency': 'USD', 'currency_symbol': '$', 'amount': 19.99}
# Example 2: Valid input without a currency
price_info = PriceModel(price=1500.75)
print(price_info.price)
# Output: {'currency': None, 'currency_symbol': None, 'amount': 1500.75}
# Example 3: String with known currency name
price_info = PriceModel(price="EUR 49.99")
print(price_info.price)
# Output: {'currency': 'EUR', 'currency_symbol': '€', 'amount': 49.99}Parse a single price from a string:
from pydantic import BaseModel
from price_parser import ParserTypePrice
class PriceModel(BaseModel):
price: ParserTypePrice()
# Example 1: Parse numeric price from a string
price_info = PriceModel(price="$19.99")
print(price_info.price) # Output: 19.99
# Example 2: Parse numeric price from an integer
price_info = PriceModel(price='€1.500')
print(price_info.price) # Output: 1500.0
# Example 3: Parse numeric price from a float
price_info = PriceModel(price=99.99)
print(price_info.price) # Output: 99.99
# Example 4: Handle invalid or empty input
try:
price_info = PriceModel(price="invalid input")
except ValueError as e:
print(e) # Output: ValueError with explanationExtract both the price value and currency details:
from pydantic import BaseModel
from price_parser import ParserTypePrice, ParserTypeCurrency
class CombinedModel(BaseModel):
numeric_price: ParserTypePrice()
full_price_details: ParserTypeCurrency
# Input data
data = {
"numeric_price": "$19.99",
"full_price_details": "USD 19.99",
}
# Parse the data
price_info = CombinedModel(**data)
print(price_info.numeric_price) # Output: 19.99
print(price_info.full_price_details) # Output: {'currency': 'USD', 'currency_symbol': '$', 'amount': 19.99}Ideal for processing pricing data from product listings.
from pydantic import BaseModel
from price_parser import ParserTypeCurrency
class ProductModel(BaseModel):
price: ParserTypeCurrency
def parse_and_display_products(products):
"""
Parses a list of product prices using a Pydantic model and displays the extracted information.
Args:
products (list): A list of price strings to be parsed.
"""
for product in products:
try:
product_data = ProductModel(price=product)
info = product_data.price
print(
f"Price: {info['amount']}, Currency: {info['currency']}, Symbol: {info['currency_symbol']}"
)
except ValueError as e:
print(f"Error parsing product price '{product}': {e}")
products = ["$19.99", "€15.50", "₹1200"]
parse_and_display_products(products)Run unit tests to verify functionality:
pytestContributions are welcome! Feel free to open issues or submit pull requests to improve the package.
This project is licensed under the MIT License - see the LICENSE file for details.
You can use the library directly in your Python projects. For development, clone the repository and use Poetry to manage dependencies:
git clone https://github.com/mohamedmamdouh22/price-parser.git
cd price-parser
poetry installHappy Parsing! 💰
