Phone Gen

International phone number generation

This module was created exclusively for generating test data

Installation

Install using pip with

pip install phone-gen

Example

from phone_gen import PhoneNumber

phone_number = PhoneNumber("GB")  # ISO 3166-2
# or
phone_number = PhoneNumber("GBR")  # ISO 3166-3
# or
phone_number = PhoneNumber("Great Britain")  # Country name

# Get a phone number
number = phone_number.get_number()
print(number)  # +442908124840

# Get a country code
country_code = phone_number.get_code()
print(country_code)  # 44

# Get a phone number without a country code
number = phone_number.get_number(full=False)
print(number)  # 183782623

# Get a mobile phone number
number = phone_number.get_mobile()
print(number)  # +447911899521

# Get a national phone number
number = phone_number.get_national()
print(number)  # +442408055065

pytest fixture

import pytest
from phone_gen import PhoneNumber


@pytest.fixture
def phone_number():
    def wrap(code):
        return PhoneNumber(code).get_number()

    yield wrap


def test_one(phone_number):
    number = phone_number("DE")
    ...

Using the CLI

usage: phone-gen [-h] [-v] [-n] country [country ...]

International phone number generation

positional arguments:
  country         Country code or country name. Example: "GB" or "GBR" or "Great Britain"

optional arguments:
  -h, --help      show this help message and exit
  -v, --version   show program's version number and exit
  -f, --not-full  Get a phone number without a country code
  -m, --mobile    Get mobile phone number
  -n, --national  Get national phone number

Example

# Get a phone number

$ phone-gen DE
+49791774007056

$ phone-gen DEU
+499968635

$ phone-gen Germany
+49960335800


# Get a phone number without a country code
$ phone-gen -f DE
66999511

$ phone-gen -f Germany
877595

# Get mobile phone number
$ phone-gen -m DE
+491601376066

# Get national phone number
$ phone-gen -n DE
+4940381

Resources

Google's libphonenumber

Changelog

Releases

Contributing

Contributions are very welcome.

You might want to:

Fix spelling errors
Improve documentation
Add tests for untested code
Add new features
Fix bugs

Getting started

python 3.12
pipenv 2023.11.15+

Clone the repository

git clone https://github.com/tolstislon/phone-gen.git
cd phone-gen

Install dev dependencies
```
pipenv install --dev
pipenv shell
```
Run ruff format
```
pipenv run format
```
Run ruff check
```
pipenv run check
```
Run the tests
```
pipenv run tests
```

Metadata

Release files for phone-gen 3.0.35

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for phone-gen 3.0.35
File	Size	Uploaded
phone_gen-3.0.35.tar.gz	41.9 kB	Sep 11, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for phone-gen 3.0.35
File	Interpreter	ABI	Platform	Reset
phone_gen-3.0.35-py3-none-any.whl 33.0 kB Sep 11, 2026	Python 3	none	any	Details

Total release size: 74.9 kB

Release files / phone_gen-3.0.35.tar.gz

Download URL	phone_gen-3.0.35.tar.gz
Size	41.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`71cfb8f1f082a2aed119862db42a35c4f296b0688d5346943aaa6861423d9f9b`
BLAKE2b-256 checksum How to use checksums	`b11f8606208c601732facc99cb70a5915a7c444ba66f86ec165e8d8e4c094989`
Upload date	Sep 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.9.25`

Release files / phone_gen-3.0.35-py3-none-any.whl

Download URL	phone_gen-3.0.35-py3-none-any.whl
Size	33.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`0715ccad87d689935b038eccf8a713aa96399724d7298c59e87d81d1f43f09cb`
BLAKE2b-256 checksum How to use checksums	`a71915b1292119e9f79707554d371b2daee23fd0a01afbb8fd96762103e96d13`
Upload date	Sep 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.9.25`