{ "info": { "author": "Yann B\u00fcchau", "author_email": "yann.buechau@web.de", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: GNU General Public License v3 (GPLv3)", "Operating System :: OS Independent", "Programming Language :: Python :: 3.5", "Topic :: Home Automation", "Topic :: Internet", "Topic :: Scientific/Engineering :: Atmospheric Science", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: Utilities" ], "description": "patatmo Python package\n======================\n\n|build-badge| |docs-badge| |coverage-badge| |pypi-badge|\n\nThis package provides easy access to the `Netatmo `_\n`API `_. It is **painless** as it completely and\nintelligently hides the OAuth2 authentication from you.\n\nDisclaimer\n++++++++++\n\n **This software to access the** `Netatmo Weather API `_\n **emerged as part of thesis and also out of private interest.\n The author is not in any way affiliated with Netatmo (SAS).**\n\nCapabilities\n++++++++++++\n\nCurrently, the weather API's methods ``Getpublicdata``, ``Getstationsdata`` and\n``Getmeasure`` are implemented.\n\n\nExample usage\n+++++++++++++\n\nAn example of obtaining all public station's data in the region of\nHamburg/Germany:\n\nFrom the command-line\n---------------------\n\nThe smart way is to set up a configuration file `~/.patatmo/settings.conf`:\n\n\n.. code::\n\n [account]\n username=user.email@internet.com\n password=5uP3rP45sW0rD\n client_id=03012823b3fd2e420fbf980b\n client_secret=YXNkZmFzZGYgamFzamYgbGFzIG\n\nThen on the command-line:\n\n.. code:: sh\n\n netatmo-getpublicdata \\\n --lat_ne 53.7499 \\\n --lat_sw 53.3809 \\\n --lon_ne 10.3471 \\\n --lon_sw 9.7085\n\nAs one-liner:\n\n.. code:: sh\n\n netatmo-getpublicdata \\\n --user \"user.email@internet.com\" \\\n --password \"5uP3rP45sW0rD\" \\\n --id \"5uP3rP45sW0rD\" \\\n --secret \"YXNkZmFzZGYgamFzamYgbGFzIG\" \\\n --lat_ne 53.7499 \\\n --lat_sw 53.3809 \\\n --lon_ne 10.3471 \\\n --lon_sw 9.7085\n\nWith environment variables (which you could also set elsewhere,\ne.g. in your ``.bashrc``):\n\n.. code:: sh\n\n export NETATMO_USERNAME=\"user.email@internet.com\"\n export NETATMO_PASSWORD=\"5uP3rP45sW0rD\"\n export NETATMO_CLIENT_ID=\"03012823b3fd2e420fbf980b\"\n export NETATMO_CLIENT_SECRET=\"YXNkZmFzZGYgamFzamYgbGFzIG\"\n netatmo-getpublicdata \\\n --lat_ne 53.7499 \\\n --lat_sw 53.3809 \\\n --lon_ne 10.3471 \\\n --lon_sw 9.7085\n\n\nFrom Python\n-----------\n\nAn example of obtaining all public station's data in the region of\nHamburg/Germany:\n\n.. code:: python\n\n import patatmo\n\n # your netatmo connect developer credentials\n credentials = {\n \"password\":\"5uP3rP45sW0rD\",\n \"username\":\"user.email@internet.com\",\n \"client_id\": \"03012823b3fd2e420fbf980b\",\n \"client_secret\":\"YXNkZmFzZGYgamFzamYgbGFzIG\"\n }\n\n # configure the authentication\n authentication = patatmo.api.authentication.Authentication(\n credentials=credentials,\n tmpfile = \"temp_auth.json\"\n )\n # providing a path to a tmpfile is optionally.\n # If you do so, the tokens are stored there for later reuse,\n # e.g. next time you invoke this script.\n # This saves time because no new tokens have to be requested.\n # New tokens are then only requested if the old ones expire.\n\n # create a api client\n client = patatmo.api.client.NetatmoClient(authentication)\n\n # lat/lon outline of Hamburg/Germany\n hamburg_region = {\n \"lat_ne\" : 53.7499,\n \"lat_sw\" : 53.3809,\n \"lon_ne\" : 10.3471,\n \"lon_sw\" : 9.7085,\n }\n\n # issue the API request\n hamburg = client.Getpublicdata(region = hamburg_region)\n\n # convert the response to a pandas.DataFrame\n print(hamburg.dataframe.to_csv())\n\n\n.. code::\n\n ,index,altitude,humidity,id,latitude,longitude,pressure,temperature,time_humidity,time_pressure,time_temperature,timezone\n 0,0,30.0,67.0,70:ee:50:12:9a:b8,53.51695,10.15599,1015.4,22.5,2017-08-26 16:36:19,2017-08-26 16:36:36,2017-08-26 16:36:19,Europe/Berlin\n 1,1,23.0,65.0,70:ee:50:03:da:4c,53.523361337741,10.16719281615,1013.2,22.8,2017-08-26 16:35:33,2017-08-26 16:36:11,2017-08-26 16:35:33,Europe/Berlin\n 2,2,25.0,80.0,70:ee:50:02:95:92,53.517903,10.165769,1016.9,21.5,2017-08-26 16:38:17,2017-08-26 16:38:23,2017-08-26 16:38:17,Europe/Berlin\n 3,3,,,70:ee:50:17:bd:96,53.530789,10.127101,1010.1,,,2017-08-26 16:35:01,,Europe/Berlin\n 4,4,15.0,83.0,70:ee:50:03:bc:2c,53.530948,10.134062,1013.5,20.6,2017-08-26 16:35:07,2017-08-26 16:35:25,2017-08-26 16:35:07,Europe/Berlin\n 5,5,29.0,72.0,70:ee:50:03:72:28,53.545417580965,10.160120337925,1013.7,22.5,2017-08-26 16:42:05,2017-08-26 16:42:40,2017-08-26 16:42:05,Europe/Berlin\n 6,6,24.0,70.0,70:ee:50:14:42:1c,53.5698669,10.1554532,1011.4,23.2,2017-08-26 16:33:11,2017-08-26 16:33:55,2017-08-26 16:33:11,Europe/Berlin\n 7,7,31.0,69.0,70:ee:50:06:92:40,53.57426932987,10.161323698426,1013.7,22.3,2017-08-26 16:35:02,2017-08-26 16:35:30,2017-08-26 16:35:02,Europe/Berlin\n 8,8,26.0,68.0,70:ee:50:01:3c:f6,53.5811,10.1485,1016.2,23.2,2017-08-26 16:40:57,2017-08-26 16:41:21,2017-08-26 16:40:57,Europe/Berlin\n\n\nInstall\n+++++++\n\nThis package is on `PyPi `_. To install `patatmo`,\nrun\n\n.. code:: sh\n\n pip install --user patatmo\n\nDocumentation\n+++++++++++++\n\nYou can find detailed documentation of this package\n`here on on Gitlab `_.\n\nDevelopment\n+++++++++++\n\nThe following might only be interesting for developers\n\nLocal installation\n------------------\n\nInstall this module from the repository root via :code:`pip`:\n\n.. code:: sh\n\n # local user library under ~/.local\n pip3 install --user .\n # in \"editable\" mode\n pip3 install --user -e .\n\nTesting\n-------\n\nTo be able to run *all* tests, you need to specify valid **credentials and a\ndevice and model id** of your test station. You can do so either in the file\n``tests/USER_DATA.json`` (e.g. copy the example file :code:`cp\ntests/USER_DATA.json.example tests/USER_DATA.json` and adjust it) or via the\nenvironment variables\n\n.. code:: sh\n\n NETATMO_CLIENT_ID\n NETATMO_CLIENT_SECRET\n NETATMO_USERNAME\n NETATMO_PASSWORD\n NETATMO_DEVICE_ID\n NETATMO_MODULE_ID\n\nOtherwise, only the possible tests are run.\n\nThen:\n\n- ``make test`` to run all tests directly\n- ``make testverbose`` to run all tests directly with verbose output\n- ``make setup-test`` to run all tests via the ``./setup.py test`` mechanism\n- ``make coverage`` to get a test coverage\n\nVersioning\n----------\n\n- ``make increase-patch`` to increase the patch version number\n- ``make increase-minor`` to increase the minor version number\n- ``make increase-major`` to increase the major version number\n\n\n.. |build-badge| image:: https://gitlab.com/nobodyinperson/python3-patatmo/badges/master/build.svg\n :target: https://gitlab.com/nobodyinperson/python3-patatmo/commits/master\n :alt: Build\n\n.. |docs-badge| image:: https://img.shields.io/badge/docs-sphinx-brightgreen.svg\n :target: https://nobodyinperson.gitlab.io/python3-patatmo/\n :alt: Documentation\n\n.. |coverage-badge| image:: https://gitlab.com/nobodyinperson/python3-patatmo/badges/master/coverage.svg\n :target: https://nobodyinperson.gitlab.io/python3-patatmo/coverage-report\n :alt: Coverage\n\n.. |pypi-badge| image:: https://badge.fury.io/py/patatmo.svg\n :target: https://badge.fury.io/py/patatmo\n :alt: PyPi", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://gitlab.com/nobodyinperson/python3-patatmo", "keywords": "netatmo,api", "license": "GPLv3", "maintainer": "", "maintainer_email": "", "name": "patatmo", "package_url": "https://pypi.org/project/patatmo/", "platform": "", "project_url": "https://pypi.org/project/patatmo/", "project_urls": { "Homepage": "https://gitlab.com/nobodyinperson/python3-patatmo" }, "release_url": "https://pypi.org/project/patatmo/0.2.15/", "requires_dist": null, "requires_python": "", "summary": "painless access to the netatmo weather api", "version": "0.2.15" }, "last_serial": 5229273, "releases": { "0.2.1": [ { "comment_text": "", "digests": { "md5": "028532510758bcc813a7b7c0143d131a", "sha256": "25177b1bbb2b940b0ffacc258c0c993b3e1be6396ca2d52fb37bd24425062313" }, "downloads": -1, "filename": "patatmo-0.2.1.linux-x86_64.tar.gz", "has_sig": false, "md5_digest": "028532510758bcc813a7b7c0143d131a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 31714, "upload_time": "2017-07-12T20:29:18", "url": "https://files.pythonhosted.org/packages/3b/c0/cdf8c35889c6ba50e07e83c9c80a1b9ece6593a1d49f95079b3645181f64/patatmo-0.2.1.linux-x86_64.tar.gz" }, { "comment_text": "", "digests": { "md5": "62408eb13561b5cab8430ec403cb766b", "sha256": "05f0196c6b7c663786a9f64b72929f2fee200e33a6072f972a322b69b0ef0bd2" }, "downloads": -1, "filename": "patatmo-0.2.1-py3-none-any.whl", "has_sig": false, "md5_digest": "62408eb13561b5cab8430ec403cb766b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 22583, "upload_time": "2017-07-12T20:27:29", "url": "https://files.pythonhosted.org/packages/17/66/51284576506062ebe0932438307f51f974b84a3c86fc5ba3864b0961c69e/patatmo-0.2.1-py3-none-any.whl" } ], "0.2.10": [ { "comment_text": "", "digests": { "md5": "d8fb93493c3f682db3d241738bb610a0", "sha256": "b3fe68ca1c6a168418c5b64f46437d95d9343cbdc5c5dee8d96d768b30cde1a5" }, "downloads": -1, "filename": "patatmo-0.2.10.tar.gz", "has_sig": false, "md5_digest": "d8fb93493c3f682db3d241738bb610a0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21849, "upload_time": "2017-08-26T16:30:30", "url": "https://files.pythonhosted.org/packages/10/ef/2e40d8a32e2ac01f1e877fecdea21ff2f19a297191a1f0887bed2164e42c/patatmo-0.2.10.tar.gz" } ], "0.2.11": [ { "comment_text": "", "digests": { "md5": "8961a53e62583c1fd04f976775b0ea91", "sha256": "a7618ecb8f3d9623f000e07f478105fa582362fc777ce280a1adc48174a370d6" }, "downloads": -1, "filename": "patatmo-0.2.11.tar.gz", "has_sig": false, "md5_digest": "8961a53e62583c1fd04f976775b0ea91", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22352, "upload_time": "2017-08-26T17:22:14", "url": "https://files.pythonhosted.org/packages/7d/da/78f625355b199de9d37d150e63e06df1b630c1ce7870c68f574288ab5223/patatmo-0.2.11.tar.gz" } ], "0.2.12": [ { "comment_text": "", "digests": { "md5": "ba7293af860efc2ea3f0696cb39ff238", "sha256": "5f07f3f5049d1b91fa1896fb386395d6c0347160eff225c2ea2d1491740ab2df" }, "downloads": -1, "filename": "patatmo-0.2.12.tar.gz", "has_sig": false, "md5_digest": "ba7293af860efc2ea3f0696cb39ff238", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23489, "upload_time": "2017-09-23T11:58:44", "url": "https://files.pythonhosted.org/packages/52/b6/3e75b7a6cc2399985fc85ec4a866ef2c0de5bdbf41c4bbaf55911e4bd504/patatmo-0.2.12.tar.gz" } ], "0.2.13": [ { "comment_text": "", "digests": { "md5": "3410cfe927bb35c7287a5db9b7ba3585", "sha256": "6e1324ff916e12a334a0210fc9b805e4b27293ff8454c623636fb0ff79a8bd42" }, "downloads": -1, "filename": "patatmo-0.2.13.tar.gz", "has_sig": false, "md5_digest": "3410cfe927bb35c7287a5db9b7ba3585", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21664, "upload_time": "2018-01-11T13:36:13", "url": "https://files.pythonhosted.org/packages/3a/94/f1ccd598ee8b3a0b944b2178f12a1658cb46fc5117f48cb40a92bf3a9f46/patatmo-0.2.13.tar.gz" } ], "0.2.14": [ { "comment_text": "", "digests": { "md5": "466c892b0674223c63f0ff1fd81e3fc1", "sha256": "7e20e28040225fead0b71384eaeb8d8227d3e4a5c2f8a483b59eb7300aa57de9" }, "downloads": -1, "filename": "patatmo-0.2.14.tar.gz", "has_sig": false, "md5_digest": "466c892b0674223c63f0ff1fd81e3fc1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22085, "upload_time": "2018-03-12T16:27:20", "url": "https://files.pythonhosted.org/packages/d7/b0/f421e72f2951fb1803b84ba621605bd790662c6afe146f0cb3f7cfa28445/patatmo-0.2.14.tar.gz" } ], "0.2.15": [ { "comment_text": "", "digests": { "md5": "079575fb429f25bef97669cd293485d7", "sha256": "1683ad1992f5f15bd654e8e51c15b96143449f9b17764927dff71547b2120002" }, "downloads": -1, "filename": "patatmo-0.2.15.tar.gz", "has_sig": false, "md5_digest": "079575fb429f25bef97669cd293485d7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23847, "upload_time": "2019-05-05T18:55:49", "url": "https://files.pythonhosted.org/packages/19/e6/fe9ee5c3d7b8a444294136b598424cf0fb5e0fefd35b3ee470a6a65d22f5/patatmo-0.2.15.tar.gz" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "c8cfa8870a23456319a7ae70a0caea6d", "sha256": "1ca05c5cfe6229080ce4e51d80265fe21414f1c02cd5d235accaf125334df1cb" }, "downloads": -1, "filename": "patatmo-0.2.2.linux-x86_64.tar.gz", "has_sig": false, "md5_digest": "c8cfa8870a23456319a7ae70a0caea6d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 31231, "upload_time": "2017-07-12T20:41:37", "url": "https://files.pythonhosted.org/packages/c8/da/51ad2aa6fa4accbc62e03273eebc9bf7e65b7f21f17b305f5471f4fe1c5a/patatmo-0.2.2.linux-x86_64.tar.gz" }, { "comment_text": "", "digests": { "md5": "fa9dcf7729d8f52ef264c27035dda7fa", "sha256": "ca6d0fb2e765084992db1d97ec0f6a9f8ac40c533129b1787ccf3205cdf880ca" }, "downloads": -1, "filename": "patatmo-0.2.2-py3-none-any.whl", "has_sig": false, "md5_digest": "fa9dcf7729d8f52ef264c27035dda7fa", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 22580, "upload_time": "2017-07-12T20:41:36", "url": "https://files.pythonhosted.org/packages/9d/79/2b3aa3fe93cb6c1474e36a82c0c1d6eb4681a8d537d75a3637146255af83/patatmo-0.2.2-py3-none-any.whl" } ], "0.2.3": [ { "comment_text": "", "digests": { "md5": "acd759b4d90e01909be07acaa35acce1", "sha256": "4ca8c2626c0d80320007260842b682e60d92d9fdf131cdef6f4336ddc9e5bd93" }, "downloads": -1, "filename": "patatmo-0.2.3.tar.gz", "has_sig": false, "md5_digest": "acd759b4d90e01909be07acaa35acce1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16217, "upload_time": "2017-07-12T20:47:52", "url": "https://files.pythonhosted.org/packages/fb/83/b6e30a2e6fbfb1a7f1c96b9e66ac1080a559dabfb8d20813127a0bbb992b/patatmo-0.2.3.tar.gz" } ], "0.2.4": [ { "comment_text": "", "digests": { "md5": "a0a2500ee68d3a2b53494f5ffd55dc93", "sha256": "b38ea388cee5633a500fe7adf3484c942663f4f0b74aeade48cd63bacd199f04" }, "downloads": -1, "filename": "patatmo-0.2.4.tar.gz", "has_sig": false, "md5_digest": "a0a2500ee68d3a2b53494f5ffd55dc93", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16211, "upload_time": "2017-07-12T21:08:05", "url": "https://files.pythonhosted.org/packages/2e/d0/630e31fb98037b921111db735564d247dca7fcb8274e0e0cf13054d7251e/patatmo-0.2.4.tar.gz" } ], "0.2.5": [ { "comment_text": "", "digests": { "md5": "46c3ce43c4ec22507acaec34d8821518", "sha256": "b011f89af72f1566dbb3a99cc6c07390d3901ed17cbde65cb9ab5b148e3353b9" }, "downloads": -1, "filename": "patatmo-0.2.5.tar.gz", "has_sig": false, "md5_digest": "46c3ce43c4ec22507acaec34d8821518", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16259, "upload_time": "2017-07-13T09:08:38", "url": "https://files.pythonhosted.org/packages/98/16/7a56816e6c8afff11e1320bbe481932420df2b97ed2c9ce65113877bac91/patatmo-0.2.5.tar.gz" } ], "0.2.6": [ { "comment_text": "", "digests": { "md5": "081c821b14ae66dc98ae3e6d25749231", "sha256": "4f7978f07d1358060598da9919a5cdf7f1434c4b753c3cd5953a86a80a15eac4" }, "downloads": -1, "filename": "patatmo-0.2.6.tar.gz", "has_sig": false, "md5_digest": "081c821b14ae66dc98ae3e6d25749231", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17484, "upload_time": "2017-08-14T15:04:41", "url": "https://files.pythonhosted.org/packages/28/67/2b180169d5c9054a219ecef8d41f64e687a9a7fa31f39f89ce4c8bd4ef29/patatmo-0.2.6.tar.gz" } ], "0.2.7": [ { "comment_text": "", "digests": { "md5": "c8b4b4a0adfeb3d23481048d8c4c917b", "sha256": "944b8c1a0a15e4afd25bc76d4a1bc84c7aff58c25177cbea5c6a0d4abe24c9e2" }, "downloads": -1, "filename": "patatmo-0.2.7.tar.gz", "has_sig": false, "md5_digest": "c8b4b4a0adfeb3d23481048d8c4c917b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 19608, "upload_time": "2017-08-15T11:38:19", "url": "https://files.pythonhosted.org/packages/50/b4/f7cb6578425f2ee8e30e968b8e2f27eef18c15100744126ab9960773c282/patatmo-0.2.7.tar.gz" } ], "0.2.8": [ { "comment_text": "", "digests": { "md5": "2e4add915c5590a5ebd2ddc6558e376e", "sha256": "dba0dfb47ae0ba55b7a9c4454e755632f2f7ec769fa00eb161feb275e5ef433c" }, "downloads": -1, "filename": "patatmo-0.2.8.tar.gz", "has_sig": false, "md5_digest": "2e4add915c5590a5ebd2ddc6558e376e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20312, "upload_time": "2017-08-15T14:37:03", "url": "https://files.pythonhosted.org/packages/21/89/b68a6145cb0f93a029558c35fdd016c3999b6361faa7efaefc3bc686d676/patatmo-0.2.8.tar.gz" } ], "0.2.9": [ { "comment_text": "", "digests": { "md5": "2d69f86fbec9e6cfa94c9614288bff3a", "sha256": "e245e8a40fdcf3fe65f9d1ec0eb42efb7dab1d65ad2680826f4889028c872296" }, "downloads": -1, "filename": "patatmo-0.2.9.tar.gz", "has_sig": false, "md5_digest": "2d69f86fbec9e6cfa94c9614288bff3a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21841, "upload_time": "2017-08-26T16:15:06", "url": "https://files.pythonhosted.org/packages/02/cc/a8aea0d960b752bf7b8888627e4ec269b7dbf705d9969063656d5396c09f/patatmo-0.2.9.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "079575fb429f25bef97669cd293485d7", "sha256": "1683ad1992f5f15bd654e8e51c15b96143449f9b17764927dff71547b2120002" }, "downloads": -1, "filename": "patatmo-0.2.15.tar.gz", "has_sig": false, "md5_digest": "079575fb429f25bef97669cd293485d7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23847, "upload_time": "2019-05-05T18:55:49", "url": "https://files.pythonhosted.org/packages/19/e6/fe9ee5c3d7b8a444294136b598424cf0fb5e0fefd35b3ee470a6a65d22f5/patatmo-0.2.15.tar.gz" } ] }