README

Validate and identify Tanzanian mobile phone numbers across all networks. Zero dependencies.

Supported Networks

Features

• Validate — check if a number is a real Tanzanian mobile number
• Identify carrier — detect which network a number belongs to
• Normalize — clean any format to 255XXXXXXXXX
• All formats accepted — 0754..., +255754..., 255754..., 754..., with spaces/dashes

Installation

PHP (Composer)

composer require mrone-inc/tz-phone-validator

use TzPhoneValidator\TzPhone;

TzPhone::isValid('0754123456');      // true
TzPhone::getCarrier('0754123456');   // "Vodacom"
TzPhone::normalize('0754123456');    // "255754123456"
TzPhone::isVodacom('0754123456');    // true

// Check all carriers
TzPhone::isTigo('0654123456');       // true
TzPhone::isAirtel('0684123456');     // true
TzPhone::isHalotel('0624123456');    // true
TzPhone::isTTCL('0734123456');      // true
TzPhone::isZantel('0774123456');     // true

Python (pip)

pip install tz-phone-validator

from tz_phone_validator import is_valid, get_carrier, normalize, TzPhone

# Functional API
is_valid("0754123456")      # True
get_carrier("0754123456")   # "Vodacom"
normalize("0754123456")     # "255754123456"

# OOP API
phone = TzPhone("0754123456")
phone.is_valid      # True
phone.carrier        # "Vodacom"
phone.normalized     # "255754123456"
phone.is_vodacom     # True

Node.js (npm)

npm install tz-phone-validator

const { isValid, getCarrier, normalize } = require('tz-phone-validator');

isValid('0754123456');      // true
getCarrier('0754123456');   // 'Vodacom'
normalize('0754123456');    // '255754123456'
isVodacom('0754123456');    // true

Java

Copy java/src/TzPhone.java into your project. Requires Java 17+.

TzPhone.isValid("0754123456");      // true
TzPhone.getCarrier("0754123456");   // Optional.of("Vodacom")
TzPhone.normalize("0754123456");    // Optional.of("255754123456")
TzPhone.isVodacom("0754123456");    // true

Input Formats

All functions accept any of these formats:

Running Tests

# PHP
cd php && composer install && vendor/bin/phpunit

# Python
cd python && pip install -e ".[dev]" && pytest

# Node
cd node && npm test

# Java
cd java && javac src/TzPhone.java tests/TzPhoneTest.java -d out && java -cp out TzPhoneTest

License

MIT