number-parser

0.3.2 · active · verified Tue Apr 14

number-parser is a Python library designed to convert numbers written in natural language into their equivalent numeric forms. It supports cardinal numbers in English, Hindi, Spanish, Ukrainian, and Russian, and also handles ordinal numbers and simple fractions in English. The current version is 0.3.2, and it maintains an active, though somewhat irregular, release cadence with several updates in early 2023.

Warnings

breaking Prior to version 0.3.2, users might have encountered an import bug (#91), which could lead to incorrect or failed imports of the parsing functions. This was fixed in version 0.3.2.
Fix: Upgrade to number-parser >= 0.3.2. Ensure imports are directly from `number_parser` (e.g., `from number_parser import parse`) and not from internal modules like `number_parser.parser`.
gotcha Inconsistent whitespace handling around sentence separators following numbers was an issue in versions prior to 0.3.1, potentially affecting parsing accuracy in specific contexts.
Fix: Upgrade to number-parser >= 0.3.1 to benefit from the fix for inconsistent whitespace handling.
gotcha The library's language support is granular: cardinal numbers are supported in multiple languages, but ordinal numbers and simple fractions are currently supported only for English. Attempting to parse non-English ordinals or fractions might yield unexpected results or errors.
Fix: Consult the documentation for specific language support for each parsing function (e.g., `parse_ordinal` and `parse_fraction` are English-only). Ensure your input language matches the supported features.
gotcha Parsing natural language numbers can be inherently ambiguous, especially across different locales and contexts (e.g., 'one hundred thousand' vs. 'one, hundred thousand'). While the library aims for robust parsing, complex or unusual phrasing might not always be interpreted as expected.
Fix: Test the library with a representative sample of your natural language number inputs. Be mindful of potential ambiguities and, if necessary, preprocess inputs or provide clearer phrasing.

Install

pip install number-parser Install with pip

Imports

parse
```
from number_parser import parse
```
An import bug was fixed in v0.3.2; direct import from `number_parser` is the correct and stable path.
parse_number
```
from number_parser import parse_number
```
parse_ordinal
```
from number_parser import parse_ordinal
```
Supports English only.

parse_fraction

from number_parser import parse_fraction

Supports English only.

Quickstart

Demonstrates how to use `parse` for in-place number conversion within a string and `parse_number` for converting a standalone number written in words.

from number_parser import parse

# Convert numbers in a sentence
text = "I have two hats and thirty seven coats."
parsed_text = parse(text)
print(f"Original: {text}\nParsed: {parsed_text}")

# Convert a single number in words
number_in_words = "two thousand and twenty"
parsed_number = parse_number(number_in_words)
print(f"Number '{number_in_words}' parsed to: {parsed_number}")

view raw JSON →