{ "info": { "author": "Reed Haffner", "author_email": "reedhaffner@pm.me", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3" ], "description": "# Heliacal [![PyPI](https://img.shields.io/pypi/v/Heliacal.svg)](https://pypi.org/project/Heliacal/)\n\nPython module to get sunrise, sunset, daytime, and twilight data for a location.\n\nThis is an API wrapper for [sunrise-sunset.org](https://sunrise-sunset.org/).\n\n## To get started, install heliacal\n\n pip install heliacal\n\n## Next, add heliacal and datetime to your project\n\n from heliacal import Heliacal\n import datetime\n\nHeliacal requires datetime to run.\n\n## Create a heliacal object\n\nHeliacal uses latitude and longitude to determine solar data for a location. You can use modules such as [geopy](https://geopy.readthedocs.io/en/stable/) to get the co-ordinates of a named location.\n\n los_angeles = Heliacal(34.052235, -118.243683)\n\nBy default, Heliacal will set the date to today, to change that, use set_date().\n\n los_angeles.set_date(datetime.datetime(2018, 12, 31)) # Get solar data for 2018-12-31\n\nYou now have a working Heliacal instance! You can get the following information:\n\n los_angeles.sunrise # 2018-12-31 14:58:24\n los_angeles.sunset # 2019-01-01 00:54:16\n los_angeles.solar_noon # 2018-12-31 19:56:20\n los_angeles.day_length # 35752 (seconds)\n los_angeles.civil_twilight_begin # 2018-12-31 14:30:50\n los_angeles.civil_twilight_end # 2019-01-01 01:21:49\n los_angeles.nautical_twilight_begin # 2018-12-31 13:59:38\n los_angeles.nautical_twilight_end # 2019-01-01 01:53:01\n los_angeles.astronomical_twilight_begin # 2018-12-31 13:29:11\n los_angeles.astronomical_twilight_end # 2019-01-01 02:23:28\n\n # For debugging or other things, there are:\n los_angeles.requesturl # https://api.sunrise-suns...\n los_angeles.json # {'sunrise': '2018-12-31T14:58:...\n\nNote: Heliacal returns UTC datetimes, it is the developer's job to turn them to the respective timezone.\n\n## Troubleshooting\n\nIf you receive an `SSL: CERTIFICATE_VERIFY_FAILED` error and you are using MacOS. Follow these steps in terminal:\n\n```sh\ncd /Applications/Python\\ 3.7\n./Install Certificates.command\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/reedhaffner/heliacal", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "Heliacal", "package_url": "https://pypi.org/project/Heliacal/", "platform": "", "project_url": "https://pypi.org/project/Heliacal/", "project_urls": { "Homepage": "https://github.com/reedhaffner/heliacal" }, "release_url": "https://pypi.org/project/Heliacal/2.0.1/", "requires_dist": null, "requires_python": ">=3", "summary": "Python module to get sunrise, sunset, daytime, and twilight data for a location.", "version": "2.0.1" }, "last_serial": 4927821, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "791f0694e2b14751807b26eb6b576876", "sha256": "2b8681ff23421dac6fe4174ae812d8fbd3a36254af7b90199715f60c5c0011c3" }, "downloads": -1, "filename": "Heliacal-1.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "791f0694e2b14751807b26eb6b576876", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3", "size": 14180, "upload_time": "2018-12-31T02:37:31", "url": "https://files.pythonhosted.org/packages/d2/d1/b36158345c0eb0779502791a9a3057165193e08cac2b4a318592a01ff2d6/Heliacal-1.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "5d3a3b4ef76b8b55a6a41f390814e24d", "sha256": "c1c3a2c7aaf97d7394f610f904341bbac1652728fe0f0e5a086fd0c4cffccea7" }, "downloads": -1, "filename": "Heliacal-1.0.0.tar.gz", "has_sig": false, "md5_digest": "5d3a3b4ef76b8b55a6a41f390814e24d", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3", "size": 1809, "upload_time": "2018-12-31T02:37:33", "url": "https://files.pythonhosted.org/packages/ce/f7/03e32af857f91aa2622d6434b7d6656c12e42e126f94a3e8cf8017e682aa/Heliacal-1.0.0.tar.gz" } ], "2.0.1": [ { "comment_text": "", "digests": { "md5": "6780feb72d66c6b1c523e447f7e2467a", "sha256": "45eac3344be5aedccacdf38203484461c972a0c9723e6cb5979e5d25cc4f7965" }, "downloads": -1, "filename": "Heliacal-2.0.1.tar.gz", "has_sig": false, "md5_digest": "6780feb72d66c6b1c523e447f7e2467a", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3", "size": 2001, "upload_time": "2019-03-12T00:55:07", "url": "https://files.pythonhosted.org/packages/73/2c/85ce84be764716ad31f3e377a0af03d72575ef88ffe4edea2e3913cd5ca4/Heliacal-2.0.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "6780feb72d66c6b1c523e447f7e2467a", "sha256": "45eac3344be5aedccacdf38203484461c972a0c9723e6cb5979e5d25cc4f7965" }, "downloads": -1, "filename": "Heliacal-2.0.1.tar.gz", "has_sig": false, "md5_digest": "6780feb72d66c6b1c523e447f7e2467a", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3", "size": 2001, "upload_time": "2019-03-12T00:55:07", "url": "https://files.pythonhosted.org/packages/73/2c/85ce84be764716ad31f3e377a0af03d72575ef88ffe4edea2e3913cd5ca4/Heliacal-2.0.1.tar.gz" } ] }