egygeo 1.0.0__tar.gz

egygeo-1.0.0/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2024 EGYGEO
+
+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.

egygeo-1.0.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.1
+Name: egygeo
+Version: 1.0.0
+Summary: A Python package designed to provide easy access to the geographic coordinates (latitude and longitude) of various Egyptian subdivisions.
+Author: Sara Habib
+Author-email: sara.habib48@gmail.com
+License-File: LICENSE

egygeo-1.0.0/README.md

@@ -0,0 +1,21 @@
+# EGYGEO
+
+EGYGEO is a Python package designed to provide easy access to the geographic coordinates (latitude and longitude) of various Egyptian subdivisions. It includes a module named `egysubdiv` that offers a convenient function, `get_coordinates`, allowing users to retrieve the geographic coordinates of a specified Egyptian subdivision by providing its name in either Arabic or English. The package supports the normalization of input subdivision names for robust matching.
+
+## Installation
+
+You can install egygeo using pip:
+
+```bash
+pip install egygeo
+```
+
+## Usage
+
+```bash
+from egygeo import get_coordinates
+
+# Get coordinates for Cairo
+latitude, longitude = get_coordinates('Cairo')
+print(f"The coordinates of Cairo are: {latitude}, {longitude}")
+```

egygeo-1.0.0/egygeo/__init__.py

@@ -0,0 +1,2 @@
+from .egygeo import get_coordinates
+from .egygeo import get_name

egygeo-1.0.0/egygeo/egygeo.py

@@ -0,0 +1,61 @@
+import json
+import requests
+
+
+def load_geojson_from_url(url):
+    response = requests.get(url)
+    response.raise_for_status()  # Raise an exception for bad responses
+    return json.loads(response.text)
+
+
+def load_geojson(file_path_or_url):
+    if file_path_or_url.startswith('http'):
+        # If the path starts with 'http', assume it's a URL
+        return load_geojson_from_url(file_path_or_url)
+    else:
+        with open(file_path_or_url, 'r', encoding='utf-8') as geojson_file:
+            return json.load(geojson_file)
+
+
+def get_coordinates(subdivision_name, geojson_path_or_url='https://raw.githubusercontent.com/srahabib/Egypt-governorates-geojson/main/Subdivisions%20of%20Egypt.json'):
+    geojson_data = load_geojson(geojson_path_or_url)
+
+    normalized_name = subdivision_name.lower().strip()
+
+    for feature in geojson_data['features']:
+        properties = feature['properties']
+        geometry = feature['geometry']
+
+        # Check both English and Arabic names
+        english_name = properties.get('Subdivision_en', '').lower()
+        arabic_name = properties.get('Subdivision_ar', '').lower()
+
+        if normalized_name in [english_name, arabic_name]:
+            if geometry['type'] == 'Point' and len(geometry['coordinates']) == 2:
+                return tuple(geometry['coordinates'])
+
+    # Return an empty tuple if subdivision not found
+    return ()
+
+
+def get_name(latitude, longitude, geojson_path_or_url='https://raw.githubusercontent.com/srahabib/Egypt-governorates-geojson/main/Subdivisions%20of%20Egypt.json'):
+    geojson_data = load_geojson(geojson_path_or_url)
+
+    for feature in geojson_data['features']:
+        geometry = feature['geometry']
+
+        if geometry['type'] == 'Point' and len(geometry['coordinates']) == 2:
+            feature_latitude, feature_longitude = geometry['coordinates']
+
+            # Set a tolerance level for coordinates matching
+            tolerance = 0.0001
+            if (
+                abs(feature_latitude - latitude) < tolerance and
+                abs(feature_longitude - longitude) < tolerance
+            ):
+                properties = feature['properties']
+                english_name = properties.get('Subdivision_en', '')
+                arabic_name = properties.get('Subdivision_ar', '')
+                return f"{english_name},{arabic_name}"
+
+    return "Location not found in the GeoJSON data."

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

@@ -0,0 +1,7 @@
+Metadata-Version: 2.1
+Name: egygeo
+Version: 1.0.0
+Summary: A Python package designed to provide easy access to the geographic coordinates (latitude and longitude) of various Egyptian subdivisions.
+Author: Sara Habib
+Author-email: sara.habib48@gmail.com
+License-File: LICENSE

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

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+setup.py
+egygeo/__init__.py
+egygeo/egygeo.py
+egygeo.egg-info/PKG-INFO
+egygeo.egg-info/SOURCES.txt
+egygeo.egg-info/dependency_links.txt
+egygeo.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+egygeo

egygeo-1.0.0/setup.cfg

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

egygeo-1.0.0/setup.py

@@ -0,0 +1,13 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="egygeo",
+    version="1.0.0",
+    author="Sara Habib",
+    author_email="sara.habib48@gmail.com",
+    description="A Python package designed to provide easy access to the geographic coordinates (latitude and longitude) of various Egyptian subdivisions.",
+    packages=find_packages(),
+    install_requires=[
+        # List any dependencies your package requires
+    ],
+)