Metadata-Version: 2.4
Name: pybuoy
Version: 0.5.10
Summary: Python wrapper for NOAA and NDBC REST web services.
Project-URL: Source Code, https://github.com/clairBuoyant/pybuoy
Project-URL: Bug Tracker, https://github.com/clairBuoyant/pybuoy/issues
Author-email: "Kyle J. Burda" <kylejbdev@gmail.com>
License-Expression: GPL-3.0-or-later
License-File: LICENSE
Keywords: NDBC,NOAA,api,buoy,weather,wrapper
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.12
Requires-Dist: lxml<7.0,>=6.1
Requires-Dist: requests<3,>=2.33.1
Description-Content-Type: text/x-rst

=====================================
pybuoy - Python NOAA/NDBC API Wrapper
=====================================

.. image:: https://img.shields.io/pypi/v/pybuoy?color=blue
    :alt: Latest Version
    :target: https://pypi.python.org/pypi/pybuoy

.. image:: https://img.shields.io/pypi/pyversions/pybuoy
    :alt: Supported Python Versions
    :target: https://pypi.python.org/pypi/pybuoy

.. image:: https://img.shields.io/pypi/dm/pybuoy
    :alt: PyPI - Monthly Downloads
    :target: https://pypi.python.org/pypi/pybuoy


``pybuoy`` is a Python wrapper for `NOAA <https://www.noaa.gov>`_ and `NDBC <https://www.ndbc.noaa.gov>`_ REST web services.

Installation
------------

``pybuoy`` is supported on Python 3.11+ and can be installed with either pip or a package manager like `uv <https://docs.astral.sh/uv/>`_:

Quickstart
----------

.. code-block:: python

    from pybuoy import Buoy

    buoy = Buoy()


With a instance of ``Buoy``, you can request data from NOAA and NDBC like so:

- `Get all active stations <https://pybuoy.readthedocs.io/en/latest/tutorials/active_buoys.html>`_.

- `Get realtime meteorological data <https://pybuoy.readthedocs.io/en/latest/tutorials/realtime_data.html#get-meteorological-data>`_ for buoy by station_id.

- `Get realtime wave summary data <https://pybuoy.readthedocs.io/en/latest/tutorials/realtime_data.html#get-wave-summary-data>`_ for buoy by station_id.

- `Get forecast data <https://pybuoy.readthedocs.io/en/latest/tutorials/forecast_data.html>`_ for buoy by lat/lon.
