libphonenumber-csharp / csharp /

Filename Size Date modified Message
2.7 KB
2.3 KB
PhoneNumbers C# Library

This is a C# port of libphonenumber, originally from:

Original Java code is Copyright (C) 2009-2011 Google Inc.

Project Layout

The project is a copy of the original libphonenumber with C# code
added in csharp/ root directory. The intent is to keep pulling from
the main repository and update the C# port accordingly.

  NUnit, Google.ProtoBuffersLite binaries and various conversion

  Port of libphonenumber Java library

  Port of libphonenumber Java tests in NUnit format.


Open csharp/PhoneNumbers.sln VS2008 solution file to get an overview
of the code. "Build All" should put the libraries at the usual places.

Running Tests

To run the tests, either use a GUI tool or download NUnit binaries from:

Extract the executables and add the following invocation to
PhoneNumbers.Test Debug panel:

* Start external program: C:\path\to\nunit-console.exe
* Command line arguments: PhoneNumbers.Test.dll /wait /run:PhoneNumbers.Test

Then run PhoneNumbers.Test, the test console window should appear and
the tests run.

Known Issues

- Phone numbers metadata is read from XML files and not protocol
  buffers one. I could not make it work using protobuf-csharp
  library. On the other hand, it makes one less dependency.


- Restore the Java logging calls?
- Find a suitable replace for Java CharSequence in phone numbers parsing API.
- Migrate geocoder and related files

Porting New Versions

This port was first converted from Subversion to Mercurial with
hgsubversion extension, from the source repository:

To update the port:

- Ensure you have a recent Mercurial and hgsubversion setup on your

- Update the port SVN metadata with:

  $ hg svn rebuildmeta

And possibly add the following to .hg/hgrc:

  default =

At this point, hg incoming should display new revisions.

- Pull new changes, update to "csharp" branch and merge with

- Fire your favorite diff tool and start porting changes.