=====================================
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.
Raw data
{
"_id": null,
"home_page": null,
"name": "pybuoy",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.11",
"maintainer_email": null,
"keywords": "NDBC, NOAA, api, buoy, weather, wrapper",
"author": "Kyle J. Burda",
"author_email": "kylejbdev@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/5d/8e/753fad3509ca57a10376e39a2c361b71e03efd91b6750a9a8f57c4d28386/pybuoy-0.5.4.tar.gz",
"platform": null,
"description": "=====================================\npybuoy - Python NOAA/NDBC API Wrapper\n=====================================\n\n.. image:: https://img.shields.io/pypi/v/pybuoy?color=blue\n :alt: Latest Version\n :target: https://pypi.python.org/pypi/pybuoy\n\n.. image:: https://img.shields.io/pypi/pyversions/pybuoy\n :alt: Supported Python Versions\n :target: https://pypi.python.org/pypi/pybuoy\n\n.. image:: https://img.shields.io/pypi/dm/pybuoy\n :alt: PyPI - Monthly Downloads\n :target: https://pypi.python.org/pypi/pybuoy\n\n\n``pybuoy`` is a Python wrapper for `NOAA <https://www.noaa.gov>`_ and `NDBC <https://www.ndbc.noaa.gov>`_ REST web services.\n\nInstallation\n------------\n\n``pybuoy`` is supported on Python 3.11+ and can be installed with either pip or a package manager like `poetry <https://python-poetry.org>`_:\n\n- **with pip**: ``pip install pybuoy``\n\n - recommended to install any third party library in `python's virtualenv <https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments>`_.\n\n- **with poetry**: ``poetry add pybuoy``\n\n - automatically creates and manages `python's virtualenvs <https://realpython.com/dependency-management-python-poetry>`_.\n\nQuickstart\n----------\n\n.. code-block:: python\n\n from pybuoy import Buoy\n\n buoy = Buoy()\n\n\nWith a instance of ``Buoy``, you can request data from NOAA and NDBC like so:\n\n- `Get all active stations <https://pybuoy.readthedocs.io/en/latest/tutorials/active_buoys.html>`_.\n\n- `Get realtime meteorological data <https://pybuoy.readthedocs.io/en/latest/tutorials/realtime_data.html#get-meteorological-data>`_ for buoy by station_id.\n\n- `Get realtime wave summary data <https://pybuoy.readthedocs.io/en/latest/tutorials/realtime_data.html#get-wave-summary-data>`_ for buoy by station_id.\n\n- `Get forecast data <https://pybuoy.readthedocs.io/en/latest/tutorials/forecast_data.html>`_ for buoy by lat/lon.\n",
"bugtrack_url": null,
"license": "GPL-3.0-or-later",
"summary": "Python wrapper for NOAA and NDBC REST web services.",
"version": "0.5.4",
"project_urls": {
"Bug Tracker": "https://github.com/clairBuoyant/pybuoy/issues",
"Documentation": "https://pybuoy.readthedocs.io",
"Source Code": "https://github.com/clairBuoyant/pybuoy"
},
"split_keywords": [
"ndbc",
" noaa",
" api",
" buoy",
" weather",
" wrapper"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6050b73fc20268541e4f28af87269639bf32ee13a9cbea7eae80798c96785239",
"md5": "923b77e2ca2d1a23b8c9b0a0f0e84446",
"sha256": "113051d7825a6ea00e23563fe8d74573cc2137552a7d1477fd6f4ba9c0693c7a"
},
"downloads": -1,
"filename": "pybuoy-0.5.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "923b77e2ca2d1a23b8c9b0a0f0e84446",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.11",
"size": 41521,
"upload_time": "2024-04-13T05:40:10",
"upload_time_iso_8601": "2024-04-13T05:40:10.451031Z",
"url": "https://files.pythonhosted.org/packages/60/50/b73fc20268541e4f28af87269639bf32ee13a9cbea7eae80798c96785239/pybuoy-0.5.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5d8e753fad3509ca57a10376e39a2c361b71e03efd91b6750a9a8f57c4d28386",
"md5": "0264b83864df696edd7f3f1613e97c29",
"sha256": "2551606af5fc35da69498a5c5cca6c65cd1b740bde915bb53f847c4a061b55e3"
},
"downloads": -1,
"filename": "pybuoy-0.5.4.tar.gz",
"has_sig": false,
"md5_digest": "0264b83864df696edd7f3f1613e97c29",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.11",
"size": 25794,
"upload_time": "2024-04-13T05:40:11",
"upload_time_iso_8601": "2024-04-13T05:40:11.934805Z",
"url": "https://files.pythonhosted.org/packages/5d/8e/753fad3509ca57a10376e39a2c361b71e03efd91b6750a9a8f57c4d28386/pybuoy-0.5.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-13 05:40:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "clairBuoyant",
"github_project": "pybuoy",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "pybuoy"
}