Metadata-Version: 2.2
Name: gps-toolkit-py
Version: 0.1.8
Summary: A Python package for working with GPS coordinates
Home-page: https://github.com/username/gps-toolkit-py
Author: GPS Tools Team
Author-email: example@example.com
License: MIT
Project-URL: Homepage, https://github.com/username/gps-toolkit-py
Project-URL: Bug Tracker, https://github.com/username/gps-toolkit-py/issues
Project-URL: Documentation, https://github.com/username/gps-toolkit-py/documentation
Keywords: gps,geospatial,coordinates,utm,mgrs
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: scipy
Requires-Dist: pyproj
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Provides-Extra: viz
Requires-Dist: matplotlib; extra == "viz"
Requires-Dist: folium; extra == "viz"
Provides-Extra: gis
Requires-Dist: shapely; extra == "gis"
Requires-Dist: geopandas; extra == "gis"
Dynamic: author-email
Dynamic: home-page
Dynamic: requires-python

# GPS Tools

A comprehensive Python package for working with GPS coordinates, handling conversions, distance calculations, and geofencing operations.

## Features

- **Coordinate handling**: Work with latitude/longitude, UTM, and MGRS coordinates
- **Conversions**: Convert between different coordinate systems
- **Distance calculations**: Calculate distances, bearings, and midpoints
- **Geofencing**: Create and work with geographical boundaries
- **Validation**: Robust coordinate validation functions

## Installation

```bash
pip install gps-tools
```

## Quick Example

```python
from gps_tools import Coordinate
from gps_tools.distance import haversine_distance

# Create coordinates for two cities
new_york = Coordinate(40.7128, -74.0060, name="New York")
los_angeles = Coordinate(34.0522, -118.2437, name="Los Angeles")

# Calculate the distance between them
distance = haversine_distance(new_york, los_angeles)
print(f"The distance between {new_york.name} and {los_angeles.name} is {distance/1000:.2f} km")
```

## Documentation

For complete documentation, examples, and API reference, visit the [documentation directory](documentation/).

## Optional Dependencies

GPS Tools has optional dependencies for advanced features:

```bash
# For visualization features
pip install gps-tools[viz]

# For GIS integration
pip install gps-tools[gis]

# For development
pip install gps-tools[dev]
```

## Contributing

Contributions are welcome! Please check our [contributing guide](documentation/guides/contributing.md) for details.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. 
