phonenumbers
Python library for parsing, formatting, storing and validating international phone numbers, a port of Google's libphonenumber.
phonenumbers is a Python library that parses phone numbers, formats them in national, international and E.164 layouts, and checks whether a number is possible or valid. It also formats a number as a user types it, and finds phone numbers inside a longer block of text. The package is a Python port of Google’s libphonenumber, and the metadata that drives parsing ships with it.
The normal metadata loads one region at a time, on first use. Geocoding, carrier and timezone lookups need metadata held in separate packages that the caller imports explicitly. The repository also ships phonenumberslite, a package without those three lookups, for installs that run short of space or memory. The documentation describes the API.
Worth knowing
A number written without a plus sign needs a default region, and parse raises an exception when it has neither. Static type checking works through the type stub files the package includes.
Identity
- Status
- Active
- Maintainer
- David Drysdale3
- Maintained by
- Individual
- First release
- 20114
Rendering and deploy
- Install with
- pip2
Releases
Adoption
Sources
- 2026-11-16: links, Written in, GitHub stars
api.github.com/repos/daviddrysdale/python-phonenumbers - 2026-11-16: links, Runtime, Install with
github.com/daviddrysdale/python-phonenumbers/blob/dev/README.md - 2026-11-16: Maintainer, Minimum runtime, License
github.com/daviddrysdale/python-phonenumbers/blob/v9.0.43/python/pyproject.toml - 2026-11-16: First release, Categories, Last release
pypi.org/pypi/phonenumbers/json - 2026-11-16: Current major version
api.github.com/repos/daviddrysdale/python-phonenumbers/tags?per_page=100 - 2026-11-16: Contributors
api.github.com/repos/daviddrysdale/python-phonenumbers/contributors?per_page=1 - 2026-11-16: Dependent packages, Dependent repositories
packages.ecosyste.ms/api/v1/registries/pypi.org/packages/phonenumbers