Metadata-Version: 2.4
Name: is-in-iran
Version: 0.1.0
Summary: Simple utility to check whether a (lat, lon) point lies inside Iran.
Author-email: Ali Afsahnoudeh <aliafsah1988@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/yourusername/iran-location-checker
Keywords: geojson,iran,geospatial,point-in-polygon
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: shapely>=2.0.0

# is-in-iran

A lightweight Python library that checks whether a given geographic point  
(latitude, longitude) lies inside the borders of **Iran**.

It loads an official MultiPolygon GeoJSON of Iran and performs a  
point-in-polygon check using **Shapely**.

---

## 🚀 Installation

```bash
pip install is-in-iran
```

## 🎯 Usage

```python
from is_in_iran import is_in_iran


print(is_in_iran(35.6892, 51.3890))  # → True  (Tehran)
print(is_in_iran(40.4168, -3.7038))  # → False (Madrid)
```

• Input format: (latitude, longitude)
• CRS: WGS84 (standard GPS coordinates)
• Points exactly on the border also return True.

## Development Setup

1. Create and activate a virtual environment.
2. Install the package in editable mode:

```python
pip install -e .
```

## Resources

- [GeoJSON Source](https://github.com/datasets/geo-countries)
