Library for managing postal codes for .NET

This package follows the git-flow branching model:

• Develop features of a feature/* branch.
• Create pull request to a master branch.
• Once master is branched into release/<major>.<minor>.<patch> an automatic job builds and if successful publishes the NuGet package.
• After successful build the artifact will be available via NuGet or directly from GitHub Releases.

If you want to open the solution file in Visual Studio, you may need the Sandcastle Help File Builder Visual Studio extension available in the bundle here.

The following snippets assume your working directory is in the root of the repository:

> git clone https://github.com/Cimpress-MCP/PostalCodes.Net.git
> cd PostalCodes.Net

In order to build the project you can use plain msbuild:

> nuget restore
> msbuild

> nuget restore
> xbuild

Install the nuget and mono-xbuild packages from Mono Project package repository.

> nuget restore
> xbuild

##Reading the docs

Microsoft Compiled HTML Help is supported by default on Windows.

One alternative to read Microsoft Compiled HTML Help on a Mac is iChm or Chmox.

A popular cross-platform alternative to read Microsoft Compiled HTML Help is xCHM.

##Usages

var country = CountryFactory.Instance.CreateCountry("PL");
var postalCode = PostalCodeFactory.Instance.CreatePostalCode(
	country, "44-100");

in case of invalid postal code you will get an ArgumentException with the proper message explaining the reason for the failure.