allykit 1.0.0__tar.gz → 1.0.2__tar.gz

{allykit-1.0.0/src/allykit.egg-info → allykit-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: allykit
-Version: 1.0.0
+Version: 1.0.2
 Summary: A comprehensive Python toolkit for security engineering, cryptography, web scraping, filesystem auditing, DFIR, and reusable utility functions.
 Home-page: https://github.com/hosssein193m-ai/allykit
 Author: None

{allykit-1.0.0 → allykit-1.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "allykit"
-version = "1.0.0"
+version = "1.0.2"
 description = "A comprehensive Python toolkit for security engineering, cryptography, web scraping, filesystem auditing, DFIR, and reusable utility functions."
 readme = "README.md"
 requires-python = ">=3.9"
@@ -9,7 +9,6 @@ license = { text = "MIT" }
 authors = [
     { name = "allykit Developer", email = "hossein.moradian.ir@outlook.com" }
 ]
-
 keywords = [
     "security",
     "cryptography",

allykit-1.0.2/src/allykit/IRAN.py

@@ -0,0 +1,460 @@
+"""
+Module: Iran Geographic Data
+Version: 2.1 (Complete Edition)
+Description: Comprehensive Iranian geographical, demographic, and telecommunications data.
+             Includes Persian character sets, city mappings (Persian to English),
+             provinces, cities, populations, SIM card prefixes, phone codes, car plates,
+             coordinates, and utility functions.
+
+Author: Generated Assistant
+Last Updated: 2026
+
+Main Data Structures:
+    - persian_letters, persian_numbers, persian_harakat: Persian character sets
+    - iran_cities: dict mapping Persian city names to English
+    - provinces_and_cities: dict mapping provinces to their cities
+    - iran_provinces: list of all 31 provinces
+    - regions: dict mapping Persian regions to province lists
+    - province_metadata: dict with province codes, regions, area, population
+    - city_coordinates: dict mapping Persian city names to (lat, lon) tuples
+    - city_full_data: dict with en_name, coords, province for major cities
+    - iran_cities_fa / iran_cities_en: complete city lists
+    - city_population: dict mapping Persian city names to population counts
+    - sim_card_prefixes: dict mapping operators to prefix lists
+    - sim_card_prefixes_list: flat list of all SIM prefixes
+    - city_phone_codes: dict mapping Persian city names to area codes
+    - car_plate_codes: dict mapping province names to plate number codes
+
+Utility Functions:
+    - get_province_of_city(city_fa: str) -> str
+    - get_city_coords(city_fa: str) -> tuple
+    - search_city(query: str) -> dict
+    - get_provinces_by_region(region_fa: str) -> list
+    - get_city_population(city_fa: str) -> int
+    - get_sim_operator(prefix: str) -> str
+    - get_city_phone_code(city_fa: str) -> str
+    - get_car_plate_codes(province_fa: str) -> list
+
+Usage Examples:
+    >>> from iran_geo import *
+    >>> get_province_of_city("اصفهان")
+    'اصفهان'
+    >>> get_city_population("تهران")
+    8846782
+    >>> get_sim_operator("0912")
+    'همراه اول'
+    >>> get_city_phone_code("شیراز")
+    '071'
+    >>> get_car_plate_codes("تهران")
+    ['11', '12', '22', '33', '44', '55', '66', '77', '88', '99', '10', '20', '30', '40', '50']
+"""
+
+# ==================== حروف و کاراکترهای فارسی ====================
+persian_letters = "آابپتثجچحخدذرزژسشصضطظعغفقکگلمنوهی"
+persian_numbers = "۰۱۲۳۴۵۶۷۸۹"
+persian_harakat = "ًٌٍَُِّْ"
+
+# ==================== نقشه شهرها (فارسی به انگلیسی) ====================
+iran_cities = {
+    # استان تهران و البرز
+    "تهران": "tehran", "ری": "ray", "اسلامشهر": "eslamshahr", "ورامین": "varamin",
+    "شهریار": "shahriar", "قدس": "qods", "قرچک": "qarchak", "بومهن": "bumehen",
+    "پردیس": "pardis", "ملارد": "malard", "فردیس": "fardis", "کرج": "karaj",
+    "طالقان": "taleqan", "نظرآباد": "nazarabad", "اشتهارد": "eshtehard",
+    
+    # استان اصفهان
+    "اصفهان": "isfahan", "کاشان": "kashan", "خمینی‌شهر": "khomeynishahr",
+    "نجف‌آباد": "najafabad", "شاهین‌شهر": "shahinshahr", "مبارکه": "mobarakeh",
+    "فلاورجان": "falavarjan", "زرین‌شهر": "zarinshahr", "گلپایگان": "golpayegan",
+    "فریدن": "faridan", "سمیرم": "semirom", "شهرضا": "shahreza", "نائین": "nain",
+    "نطنز": "natanz", "اردستان": "ardestan", "خوانسار": "khansar", "دهاقان": "dehaghan",
+    
+    # استان خراسان رضوی
+    "مشهد": "mashhad", "نیشابور": "neyshabur", "سبزوار": "sabzevar", "تربت حیدریه": "torbat heydarieh",
+    "تربت جام": "torbat jam", "قوچان": "ghochan", "کاشمر": "kashmar", "گناباد": "gonabad",
+    "چناران": "chenaran", "سرخس": "sarakhs", "فریمان": "fariman", "درگز": "dargaz",
+    
+    # استان فارس
+    "شیراز": "shiraz", "مرودشت": "marvdasht", "جهرم": "jahrom", "فسا": "fasa",
+    "کازرون": "kazeroon", "لارستان": "laristan", "آباده": "abadeh", "نورآباد": "nurabad",
+    "اقلید": "eqlid", "داراب": "darab", "زرین‌دشت": "zarindasht", "لامرد": "lamerd",
+    
+    # استان آذربایجان شرقی
+    "تبریز": "tabriz", "مراغه": "maragheh", "مرند": "marand", "میانه": "mianeh",
+    "اهر": "ahar", "بناب": "bonab", "سراب": "sarab", "آذرشهر": "azarshahr",
+    "هشترود": "hashtroud", "کلیبر": "kaleybar", "جلفا": "jolfa",
+    
+    # استان خوزستان
+    "اهواز": "ahvaz", "آبادان": "abadan", "دزفول": "dezful", "اندیمشک": "andimeshk",
+    "خرمشهر": "khorramshahr", "بندر ماهشهر": "bandar mahshahr", "بهبهان": "behbahan",
+    "ایذه": "izeh", "شوشتر": "shushtar", "شوش": "shush", "مسجدسلیمان": "masjed soleyman",
+    
+    # استان کرمانشاه
+    "کرمانشاه": "kermanshah", "اسلام‌آباد غرب": "eslamabad gharb", "سنقر": "sanghar",
+    "صحنه": "sahneh", "هرسین": "harsin", "کنگاور": "kangavar", "پاوه": "paveh",
+    
+    # استان مازندران
+    "ساری": "sari", "بابل": "babol", "آمل": "amol", "قائم‌شهر": "ghaemshahr",
+    "بهشهر": "behshahr", "نوشهر": "nowshahr", "چالوس": "chalus", "تنکابن": "tonkabon",
+    "نور": "noor", "محمودآباد": "mahmoudabad", "فریدونکنار": "fereydunkenar",
+    
+    # استان گیلان
+    "رشت": "rasht", "لاهیجان": "lahijan", "انزلی": "anzali", "رودسر": "roodsar",
+    "آستارا": "astara", "تالش": "talesh", "فومن": "fouman", "صومعه‌سرا": "someh sara",
+    "رضوانشهر": "rezvanshahr", "ماسال": "masal",
+    
+    # سایر استان‌ها
+    "ارومیه": "urmia", "کرمان": "kerman", "همدان": "hamedan", "یزد": "yazd",
+    "زنجان": "zanjan", "بندرعباس": "bandar abbas", "بوشهر": "bushehr", "اراک": "arak",
+    "قم": "qom", "سمنان": "semnan", "شهرکرد": "shahrekord", "یاسوج": "yasuj",
+    "ایلام": "ilam", "بجنورد": "bojnord", "بیرجند": "birjand", "سنندج": "sanandaj",
+    "خرم‌آباد": "khorramabad", "گرگان": "gorgan", "اردبیل": "ardabil", "زاهدان": "zahedan",
+    "قزوین": "qazvin",
+}
+
+# ==================== استان‌ها و شهرهای تابعه ====================
+provinces_and_cities = {
+    "تهران": ["تهران", "ری", "اسلامشهر", "ورامین", "شهریار", "قدس", "قرچک", "بومهن", "پردیس", "ملارد"],
+    "البرز": ["کرج", "فردیس", "اشتهارد", "طالقان", "نظرآباد"],
+    "اصفهان": ["اصفهان", "کاشان", "خمینی‌شهر", "نجف‌آباد", "شاهین‌شهر", "مبارکه", "فلاورجان", "زرین‌شهر", "گلپایگان", "فریدن", "سمیرم", "شهرضا", "نائین", "نطنز", "اردستان", "خوانسار", "دهاقان"],
+    "فارس": ["شیراز", "مرودشت", "جهرم", "فسا", "کازرون", "لارستان", "آباده", "نورآباد", "اقلید", "داراب", "زرین‌دشت", "لامرد"],
+    "خراسان رضوی": ["مشهد", "نیشابور", "سبزوار", "تربت حیدریه", "تربت جام", "قوچان", "کاشمر", "گناباد", "چناران", "سرخس", "فریمان", "درگز"],
+    "خراسان شمالی": ["بجنورد", "شیروان", "اسفراین", "جاجرم", "مانه و سملقان"],
+    "خراسان جنوبی": ["بیرجند", "قائن", "فردوس", "نهبندان", "طبس", "سربیشه"],
+    "آذربایجان شرقی": ["تبریز", "مراغه", "مرند", "میانه", "اهر", "بناب", "سراب", "آذرشهر", "هشترود", "کلیبر", "جلفا"],
+    "آذربایجان غربی": ["ارومیه", "خوی", "بوکان", "مهاباد", "سلماس", "میاندوآب", "نقده", "پیرانشهر", "تکاب", "اشنویه"],
+    "خوزستان": ["اهواز", "آبادان", "دزفول", "اندیمشک", "خرمشهر", "بندر ماهشهر", "بهبهان", "ایذه", "شوشتر", "شوش", "مسجدسلیمان", "رامهرمز", "باغملک"],
+    "کرمانشاه": ["کرمانشاه", "اسلام‌آباد غرب", "سنقر", "صحنه", "هرسین", "کنگاور", "پاوه", "سرپل ذهاب", "قصر شیرین"],
+    "مازندران": ["ساری", "بابل", "آمل", "قائم‌شهر", "بهشهر", "نوشهر", "چالوس", "تنکابن", "نور", "محمودآباد", "فریدونکنار", "رامسر", "جویبار"],
+    "گیلان": ["رشت", "لاهیجان", "انزلی", "رودسر", "آستارا", "تالش", "فومن", "صومعه‌سرا", "رضوانشهر", "ماسال", "آستانه اشرفیه"],
+    "گلستان": ["گرگان", "گنبد کاووس", "علی‌آباد کتول", "آق‌قلا", "بندر ترکمن", "کردکوی", "کلاله", "مینودشت", "آزادشهر"],
+    "کرمان": ["کرمان", "سیرجان", "رفسنجان", "جیرفت", "بم", "زرند", "بافت", "شهربابک", "کهنوج"],
+    "همدان": ["همدان", "ملایر", "نهاوند", "تويسركان", "اسدآباد", "رزن", "کبودرآهنگ"],
+    "یزد": ["یزد", "میبد", "اردکان", "بافق", "ابرکوه", "تفت", "مهریز", "اشکذر"],
+    "زنجان": ["زنجان", "ابهر", "خرمدره", "ماهنشان", "طارم", "ایجرود"],
+    "سمنان": ["سمنان", "شاهرود", "دامغان", "گرمسار", "مهدی‌شهر", "میامی"],
+    "لرستان": ["خرم‌آباد", "بروجرد", "دورود", "الیگودرز", "کوهدشت", "ازنا", "الشتر"],
+    "اردبیل": ["اردبیل", "مشگین‌شهر", "پارس‌آباد", "خلخال", "گرمی", "نمین", "بیله‌سوار"],
+    "هرمزگان": ["بندرعباس", "میناب", "قشم", "کیش", "بندر لنگه", "جاسک", "حاجی‌آباد", "دهبارز"],
+    "بوشهر": ["بوشهر", "برازجان", "گناوه", "خارک", "دیر", "کنگان", "دشتستان", "جم"],
+    "سیستان و بلوچستان": ["زاهدان", "زابل", "چابهار", "ایرانشهر", "سراوان", "خاش", "نیکشهر"],
+    "چهارمحال و بختیاری": ["شهرکرد", "بروجن", "اردل", "فارسان", "لردگان", "کوهرنگ"],
+    "ایلام": ["ایلام", "دهلران", "مهران", "ایوان", "آبدانان", "دره‌شهر"],
+    "کهگیلویه و بویراحمد": ["یاسوج", "گچساران", "دهدشت", "لیکک", "باشت"],
+    "قزوین": ["قزوین", "الوند", "آبیک", "بوئین‌زهرا", "تاکستان"],
+    "قم": ["قم", "جعفریه", "دستجرد"],
+    "مرکزی": ["اراک", "ساوه", "خمین", "محلات", "دلیجان", "تفرش", "شازند", "آشتیان"],
+}
+
+# ==================== لیست کامل استان‌ها ====================
+iran_provinces = [
+    "تهران", "البرز", "اصفهان", "فارس", "خراسان رضوی", "خراسان شمالی", "خراسان جنوبی",
+    "آذربایجان شرقی", "آذربایجان غربی", "خوزستان", "کرمانشاه", "مازندران", "گیلان",
+    "گلستان", "کرمان", "همدان", "یزد", "زنجان", "سمنان", "لرستان", "اردبیل", "هرمزگان",
+    "بوشهر", "سیستان و بلوچستان", "چهارمحال و بختیاری", "ایلام", "کهگیلویه و بویراحمد",
+    "قزوین", "قم", "مرکزی"
+]
+
+# ==================== تقسیمات منطقه‌ای ====================
+regions = {
+    "شمال": ["گیلان", "مازندران", "گلستان"],
+    "جنوب": ["هرمزگان", "سیستان و بلوچستان", "بوشهر", "کهگیلویه و بویراحمد"],
+    "غرب": ["کردستان", "کرمانشاه", "ایلام", "آذربایجان غربی", "لرستان", "همدان"],
+    "شرق": ["خراسان رضوی", "خراسان شمالی", "خراسان جنوبی", "سیستان و بلوچستان", "کرمان"],
+    "مرکز": ["تهران", "اصفهان", "البرز", "سمنان", "یزد", "زنجان", "قم", "مرکزی", "قزوین"],
+    "جنوب‌غرب": ["خوزستان", "چهارمحال و بختیاری", "کهگیلویه و بویراحمد", "بوشهر"],
+    "شمال‌غرب": ["آذربایجان شرقی", "آذربایجان غربی", "اردبیل", "زنجان"],
+}
+
+# ==================== متادیتای استان‌ها ====================
+province_metadata = {
+    "تهران": {"code": "01", "region": "مرکز", "area_km2": 18814, "population": 13900000},
+    "البرز": {"code": "30", "region": "مرکز", "area_km2": 5833, "population": 2712000},
+    "اصفهان": {"code": "04", "region": "مرکز", "area_km2": 107029, "population": 5120000},
+    "فارس": {"code": "07", "region": "جنوب", "area_km2": 122608, "population": 4851000},
+    "خراسان رضوی": {"code": "09", "region": "شرق", "area_km2": 118884, "population": 6434000},
+    "خراسان شمالی": {"code": "28", "region": "شرق", "area_km2": 28434, "population": 863000},
+    "خراسان جنوبی": {"code": "29", "region": "شرق", "area_km2": 151193, "population": 768000},
+    "آذربایجان شرقی": {"code": "03", "region": "شمال‌غرب", "area_km2": 45650, "population": 3909000},
+    "آذربایجان غربی": {"code": "02", "region": "شمال‌غرب", "area_km2": 37437, "population": 3265000},
+    "خوزستان": {"code": "06", "region": "جنوب‌غرب", "area_km2": 64055, "population": 4710000},
+    "مازندران": {"code": "12", "region": "شمال", "area_km2": 23842, "population": 3283000},
+    "گیلان": {"code": "11", "region": "شمال", "area_km2": 14042, "population": 2530000},
+    "گلستان": {"code": "27", "region": "شمال", "area_km2": 20367, "population": 1868000},
+    "کرمان": {"code": "08", "region": "شرق", "area_km2": 180726, "population": 3164000},
+    "همدان": {"code": "13", "region": "غرب", "area_km2": 19368, "population": 1738000},
+    "یزد": {"code": "21", "region": "مرکز", "area_km2": 129285, "population": 1138000},
+    "زنجان": {"code": "19", "region": "مرکز", "area_km2": 21773, "population": 1057000},
+    "سمنان": {"code": "20", "region": "مرکز", "area_km2": 97491, "population": 702000},
+    "لرستان": {"code": "15", "region": "غرب", "area_km2": 28294, "population": 1760000},
+    "اردبیل": {"code": "24", "region": "شمال‌غرب", "area_km2": 17953, "population": 1270000},
+    "هرمزگان": {"code": "22", "region": "جنوب", "area_km2": 70697, "population": 1776000},
+    "بوشهر": {"code": "18", "region": "جنوب", "area_km2": 23295, "population": 1163000},
+    "سیستان و بلوچستان": {"code": "11", "region": "جنوب", "area_km2": 180726, "population": 2775000},
+    "چهارمحال و بختیاری": {"code": "14", "region": "جنوب‌غرب", "area_km2": 16332, "population": 947000},
+    "ایلام": {"code": "16", "region": "غرب", "area_km2": 20133, "population": 580000},
+    "کهگیلویه و بویراحمد": {"code": "17", "region": "جنوب‌غرب", "area_km2": 15504, "population": 713000},
+    "قزوین": {"code": "26", "region": "مرکز", "area_km2": 15567, "population": 1273000},
+    "قم": {"code": "25", "region": "مرکز", "area_km2": 11240, "population": 1292000},
+    "مرکزی": {"code": "00", "region": "مرکز", "area_km2": 29127, "population": 1429000},
+}
+
+# ==================== مختصات شهرهای مهم ====================
+city_coordinates = {
+    # استان تهران
+    "تهران": (35.6892, 51.3890), "ری": (35.5966, 51.4400), "اسلامشهر": (35.5525, 51.2350),
+    "کرج": (35.8355, 50.9391), "ورامین": (35.3242, 51.6453),
+    
+    # استان اصفهان
+    "اصفهان": (32.6546, 51.6680), "کاشان": (33.9850, 51.4096), "نجف‌آباد": (32.6344, 51.3669),
+    
+    # استان خراسان
+    "مشهد": (36.2972, 59.6067), "نیشابور": (36.2146, 58.7958), "سبزوار": (36.2147, 57.6777),
+    "بجنورد": (37.4748, 57.3292), "بیرجند": (32.8660, 59.2211),
+    
+    # استان فارس
+    "شیراز": (29.5918, 52.5837), "مرودشت": (29.8747, 52.8042), "جهرم": (28.5034, 53.5605),
+    
+    # استان آذربایجان
+    "تبریز": (38.0800, 46.2937), "مراغه": (37.3891, 46.2398), "ارومیه": (37.6648, 45.3750),
+    "اردبیل": (38.2498, 48.2933),
+    
+    # استان خوزستان
+    "اهواز": (31.3640, 48.6733), "آبادان": (30.3399, 48.2969), "دزفول": (32.3811, 48.4050),
+    
+    # استان‌های شمالی
+    "رشت": (37.2760, 49.5886), "ساری": (36.5633, 53.0601), "بابل": (36.5496, 52.6780),
+    "آمل": (36.4725, 52.3506), "گرگان": (36.8451, 54.4399),
+    
+    # سایر مراکز استان
+    "کرمان": (30.2839, 57.0838), "همدان": (34.8100, 48.5150), "یزد": (31.8974, 54.3569),
+    "زنجان": (36.6736, 48.4787), "بندرعباس": (27.1832, 56.2665), "بوشهر": (28.9238, 50.8201),
+    "اراک": (34.0918, 49.6894), "قم": (34.6399, 50.8758), "سمنان": (35.5800, 53.3933),
+    "شهرکرد": (32.3256, 50.8630), "یاسوج": (30.6676, 51.6052), "ایلام": (33.6374, 46.4227),
+    "سنندج": (35.3095, 46.9992), "خرم‌آباد": (33.4878, 48.3558), "قزوین": (36.2688, 50.0040),
+    "زاهدان": (29.4963, 60.8629),
+}
+
+# ==================== داده کامل شهرها ====================
+city_full_data = {
+    "تهران": {"en_name": "tehran", "coords": (35.6892, 51.3890), "province": "تهران"},
+    "اصفهان": {"en_name": "isfahan", "coords": (32.6546, 51.6680), "province": "اصفهان"},
+    "مشهد": {"en_name": "mashhad", "coords": (36.2972, 59.6067), "province": "خراسان رضوی"},
+    "شیراز": {"en_name": "shiraz", "coords": (29.5918, 52.5837), "province": "فارس"},
+    "تبریز": {"en_name": "tabriz", "coords": (38.0800, 46.2937), "province": "آذربایجان شرقی"},
+    "اهواز": {"en_name": "ahvaz", "coords": (31.3640, 48.6733), "province": "خوزستان"},
+    "کرج": {"en_name": "karaj", "coords": (35.8355, 50.9391), "province": "البرز"},
+    "کرمانشاه": {"en_name": "kermanshah", "coords": (34.6731, 46.5588), "province": "کرمانشاه"},
+    "قم": {"en_name": "qom", "coords": (34.6399, 50.8758), "province": "قم"},
+    "ارومیه": {"en_name": "urmia", "coords": (37.6648, 45.3750), "province": "آذربایجان غربی"},
+    "رشت": {"en_name": "rasht", "coords": (37.2760, 49.5886), "province": "گیلان"},
+    "زاهدان": {"en_name": "zahedan", "coords": (29.4963, 60.8629), "province": "سیستان و بلوچستان"},
+    "کرمان": {"en_name": "kerman", "coords": (30.2839, 57.0838), "province": "کرمان"},
+    "اراک": {"en_name": "arak", "coords": (34.0918, 49.6894), "province": "مرکزی"},
+    "همدان": {"en_name": "hamedan", "coords": (34.8100, 48.5150), "province": "همدان"},
+    "یزد": {"en_name": "yazd", "coords": (31.8974, 54.3569), "province": "یزد"},
+    "اردبیل": {"en_name": "ardabil", "coords": (38.2498, 48.2933), "province": "اردبیل"},
+    "بندرعباس": {"en_name": "bandar abbas", "coords": (27.1832, 56.2665), "province": "هرمزگان"},
+    "بوشهر": {"en_name": "bushehr", "coords": (28.9238, 50.8201), "province": "بوشهر"},
+    "ساری": {"en_name": "sari", "coords": (36.5633, 53.0601), "province": "مازندران"},
+    "سمنان": {"en_name": "semnan", "coords": (35.5800, 53.3933), "province": "سمنان"},
+    "سنندج": {"en_name": "sanandaj", "coords": (35.3095, 46.9992), "province": "کردستان"},
+    "شهرکرد": {"en_name": "shahrekord", "coords": (32.3256, 50.8630), "province": "چهارمحال و بختیاری"},
+    "قزوین": {"en_name": "qazvin", "coords": (36.2688, 50.0040), "province": "قزوین"},
+    "گرگان": {"en_name": "gorgan", "coords": (36.8451, 54.4399), "province": "گلستان"},
+    "خرم‌آباد": {"en_name": "khorramabad", "coords": (33.4878, 48.3558), "province": "لرستان"},
+    "یاسوج": {"en_name": "yasuj", "coords": (30.6676, 51.6052), "province": "کهگیلویه و بویراحمد"},
+    "بجنورد": {"en_name": "bojnord", "coords": (37.4748, 57.3292), "province": "خراسان شمالی"},
+    "بیرجند": {"en_name": "birjand", "coords": (32.8660, 59.2211), "province": "خراسان جنوبی"},
+    "زنجان": {"en_name": "zanjan", "coords": (36.6736, 48.4787), "province": "زنجان"},
+    "ایلام": {"en_name": "ilam", "coords": (33.6374, 46.4227), "province": "ایلام"},
+}
+
+# ==================== لیست کامل شهرها (فارسی) ====================
+iran_cities_fa = sorted(list(set(iran_cities.keys()) | set(
+    [city for cities in provinces_and_cities.values() for city in cities]
+)))
+
+# ==================== لیست کامل شهرها (انگلیسی) ====================
+iran_cities_en = sorted([iran_cities.get(city, city).title() for city in iran_cities_fa if city in iran_cities] + [
+    "Arak", "Qom", "Gorgan", "Sanandaj", "Ilam", "Yasuj", "Shahrekord", "Birjand", "Bojnord"
+])
+iran_cities_en = list(set(iran_cities_en))
+
+# ==================== جمعیت شهرها ====================
+city_population = {
+    "تهران": 8846782, "مشهد": 3001184, "اصفهان": 1961260, "کرج": 1592492,
+    "شیراز": 1565572, "تبریز": 1558693, "قم": 1201158, "اهواز": 1184788,
+    "کرمانشاه": 946651, "ارومیه": 736224, "رشت": 679995, "زاهدان": 587730,
+    "همدان": 554406, "کرمان": 537718, "یزد": 529673, "اردبیل": 529374,
+    "بندرعباس": 526648, "اراک": 520944, "اسلامشهر": 448129, "زنجان": 430871,
+    "سنندج": 412767, "قزوین": 402748, "خرم‌آباد": 373416, "گرگان": 350676,
+    "ساری": 309820, "کاشان": 304487, "نجف‌آباد": 235281, "خمینی‌شهر": 247128,
+    "شاهین‌شهر": 173329, "مرودشت": 138649, "جهرم": 141634, "فسا": 110825,
+    "آبادان": 231476, "دزفول": 264709, "بهبهان": 122604, "بابل": 250217,
+    "آمل": 237528, "قائم‌شهر": 204953, "چالوس": 65354, "لاهیجان": 103687,
+    "گنبد کاووس": 151910, "مراغه": 175255, "میاندوآب": 134425, "بوکان": 193501,
+    "سقز": 165258, "رفسنجان": 161909, "سیرجان": 199704, "جیرفت": 130851,
+    "بم": 127396, "ملایر": 170237, "نهاوند": 76162, "بروجرد": 234997,
+    "الیگودرز": 89807, "شاهرود": 150129, "دامغان": 59930, "میبد": 80712,
+    "اردکان": 77946, "ابهر": 99450, "خوی": 200958, "مهاباد": 168393,
+    "سلماس": 92811, "نیشابور": 264375, "سبزوار": 243700, "تربت حیدریه": 140019,
+    "قوچان": 101604, "کازرون": 96683, "لارستان": 79742, "نورآباد": 65000,
+    "اقلید": 55372, "پارس‌آباد": 93957, "مشگین‌شهر": 74109, "خلخال": 41657,
+    "میناب": 80000, "قشم": 47120, "کیش": 39853, "گناوه": 64793, "برازجان": 95392,
+    "دهلران": 32418, "مهران": 12540, "تاکستان": 77907, "آبیک": 60927,
+    "ساوه": 220762, "خمین": 72882, "محلات": 43113, "فردیس": 181174,
+    "گلستان": 27000, "بهارستان": 88000, "قدس": 311117, "قرچک": 231075,
+    "ورامین": 225628, "ملارد": 333500, "پردیس": 100000, "بومهن": 79034,
+}
+
+# ==================== پیش‌شماره اپراتورهای سیم‌کارت ====================
+sim_card_prefixes = {
+    "همراه اول": ["0910", "0911", "0912", "0913", "0914", "0915", "0916", "0917", "0918", "0919",
+                   "0901", "0902", "0903", "0904", "0905", "0906", "0930", "0933", "0936", "0939"],
+    "ایرانسل": ["0921", "0922", "0923", "0935", "0937", "0938", "0941", "0900"],
+    "رایتل": ["0920", "0924", "0925", "0926", "0927", "0928", "0929"],
+    "آپتل": ["0990", "0991", "0992", "0993", "0994"],
+    "شاتل موبایل": ["0995", "0996"],
+    "اسپادان": ["0998"],
+    "تله‌کیش": ["0934"],
+    "سامانتل": ["0999"],
+    "لوتوس تل": ["0931"],
+    "واعظ": ["0922"],
+    "آذرتل": ["0923"],
+    "صبا ایده": ["0997"],
+}
+
+sim_card_prefixes_list = sorted(set([p for prefixes in sim_card_prefixes.values() for p in prefixes]))
+
+# ==================== پیش‌شماره تلفن ثابت (کد شهرها) ====================
+city_phone_codes = {
+    "تهران": "021", "ری": "021", "اسلامشهر": "021", "ورامین": "021", "شهریار": "021",
+    "کرج": "026", "فردیس": "026", "اشتهارد": "026", "طالقان": "026",
+    "اصفهان": "031", "کاشان": "031", "نجف‌آباد": "031", "خمینی‌شهر": "031",
+    "مشهد": "051", "نیشابور": "051", "سبزوار": "051", "تربت حیدریه": "051",
+    "شیراز": "071", "مرودشت": "071", "جهرم": "071", "فسا": "071",
+    "تبریز": "041", "مراغه": "041", "مرند": "041", "میانه": "041",
+    "اهواز": "061", "آبادان": "061", "دزفول": "061", "اندیمشک": "061",
+    "کرمانشاه": "083", "اسلام‌آباد غرب": "083", "سنقر": "083",
+    "ساری": "011", "بابل": "011", "آمل": "011", "قائم‌شهر": "011",
+    "رشت": "013", "لاهیجان": "013", "انزلی": "013", "رودسر": "013",
+    "ارومیه": "044", "خوی": "044", "بوکان": "044", "مهاباد": "044",
+    "کرمان": "034", "سیرجان": "034", "رفسنجان": "034", "جیرفت": "034",
+    "همدان": "081", "ملایر": "081", "نهاوند": "081", "تويسركان": "081",
+    "یزد": "035", "میبد": "035", "اردکان": "035", "بافق": "035",
+    "زنجان": "024", "ابهر": "024", "خرمدره": "024",
+    "سمنان": "023", "شاهرود": "023", "دامغان": "023",
+    "لرستان": "066", "بروجرد": "066", "دورود": "066", "الیگودرز": "066",
+    "اردبیل": "045", "مشگین‌شهر": "045", "پارس‌آباد": "045",
+    "بندرعباس": "076", "میناب": "076", "قشم": "076", "کیش": "076",
+    "بوشهر": "077", "برازجان": "077", "گناوه": "077",
+    "زاهدان": "054", "زابل": "054", "چابهار": "054", "ایرانشهر": "054",
+    "شهرکرد": "038", "بروجن": "038", "اردل": "038",
+    "ایلام": "084", "دهلران": "084", "مهران": "084",
+    "یاسوج": "074", "گچساران": "074", "دهدشت": "074",
+    "قزوین": "028", "الوند": "028", "آبیک": "028", "تاکستان": "028",
+    "قم": "025", "جعفریه": "025",
+    "اراک": "086", "ساوه": "086", "خمین": "086", "محلات": "086",
+    "گرگان": "017", "گنبد کاووس": "017", "علی‌آباد کتول": "017",
+    "سنندج": "087", "مریوان": "087", "سقز": "087", "بانه": "087",
+    "بجنورد": "058", "شیروان": "058", "اسفراین": "058",
+    "بیرجند": "056", "قائن": "056", "فردوس": "056", "طبس": "056",
+}
+
+# ==================== کد پلاک خودرو ====================
+car_plate_codes = {
+    "تهران": ["11", "12", "22", "33", "44", "55", "66", "77", "88", "99", "10", "20", "30", "40", "50"],
+    "البرز": ["21", "81", "91"],
+    "اصفهان": ["43", "53", "63", "73", "83", "93"],
+    "فارس": ["63", "73", "83", "93"],
+    "خراسان رضوی": ["12", "32", "42", "52", "73", "82"],
+    "خراسان شمالی": ["26", "36"],
+    "خراسان جنوبی": ["26", "36"],
+    "آذربایجان شرقی": ["15", "25", "35", "45", "55", "65", "75", "85", "95"],
+    "آذربایجان غربی": ["17", "27", "37", "47", "57", "67", "77", "87"],
+    "خوزستان": ["14", "24", "34", "44", "54", "64", "74", "84", "94"],
+    "مازندران": ["15", "25", "35", "45", "55", "62", "72"],
+    "گیلان": ["16", "26", "36", "46", "56", "66", "76", "86", "96"],
+    "گلستان": ["26", "36", "46"],
+    "کرمان": ["15", "25", "35", "45", "55", "65", "75"],
+    "همدان": ["18", "28", "38", "48"],
+    "یزد": ["14", "24", "34", "44", "54"],
+    "زنجان": ["27", "37", "47"],
+    "سمنان": ["26", "36", "46", "56"],
+    "لرستان": ["13", "23", "33", "43"],
+    "اردبیل": ["13", "23", "33", "43"],
+    "هرمزگان": ["18", "28", "38", "48", "58"],
+    "بوشهر": ["18", "28", "38", "48"],
+    "سیستان و بلوچستان": ["15", "25", "35", "45", "55"],
+    "چهارمحال و بختیاری": ["31", "41", "51"],
+    "ایلام": ["18", "28", "38"],
+    "کهگیلویه و بویراحمد": ["23", "33", "43"],
+    "قزوین": ["18", "28", "38", "48"],
+    "قم": ["15", "25", "35", "45"],
+    "مرکزی": ["17", "27", "37", "47"],
+    "کردستان": ["11", "21", "31", "41"],
+}
+
+# ==================== توابع کمکی ====================
+def get_province_of_city(city_fa: str) -> str:
+    """دریافت نام استان بر اساس نام شهر فارسی"""
+    for province, cities in provinces_and_cities.items():
+        if city_fa in cities:
+            return province
+    return None
+
+def get_city_coords(city_fa: str) -> tuple:
+    """دریافت مختصات جغرافیایی شهر"""
+    return city_coordinates.get(city_fa, (None, None))
+
+def search_city(query: str) -> dict:
+    """جستجوی شهر (به فارسی یا انگلیسی)"""
+    query = query.lower().strip()
+    results = {}
+    for fa, en in iran_cities.items():
+        if query in fa.lower() or query in en.lower():
+            results[fa] = {
+                "en": en,
+                "province": get_province_of_city(fa),
+                "coords": get_city_coords(fa),
+                "population": get_city_population(fa)
+            }
+    return results
+
+def get_provinces_by_region(region_fa: str) -> list:
+    """دریافت استان‌های یک منطقه"""
+    return regions.get(region_fa, [])
+
+def get_city_population(city_fa: str) -> int:
+    """دریافت جمعیت شهر"""
+    return city_population.get(city_fa, 0)
+
+def get_sim_operator(prefix: str) -> str:
+    """دریافت نام اپراتور بر اساس پیش‌شماره (مثال: 0912 -> همراه اول)"""
+    if not prefix.startswith("09"):
+        prefix = "09" + prefix if len(prefix) == 2 else prefix
+    for operator, prefixes in sim_card_prefixes.items():
+        if prefix in prefixes:
+            return operator
+    return "ناشناس"
+
+def get_city_phone_code(city_fa: str) -> str:
+    """دریافت کد تلفن ثابت شهر (مثال: تهران -> 021)"""
+    return city_phone_codes.get(city_fa, "نامشخص")
+
+def get_car_plate_codes(province_fa: str) -> list:
+    """دریافت کدهای پلاک خودروی استان (مثال: تهران -> ['11', '12', ...])"""
+    return car_plate_codes.get(province_fa, [])
+
+def get_city_full_info(city_fa: str) -> dict:
+    """دریافت اطلاعات کامل یک شهر"""
+    return {
+        "name_fa": city_fa,
+        "name_en": iran_cities.get(city_fa, "unknown"),
+        "province": get_province_of_city(city_fa),
+        "population": get_city_population(city_fa),
+        "coords": get_city_coords(city_fa),
+        "phone_code": get_city_phone_code(city_fa)
+    }
+