Skip to content

myselfdesai/ideal_ukpostcode

Repository files navigation

ideal_ukpostcode

image

package supports validating and formatting postcodes for the UK

Introduction

package supports validating and formatting postcodes for the UK. The details of which postcodes are valid and which are the parts they consist of can be found at wiki

Installation

To install ideal_ukpostcode, run this command in your terminal:

pip install ideal_ukpostcode

This is the preferred method to install ideal_ukpostcode, as it will always install the most recent stable release.

If you don't have pip installed, this Python installation guide can guide you through the process.

From sources

The sources for ideal_ukpostcode can be downloaded from the Github repo.

You can clone the public repository:

git clone git://github.com/myselfdesai/ideal_ukpostcode

Usage

To use ideal_ukpostcode in a project:

validate a postcode

it gives boolean result True or False

import ideal_ukpostcode
ideal_ukpostcode.validate("EC1A 1BB")

format a postcode

format(area, district, sector, unit)

import ideal_ukpostcode
ideal_ukpostcode.format("EC","1A","1","BB")

Test

install dev dependencies

pip install -r requirements_dev.txt

In the root folder, execute :

pytest

Credits

This package was created with Cookiecutter and the giswqs/pypackage project template.