egydata 1.0.0__tar.gz

egydata-1.0.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 InnoSoft
+CEO & Founder: Mohamed Ahmed Ghanam
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

egydata-1.0.0/PKG-INFO

@@ -0,0 +1,234 @@
+Metadata-Version: 2.4
+Name: egydata
+Version: 1.0.0
+Summary: Python library created by InnoSoft-Company tech team for Egyptian data: cities, governorates, timezones, phone numbers, etc.
+Home-page: https://www.midoghanam.site/
+Author: InnoSoft Company
+Author-email: InnoSoft Company <midoghanam@hotmail.com>, Mohammed Ahmed Ghanam <midoghanam@hotmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 InnoSoft
+        CEO & Founder: Mohamed Ahmed Ghanam
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Keywords: egypt,data,cities,governorates,timezone,phone numbers
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# Egydata
+
+[![PyPI Version](https://img.shields.io/pypi/v/egydata.svg)](https://pypi.org/project/egydata/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/egydata.svg)](https://pypi.org/project/egydata/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/InnoSoft-Company/egydata/blob/main/LICENSE)
+
+Structured Egyptian geographical and timezone data for Python.
+
+Provides a complete, offline dataset of Egyptian governorates, cities, landline and mobile area codes, and timezone utilities — with zero dependencies (uses Python standard library only).
+
+[View on GitHub](https://github.com/InnoSoft-Company/egydata) | [View on PyPI](https://pypi.org/project/egydata/)
+
+---
+
+## Installation
+
+```bash
+pip install egydata
+```
+
+Quick Start
+
+```python
+from egydata import governorates, cities, phoneArea, timezone
+
+# Get all governorates
+all_govs = governorates.get_all()
+
+# Find a city by name
+maadi = cities.search("Maadi")
+
+# Check current time in Egypt
+now = timezone.now()
+```
+
+---
+
+Usage
+
+Governorates
+
+```python
+from egydata import governorates
+
+# Get all 27 governorates
+all_govs = governorates.get_all()
+# [{'id': 1, 'code': 'CAI', 'name': 'القاهرة', 'nameEn': 'Cairo'}, ...]
+
+# Find by code
+cairo = governorates.get_by_code("CAI")
+# {'id': 1, 'code': 'CAI', 'name': 'القاهرة', 'nameEn': 'Cairo'}
+
+# Find by id
+alex = governorates.get_by_id(2)
+# {'id': 2, 'code': 'ALX', 'name': 'الإسكندرية', 'nameEn': 'Alexandria'}
+
+# Search (Arabic, English, or code, partial match)
+results = governorates.search("alex")
+# [{'id': 2, 'code': 'ALX', 'name': 'الإسكندرية', 'nameEn': 'Alexandria'}]
+
+ar_results = governorates.search("القاهرة")
+# [{'id': 1, 'code': 'CAI', 'name': 'القاهرة', 'nameEn': 'Cairo'}]
+```
+
+Cities
+
+```python
+from egydata import cities
+
+# Get cities by governorate code
+cairo_cities = cities.get_by_governorate("CAI")
+# [{'id': 1, 'name': 'مدينة نصر', 'nameEn': 'Nasr City', 'governorateCode': 'CAI'}, ...]
+
+# Find by id
+sharm = cities.get_by_id(131)
+# {'id': 131, 'name': 'شرم الشيخ', 'nameEn': 'Sharm El Sheikh', 'governorateCode': 'SIS'}
+
+# Search cities (Arabic or English, partial match)
+found = cities.search("Maadi")
+# [{'id': 3, 'name': 'المعادي', 'nameEn': 'Maadi', 'governorateCode': 'CAI'}]
+```
+
+Phone Area Codes
+
+```python
+from egydata import phoneArea
+
+# Get all area codes (landline and mobile)
+all_codes = phoneArea.get_all()
+# [{'code': '010', 'region': 'ڤودافون', 'regionEn': 'Vodafone'}, ...]
+
+# Look up region by code
+region = phoneArea.get_region("03")
+# {'code': '03', 'region': 'الإسكندرية', 'regionEn': 'Alexandria'}
+
+# Find area code by region name (Arabic or English)
+entry = phoneArea.get_code("Mansoura")
+# {'code': '050', 'region': 'الدقهلية (المنصورة)', 'regionEn': 'Dakahlia (Mansoura)'}
+```
+
+Timezone
+
+```python
+from egydata import timezone
+
+print(timezone.name)      # 'Africa/Cairo'
+print(timezone.offset)    # '+02:00' (standard time offset)
+
+now = timezone.now()      # current date/time in Egypt (timezone-aware datetime)
+print(now.isoformat())
+
+# Check if daylight saving time is active (Egypt resumed DST in 2023)
+is_dst = timezone.isDST() # returns True if current offset is +03:00
+
+# Optionally check a specific date
+from datetime import datetime
+date = datetime(2024, 8, 1)
+print(timezone.isDST(date))  # True (during DST period)
+```
+
+---
+
+API Reference
+
+governorates
+
+Method Parameters Returns Description
+get_all() – list[Governorate] Returns all 27 Egyptian governorates.
+get_by_code(code) code: str Governorate \| None Find governorate by its code (e.g., 'CAI').
+get_by_id(id) id: int/str Governorate \| None Find governorate by its numeric ID.
+search(query) query: str list[Governorate] Search by Arabic/English name or code (case‑insensitive, partial).
+
+Governorate shape:
+{'id': int, 'code': str, 'name': str, 'nameEn': str}
+
+---
+
+cities
+
+Method Parameters Returns Description
+get_by_governorate(gov_code) gov_code: str list[City] Get all cities in a governorate (by its code).
+get_by_id(id) id: int/str City \| None Find city by its numeric ID.
+search(query) query: str list[City] Search by Arabic or English name (partial, case‑insensitive).
+
+City shape:
+{'id': int, 'name': str, 'nameEn': str, 'governorateCode': str}
+
+---
+
+phoneArea
+
+Method Parameters Returns Description
+get_all() – list[AreaCode] Returns all landline and mobile area codes.
+get_region(code) code: str AreaCode \| None Look up region info by area code.
+get_code(region_name) region_name: str AreaCode \| None Find area code entry by region name (Arabic or English).
+
+AreaCode shape:
+{'code': str, 'region': str, 'regionEn': str}
+
+---
+
+timezone
+
+Property / Method Returns Description
+name 'Africa/Cairo' IANA timezone identifier.
+offset '+02:00' Standard UTC offset (without DST).
+now() datetime Current date and time in Egypt (timezone‑aware).
+isDST(date=None) bool Whether DST is active (for given date or now).
+
+---
+
+Data Coverage
+
+· 27 governorates with Arabic and English names and ISO‑like codes.
+· 151 cities and districts across all governorates.
+· 30 landline and mobile area codes (including mobile operators).
+· Full timezone support for Africa/Cairo (DST‑aware).
+
+All data is embedded in the package – no network requests, no external dependencies.
+
+---
+
+Requirements
+
+· Python 3.9 or later (uses standard library zoneinfo; for Python 3.8 you may need the backports.zoneinfo package).
+
+---
+
+License
+
+MIT
+
+```

egydata-1.0.0/README.md

@@ -0,0 +1,193 @@
+# Egydata
+
+[![PyPI Version](https://img.shields.io/pypi/v/egydata.svg)](https://pypi.org/project/egydata/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/egydata.svg)](https://pypi.org/project/egydata/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/InnoSoft-Company/egydata/blob/main/LICENSE)
+
+Structured Egyptian geographical and timezone data for Python.
+
+Provides a complete, offline dataset of Egyptian governorates, cities, landline and mobile area codes, and timezone utilities — with zero dependencies (uses Python standard library only).
+
+[View on GitHub](https://github.com/InnoSoft-Company/egydata) | [View on PyPI](https://pypi.org/project/egydata/)
+
+---
+
+## Installation
+
+```bash
+pip install egydata
+```
+
+Quick Start
+
+```python
+from egydata import governorates, cities, phoneArea, timezone
+
+# Get all governorates
+all_govs = governorates.get_all()
+
+# Find a city by name
+maadi = cities.search("Maadi")
+
+# Check current time in Egypt
+now = timezone.now()
+```
+
+---
+
+Usage
+
+Governorates
+
+```python
+from egydata import governorates
+
+# Get all 27 governorates
+all_govs = governorates.get_all()
+# [{'id': 1, 'code': 'CAI', 'name': 'القاهرة', 'nameEn': 'Cairo'}, ...]
+
+# Find by code
+cairo = governorates.get_by_code("CAI")
+# {'id': 1, 'code': 'CAI', 'name': 'القاهرة', 'nameEn': 'Cairo'}
+
+# Find by id
+alex = governorates.get_by_id(2)
+# {'id': 2, 'code': 'ALX', 'name': 'الإسكندرية', 'nameEn': 'Alexandria'}
+
+# Search (Arabic, English, or code, partial match)
+results = governorates.search("alex")
+# [{'id': 2, 'code': 'ALX', 'name': 'الإسكندرية', 'nameEn': 'Alexandria'}]
+
+ar_results = governorates.search("القاهرة")
+# [{'id': 1, 'code': 'CAI', 'name': 'القاهرة', 'nameEn': 'Cairo'}]
+```
+
+Cities
+
+```python
+from egydata import cities
+
+# Get cities by governorate code
+cairo_cities = cities.get_by_governorate("CAI")
+# [{'id': 1, 'name': 'مدينة نصر', 'nameEn': 'Nasr City', 'governorateCode': 'CAI'}, ...]
+
+# Find by id
+sharm = cities.get_by_id(131)
+# {'id': 131, 'name': 'شرم الشيخ', 'nameEn': 'Sharm El Sheikh', 'governorateCode': 'SIS'}
+
+# Search cities (Arabic or English, partial match)
+found = cities.search("Maadi")
+# [{'id': 3, 'name': 'المعادي', 'nameEn': 'Maadi', 'governorateCode': 'CAI'}]
+```
+
+Phone Area Codes
+
+```python
+from egydata import phoneArea
+
+# Get all area codes (landline and mobile)
+all_codes = phoneArea.get_all()
+# [{'code': '010', 'region': 'ڤودافون', 'regionEn': 'Vodafone'}, ...]
+
+# Look up region by code
+region = phoneArea.get_region("03")
+# {'code': '03', 'region': 'الإسكندرية', 'regionEn': 'Alexandria'}
+
+# Find area code by region name (Arabic or English)
+entry = phoneArea.get_code("Mansoura")
+# {'code': '050', 'region': 'الدقهلية (المنصورة)', 'regionEn': 'Dakahlia (Mansoura)'}
+```
+
+Timezone
+
+```python
+from egydata import timezone
+
+print(timezone.name)      # 'Africa/Cairo'
+print(timezone.offset)    # '+02:00' (standard time offset)
+
+now = timezone.now()      # current date/time in Egypt (timezone-aware datetime)
+print(now.isoformat())
+
+# Check if daylight saving time is active (Egypt resumed DST in 2023)
+is_dst = timezone.isDST() # returns True if current offset is +03:00
+
+# Optionally check a specific date
+from datetime import datetime
+date = datetime(2024, 8, 1)
+print(timezone.isDST(date))  # True (during DST period)
+```
+
+---
+
+API Reference
+
+governorates
+
+Method Parameters Returns Description
+get_all() – list[Governorate] Returns all 27 Egyptian governorates.
+get_by_code(code) code: str Governorate \| None Find governorate by its code (e.g., 'CAI').
+get_by_id(id) id: int/str Governorate \| None Find governorate by its numeric ID.
+search(query) query: str list[Governorate] Search by Arabic/English name or code (case‑insensitive, partial).
+
+Governorate shape:
+{'id': int, 'code': str, 'name': str, 'nameEn': str}
+
+---
+
+cities
+
+Method Parameters Returns Description
+get_by_governorate(gov_code) gov_code: str list[City] Get all cities in a governorate (by its code).
+get_by_id(id) id: int/str City \| None Find city by its numeric ID.
+search(query) query: str list[City] Search by Arabic or English name (partial, case‑insensitive).
+
+City shape:
+{'id': int, 'name': str, 'nameEn': str, 'governorateCode': str}
+
+---
+
+phoneArea
+
+Method Parameters Returns Description
+get_all() – list[AreaCode] Returns all landline and mobile area codes.
+get_region(code) code: str AreaCode \| None Look up region info by area code.
+get_code(region_name) region_name: str AreaCode \| None Find area code entry by region name (Arabic or English).
+
+AreaCode shape:
+{'code': str, 'region': str, 'regionEn': str}
+
+---
+
+timezone
+
+Property / Method Returns Description
+name 'Africa/Cairo' IANA timezone identifier.
+offset '+02:00' Standard UTC offset (without DST).
+now() datetime Current date and time in Egypt (timezone‑aware).
+isDST(date=None) bool Whether DST is active (for given date or now).
+
+---
+
+Data Coverage
+
+· 27 governorates with Arabic and English names and ISO‑like codes.
+· 151 cities and districts across all governorates.
+· 30 landline and mobile area codes (including mobile operators).
+· Full timezone support for Africa/Cairo (DST‑aware).
+
+All data is embedded in the package – no network requests, no external dependencies.
+
+---
+
+Requirements
+
+· Python 3.9 or later (uses standard library zoneinfo; for Python 3.8 you may need the backports.zoneinfo package).
+
+---
+
+License
+
+MIT
+
+```

egydata-1.0.0/egydata/__init__.py

@@ -0,0 +1,4 @@
+from . import *
+
+
+__version__ = "1.0.0"

egydata-1.0.0/egydata/cities.py

@@ -0,0 +1,212 @@
+cities = [
+  # Cairo (CAI)
+  {"id": 1, "name": "مدينة نصر", "nameEn": "Nasr City", "governorateCode": "CAI"},
+  {"id": 2, "name": "مصر الجديدة", "nameEn": "Heliopolis", "governorateCode": "CAI"},
+  {"id": 3, "name": "المعادي", "nameEn": "Maadi", "governorateCode": "CAI"},
+  {"id": 4, "name": "مصر القديمة", "nameEn": "Old Cairo", "governorateCode": "CAI"},
+  {"id": 5, "name": "شبرا", "nameEn": "Shubra", "governorateCode": "CAI"},
+  {"id": 6, "name": "عين شمس", "nameEn": "Ain Shams", "governorateCode": "CAI"},
+  {"id": 7, "name": "حلوان", "nameEn": "Helwan", "governorateCode": "CAI"},
+  {"id": 8, "name": "التجمع الخامس", "nameEn": "Fifth Settlement", "governorateCode": "CAI"},
+  {"id": 9, "name": "القاهرة الجديدة", "nameEn": "New Cairo", "governorateCode": "CAI"},
+  {"id": 10, "name": "المقطم", "nameEn": "Mokattam", "governorateCode": "CAI"},
+  # Alexandria (ALX)
+  {"id": 11, "name": "المنتزه", "nameEn": "Montaza", "governorateCode": "ALX"},
+  {"id": 12, "name": "وسط الإسكندرية", "nameEn": "Downtown Alexandria", "governorateCode": "ALX"},
+  {"id": 13, "name": "العجمي", "nameEn": "Agami", "governorateCode": "ALX"},
+  {"id": 14, "name": "سيدي بشر", "nameEn": "Sidi Bishr", "governorateCode": "ALX"},
+  {"id": 15, "name": "برج العرب", "nameEn": "Borg El Arab", "governorateCode": "ALX"},
+  {"id": 16, "name": "العامرية", "nameEn": "Amreya", "governorateCode": "ALX"},
+  # Giza (GIZ)
+  {"id": 17, "name": "الدقي", "nameEn": "Dokki", "governorateCode": "GIZ"},
+  {"id": 18, "name": "المهندسين", "nameEn": "Mohandessin", "governorateCode": "GIZ"},
+  {"id": 19, "name": "العجوزة", "nameEn": "Agouza", "governorateCode": "GIZ"},
+  {"id": 20, "name": "الهرم", "nameEn": "Haram", "governorateCode": "GIZ"},
+  {"id": 21, "name": "فيصل", "nameEn": "Faisal", "governorateCode": "GIZ"},
+  {"id": 22, "name": "6 أكتوبر", "nameEn": "6th of October", "governorateCode": "GIZ"},
+  {"id": 23, "name": "الشيخ زايد", "nameEn": "Sheikh Zayed", "governorateCode": "GIZ"},
+  {"id": 24, "name": "إمبابة", "nameEn": "Imbaba", "governorateCode": "GIZ"},
+  # Port Said (PTS)
+  {"id": 25, "name": "حي الشرق", "nameEn": "East District", "governorateCode": "PTS"},
+  {"id": 26, "name": "حي العرب", "nameEn": "Arab District", "governorateCode": "PTS"},
+  {"id": 27, "name": "حي الضواحي", "nameEn": "Suburbs District", "governorateCode": "PTS"},
+  {"id": 28, "name": "بورفؤاد", "nameEn": "Port Fouad", "governorateCode": "PTS"},
+  # Suez (SUZ)
+  {"id": 29, "name": "حي السويس", "nameEn": "Suez District", "governorateCode": "SUZ"},
+  {"id": 30, "name": "حي الأربعين", "nameEn": "Arbaeen District", "governorateCode": "SUZ"},
+  {"id": 31, "name": "عتاقة", "nameEn": "Ataka", "governorateCode": "SUZ"},
+  {"id": 32, "name": "حي فيصل", "nameEn": "Faisal District", "governorateCode": "SUZ"},
+  # Dakahlia (DKH)
+  {"id": 33, "name": "المنصورة", "nameEn": "Mansoura", "governorateCode": "DKH"},
+  {"id": 34, "name": "طلخا", "nameEn": "Talkha", "governorateCode": "DKH"},
+  {"id": 35, "name": "ميت غمر", "nameEn": "Mit Ghamr", "governorateCode": "DKH"},
+  {"id": 36, "name": "دكرنس", "nameEn": "Dikirnis", "governorateCode": "DKH"},
+  {"id": 37, "name": "أجا", "nameEn": "Aga", "governorateCode": "DKH"},
+  {"id": 38, "name": "السنبلاوين", "nameEn": "Sinbellawin", "governorateCode": "DKH"},
+  # Sharqia (SHR)
+  {"id": 39, "name": "الزقازيق", "nameEn": "Zagazig", "governorateCode": "SHR"},
+  {"id": 40, "name": "العاشر من رمضان", "nameEn": "10th of Ramadan", "governorateCode": "SHR"},
+  {"id": 41, "name": "بلبيس", "nameEn": "Bilbeis", "governorateCode": "SHR"},
+  {"id": 42, "name": "أبو حماد", "nameEn": "Abu Hammad", "governorateCode": "SHR"},
+  {"id": 43, "name": "منيا القمح", "nameEn": "Minya Al Qamh", "governorateCode": "SHR"},
+  {"id": 44, "name": "فاقوس", "nameEn": "Faqous", "governorateCode": "SHR"},
+  # Qalyubia (QLB)
+  {"id": 45, "name": "بنها", "nameEn": "Benha", "governorateCode": "QLB"},
+  {"id": 46, "name": "شبرا الخيمة", "nameEn": "Shubra El Kheima", "governorateCode": "QLB"},
+  {"id": 47, "name": "قليوب", "nameEn": "Qalyub", "governorateCode": "QLB"},
+  {"id": 48, "name": "القناطر الخيرية", "nameEn": "El Qanater El Khayreya", "governorateCode": "QLB"},
+  {"id": 49, "name": "طوخ", "nameEn": "Toukh", "governorateCode": "QLB"},
+  # Kafr El Sheikh (KFS)
+  {"id": 50, "name": "كفر الشيخ", "nameEn": "Kafr El Sheikh City", "governorateCode": "KFS"},
+  {"id": 51, "name": "دسوق", "nameEn": "Desouk", "governorateCode": "KFS"},
+  {"id": 52, "name": "فوه", "nameEn": "Fuwwah", "governorateCode": "KFS"},
+  {"id": 53, "name": "بيلا", "nameEn": "Bella", "governorateCode": "KFS"},
+  # Gharbia (GHR)
+  {"id": 54, "name": "طنطا", "nameEn": "Tanta", "governorateCode": "GHR"},
+  {"id": 55, "name": "المحلة الكبرى", "nameEn": "El Mahalla El Kubra", "governorateCode": "GHR"},
+  {"id": 56, "name": "كفر الزيات", "nameEn": "Kafr El Zayat", "governorateCode": "GHR"},
+  {"id": 57, "name": "زفتى", "nameEn": "Zefta", "governorateCode": "GHR"},
+  {"id": 58, "name": "السنطة", "nameEn": "Santa", "governorateCode": "GHR"},
+  # Monufia (MNF)
+  {"id": 59, "name": "شبين الكوم", "nameEn": "Shebin El Kom", "governorateCode": "MNF"},
+  {"id": 60, "name": "منوف", "nameEn": "Menouf", "governorateCode": "MNF"},
+  {"id": 61, "name": "أشمون", "nameEn": "Ashmoun", "governorateCode": "MNF"},
+  {"id": 62, "name": "السادات", "nameEn": "Sadat City", "governorateCode": "MNF"},
+  {"id": 63, "name": "تلا", "nameEn": "Tala", "governorateCode": "MNF"},
+  # Beheira (BHR)
+  {"id": 64, "name": "دمنهور", "nameEn": "Damanhour", "governorateCode": "BHR"},
+  {"id": 65, "name": "كفر الدوار", "nameEn": "Kafr El Dawar", "governorateCode": "BHR"},
+  {"id": 66, "name": "رشيد", "nameEn": "Rashid", "governorateCode": "BHR"},
+  {"id": 67, "name": "إدكو", "nameEn": "Edku", "governorateCode": "BHR"},
+  {"id": 68, "name": "أبو المطامير", "nameEn": "Abu El Matamir", "governorateCode": "BHR"},
+  # Ismailia (ISM)
+  {"id": 69, "name": "الإسماعيلية", "nameEn": "Ismailia City", "governorateCode": "ISM"},
+  {"id": 70, "name": "فايد", "nameEn": "Fayed", "governorateCode": "ISM"},
+  {"id": 71, "name": "القنطرة شرق", "nameEn": "Qantara East", "governorateCode": "ISM"},
+  {"id": 72, "name": "التل الكبير", "nameEn": "Tell El Kebir", "governorateCode": "ISM"},
+  # Damietta (DMT)
+  {"id": 73, "name": "دمياط", "nameEn": "Damietta City", "governorateCode": "DMT"},
+  {"id": 74, "name": "دمياط الجديدة", "nameEn": "New Damietta", "governorateCode": "DMT"},
+  {"id": 75, "name": "رأس البر", "nameEn": "Ras El Bar", "governorateCode": "DMT"},
+  {"id": 76, "name": "فارسكور", "nameEn": "Faraskour", "governorateCode": "DMT"},
+  # Faiyum (FYM)
+  {"id": 77, "name": "الفيوم", "nameEn": "Faiyum City", "governorateCode": "FYM"},
+  {"id": 78, "name": "إطسا", "nameEn": "Etsa", "governorateCode": "FYM"},
+  {"id": 79, "name": "طامية", "nameEn": "Tamiya", "governorateCode": "FYM"},
+  {"id": 80, "name": "سنورس", "nameEn": "Snouris", "governorateCode": "FYM"},
+  # Beni Suef (BNS)
+  {"id": 81, "name": "بني سويف", "nameEn": "Beni Suef City", "governorateCode": "BNS"},
+  {"id": 82, "name": "الواسطى", "nameEn": "El Wasta", "governorateCode": "BNS"},
+  {"id": 83, "name": "ناصر", "nameEn": "Nasser", "governorateCode": "BNS"},
+  {"id": 84, "name": "إهناسيا", "nameEn": "Ehnasia", "governorateCode": "BNS"},
+  # Minya (MNY)
+  {"id": 85, "name": "المنيا", "nameEn": "Minya City", "governorateCode": "MNY"},
+  {"id": 86, "name": "ملوي", "nameEn": "Mallawi", "governorateCode": "MNY"},
+  {"id": 87, "name": "سمالوط", "nameEn": "Samalut", "governorateCode": "MNY"},
+  {"id": 88, "name": "المنيا الجديدة", "nameEn": "New Minya", "governorateCode": "MNY"},
+  {"id": 89, "name": "أبو قرقاص", "nameEn": "Abu Qurqas", "governorateCode": "MNY"},
+  # Asyut (AST)
+  {"id": 90, "name": "أسيوط", "nameEn": "Asyut City", "governorateCode": "AST"},
+  {"id": 91, "name": "ديروط", "nameEn": "Dairut", "governorateCode": "AST"},
+  {"id": 92, "name": "القوصية", "nameEn": "El Qusiya", "governorateCode": "AST"},
+  {"id": 93, "name": "منفلوط", "nameEn": "Manfalut", "governorateCode": "AST"},
+  {"id": 94, "name": "أبنوب", "nameEn": "Abnoub", "governorateCode": "AST"},
+  # Sohag (SHG)
+  {"id": 95, "name": "سوهاج", "nameEn": "Sohag City", "governorateCode": "SHG"},
+  {"id": 96, "name": "أخميم", "nameEn": "Akhmim", "governorateCode": "SHG"},
+  {"id": 97, "name": "جرجا", "nameEn": "Girga", "governorateCode": "SHG"},
+  {"id": 98, "name": "طهطا", "nameEn": "Tahta", "governorateCode": "SHG"},
+  {"id": 99, "name": "المراغة", "nameEn": "El Maragha", "governorateCode": "SHG"},
+  # Qena (QNA)
+  {"id": 100, "name": "قنا", "nameEn": "Qena City", "governorateCode": "QNA"},
+  {"id": 101, "name": "نجع حمادي", "nameEn": "Nag Hammadi", "governorateCode": "QNA"},
+  {"id": 102, "name": "دشنا", "nameEn": "Dishna", "governorateCode": "QNA"},
+  {"id": 103, "name": "قوص", "nameEn": "Qus", "governorateCode": "QNA"},
+  # Luxor (LXR)
+  {"id": 104, "name": "الأقصر", "nameEn": "Luxor City", "governorateCode": "LXR"},
+  {"id": 105, "name": "إسنا", "nameEn": "Esna", "governorateCode": "LXR"},
+  {"id": 106, "name": "أرمنت", "nameEn": "Armant", "governorateCode": "LXR"},
+  {"id": 107, "name": "الطود", "nameEn": "El Tod", "governorateCode": "LXR"},
+    # Aswan (ASN)
+    {"id": 108, "name": "أسوان", "nameEn": "Aswan City", "governorateCode": "ASN"},
+    {"id": 109, "name": "كوم أمبو", "nameEn": "Kom Ombo", "governorateCode": "ASN"},
+    {"id": 110, "name": "إدفو", "nameEn": "Edfu", "governorateCode": "ASN"},
+    {"id": 111, "name": "دراو", "nameEn": "Daraw", "governorateCode": "ASN"},
+    {"id": 112, "name": "أبو سمبل", "nameEn": "Abu Simbel", "governorateCode": "ASN"},
+    # Red Sea (RED)
+    {"id": 113, "name": "الغردقة", "nameEn": "Hurghada", "governorateCode": "RED"},
+    {"id": 114, "name": "سفاجا", "nameEn": "Safaga", "governorateCode": "RED"},
+    {"id": 115, "name": "القصير", "nameEn": "El Quseir", "governorateCode": "RED"},
+    {"id": 116, "name": "مرسى علم", "nameEn": "Marsa Alam", "governorateCode": "RED"},
+    {"id": 117, "name": "رأس غارب", "nameEn": "Ras Ghareb", "governorateCode": "RED"},
+    # New Valley (WAD)
+    {"id": 118, "name": "الخارجة", "nameEn": "El Kharga", "governorateCode": "WAD"},
+    {"id": 119, "name": "الداخلة", "nameEn": "Dakhla", "governorateCode": "WAD"},
+    {"id": 120, "name": "الفرافرة", "nameEn": "Farafra", "governorateCode": "WAD"},
+    {"id": 121, "name": "باريس", "nameEn": "Paris", "governorateCode": "WAD"},
+    # Matruh (MTR)
+    {"id": 122, "name": "مرسى مطروح", "nameEn": "Marsa Matruh", "governorateCode": "MTR"},
+    {"id": 123, "name": "سيوة", "nameEn": "Siwa", "governorateCode": "MTR"},
+    {"id": 124, "name": "الحمام", "nameEn": "El Hamam", "governorateCode": "MTR"},
+    {"id": 125, "name": "العلمين", "nameEn": "El Alamein", "governorateCode": "MTR"},
+    {"id": 126, "name": "الضبعة", "nameEn": "El Dabaa", "governorateCode": "MTR"},
+    # North Sinai (SIN)
+    {"id": 127, "name": "العريش", "nameEn": "Arish", "governorateCode": "SIN"},
+    {"id": 128, "name": "الشيخ زويد", "nameEn": "Sheikh Zuweid", "governorateCode": "SIN"},
+    {"id": 129, "name": "رفح", "nameEn": "Rafah", "governorateCode": "SIN"},
+    {"id": 130, "name": "بئر العبد", "nameEn": "Bir al-Abed", "governorateCode": "SIN"},
+    # South Sinai (SIS)
+    {"id": 131, "name": "شرم الشيخ", "nameEn": "Sharm El Sheikh", "governorateCode": "SIS"},
+    {"id": 132, "name": "دهب", "nameEn": "Dahab", "governorateCode": "SIS"},
+    {"id": 133, "name": "نويبع", "nameEn": "Nuweiba", "governorateCode": "SIS"},
+    {"id": 134, "name": "طابا", "nameEn": "Taba", "governorateCode": "SIS"},
+    {"id": 135, "name": "سانت كاترين", "nameEn": "Saint Catherine", "governorateCode": "SIS"},
+    {"id": 136, "name": "الطور", "nameEn": "El Tor", "governorateCode": "SIS"},
+    # New Cities (4th Generation & Others)
+    {"id": 137, "name": "العاصمة الإدارية الجديدة", "nameEn": "New Administrative Capital", "governorateCode": "CAI"},
+    {"id": 138, "name": "الشروق", "nameEn": "El Shorouk", "governorateCode": "CAI"},
+    {"id": 139, "name": "بدر", "nameEn": "Badr City", "governorateCode": "CAI"},
+    {"id": 140, "name": "مدينتي", "nameEn": "Madinaty", "governorateCode": "CAI"},
+    {"id": 141, "name": "مدينة الرحاب", "nameEn": "Al Rehab", "governorateCode": "CAI"},
+    {"id": 142, "name": "15 مايو", "nameEn": "15 May City", "governorateCode": "CAI"},
+    {"id": 143, "name": "سفنكس الجديدة", "nameEn": "New Sphinx", "governorateCode": "GIZ"},
+    {"id": 144, "name": "حدائق أكتوبر", "nameEn": "Hadayek October", "governorateCode": "GIZ"},
+    {"id": 145, "name": "برج العرب الجديدة", "nameEn": "New Borg El Arab", "governorateCode": "ALX"},
+    {"id": 146, "name": "العبور", "nameEn": "El Obour", "governorateCode": "QLB"},
+    {"id": 147, "name": "العبور الجديدة", "nameEn": "New Obour", "governorateCode": "QLB"},
+    {"id": 148, "name": "المنصورة الجديدة", "nameEn": "New Mansoura", "governorateCode": "DKH"},
+    {"id": 149, "name": "العلمين الجديدة", "nameEn": "New Alamein", "governorateCode": "MTR"},
+    {"id": 150, "name": "مدينة الجلالة", "nameEn": "Galala City", "governorateCode": "SUZ"},
+    {"id": 151, "name": "مدينة ناصر (غرب أسيوط)", "nameEn": "Nasser City (West Asyut)", "governorateCode": "AST"},
+]
+
+_id_map = {c["id"]: c for c in cities}
+_gov_map = {}
+for city in cities:
+    code = city["governorateCode"]
+    _gov_map.setdefault(code, []).append(city)
+
+def get_by_governorate(gov_code):
+    """إرجاع قائمة المدن التابعة لمحافظة معينة (باستخدام كود المحافظة)."""
+    if not isinstance(gov_code, str):
+        return []
+    return _gov_map.get(gov_code.upper(), []).copy()
+
+def get_by_id(id):
+    """إرجاع المدينة باستخدام الرقم التعريفي."""
+    try:
+        num_id = int(id)
+    except (ValueError, TypeError):
+        return None
+    return _id_map.get(num_id)
+
+def search(query):
+    """البحث في المدن بالاسم العربي أو الإنجليزي."""
+    if not isinstance(query, str) or not query.strip():
+        return []
+    q = query.strip().lower()
+    result = []
+    for city in cities:
+        if q in city["name"] or q in city["nameEn"].lower():
+            result.append(city)
+    return result

egydata-1.0.0/egydata/governorates.py

@@ -0,0 +1,51 @@
+governorates = [
+  {"id": 1, "code": "CAI", "name": "القاهرة", "nameEn": "Cairo"},
+  {"id": 2, "code": "ALX", "name": "الإسكندرية", "nameEn": "Alexandria"},
+  {"id": 3, "code": "GIZ", "name": "الجيزة", "nameEn": "Giza"},
+  {"id": 4, "code": "PTS", "name": "بورسعيد", "nameEn": "Port Said"},
+  {"id": 5, "code": "SUZ", "name": "السويس", "nameEn": "Suez"},
+  {"id": 6, "code": "DKH", "name": "الدقهلية", "nameEn": "Dakahlia"},
+  {"id": 7, "code": "SHR", "name": "الشرقية", "nameEn": "Sharqia"},
+  {"id": 8, "code": "QLB", "name": "القليوبية", "nameEn": "Qalyubia"},
+  {"id": 9, "code": "KFS", "name": "كفر الشيخ", "nameEn": "Kafr El Sheikh"},
+  {"id": 10, "code": "GHR", "name": "الغربية", "nameEn": "Gharbia"},
+  {"id": 11, "code": "MNF", "name": "المنوفية", "nameEn": "Monufia"},
+  {"id": 12, "code": "BHR", "name": "البحيرة", "nameEn": "Beheira"},
+  {"id": 13, "code": "ISM", "name": "الإسماعيلية", "nameEn": "Ismailia"},
+  {"id": 14, "code": "DMT", "name": "دمياط", "nameEn": "Damietta"},
+  {"id": 15, "code": "FYM", "name": "الفيوم", "nameEn": "Faiyum"},
+  {"id": 16, "code": "BNS", "name": "بني سويف", "nameEn": "Beni Suef"},
+  {"id": 17, "code": "MNY", "name": "المنيا", "nameEn": "Minya"},
+  {"id": 18, "code": "AST", "name": "أسيوط", "nameEn": "Asyut"},
+  {"id": 19, "code": "SHG", "name": "سوهاج", "nameEn": "Sohag"},
+  {"id": 20, "code": "QNA", "name": "قنا", "nameEn": "Qena"},
+  {"id": 21, "code": "LXR", "name": "الأقصر", "nameEn": "Luxor"},
+  {"id": 22, "code": "ASN", "name": "أسوان", "nameEn": "Aswan"},
+  {"id": 23, "code": "RED", "name": "البحر الأحمر", "nameEn": "Red Sea"},
+  {"id": 24, "code": "WAD", "name": "الوادي الجديد", "nameEn": "New Valley"},
+ {"id": 25, "code": "MTR", "name": "مطروح", "nameEn": "Matruh"},
+  {"id": 26, "code": "SIN", "name": "شمال سيناء", "nameEn": "North Sinai"},
+  {"id": 27, "code": "SIS", "name": "جنوب سيناء", "nameEn": "South Sinai"},
+]
+
+_code_map = {g["code"]: g for g in governorates}
+_id_map = {g["id"]: g for g in governorates}
+
+def get_all(): return governorates.copy()
+
+def get_by_code(code):
+  if not isinstance(code, str): return None
+  return _code_map.get(code.upper())
+
+def get_by_id(id):
+  try: num_id = int(id)
+  except (ValueError, TypeError): return None
+  return _id_map.get(num_id)
+
+def search(query):
+  if not isinstance(query, str) or not query.strip(): return []
+  q = query.strip().lower()
+  result = []
+  for g in governorates:
+    if (q in g["name"] or q in g["nameEn"].lower() or q in g["code"].lower()): result.append(g)
+  return result

egydata-1.0.0/egydata/phoneAreas.py

@@ -0,0 +1,50 @@
+area_codes = [
+  # Mobile Networks
+  {"code": "010", "region": "ڤودافون", "regionEn": "Vodafone"},
+  {"code": "011", "region": "اتصالات", "regionEn": "Etisalat"},
+  {"code": "012", "region": "أورنج", "regionEn": "Orange"},
+  {"code": "015", "region": "وي / العاشر من رمضان", "regionEn": "WE / 10th of Ramadan"},
+  # Landlines
+  {"code": "02", "region": "القاهرة والجيزة", "regionEn": "Cairo & Giza"},
+  {"code": "03", "region": "الإسكندرية", "regionEn": "Alexandria"},
+  {"code": "013", "region": "القليوبية (بنها)", "regionEn": "Qalyubia (Benha)"},
+  {"code": "040", "region": "الغربية (طنطا)", "regionEn": "Gharbia (Tanta)"},
+  {"code": "045", "region": "البحيرة (دمنهور)", "regionEn": "Beheira (Damanhour)"},
+  {"code": "046", "region": "مطروح", "regionEn": "Matruh"},
+  {"code": "047", "region": "كفر الشيخ", "regionEn": "Kafr El Sheikh"},
+  {"code": "048", "region": "المنوفية (شبين الكوم)", "regionEn": "Monufia (Shebin El Kom)"},
+  {"code": "050", "region": "الدقهلية (المنصورة)", "regionEn": "Dakahlia (Mansoura)"},
+  {"code": "055", "region": "الشرقية (الزقازيق)", "regionEn": "Sharqia (Zagazig)"},
+  {"code": "057", "region": "دمياط", "regionEn": "Damietta"},
+  {"code": "062", "region": "السويس", "regionEn": "Suez"},
+  {"code": "064", "region": "الإسماعيلية", "regionEn": "Ismailia"},
+  {"code": "065", "region": "البحر الأحمر (الغردقة)", "regionEn": "Red Sea (Hurghada)"},
+  {"code": "066", "region": "بورسعيد", "regionEn": "Port Said"},
+  {"code": "068", "region": "شمال سيناء (العريش)", "regionEn": "North Sinai (Arish)"},
+  {"code": "069", "region": "جنوب سيناء", "regionEn": "South Sinai"},
+  {"code": "082", "region": "بني سويف", "regionEn": "Beni Suef"},
+  {"code": "084", "region": "الفيوم", "regionEn": "Faiyum"},
+  {"code": "086", "region": "المنيا", "regionEn": "Minya"},
+  {"code": "088", "region": "أسيوط", "regionEn": "Asyut"},
+  {"code": "092", "region": "الوادي الجديد", "regionEn": "New Valley"},
+  {"code": "093", "region": "سوهاج", "regionEn": "Sohag"},
+  {"code": "095", "region": "الأقصر", "regionEn": "Luxor"},
+  {"code": "096", "region": "قنا", "regionEn": "Qena"},
+  {"code": "097", "region": "أسوان", "regionEn": "Aswan"},
+]
+
+_code_map = {item["code"]: item for item in area_codes}
+
+def get_all(): return area_codes.copy()
+
+def get_region(code):
+  if not isinstance(code, str): return None
+  normalized = "0" + code.lstrip("0")
+  return _code_map.get(code) or _code_map.get(normalized)
+
+def get_code(region_name):
+  if not isinstance(region_name, str) or not region_name.strip(): return None
+  q = region_name.strip().lower()
+  for item in area_codes:
+    if q in item["region"] or q in item["regionEn"].lower(): return item
+  return None

egydata-1.0.0/egydata/timezones.py

@@ -0,0 +1,14 @@
+from datetime import datetime
+from zoneinfo import ZoneInfo
+
+name = "Africa/Cairo"
+offset = "+02:00"
+
+def now(): return datetime.now(ZoneInfo(name))
+
+def isDST(date=None):
+  if date is None: date = datetime.now()
+  if date.tzinfo is None: date = date.replace(tzinfo=ZoneInfo(name))
+  else: date = date.astimezone(ZoneInfo(name))
+  offset_minutes = date.utcoffset().total_seconds() / 60
+  return offset_minutes == 180

egydata-1.0.0/egydata.egg-info/PKG-INFO

@@ -0,0 +1,234 @@
+Metadata-Version: 2.4
+Name: egydata
+Version: 1.0.0
+Summary: Python library created by InnoSoft-Company tech team for Egyptian data: cities, governorates, timezones, phone numbers, etc.
+Home-page: https://www.midoghanam.site/
+Author: InnoSoft Company
+Author-email: InnoSoft Company <midoghanam@hotmail.com>, Mohammed Ahmed Ghanam <midoghanam@hotmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 InnoSoft
+        CEO & Founder: Mohamed Ahmed Ghanam
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Keywords: egypt,data,cities,governorates,timezone,phone numbers
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# Egydata
+
+[![PyPI Version](https://img.shields.io/pypi/v/egydata.svg)](https://pypi.org/project/egydata/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/egydata.svg)](https://pypi.org/project/egydata/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/InnoSoft-Company/egydata/blob/main/LICENSE)
+
+Structured Egyptian geographical and timezone data for Python.
+
+Provides a complete, offline dataset of Egyptian governorates, cities, landline and mobile area codes, and timezone utilities — with zero dependencies (uses Python standard library only).
+
+[View on GitHub](https://github.com/InnoSoft-Company/egydata) | [View on PyPI](https://pypi.org/project/egydata/)
+
+---
+
+## Installation
+
+```bash
+pip install egydata
+```
+
+Quick Start
+
+```python
+from egydata import governorates, cities, phoneArea, timezone
+
+# Get all governorates
+all_govs = governorates.get_all()
+
+# Find a city by name
+maadi = cities.search("Maadi")
+
+# Check current time in Egypt
+now = timezone.now()
+```
+
+---
+
+Usage
+
+Governorates
+
+```python
+from egydata import governorates
+
+# Get all 27 governorates
+all_govs = governorates.get_all()
+# [{'id': 1, 'code': 'CAI', 'name': 'القاهرة', 'nameEn': 'Cairo'}, ...]
+
+# Find by code
+cairo = governorates.get_by_code("CAI")
+# {'id': 1, 'code': 'CAI', 'name': 'القاهرة', 'nameEn': 'Cairo'}
+
+# Find by id
+alex = governorates.get_by_id(2)
+# {'id': 2, 'code': 'ALX', 'name': 'الإسكندرية', 'nameEn': 'Alexandria'}
+
+# Search (Arabic, English, or code, partial match)
+results = governorates.search("alex")
+# [{'id': 2, 'code': 'ALX', 'name': 'الإسكندرية', 'nameEn': 'Alexandria'}]
+
+ar_results = governorates.search("القاهرة")
+# [{'id': 1, 'code': 'CAI', 'name': 'القاهرة', 'nameEn': 'Cairo'}]
+```
+
+Cities
+
+```python
+from egydata import cities
+
+# Get cities by governorate code
+cairo_cities = cities.get_by_governorate("CAI")
+# [{'id': 1, 'name': 'مدينة نصر', 'nameEn': 'Nasr City', 'governorateCode': 'CAI'}, ...]
+
+# Find by id
+sharm = cities.get_by_id(131)
+# {'id': 131, 'name': 'شرم الشيخ', 'nameEn': 'Sharm El Sheikh', 'governorateCode': 'SIS'}
+
+# Search cities (Arabic or English, partial match)
+found = cities.search("Maadi")
+# [{'id': 3, 'name': 'المعادي', 'nameEn': 'Maadi', 'governorateCode': 'CAI'}]
+```
+
+Phone Area Codes
+
+```python
+from egydata import phoneArea
+
+# Get all area codes (landline and mobile)
+all_codes = phoneArea.get_all()
+# [{'code': '010', 'region': 'ڤودافون', 'regionEn': 'Vodafone'}, ...]
+
+# Look up region by code
+region = phoneArea.get_region("03")
+# {'code': '03', 'region': 'الإسكندرية', 'regionEn': 'Alexandria'}
+
+# Find area code by region name (Arabic or English)
+entry = phoneArea.get_code("Mansoura")
+# {'code': '050', 'region': 'الدقهلية (المنصورة)', 'regionEn': 'Dakahlia (Mansoura)'}
+```
+
+Timezone
+
+```python
+from egydata import timezone
+
+print(timezone.name)      # 'Africa/Cairo'
+print(timezone.offset)    # '+02:00' (standard time offset)
+
+now = timezone.now()      # current date/time in Egypt (timezone-aware datetime)
+print(now.isoformat())
+
+# Check if daylight saving time is active (Egypt resumed DST in 2023)
+is_dst = timezone.isDST() # returns True if current offset is +03:00
+
+# Optionally check a specific date
+from datetime import datetime
+date = datetime(2024, 8, 1)
+print(timezone.isDST(date))  # True (during DST period)
+```
+
+---
+
+API Reference
+
+governorates
+
+Method Parameters Returns Description
+get_all() – list[Governorate] Returns all 27 Egyptian governorates.
+get_by_code(code) code: str Governorate \| None Find governorate by its code (e.g., 'CAI').
+get_by_id(id) id: int/str Governorate \| None Find governorate by its numeric ID.
+search(query) query: str list[Governorate] Search by Arabic/English name or code (case‑insensitive, partial).
+
+Governorate shape:
+{'id': int, 'code': str, 'name': str, 'nameEn': str}
+
+---
+
+cities
+
+Method Parameters Returns Description
+get_by_governorate(gov_code) gov_code: str list[City] Get all cities in a governorate (by its code).
+get_by_id(id) id: int/str City \| None Find city by its numeric ID.
+search(query) query: str list[City] Search by Arabic or English name (partial, case‑insensitive).
+
+City shape:
+{'id': int, 'name': str, 'nameEn': str, 'governorateCode': str}
+
+---
+
+phoneArea
+
+Method Parameters Returns Description
+get_all() – list[AreaCode] Returns all landline and mobile area codes.
+get_region(code) code: str AreaCode \| None Look up region info by area code.
+get_code(region_name) region_name: str AreaCode \| None Find area code entry by region name (Arabic or English).
+
+AreaCode shape:
+{'code': str, 'region': str, 'regionEn': str}
+
+---
+
+timezone
+
+Property / Method Returns Description
+name 'Africa/Cairo' IANA timezone identifier.
+offset '+02:00' Standard UTC offset (without DST).
+now() datetime Current date and time in Egypt (timezone‑aware).
+isDST(date=None) bool Whether DST is active (for given date or now).
+
+---
+
+Data Coverage
+
+· 27 governorates with Arabic and English names and ISO‑like codes.
+· 151 cities and districts across all governorates.
+· 30 landline and mobile area codes (including mobile operators).
+· Full timezone support for Africa/Cairo (DST‑aware).
+
+All data is embedded in the package – no network requests, no external dependencies.
+
+---
+
+Requirements
+
+· Python 3.9 or later (uses standard library zoneinfo; for Python 3.8 you may need the backports.zoneinfo package).
+
+---
+
+License
+
+MIT
+
+```

egydata-1.0.0/egydata.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+egydata/__init__.py
+egydata/cities.py
+egydata/governorates.py
+egydata/phoneAreas.py
+egydata/timezones.py
+egydata.egg-info/PKG-INFO
+egydata.egg-info/SOURCES.txt
+egydata.egg-info/dependency_links.txt
+egydata.egg-info/top_level.txt

egydata-1.0.0/egydata.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

egydata-1.0.0/egydata.egg-info/top_level.txt

@@ -0,0 +1 @@
+egydata

egydata-1.0.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "egydata"
+version = "1.0.0"
+description = "Python library created by InnoSoft-Company tech team for Egyptian data: cities, governorates, timezones, phone numbers, etc."
+readme = "README.md"
+requires-python = ">=3.9"
+authors = [
+  { name = "InnoSoft Company", email = "midoghanam@hotmail.com" },
+  { name = "Mohammed Ahmed Ghanam", email = "midoghanam@hotmail.com" }
+]
+license = { file = "LICENSE" }
+keywords = ["egypt", "data", "cities", "governorates", "timezone", "phone numbers"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+]
+dependencies = [
+]

egydata-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

egydata-1.0.0/setup.py

@@ -0,0 +1,25 @@
+from setuptools import setup, find_packages
+
+setup(
+  name="egydata",
+  version="1.0.0",
+  author="InnoSoft Company",                # ← change to your company
+  author_email="midoghanam@hotmail.com",        # ← company email
+  description="Python library for Egyptian data: cities, governorates, timezones, phone numbers, etc.",
+  long_description=open("README.md", encoding="utf-8").read(),
+  long_description_content_type="text/markdown",
+  url="https://www.midoghanam.site/",        # can be your homepage or GitHub
+  project_urls={
+    "Source Code": "https://github.com/InnoSoft-Company/egydata",
+    "Bug Tracker": "https://github.com/InnoSoft-Company/egydata/issues",
+    "Documentation": "https://github.com/InnoSoft-Company/egydata#readme",
+  },
+  packages=find_packages(),
+  python_requires=">=3.9",
+  install_requires=[],
+  classifiers=[
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+  ],
+)