Metadata-Version: 2.3
Name: pybuoy
Version: 0.5.8
Summary: Python wrapper for NOAA and NDBC REST web services.
License: GPL-3.0-or-later
Keywords: NDBC,NOAA,api,buoy,weather,wrapper
Author: Kyle J. Burda
Author-email: kylejbdev@gmail.com
Requires-Python: >=3.11,<4.0
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: lxml (>=5.4.0,<6.0.0)
Requires-Dist: requests (>=2.32.3,<3.0.0)
Project-URL: Bug Tracker, https://github.com/clairBuoyant/pybuoy/issues
Project-URL: Documentation, https://pybuoy.readthedocs.io
Project-URL: Source Code, https://github.com/clairBuoyant/pybuoy
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 `poetry <https://python-poetry.org>`_:

- **with pip**: ``pip install pybuoy``

  - recommended to install any third party library in `python's virtualenv <https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments>`_.

- **with poetry**: ``poetry add pybuoy``

  - automatically creates and manages `python's virtualenvs <https://realpython.com/dependency-management-python-poetry>`_.

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.

