daviddrysdale/python-phonenumbers
Python Phonenumbers
This project is a Python port of the libphonenumber library, providing a suite of tools for parsing, formatting, and validating international phone numbers. It converts raw phone number strings into structured objects based on international numbering plans and verifies if numbers are possible or valid according to digit length and assigned exchange prefixes.
The library provides metadata services to retrieve the original network carrier, geographical location descriptions, and associated time zones for specific phone numbers. It also includes tools for transforming numbers into standardized international or national formats, including real-time incremental input formatting.
Additional capabilities include scanning unstructured text to extract phone numbers and their character positions, as well as validating the syntax of phone-context parameters within tel URIs.
Features
- International Phone Number Libraries - Provides a Python implementation of the Google libphonenumber library for comprehensive global phone number processing.
- Format Validation Rules - Verifies that parsed phone numbers match length and prefix constraints defined in regional metadata.
- Phone Number Parsing - Transforms raw phone number strings into structured data objects by analyzing digits and international prefixes.
- Phone Number Parsing & Formatting - Provides a core engine for parsing raw phone strings and formatting them according to international standards.
- Phone Number Validation - Checks if phone numbers are possible or valid based on regional numbering plans and assigned exchanges.
- Regional Phone Formatting - Applies localized digit-grouping and prefix rules to generate national and international phone number representations.
- Phone Number Objects - Converts raw phone strings into structured objects that separate country codes from national number components.
- Phone Number Geography Lookups - Determines the geographical description, country name, or associated time zones for a specific phone number.
- Phone Number Extraction - Scans unstructured text blocks to identify and isolate potential phone numbers using regular expressions.
- Phone Metadata Extraction - Retrieves technical attributes including network carrier, geographical location, and time zones for parsed numbers.
- Incremental Input Formatting - Implements logic that updates phone number formatting in real-time as digits are entered to maintain correct country codes.
- Telephony Time Zone Determination - Provides a service to determine potential time zone names based on a phone number's regional metadata.
- Telecom Carrier Lookups - Implements prefix-based lookups to map phone numbers to their respective telecommunications carriers.
- Text Processing - Parses, formats, and validates international phone numbers.
- Document Parsers - Parse, format, and validate international phone numbers.
- Text Processing - Parses, formats, and validates international phone numbers.
