A simple regex based exhaustive validator for PIN codes in India
Go to file
Nemo cbc329f738
Merge pull request #4 from captn3m0/next
2023-07-10 21:52:04 +05:30
.github Merge pull request #4 from captn3m0/next 2023-07-10 21:52:04 +05:30
bin Initial commit for rubygem 2020-04-26 08:58:11 +05:30
src [php] Fix 7.2 tests 2023-07-02 14:59:31 +05:30
tests v2 browser testing and build 2023-07-10 21:48:45 +05:30
.editorconfig Minor updates 2021-12-19 19:18:41 +05:30
.gitattributes [php] Ignore things for composer 2023-07-02 14:27:38 +05:30
.gitignore Lots of changes for v2 2023-07-01 20:00:02 +05:30
.npmignore [npm] Fix ignored files 2023-07-02 15:11:57 +05:30
CHANGELOG.md Minor updates 2021-12-19 19:18:41 +05:30
CODE_OF_CONDUCT.md Docs updates 2023-07-02 14:48:11 +05:30
CONTRIBUTING.md Docs updates 2023-07-02 14:48:11 +05:30
Gemfile Don't commit Gemfile.lock 2020-04-26 08:58:11 +05:30
HACKING.md Lots of changes for v2 2023-07-01 20:00:02 +05:30
LICENSE Adds LICENSE and badges 2020-02-25 14:45:40 +05:30
README.md [docs] Add supported language note (skip-ci) 2023-07-02 15:07:27 +05:30
Rakefile [ruby] Adds test and code 2020-04-26 08:58:11 +05:30
composer.json [ci] Migrate from Travis 2023-07-02 14:33:09 +05:30
package.json v2 browser testing and build 2023-07-10 21:48:45 +05:30
phpunit.xml Lots of changes for v2 2023-07-01 20:00:02 +05:30
pincode-regex.js v2 browser testing and build 2023-07-10 21:48:45 +05:30
pincode-validator.gemspec Lots of changes for v2 2023-07-01 20:00:02 +05:30
pyproject.toml Version bump 2023-07-02 14:50:25 +05:30
regex.txt [php] Get PHP functional 2023-07-02 14:21:35 +05:30
regexes.txt [php] Get PHP functional 2023-07-02 14:21:35 +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). Available as a package for Ruby, Python, Node.js, and browsers.

Why?

A simple \d{6} approach marks a lot of invalid pincodes as valid. Out of the 900000 possible combinations, only approximately 19000 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. You can use the regex directly, or via a few helper methods.

Supported Language Versions

This project only supports supported versions of various languages.

PHP

The package is available on packagist.

To use the PHP package:

use PIN\Validator as P;
// validates a given pincode
// returns boolean
P::validate('110011'); // returns true;

// Searches for all valid pincodes in a given string.
// returns array(string)
P::search('bangalore 560029'); // returns ["560029"]

Node.js

The package is available on npm.

To use the package:

const P = require('pincode-validator');
P.validate('110011'); // returns true
P.search('my pincode is 560029'); // returns ['560029']

// or directly use the regex in your code
P.exactRegex.match('560029')
"address with pincode (560029)".matchAll(P.regex)

Please see tests/validate.js for more examples.

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
require 'pincode_validator'

Pin::valid?('560029') # returns true
Pin::valid?('111111') # returns false

Pin::search('my pincode is 244713') # returns ['244713']
Pin::search('my pincode is 244713 or 560029') # returns ['244713', '560029']

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>

You can use githack for directly using this in your code: https://rawcdn.githack.com/captn3m0/india-pincode-regex/v2.0.0/pincode-regex.js (Make sure you use the latest version). Please watch the 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 CONTRIBUTING.md for some development details and contribution guidelines
  • Pull requests are welcome for adding libraries in other languages (in the same repo). Python support is WIP, and I'd love to have support for other languages as well.
  • 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.