FindSoftware

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

Current major version
95
Last release
2026-11-064

Adoption

GitHub stars
3,7811
Contributors
316
Dependent repositories
6,5927
Dependent packages
2227

Why these figures do not compare

Sources

  1. 2026-11-16: links, Written in, GitHub stars
    api.github.com/repos/daviddrysdale/python-phonenumbers
  2. 2026-11-16: links, Runtime, Install with
    github.com/daviddrysdale/python-phonenumbers/blob/dev/README.md
  3. 2026-11-16: Maintainer, Minimum runtime, License
    github.com/daviddrysdale/python-phonenumbers/blob/v9.0.43/python/pyproject.toml
  4. 2026-11-16: First release, Categories, Last release
    pypi.org/pypi/phonenumbers/json
  5. 2026-11-16: Current major version
    api.github.com/repos/daviddrysdale/python-phonenumbers/tags?per_page=100
  6. 2026-11-16: Contributors
    api.github.com/repos/daviddrysdale/python-phonenumbers/contributors?per_page=1
  7. 2026-11-16: Dependent packages, Dependent repositories
    packages.ecosyste.ms/api/v1/registries/pypi.org/packages/phonenumbers

Last reviewed · Listed since Edit on GitHubThis page as markdownas JSON