# daviddrysdale/python-phonenumbers

Python port of Google's libphonenumber

Repository: https://github.com/daviddrysdale/python-phonenumbers
Canonical: https://ross.abutalabs.com/products/python-phonenumbers
Language: Python
License: Apache-2.0
License Family: permissive
Last push: 2026-08-14T05:27:20+00:00

## Health v2 (maintenance only)
Score: 76/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 97, release rhythm 35, longevity 100
- inputs: {"age_days": 5613, "days_push": 19, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3769, forks 441 (observed 2026-08-28T04:08:18.108649+00:00)

## What it is
A Python port of Google's libphonenumber library for parsing, formatting, and validating international phone numbers. It converts phone number strings into structured PhoneNumber objects and checks their validity and possibility per country rules.

## Use cases
- parse phone numbers from user input
- validate phone numbers for a country
- format phone numbers in E.164
- normalize phone numbers in a database
- check if a phone number is valid or possible
- extract country code from a phone number

## When to choose
- you need robust international phone number parsing and validation in Python
- you want feature parity with Google's libphonenumber metadata
- you need to format numbers for storage or display in a consistent standard

## When to avoid
- you only need simple US-only digit checks
- you need live carrier or line-type lookups, which require external services
- you work in a non-Python language and can use libphonenumber directly

## Facets
- artifact type: library
- maturity: active
- function: parser, nlp, developer-tools
- domain: developer-tools, apis
- platform: python, cross-platform
- tags: phone-numbers, libphonenumber, validation, formatting, e164, natural-language-processing

## Member repositories
- daviddrysdale/python-phonenumbers (main) score 76

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:18.108649+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:27:53.955248+00:00, confidence not recorded.
  - readme: https://github.com/daviddrysdale/python-phonenumbers (fetched 2026-08-28T04:08:18.108649+00:00, sha 4744dfc8e38d)
- Data as of 2026-08-30T08:39:29.467469+00:00.