faker-indian 0.1.0 → 0.2.0

data/lib/faker/indian/data/address.yml

@@ -1,40 +1,293 @@
+---
 locations:
   Mumbai:
     state: Maharashtra
-    pincode: "400001"
+    pincode: '400001'
   Pune:
     state: Maharashtra
-    pincode: "411001"
+    pincode: '411001'
   Delhi:
     state: Delhi
-    pincode: "110001"
+    pincode: '110001'
   Bengaluru:
     state: Karnataka
-    pincode: "560001"
-  Chennai:
-    state: Tamil Nadu
-    pincode: "600001"
+    pincode: '560001'
   Hyderabad:
     state: Telangana
-    pincode: "500001"
-  Ahmedabad:
-    state: Gujarat
-    pincode: "380001"
+    pincode: '500001'
+  Chennai:
+    state: Tamil Nadu
+    pincode: '600001'
   Kolkata:
     state: West Bengal
-    pincode: "700001"
+    pincode: '700001'
+  Ahmedabad:
+    state: Gujarat
+    pincode: '380001'
   Jaipur:
     state: Rajasthan
-    pincode: "302001"
+    pincode: '302001'
   Lucknow:
     state: Uttar Pradesh
-    pincode: "226001"
-
+    pincode: '226001'
+  Surat:
+    state: Gujarat
+    pincode: '395003'
+  Kanpur:
+    state: Uttar Pradesh
+    pincode: '208001'
+  Nagpur:
+    state: Maharashtra
+    pincode: '440001'
+  Indore:
+    state: Madhya Pradesh
+    pincode: '452001'
+  Bhopal:
+    state: Madhya Pradesh
+    pincode: '462001'
+  Patna:
+    state: Bihar
+    pincode: '800001'
+  Chandigarh:
+    state: Chandigarh
+    pincode: '160001'
+  Coimbatore:
+    state: Tamil Nadu
+    pincode: '641001'
+  Kochi:
+    state: Kerala
+    pincode: '682001'
+  Visakhapatnam:
+    state: Andhra Pradesh
+    pincode: '530001'
+  Thiruvananthapuram:
+    state: Kerala
+    pincode: '695001'
+  Vadodara:
+    state: Gujarat
+    pincode: '390001'
+  Ludhiana:
+    state: Punjab
+    pincode: '141001'
+  Agra:
+    state: Uttar Pradesh
+    pincode: '282001'
+  Nashik:
+    state: Maharashtra
+    pincode: '422001'
+  Faridabad:
+    state: Haryana
+    pincode: '121001'
+  Meerut:
+    state: Uttar Pradesh
+    pincode: '250001'
+  Raipur:
+    state: Chhattisgarh
+    pincode: '492001'
+  Ranchi:
+    state: Jharkhand
+    pincode: '834001'
+  Guwahati:
+    state: Assam
+    pincode: '781001'
+  Amritsar:
+    state: Punjab
+    pincode: '143001'
+  Aurangabad:
+    state: Maharashtra
+    pincode: '431001'
+  Bareilly:
+    state: Uttar Pradesh
+    pincode: '243001'
+  Belgaum:
+    state: Karnataka
+    pincode: '590001'
+  Bhavnagar:
+    state: Gujarat
+    pincode: '364001'
+  Bhubaneswar:
+    state: Odisha
+    pincode: '751001'
+  Bikaner:
+    state: Rajasthan
+    pincode: '334001'
+  Bilaspur:
+    state: Chhattisgarh
+    pincode: '495001'
+  Cuttack:
+    state: Odisha
+    pincode: '753001'
+  Dehradun:
+    state: Uttarakhand
+    pincode: '248001'
+  Dhanbad:
+    state: Jharkhand
+    pincode: '826001'
+  Durgapur:
+    state: West Bengal
+    pincode: '713201'
+  Erode:
+    state: Tamil Nadu
+    pincode: '638001'
+  Gandhinagar:
+    state: Gujarat
+    pincode: '382001'
+  Gaya:
+    state: Bihar
+    pincode: '823001'
+  Gorakhpur:
+    state: Uttar Pradesh
+    pincode: '273001'
+  Guntur:
+    state: Andhra Pradesh
+    pincode: '522001'
+  Hubli:
+    state: Karnataka
+    pincode: '580020'
+  Jabalpur:
+    state: Madhya Pradesh
+    pincode: '482001'
+  Jalandhar:
+    state: Punjab
+    pincode: '144001'
+  Jammu:
+    state: Jammu and Kashmir
+    pincode: '180001'
+  Jamnagar:
+    state: Gujarat
+    pincode: '361001'
+  Jamshedpur:
+    state: Jharkhand
+    pincode: '831001'
+  Jhansi:
+    state: Uttar Pradesh
+    pincode: '284001'
+  Jodhpur:
+    state: Rajasthan
+    pincode: '342001'
+  Kakinada:
+    state: Andhra Pradesh
+    pincode: '533001'
+  Kolhapur:
+    state: Maharashtra
+    pincode: '416003'
+  Kota:
+    state: Rajasthan
+    pincode: '324001'
+  Madurai:
+    state: Tamil Nadu
+    pincode: '625001'
+  Mangalore:
+    state: Karnataka
+    pincode: '575001'
+  Mysuru:
+    state: Karnataka
+    pincode: '570001'
+  Noida:
+    state: Uttar Pradesh
+    pincode: '201301'
+  Panaji:
+    state: Goa
+    pincode: '403001'
+  Prayagraj:
+    state: Uttar Pradesh
+    pincode: '211001'
+  Rajkot:
+    state: Gujarat
+    pincode: '360001'
+  Salem:
+    state: Tamil Nadu
+    pincode: '636001'
+  Shimla:
+    state: Himachal Pradesh
+    pincode: '171001'
+  Srinagar:
+    state: Jammu and Kashmir
+    pincode: '190001'
+  Tiruchirappalli:
+    state: Tamil Nadu
+    pincode: '620001'
+  Udaipur:
+    state: Rajasthan
+    pincode: '313001'
 streets:
-  - MG Road
-  - FC Road
-  - Park Street
-  - Brigade Road
-  - Linking Road
-  - Anna Salai
-  - Ring Road
+- MG Road
+- FC Road
+- Park Street
+- Brigade Road
+- Linking Road
+- Anna Salai
+- Ring Road
+- Outer Ring Road
+- JM Road
+- Karve Road
+- Laxmi Road
+- Church Street
+- Hill Road
+- Elgin Road
+- Gariahat Road
+- Residency Road
+- Ashram Road
+- Law Garden Road
+- VIP Road
+- Rajpur Road
+- Civil Lines Road
+- Airport Road
+- Station Road
+- Mall Road
+- College Road
+- Camac Street
+- Marine Drive
+- Banjara Hills Road No. 12
+- Hauz Khas Village Road
+- Cathedral Road
+state_codes:
+  Maharashtra: MH
+  Karnataka: KA
+  Delhi: DL
+  Tamil Nadu: TN
+  Gujarat: GJ
+  Uttar Pradesh: UP
+  West Bengal: WB
+  Rajasthan: RJ
+  Andhra Pradesh: AP
+  Telangana: TS
+  Kerala: KL
+  Madhya Pradesh: MP
+  Haryana: HR
+  Punjab: PB
+  Bihar: BR
+  Odisha: OR
+  Chhattisgarh: CG
+  Jharkhand: JH
+  Assam: AS
+  Uttarakhand: UK
+  Himachal Pradesh: HP
+  Jammu and Kashmir: JK
+  Goa: GA
+  Chandigarh: CH
+districts:
+- Andheri
+- Koramangala
+- Bandra
+- Powai
+- Salt Lake
+- Connaught Place
+- Hinjewadi
+- Gachibowli
+- T Nagar
+- Adyar
+- Satellite Road
+- Vastrapur
+- Hazratganj
+- Civil Lines
+- MG Road Extension
+landmarks:
+- Near Metro Station
+- Opposite City Mall
+- Behind Railway Station
+- Next to Bus Stand
+- Near Airport
+- Close to IT Park
+- Opposite Hospital
+- Near City Market

data/lib/faker/indian/data/company.yml

@@ -0,0 +1,28 @@
+prefixes:
+  - Shree
+  - Bharat
+  - Hindustan
+  - New India
+  - National
+
+cores:
+  - Tech Solutions
+  - Industries
+  - Traders
+  - Exports
+  - Logistics
+  - Pharmaceuticals
+  - Infotech
+  - Enterprises
+
+suffixes:
+  - Pvt Ltd
+  - LLP
+  - Limited
+  - Technologies
+  - Services
+
+types:
+  - Private Limited
+  - LLP
+  - Public Limited

data/lib/faker/indian/data/food.yml

@@ -89,3 +89,21 @@ street_food:
   - Jalebi
   - Kulfi
   - Poha
+
+meals:
+  - breakfast
+  - lunch
+  - dinner
+
+beverages:
+  - Masala Chai
+  - Filter Coffee
+  - Lassi
+  - Nimbu Pani
+  - Mango Lassi
+  - Thandai
+
+spice_levels:
+  - mild
+  - medium
+  - spicy

data/lib/faker/indian/data/name.yml

@@ -39,3 +39,16 @@ prefixes:
   - Ms.
   - Dr.
   - Prof.
+
+middle_names:
+  - Kumar
+  - Devi
+  - Lal
+  - Bai
+  - Chand
+  - Prasad
+
+suffixes:
+  - Ji
+  - Bai
+  - Sahib

data/lib/faker/indian/data/phone.yml

@@ -0,0 +1,17 @@
+operators:
+  - Jio
+  - Airtel
+  - Vi
+  - BSNL
+
+std_codes:
+  - "22"
+  - "11"
+  - "80"
+  - "44"
+  - "40"
+  - "33"
+  - "79"
+  - "20"
+  - "141"
+  - "522"

data/lib/faker/indian/data/travel.yml

@@ -0,0 +1,23 @@
+stations:
+  - Mumbai CST
+  - New Delhi
+  - Howrah Junction
+  - Bengaluru City
+  - Chennai Central
+  - Secunderabad Junction
+  - Ahmedabad Junction
+  - Pune Junction
+  - Jaipur Junction
+  - Lucknow NR
+
+trains:
+  - Rajdhani Express
+  - Shatabdi Express
+  - Duronto Express
+  - Garib Rath Express
+  - Vande Bharat Express
+  - Deccan Queen
+  - Tamil Nadu Express
+  - Karnataka Express
+  - Punjab Mail
+  - Konkan Kanya Express

data/lib/faker/indian/food.rb

@@ -5,13 +5,17 @@ require "faker"
 module Faker
   module Indian
     class Food
-      _data = Data.load(:food)
+      data = Data.load(:food)
+
+      DISHES = data.fetch(:dishes).freeze
+      RESTAURANTS = data.fetch(:restaurants).freeze
+      CUISINES = data.fetch(:cuisines).freeze
+      STREET_FOOD = data.fetch(:street_food).freeze
+      SWEETS = data.fetch(:sweets).freeze
+      MEALS = data.fetch(:meals).freeze
+      BEVERAGES = data.fetch(:beverages).freeze
+      SPICE_LEVELS = data.fetch(:spice_levels).freeze
 
-      DISHES = _data.fetch(:dishes).freeze
-      RESTAURANTS = _data.fetch(:restaurants).freeze
-      CUISINES = _data.fetch(:cuisines).freeze
-      STREET_FOOD = _data.fetch(:street_food).freeze
-      SWEETS = _data.fetch(:sweets).freeze
       class << self
         def dish
           DISHES.sample(random: random)
@@ -33,6 +37,22 @@ module Faker
           SWEETS.sample(random: random)
         end
 
+        def meal
+          MEALS.sample(random: random)
+        end
+
+        def beverage
+          BEVERAGES.sample(random: random)
+        end
+
+        def combo
+          "#{dish} with #{beverage}"
+        end
+
+        def spice_level
+          SPICE_LEVELS.sample(random: random)
+        end
+
         private
 
         def random

data/lib/faker/indian/identity.rb

@@ -4,12 +4,14 @@ require "faker"
 
 module Faker
   module Indian
+    # Provides fake identity data specific to the Indian context
+    # such as Aadhar numbers, PAN card formats, GSTIN, voterID, passport number.
     class Identity
-      _data = Data.load(:identity)
+      data = Data.load(:identity)
 
       LETTERS = ("A".."Z").to_a.freeze
-      PAN_ENTITY_TYPES = _data.fetch(:pan_entity_types).freeze
-      GSTIN_STATE_CODES = _data.fetch(:gstin_state_codes).freeze
+      PAN_ENTITY_TYPES = data.fetch(:pan_entity_types).freeze
+      GSTIN_STATE_CODES = data.fetch(:gstin_state_codes).freeze
       CHECKSUM_CHARS = (("0".."9").to_a + LETTERS).freeze
 
       class << self
@@ -30,12 +32,17 @@ module Faker
                .join(" ")
         end
 
-        def gstin
+        def aadhaar_masked
+          "XXXX XXXX #{format('%04d', random.rand(0..9999))}"
+        end
+
+        def gstin(pan: nil)
           state = GSTIN_STATE_CODES.sample(random: random)
           entity_number = random.rand(1..9)
           checksum = CHECKSUM_CHARS.sample(random: random)
+          pan_value = pan || self.pan
 
-          "#{state}#{pan}#{entity_number}Z#{checksum}"
+          "#{state}#{pan_value}#{entity_number}Z#{checksum}"
         end
 
         def voter_id
@@ -46,6 +53,15 @@ module Faker
           "#{sample_letter}#{random.rand(1_000_000..9_999_999)}"
         end
 
+        def driving_license(state: nil)
+          code = resolve_state_code(state)
+          year = random.rand(2010..2024)
+          series = format("%02d", random.rand(1..99))
+          number = random.rand(1_000_000..9_999_999)
+
+          "#{code}-#{series}-#{year}-#{number}"
+        end
+
         private
 
         def random
@@ -55,6 +71,24 @@ module Faker
         def sample_letter
           LETTERS.sample(random: random)
         end
+
+        def resolve_state_code(state)
+          return sample_state_code if state.nil?
+
+          normalized = state.to_s
+          return normalized.upcase if normalized.length == 2
+
+          match = Address::STATE_CODES.find do |name, code|
+            name.casecmp?(normalized) || code.casecmp?(normalized)
+          end
+          return match.last if match
+
+          raise Error, "unknown state: #{state}"
+        end
+
+        def sample_state_code
+          Address::STATE_CODES.values.sample(random: random)
+        end
       end
     end
   end

data/lib/faker/indian/languages.rb

@@ -5,9 +5,9 @@ require "faker"
 module Faker
   module Indian
     class Languages
-      _data = Data.load(:languages)
+      data = Data.load(:languages)
 
-      LANGUAGES = _data.freeze
+      LANGUAGES = data.freeze
 
       class << self
         def name(language: nil)

data/lib/faker/indian/name.rb

@@ -5,11 +5,13 @@ require "faker"
 module Faker
   module Indian
     class Name
-      _data = Data.load(:name)
+      data = Data.load(:name)
 
-      FIRST_NAMES = _data.fetch(:first_names).freeze
-      LAST_NAMES = _data.fetch(:last_names).freeze
-      PREFIXES = _data.fetch(:prefixes).freeze
+      FIRST_NAMES = data.fetch(:first_names).freeze
+      LAST_NAMES = data.fetch(:last_names).freeze
+      PREFIXES = data.fetch(:prefixes).freeze
+      MIDDLE_NAMES = data.fetch(:middle_names).freeze
+      SUFFIXES = data.fetch(:suffixes).freeze
 
       class << self
         def first_name
@@ -20,7 +22,13 @@ module Faker
           LAST_NAMES.sample(random: random)
         end
 
-        def full_name
+        def middle_name
+          MIDDLE_NAMES.sample(random: random)
+        end
+
+        def full_name(language: nil)
+          return Languages.full_name(language: language) if language
+
           "#{first_name} #{last_name}"
         end
 
@@ -28,6 +36,10 @@ module Faker
           PREFIXES.sample(random: random)
         end
 
+        def suffix
+          SUFFIXES.sample(random: random)
+        end
+
         private
 
         def random

data/lib/faker/indian/payment.rb

@@ -5,15 +5,16 @@ require "faker"
 module Faker
   module Indian
     class Payment
-      _data = Data.load(:payment)
+      data = Data.load(:payment)
 
-      HANDLES = _data.fetch(:handles).freeze
-      BANK_CODES = _data.fetch(:banks).freeze
-      NAMES = _data.fetch(:names).freeze
+      HANDLES = data.fetch(:handles).freeze
+      BANK_CODES = data.fetch(:banks).freeze
+      NAMES = data.fetch(:names).freeze
 
       class << self
-        def upi_id
-          "#{sample_name}#{random.rand(10..99)}@#{sample_handle}"
+        def upi_id(name: nil)
+          handle_name = sanitize_name(name || sample_name)
+          "#{handle_name}#{random.rand(10..99)}@#{sample_handle}"
         end
         alias upi upi_id
 
@@ -31,6 +32,19 @@ module Faker
           random.rand(100_000_000_000..999_999_999_999).to_s
         end
 
+        def demat_account
+          random.rand(100_000_000_000_000..999_999_999_999_999).to_s
+        end
+
+        def bank_details
+          code = sample_bank_code
+          {
+            bank_name: BANK_CODES[code],
+            ifsc: "#{code}0#{random.rand(100_000..999_999)}",
+            account_number: random.rand(100_000_000_000..999_999_999_999).to_s
+          }
+        end
+
         private
 
         def random
@@ -48,6 +62,10 @@ module Faker
         def sample_bank_code
           BANK_CODES.keys.sample(random: random)
         end
+
+        def sanitize_name(name)
+          name.to_s.downcase.gsub(/\s+/, "")
+        end
       end
     end
   end

data/lib/faker/indian/phone.rb

@@ -5,11 +5,32 @@ require "faker"
 module Faker
   module Indian
     class Phone
+      data = Data.load(:phone)
+
+      OPERATORS = data.fetch(:operators).freeze
+      STD_CODES = data.fetch(:std_codes).freeze
+
       class << self
-        def mobile_number
+        def mobile_number(formatted: true)
           first_digit = random.rand(6..9)
           remaining = random.rand(0..999_999_999)
-          "+91 #{first_digit}#{format("%09d", remaining)}"
+          digits = "#{first_digit}#{format('%09d', remaining)}"
+
+          formatted ? "+91 #{digits}" : digits
+        end
+
+        def landline
+          std = STD_CODES.sample(random: random)
+          number = random.rand(1_000_000..9_999_999)
+          "0#{std}-#{number}"
+        end
+
+        def operator
+          OPERATORS.sample(random: random)
+        end
+
+        def whatsapp_number(formatted: true)
+          mobile_number(formatted: formatted)
         end
 
         private