haversigeo 0.1.0__tar.gz

haversigeo-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026, james blessings
+
+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.
+

haversigeo-0.1.0/PKG-INFO

@@ -0,0 +1,42 @@
+Metadata-Version: 2.4
+Name: haversigeo
+Version: 0.1.0
+Summary: A package for calculating distance between two places using haversine formula
+License: MIT
+License-File: LICENSE
+Author: james blessings
+Requires-Python: >=3.12,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Description-Content-Type: text/markdown
+
+# haversigeo
+
+A package for calculating distance between two places using haversine formula
+
+## Installation
+
+```bash
+$ pip install haversigeo
+```
+
+## Usage
+
+- TODO
+
+## Contributing
+
+Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.
+
+## License
+
+`haversigeo` was created by james blessings. It is licensed under the terms of the MIT license.
+
+## Credits
+
+`haversigeo` was created with [`cookiecutter`](https://cookiecutter.readthedocs.io/en/latest/) and the `py-pkgs-cookiecutter` [template](https://github.com/py-pkgs/py-pkgs-cookiecutter).
+

haversigeo-0.1.0/README.md

@@ -0,0 +1,25 @@
+# haversigeo
+
+A package for calculating distance between two places using haversine formula
+
+## Installation
+
+```bash
+$ pip install haversigeo
+```
+
+## Usage
+
+- TODO
+
+## Contributing
+
+Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.
+
+## License
+
+`haversigeo` was created by james blessings. It is licensed under the terms of the MIT license.
+
+## Credits
+
+`haversigeo` was created with [`cookiecutter`](https://cookiecutter.readthedocs.io/en/latest/) and the `py-pkgs-cookiecutter` [template](https://github.com/py-pkgs/py-pkgs-cookiecutter).

haversigeo-0.1.0/pyproject.toml

@@ -0,0 +1,15 @@
+[tool.poetry]
+name = "haversigeo"
+version = "0.1.0"
+description = "A package for calculating distance between two places using haversine formula"
+authors = ["james blessings"]
+license = "MIT"
+readme = "README.md"
+
+[tool.poetry.dependencies]
+python = "^3.12"
+
+
+[build-system]
+requires = ["poetry-core>=1.0.0"]
+build-backend = "poetry.core.masonry.api"

haversigeo-0.1.0/src/haversigeo/__init__.py

@@ -0,0 +1,3 @@
+# read version from installed package
+from importlib.metadata import version
+__version__ = version("haversigeo")

haversigeo-0.1.0/src/haversigeo/haversigeo.py

@@ -0,0 +1,42 @@
+import math
+
+
+def haversine_distance(origin, destination):
+  """Calculate the great-circle distance between two points on Earth.
+
+  Uses the haversine formula to compute the shortest distance over the
+  Earth's surface between two points given as latitude/longitude pairs,
+  assuming a spherical Earth with a mean radius of 6,371,000 meters.
+
+  Args:
+    origin (tuple[float, float]): Starting point as ``(latitude, longitude)``
+      in decimal degrees.
+    destination (tuple[float, float]): End point as ``(latitude, longitude)``
+      in decimal degrees.
+
+  Returns:
+    float: The distance between the two points in meters.
+
+  Notes:
+    - Coordinates must be in ``(latitude, longitude)`` order. Many GIS
+      libraries use ``(longitude, latitude)``, so check the order of your
+      data before calling.
+    - Because the Earth is modelled as a perfect sphere, results can differ
+      from ellipsoidal (e.g. WGS84) geodesic distances by up to roughly 0.5%.
+
+  Examples:
+    >>> haversine_distance((0, 0), (0, 0))
+    0.0
+    >>> round(haversine_distance((0, 0), (1, 0)), 2)
+    111194.93
+  """
+  lat1, lon1 = origin
+  lat2, lon2 = destination
+  radius = 6371000
+  dlat = math.radians(lat2-lat1)
+  dlon = math.radians(lon2-lon1)
+  a = math.sin(dlat/2) * math.sin(dlat/2) + math.cos(math.radians(lat1)) \
+    * math.cos(math.radians(lat2)) * math.sin(dlon/2) * math.sin(dlon/2)
+  c = 2 * math.atan2(math.sqrt(a), math.sqrt(1-a))
+  distance = radius * c
+  return distance