=====================================
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/ac/2e/ad7081f49d008ad172af1f39e30f4ae74e0018f0245fd4a57d804cccc66d/pybuoy-0.5.7.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.7",
"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": "b03a44d9d537efb1d064ca64a5e535c805f5c8445e523f62ad6c859910165d7f",
"md5": "dd540988a0eed848643155f1333f12bd",
"sha256": "ffda437673ef1fe21158d19f93dc8ff00852482c7a6d55f10fe3c456ddb0d286"
},
"downloads": -1,
"filename": "pybuoy-0.5.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "dd540988a0eed848643155f1333f12bd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.11",
"size": 41552,
"upload_time": "2024-12-26T16:41:24",
"upload_time_iso_8601": "2024-12-26T16:41:24.029714Z",
"url": "https://files.pythonhosted.org/packages/b0/3a/44d9d537efb1d064ca64a5e535c805f5c8445e523f62ad6c859910165d7f/pybuoy-0.5.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ac2ead7081f49d008ad172af1f39e30f4ae74e0018f0245fd4a57d804cccc66d",
"md5": "502ac6f7a16a9f7b1696e5f495ba4d36",
"sha256": "8dc5f9337d8c2fe0dffa38d668f8d5746c8379198e7e478d630c994c7f4cce9a"
},
"downloads": -1,
"filename": "pybuoy-0.5.7.tar.gz",
"has_sig": false,
"md5_digest": "502ac6f7a16a9f7b1696e5f495ba4d36",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.11",
"size": 25897,
"upload_time": "2024-12-26T16:41:25",
"upload_time_iso_8601": "2024-12-26T16:41:25.201942Z",
"url": "https://files.pythonhosted.org/packages/ac/2e/ad7081f49d008ad172af1f39e30f4ae74e0018f0245fd4a57d804cccc66d/pybuoy-0.5.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-26 16:41:25",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "clairBuoyant",
"github_project": "pybuoy",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "pybuoy"
}
JSON
