apicast


Nameapicast JSON
Version 0.9.0 PyPI version JSON
download
home_pagehttps://github.com/hiveeyes/apicast
SummaryPython client and HTTP service to access bee flight forecast information published by Deutscher Wetterdienst (DWD), the federal meteorological service in Germany.
upload_time2024-03-31 16:03:25
maintainerNone
docs_urlNone
authorAndreas Motl
requires_pythonNone
licenseAGPL 3, EUPL 1.2
keywords honey bee apis mellifera flight forecast information dwd cdc deutscher wetterdienst climate data center weather opendata data acquisition transformation export geospatial temporal timeseries sensor network observation http rest api json markdown
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            #######
Apicast
#######

|

.. start-badges

|ci-tests| |ci-coverage| |license| |pypi-downloads|
|python-versions| |status| |pypi-version|

.. |ci-tests| image:: https://github.com/hiveeyes/apicast/workflows/Tests/badge.svg
    :target: https://github.com/hiveeyes/apicast/actions?workflow=Tests

.. |ci-coverage| image:: https://codecov.io/gh/hiveeyes/apicast/branch/main/graph/badge.svg
    :target: https://codecov.io/gh/hiveeyes/apicast
    :alt: Test suite code coverage

.. |python-versions| image:: https://img.shields.io/pypi/pyversions/apicast.svg
    :target: https://python.org

.. |pypi-version| image:: https://img.shields.io/pypi/v/apicast.svg
    :target: https://pypi.org/project/apicast/

.. |status| image:: https://img.shields.io/pypi/status/apicast.svg
    :target: https://pypi.org/project/apicast/

.. |license| image:: https://img.shields.io/pypi/l/apicast.svg
    :target: https://pypi.org/project/apicast/

.. |pypi-downloads| image:: https://static.pepy.tech/badge/apicast/month
    :target: https://pepy.tech/project/apicast

.. end-badges


*****
About
*****

Apicast acquires bee flight forecast information published by Deutscher Wetterdienst (DWD).

- **Development**: `Hiveeyes » DWD-Prognose Bienenflug`_
- **Live API**: https://apicast.hiveeyes.org/ (also on HTTP)


*****
Setup
*****

CLI version::

    pip install apicast

HTTP API::

    pip install apicast[service]


********
Synopsis
********

Display list of states and sites::

    apicast beeflight stations

Display list of location slugs::

    apicast beeflight stations --slugs

Acquire information for given location slug ``brandenburg/potsdam``::

    apicast beeflight forecast --station=brandenburg/potsdam

Acquire information for given location slug ``brandenburg/potsdam``, output as table in Markdown format::

    apicast beeflight forecast --station=brandenburg/potsdam --format=table-markdown

Output as table in JSON machine readable format::

    apicast beeflight forecast --station=brandenburg/potsdam --format=json-machine



********
HTTP API
********

Start HTTP API service::

    apicast service

Start HTTP service with dynamic code reloading::

    apicast service --reload

Then navigate to::

    open http://localhost:24640/



*******
Example
*******

::

    apicast beeflight forecast --station=brandenburg/potsdam

::

    [
        {
            "Datum": "Mo 01.06.",
            "morgens": "stark",
            "mittags": "intensiv",
            "abends": "stark"
        },
        {
            "Datum": "Di 02.06.",
            "morgens": "stark",
            "mittags": "intensiv",
            "abends": "intensiv"
        },
        {
            "Datum": "Mi 03.06.",
            "morgens": "intensiv",
            "mittags": "intensiv",
            "abends": "intensiv"
        }
    ]


*****
Tests
*****

::

    make test


********************
Content attributions
********************

The copyright of data, particular images and pictograms are held by their respective owners, unless otherwise noted.

Data
====

- **Source**:

  - https://www.dwd.de/DE/leistungen/biene_flug/bienenflug.html
  - https://www.dwd.de/DE/fachnutzer/freizeitgaertner/1_gartenwetter/_node.html

- **Documentation**:

  - https://www.dwd.de/DE/fachnutzer/landwirtschaft/dokumentationen/allgemein/bienenflug_doku.html
  - https://www.dwd.de/DE/fachnutzer/landwirtschaft/dokumentationen/isabel/meinagrar_bienenflug.html
  - https://www.dwd.de/DE/klimaumwelt/ku_beratung/landwirtschaft/agrar_modelle/Bienenflug.pdf?__blob=publicationFile

- **Data copyright**: © Deutscher Wetterdienst (DWD), Agricultural Meteorology Department


Logo picture
============

- **Description**:     	A bee swarm on an oak tree in Plymouth, UK
- **Date**:    	        21 June 2009
- **Source**: 	        Own work
- **Author**: 	        Nilfanion
- **Camera location**:	50° 24′ 38.3″ N, 4° 09′ 28.2″ W
- **License**:          Creative Commons Attribution-Share Alike 3.0 Unported
- **URL**:              https://commons.wikimedia.org/wiki/File:Bee_swarm_in_Plymouth.jpg


.. _Hiveeyes » DWD-Prognose Bienenflug: https://community.hiveeyes.org/t/dwd-prognose-bienenflug/787

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/hiveeyes/apicast",
    "name": "apicast",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": "honey bee apis mellifera flight forecast information dwd cdc deutscher wetterdienst climate data center weather opendata data acquisition transformation export geospatial temporal timeseries sensor network observation http rest api json markdown",
    "author": "Andreas Motl",
    "author_email": "andreas@hiveeyes.org",
    "download_url": "https://files.pythonhosted.org/packages/b8/9c/2efcf133e7f9803e0ef148ad0465b8082370ecbe8ab34fd0ca326098fb6b/apicast-0.9.0.tar.gz",
    "platform": null,
    "description": "#######\nApicast\n#######\n\n|\n\n.. start-badges\n\n|ci-tests| |ci-coverage| |license| |pypi-downloads|\n|python-versions| |status| |pypi-version|\n\n.. |ci-tests| image:: https://github.com/hiveeyes/apicast/workflows/Tests/badge.svg\n    :target: https://github.com/hiveeyes/apicast/actions?workflow=Tests\n\n.. |ci-coverage| image:: https://codecov.io/gh/hiveeyes/apicast/branch/main/graph/badge.svg\n    :target: https://codecov.io/gh/hiveeyes/apicast\n    :alt: Test suite code coverage\n\n.. |python-versions| image:: https://img.shields.io/pypi/pyversions/apicast.svg\n    :target: https://python.org\n\n.. |pypi-version| image:: https://img.shields.io/pypi/v/apicast.svg\n    :target: https://pypi.org/project/apicast/\n\n.. |status| image:: https://img.shields.io/pypi/status/apicast.svg\n    :target: https://pypi.org/project/apicast/\n\n.. |license| image:: https://img.shields.io/pypi/l/apicast.svg\n    :target: https://pypi.org/project/apicast/\n\n.. |pypi-downloads| image:: https://static.pepy.tech/badge/apicast/month\n    :target: https://pepy.tech/project/apicast\n\n.. end-badges\n\n\n*****\nAbout\n*****\n\nApicast acquires bee flight forecast information published by Deutscher Wetterdienst (DWD).\n\n- **Development**: `Hiveeyes \u00bb DWD-Prognose Bienenflug`_\n- **Live API**: https://apicast.hiveeyes.org/ (also on HTTP)\n\n\n*****\nSetup\n*****\n\nCLI version::\n\n    pip install apicast\n\nHTTP API::\n\n    pip install apicast[service]\n\n\n********\nSynopsis\n********\n\nDisplay list of states and sites::\n\n    apicast beeflight stations\n\nDisplay list of location slugs::\n\n    apicast beeflight stations --slugs\n\nAcquire information for given location slug ``brandenburg/potsdam``::\n\n    apicast beeflight forecast --station=brandenburg/potsdam\n\nAcquire information for given location slug ``brandenburg/potsdam``, output as table in Markdown format::\n\n    apicast beeflight forecast --station=brandenburg/potsdam --format=table-markdown\n\nOutput as table in JSON machine readable format::\n\n    apicast beeflight forecast --station=brandenburg/potsdam --format=json-machine\n\n\n\n********\nHTTP API\n********\n\nStart HTTP API service::\n\n    apicast service\n\nStart HTTP service with dynamic code reloading::\n\n    apicast service --reload\n\nThen navigate to::\n\n    open http://localhost:24640/\n\n\n\n*******\nExample\n*******\n\n::\n\n    apicast beeflight forecast --station=brandenburg/potsdam\n\n::\n\n    [\n        {\n            \"Datum\": \"Mo 01.06.\",\n            \"morgens\": \"stark\",\n            \"mittags\": \"intensiv\",\n            \"abends\": \"stark\"\n        },\n        {\n            \"Datum\": \"Di 02.06.\",\n            \"morgens\": \"stark\",\n            \"mittags\": \"intensiv\",\n            \"abends\": \"intensiv\"\n        },\n        {\n            \"Datum\": \"Mi 03.06.\",\n            \"morgens\": \"intensiv\",\n            \"mittags\": \"intensiv\",\n            \"abends\": \"intensiv\"\n        }\n    ]\n\n\n*****\nTests\n*****\n\n::\n\n    make test\n\n\n********************\nContent attributions\n********************\n\nThe copyright of data, particular images and pictograms are held by their respective owners, unless otherwise noted.\n\nData\n====\n\n- **Source**:\n\n  - https://www.dwd.de/DE/leistungen/biene_flug/bienenflug.html\n  - https://www.dwd.de/DE/fachnutzer/freizeitgaertner/1_gartenwetter/_node.html\n\n- **Documentation**:\n\n  - https://www.dwd.de/DE/fachnutzer/landwirtschaft/dokumentationen/allgemein/bienenflug_doku.html\n  - https://www.dwd.de/DE/fachnutzer/landwirtschaft/dokumentationen/isabel/meinagrar_bienenflug.html\n  - https://www.dwd.de/DE/klimaumwelt/ku_beratung/landwirtschaft/agrar_modelle/Bienenflug.pdf?__blob=publicationFile\n\n- **Data copyright**: \u00a9 Deutscher Wetterdienst (DWD), Agricultural Meteorology Department\n\n\nLogo picture\n============\n\n- **Description**:     \tA bee swarm on an oak tree in Plymouth, UK\n- **Date**:    \t        21 June 2009\n- **Source**: \t        Own work\n- **Author**: \t        Nilfanion\n- **Camera location**:\t50\u00b0 24\u2032 38.3\u2033 N, 4\u00b0 09\u2032 28.2\u2033 W\n- **License**:          Creative Commons Attribution-Share Alike 3.0 Unported\n- **URL**:              https://commons.wikimedia.org/wiki/File:Bee_swarm_in_Plymouth.jpg\n\n\n.. _Hiveeyes \u00bb DWD-Prognose Bienenflug: https://community.hiveeyes.org/t/dwd-prognose-bienenflug/787\n",
    "bugtrack_url": null,
    "license": "AGPL 3, EUPL 1.2",
    "summary": "Python client and HTTP service to access bee flight forecast information published by Deutscher Wetterdienst (DWD), the federal meteorological service in Germany.",
    "version": "0.9.0",
    "project_urls": {
        "Homepage": "https://github.com/hiveeyes/apicast"
    },
    "split_keywords": [
        "honey",
        "bee",
        "apis",
        "mellifera",
        "flight",
        "forecast",
        "information",
        "dwd",
        "cdc",
        "deutscher",
        "wetterdienst",
        "climate",
        "data",
        "center",
        "weather",
        "opendata",
        "data",
        "acquisition",
        "transformation",
        "export",
        "geospatial",
        "temporal",
        "timeseries",
        "sensor",
        "network",
        "observation",
        "http",
        "rest",
        "api",
        "json",
        "markdown"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "af8cdbdaa9b785049e95c78f36c56978311c4552867a512dd3630806f6c51daa",
                "md5": "8ce19c9a5da16ce5a915d70827be0ec0",
                "sha256": "07e98bc50ddd04120bc14141e7ac1ae65d0907ec0f8e45af4f405d1f014e8521"
            },
            "downloads": -1,
            "filename": "apicast-0.9.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "8ce19c9a5da16ce5a915d70827be0ec0",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 22654,
            "upload_time": "2024-03-31T16:03:23",
            "upload_time_iso_8601": "2024-03-31T16:03:23.306260Z",
            "url": "https://files.pythonhosted.org/packages/af/8c/dbdaa9b785049e95c78f36c56978311c4552867a512dd3630806f6c51daa/apicast-0.9.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b89c2efcf133e7f9803e0ef148ad0465b8082370ecbe8ab34fd0ca326098fb6b",
                "md5": "981a94b6ca8a10aac48f7b2e8fefed7e",
                "sha256": "66324c6f3c5620422b39daf901b437db7be05f7a83825cef28050f3b852264cb"
            },
            "downloads": -1,
            "filename": "apicast-0.9.0.tar.gz",
            "has_sig": false,
            "md5_digest": "981a94b6ca8a10aac48f7b2e8fefed7e",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 25495,
            "upload_time": "2024-03-31T16:03:25",
            "upload_time_iso_8601": "2024-03-31T16:03:25.369506Z",
            "url": "https://files.pythonhosted.org/packages/b8/9c/2efcf133e7f9803e0ef148ad0465b8082370ecbe8ab34fd0ca326098fb6b/apicast-0.9.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-03-31 16:03:25",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "hiveeyes",
    "github_project": "apicast",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "apicast"
}
        
Elapsed time: 4.17928s