Metadata-Version: 2.1
Name: osmium
Version: 4.3.0
Summary: Python bindings for libosmium, the data processing library for OSM data
Keywords: OSM,OpenStreetMap,Osmium
Author-Email: Sarah Hoffmann <lonvia@denofr.de>
Maintainer-Email: Sarah Hoffmann <lonvia@denofr.de>
License: BSD-2-Clause
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Free Threading :: 2 - Beta
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: C++
Classifier: Typing :: Typed
Project-URL: Homepage, https://osmcode.org/pyosmium
Project-URL: Documentation, https://docs.osmcode.org/pyosmium/latest/
Project-URL: Repository, https://github.com/osmcode/pyosmium
Project-URL: Issues, https://github.com/osmcode/pyosmium/issues
Requires-Python: >=3.8
Requires-Dist: requests
Provides-Extra: tests
Requires-Dist: pytest; extra == "tests"
Requires-Dist: pytest-httpserver; extra == "tests"
Requires-Dist: werkzeug; extra == "tests"
Requires-Dist: shapely; extra == "tests"
Provides-Extra: docs
Requires-Dist: mkdocs; extra == "docs"
Requires-Dist: mkdocs-material; extra == "docs"
Requires-Dist: mkdocstrings; extra == "docs"
Requires-Dist: mkdocstrings-python; extra == "docs"
Requires-Dist: mkdocs-autorefs; extra == "docs"
Requires-Dist: mkdocs-gen-files; extra == "docs"
Requires-Dist: mkdocs-jupyter; extra == "docs"
Requires-Dist: argparse-manpage; extra == "docs"
Description-Content-Type: text/x-rst

========
pyosmium
========

This library provides Python bindings for the `Libosmium`_ C++
library, a library for working with OpenStreetMap data in a fast and flexible
manner.

.. _Libosmium: https://github.com/osmcode/libosmium

Installation
============

pyosmium can be installed with pip:

    pip install osmium

The Pypi source package already comes bundled with a matching version of
libosmium, protozero and pybind11. Pyosmium additionally depends on
expat, libz and libbz2. You need to install
development packages for these libraries. On Debian/Ubuntu do::

    sudo apt-get install build-essential cmake libexpat1-dev zlib1g-dev libbz2-dev


Python >= 3.8 is supported. Pypy is known not to work.

Documentation
=============

The documentation for the latest release is available at
`osmcode.org`_.

If you find bugs or have feature requests, please report those in the
`Github issue tracker`_. For general questions about using pyosmium you
can contanct the `OSM forum`_.

.. _osmcode.org: http://docs.osmcode.org/pyosmium/latest
.. _Github issue tracker: https://github.com/osmcode/pyosmium/issues/
.. _OSM forum: https://community.openstreetmap.org/

Examples
========

The package contains an `example` directory with small examples on how to use
the library. They are mostly ports of the examples in Libosmium and
osmium-contrib.

Also check out the `Cookbook section`_ in the documentation.

.. _Cookbook section: https://docs.osmcode.org/pyosmium/latest/cookbooks/

Fineprint
=========

Pyosmium is available under the BSD 2-Clause License. See LICENSE.TXT.

The source code can be found on `GitHub`_.

.. _GitHub: https://github.com/osmcode/pyosmium
