A simple regex based exhaustive validator for PIN codes in India
Go to file
Nemo eb853b5f4c Fix .gitattributes 2020-04-27 11:57:42 +05:30
bin Initial commit for rubygem 2020-04-26 08:58:11 +05:30
src [ruby] Fix missing version 2020-04-26 08:58:11 +05:30
tests [ruby] Adds test and code 2020-04-26 08:58:11 +05:30
.editorconfig Python package and other updates 2020-03-13 16:42:58 +05:30
.gitattributes Fix .gitattributes 2020-04-27 11:57:42 +05:30
.gitignore [docs] Updates docs with a WHY note 2020-04-26 09:34:42 +05:30
.npmignore Improve all ignore files 2020-03-17 01:21:31 +05:30
.travis.yml [ci/ruby] Adds travis builds for Ruby 2020-04-26 08:58:11 +05:30
CODE_OF_CONDUCT.md [docs] Adds ruby in docs 2020-04-26 08:58:11 +05:30
Gemfile Don't commit Gemfile.lock 2020-04-26 08:58:11 +05:30
HACKING.md [docs] Adds ruby in docs 2020-04-26 08:58:11 +05:30
LICENSE Adds LICENSE and badges 2020-02-25 14:45:40 +05:30
Pipfile Python package and other updates 2020-03-13 16:42:58 +05:30
README.md Fix contributing 2020-04-26 10:03:11 +05:30
Rakefile [ruby] Adds test and code 2020-04-26 08:58:11 +05:30
composer.json Support phpunit 8.0 for php7.2 for now 2020-02-24 23:54:30 +05:30
package.json Version Bump (1.0.4) 2020-04-21 21:11:41 +05:30
phpunit.xml Initial commit 2020-02-24 23:32:18 +05:30
pincode-regex.js Adds support for browser-usage using browserify 2020-04-21 21:09:50 +05:30
pincode-validator.gemspec [docs] Adds ruby in docs 2020-04-26 08:58:11 +05:30
pyproject.toml Version Bump (1.0.4) 2020-04-21 21:11:41 +05:30
regex.txt Python package and other updates 2020-03-13 16:42:58 +05:30

README.md

india-pincode-regex Packagist Version Build Status npm GitHub package.json version GitHub

Validate a Postal Index Number for India with a few regexes and zero false-positives. The regexes are available in regex.txt. There is one regex per area code (the first digit of the PIN, which goes from 1-8).

Why?

A simple \d{6} approach marks a lot of invalid pincodes as valid. Out of the 900000 possible combinations, only approximately 155600 are valid pincodes in India. A simple example is 111111 which is an invalid pincode, but any simple 6 digit-check will pass it as a valid one.

Source

The source for the data is the "All India Pincode Directory" dataset on data.gov.in. The last updated date for the dataset is currently 30th May 2019.

Usage

The regex.txt file is 32KB in size, so you can easily use it wherever you want, including browsers. If you are using any of the packages below, this is already delivered compressed.

PHP

The package is available on packagist.

To use the PHP package:

use PIN\Validator as P;
P::validate('110011'); // returns true;

Node.js

The package is available on npm.

To use the package:

const P = require('pincode-validator');
P.validate('110011'); // returns true

Ruby

Add this line to your application's Gemfile:

gem 'pincode_validator'

And then execute:

$ bundle

Or install it yourself as:

$ gem install pincode_validator

Browser

To use it in the browser, download the pincode-regex.js file and include it in your browser. Pincode is available as a Global variable.

<script src="../pincode-regex.js"></script>
<script>
Pincode.validate("560029"); // returns true
</script>

Since there is no hotline/CDN for this yet, please watch to repo to get notified of new releases.

Code of Conduct

Everyone interacting in the this projects codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.

Contributing

  • See HACKING.md for some development details.
  • Pull requests are welcome for adding libraries in other languages (in the same repo).
  • This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

Licensed under the MIT License. See LICENSE file for details.