sl-admin-divisions

A comprehensive npm library providing Sri Lanka's administrative divisions data including Districts, DS Divisions, and GN Divisions with helpful utility functions.

Installation

npm install sl-admin-divisions

Usage

const { getDistricts, getDsDivisions, getGnDivisions, findDistrictByDs, data } = require('sl-admin-divisions');

// Get all districts
const districts = getDistricts();
console.log(districts);

// Get DS Divisions for a district
const dsDivisions = getDsDivisions('Colombo');
console.log(dsDivisions);

// Get GN Divisions for a DS Division
const gnDivisions = getGnDivisions('Colombo');
console.log(gnDivisions);

// Find district by DS Division name
const district = findDistrictByDs('Colombo');
console.log(district);

// Access raw data
console.log(data.districts);
console.log(data.dsDivisions);
console.log(data.gnDivisions);

API

getDistricts()

Returns an array of all districts in Sri Lanka.

getDsDivisions(district)

Returns an array of DS Divisions for the given district. The function is case-insensitive and handles whitespace variations.

getGnDivisions(ds)

Returns an array of GN Divisions for the given DS Division. The function is case-insensitive and handles whitespace variations.

findDistrictByDs(ds)

Finds and returns the district name for a given DS Division. Returns null if not found.

data

Raw data object containing:

• districts: Array of all districts
• dsDivisions: Object mapping districts to their DS Divisions
• gnDivisions: Object mapping DS Divisions to their GN Divisions

License

MIT

Author

J.A Venura jayasingha