phone_numbers_parser 3.0.1

Dart library for parsing phone numbers. Inspired by Google's libphonenumber and PhoneNumberKit for ios.

Phone Numbers Parser

Dart library for parsing phone numbers. Inspired by Google's libphonenumber and PhoneNumberKit for ios.

The advantage of this lib instead of libphonenumber is that it instantly supports all platforms (no need for channeling).

Features

• Find phone numbers in a text
• Validate a phone number
• Find the country of a phone number (Geocoding available as separate package)
• A light parser for size aware applications
• Formatter
• Phone ranges
• Supports easthern arabic digits
• Uses best-in-class metadata from Google's libPhoneNumber project.

Parsers

There are two parsers: LightPhoneParser and Phone Parser

LightPhoneParser:

• smaller size footprint (more will be tree shaken)
• uses mainly length information for validation
• fast

PhoneParser:

• more accurate
• bigger size footprint
• more computationally intensive
• uses pattern matching

Usage PhoneParser

  final parser = PhoneParser(); // alternatively LightPhoneParser
  // creation
  final frPhone = parser.parseNational('fr', '655 5705 76');
  final frPhone1 = parser.parseRaw('[phone]');
  final frPhone2 = parser.parseWithIsoCode('fr', '655 5705 76');
  final frPhone3 = parser.parseWithCountryCode('33', '655 5705 76');
  final frPhone4 = parser.parseWithIsoCode('fr', '0655 5705 76');
  final allSame = frPhone == frPhone1 &&
      frPhone == frPhone2 &&
      frPhone == frPhone3 &&
      frPhone == frPhone4;
  print(allSame); // true

  // validation
  print(parser.validate(frPhone1)); // true
  print(parser.validate(frPhone1, PhoneNumberType.mobile)); // true
  print(parser.validate(frPhone1, PhoneNumberType.fixedLine)); // false

  // changing the country
  final esPhone = parser.copyWithIsoCode(frPhone, 'ES');
  print(esPhone.countryCode); // 34
  print(esPhone.isoCode); // ES
  print(esPhone.international); // '[phone]'

  // utils
  final text = 'hey my phone number is: [phone]';
  final found = parser.findPotentialPhoneNumbers(text);
  print(text.substring(found.first.start, found.first.end)); 

Formatter

  final parser = PhoneParser();
  final formatter = PhoneNumberFormatter();
  final phoneNumber = parser.parseWithIsoCode('US', '2025550119');
  final formatted = formatter.formatNsn(phoneNumber);
  print(formatted); // 202-555-0119

Range

 final first = parser.parseRaw('[phone]');
  final last = parser.parseRaw('[phone]');
  final range = PhoneNumberRange(first, last);

  print('Count: ${range.count}');
  print('Expand: ${range.expandRange().join(',')}');

  if (first > last) {
    print("this shouldn't be.");
  }

  final one = parser.parseRaw('[phone]');
  final two = parser.parseRaw('[phone]');

  if (one.isAdjacentTo(two)) {
    print('We are together');
  }
  if (one.isSequentialTo(two)) {
    print('$two comes after $one');
  }

  /// treat the phone no. like an int
  var three = two + 1;
  print('Its still a phone No. $three');
  two - 1 == one;
  var another = one + 2;
  print('$another == $three');

Demo

The phone number input packages has a demo that uses this parser: https://cedvdb.github.io/phone_form_field/