{ "info": { "author": "Stacy Brock", "author_email": "kalrnux@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 2 - Pre-Alpha", "License :: OSI Approved :: Apache Software License", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7" ], "description": "\n# nwswx\n\nA Python 3 client for retrieving data from the [NWS Weather Forecast API](https://forecast-v3.weather.gov/documentation).\n\n## Installation\n\n```\npip install nwswx\n```\n\n## Requirements\n\n* Python 3.4+\n* [Requests](http://docs.python-requests.org)\n\n### Package Build Requirements\n\nThe full list of packages required to build this module can be found in `requirements.txt`\n\n## Documentation\n\nFull documentation, including examples and an API reference: http://nwswx.readthedocs.io\n\n## Examples\n\nGet forecast for a point in GeoJSON format:\n```\n>>> import nwswx\n>>> nws = nwswx.WxAPI('your@email.com')\n>>> forecast = nws.point_forecast(39.0693, -94.6716)\n>>> print(forecast)\n{\n \"@context\": [\n \"https://raw.githubusercontent.com/geojson/geojson-ld/master/contexts/geojson-base.jsonld\",\n {\n \"wx\": \"https://api.weather.gov/ontology#\",\n \"geo\": \"http://www.opengis.net/ont/geosparql#\",\n \"unit\": \"http://codes.wmo.int/common/unit/\",\n \"@vocab\": \"https://api.weather.gov/ontology#\"\n }\n ], ...\n```\n\nGet forecast for a point in JSON-LD format:\n```\n>>> import nwswx\n>>> nws = nwswx.WxAPI('your@email.com')\n>>> forecast = nws.point_forecast(39.0693, -94.6716, return_format=nwswx.formats.JSONLD)\n>>> print(forecast['periods'])\n[{'number': 1, 'name': 'Tonight', 'startTime': '2019-01-13T22:00:00-08:00', 'endTime':\n'2019-01-14T06:00:00-08:00', 'isDaytime': False, 'temperature': 28, 'temperatureUnit':\n'F', 'temperatureTrend': None, 'windSpeed': '2 to 6 mph', 'windDirection': 'N',\n'icon': 'https://api.weather.gov/icons/land/night/few?size=medium', 'shortForecast':\n'Mostly Clear', 'detailedForecast': 'Mostly clear, with a low around 28. North wind 2\nto 6 mph.'}, ...\n```\n\nGet an hourly forecast for a point in JSON-LD format:\n```\n>>> import nwswx\n>>> nws = nwswx.WxAPI('your@email.com')\n>>> forecast = nws.point_hourly_forecast(39.0693, -94.6716, return_format=nwswx.formats.JSONLD)\n>>> print(forecast['periods'])\n[{'number': 1, 'name': '', 'startTime': '2019-01-16T19:00:00-08:00', 'endTime':\n'2019-01-16T20:00:00-08:00', 'isDaytime': False, 'temperature': 42,\n'temperatureUnit': 'F', 'temperatureTrend': None, 'windSpeed': '10 mph', 'windDirection':\n'NE', 'icon': 'https://api.weather.gov/icons/land/night/rain,90?size=small',\n'shortForecast': 'Light Rain', 'detailedForecast': ''}, ...\n```\n\nGet active weather alerts for a point in ATOM format:\n```\n>>> import nwswx\n>>> nws = nwswx.WxAPI('your@email.com')\n>>> alerts = nws.active_alerts({'point': '39.0693,-94.6716'}, return_format=nwswx.formats.ATOM)\n>>> print(alerts)\n\n\n https://api.weather.gov/alerts?point=39.0693%2C-94.6716&active=1&zone=KSZ104%2CKSC209\n NWS CAP Server\n 2019-01-17T06:04:28+00:00\n \n w-nws.webmaster@noaa.gov\n \n current watches, warnings, and advisories for 39.0693 N, 94.6716 W\n \n \n https://api.weather.gov/alerts/NWS-IDP-PROD-3320294-2901037\n \n 2019-01-16T14:52:00-06:00\n 2019-01-16T14:52:00-06:00\n \n NWS\n \n Winter Weather Advisory issued January 16 at 2:52PM CST expiring January 17 at 9:00AM CST by NWS Kansas City/Pleasant HIll MO\n...\n```\n\n## Limitations, of Which There Are Many\n\nThe following list of endpoints have not been implemented:\n\n* `/stations`\n* `/stations/{stationId}`\n* `/stations/{stationId}/observations`\n* `/stations/{stationId}/observations/current`\n* `/stations/{stationId}/observations/{recordId}`\n* `/products/{productId}`\n* `/products/types`\n* `/products/types/{typeId}`\n* `/products/types/{typeId}/locations`\n* `/products/types/{typeId}/locations/{locationId}`\n* `/products/locations`\n* `/products/locations/{locationId}/types`\n* `/offices/{officeId}`\n* `/zones/{type}/{zoneId}`\n* `/zones/{type}/{zoneId}/forecast`\n* `/alerts/active/count`\n* `/alerts/active/zone/{zoneId}`\n* `/alerts/active/area/{area}`\n* `/alerts/active/region/{region}`\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/stacybrock/nws-wx-client", "keywords": "", "license": "Apache-2.0", "maintainer": "", "maintainer_email": "", "name": "nwswx", "package_url": "https://pypi.org/project/nwswx/", "platform": "", "project_url": "https://pypi.org/project/nwswx/", "project_urls": { "Homepage": "https://github.com/stacybrock/nws-wx-client" }, "release_url": "https://pypi.org/project/nwswx/0.1.1/", "requires_dist": [ "requests" ], "requires_python": ">=3.4.0", "summary": "A Python 3 client for retrieving data from the NWS Weather Forecast API", "version": "0.1.1" }, "last_serial": 4758039, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "d7c731ec3e3f6f91727627bb207d15f5", "sha256": "ddd0eb7a4d0557019cfb78bab9d0ef7595c0a2d410551819327f0eacde0d3f93" }, "downloads": -1, "filename": "nwswx-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "d7c731ec3e3f6f91727627bb207d15f5", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.4.0", "size": 12265, "upload_time": "2019-01-17T22:49:16", "url": "https://files.pythonhosted.org/packages/09/aa/5af68c955c771ce014b22ce4740acc444bfb1200e8dcbd95a54b26cdbc82/nwswx-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3e405c167b0b8c413554c7057928d44c", "sha256": "027339e05187a07db9f9508e29d892cf0b8ea965e9c3fcf4c8b50e94d6063d06" }, "downloads": -1, "filename": "nwswx-0.1.0.tar.gz", "has_sig": false, "md5_digest": "3e405c167b0b8c413554c7057928d44c", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.4.0", "size": 13911, "upload_time": "2019-01-17T22:49:18", "url": "https://files.pythonhosted.org/packages/03/2f/b504437abd242bb916748158c60ef240f02d8a04e11dd53941b53dc7c647/nwswx-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "1ce44d2865c542d6c23c72c2ba7ad592", "sha256": "95aae12553f3205910e12062c58b7b5bbf745ac2874570134b6eb1565a561ddc" }, "downloads": -1, "filename": "nwswx-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "1ce44d2865c542d6c23c72c2ba7ad592", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.4.0", "size": 12285, "upload_time": "2019-01-30T05:12:56", "url": "https://files.pythonhosted.org/packages/ac/ca/bbdc89626de71abfae168f62390d90544060c275ec339417fe5f37546d47/nwswx-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3aa3baf43c12534b9f309f8ec7ad458e", "sha256": "299f7ae6ada27b0de49657bed4f683023b8a58eb3e0d5be8881cb5db8785af4d" }, "downloads": -1, "filename": "nwswx-0.1.1.tar.gz", "has_sig": false, "md5_digest": "3aa3baf43c12534b9f309f8ec7ad458e", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.4.0", "size": 13965, "upload_time": "2019-01-30T05:12:58", "url": "https://files.pythonhosted.org/packages/d4/ad/ec010876b81fa45abd90dacd44ccf528be1bf881bf33c72c5e081aaccbd5/nwswx-0.1.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "1ce44d2865c542d6c23c72c2ba7ad592", "sha256": "95aae12553f3205910e12062c58b7b5bbf745ac2874570134b6eb1565a561ddc" }, "downloads": -1, "filename": "nwswx-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "1ce44d2865c542d6c23c72c2ba7ad592", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.4.0", "size": 12285, "upload_time": "2019-01-30T05:12:56", "url": "https://files.pythonhosted.org/packages/ac/ca/bbdc89626de71abfae168f62390d90544060c275ec339417fe5f37546d47/nwswx-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3aa3baf43c12534b9f309f8ec7ad458e", "sha256": "299f7ae6ada27b0de49657bed4f683023b8a58eb3e0d5be8881cb5db8785af4d" }, "downloads": -1, "filename": "nwswx-0.1.1.tar.gz", "has_sig": false, "md5_digest": "3aa3baf43c12534b9f309f8ec7ad458e", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.4.0", "size": 13965, "upload_time": "2019-01-30T05:12:58", "url": "https://files.pythonhosted.org/packages/d4/ad/ec010876b81fa45abd90dacd44ccf528be1bf881bf33c72c5e081aaccbd5/nwswx-0.1.1.tar.gz" } ] }