diff options
| author | CoprDistGit <infra@openeuler.org> | 2023-05-05 08:35:40 +0000 |
|---|---|---|
| committer | CoprDistGit <infra@openeuler.org> | 2023-05-05 08:35:40 +0000 |
| commit | d5a8b26140ffaebdc2717851dab741d2dc2dc51d (patch) | |
| tree | c0fe0adb584887f05748cef84384a9d2a71b8186 | |
| parent | 06f1396fc2a28e0e57d178d7847e8bce042ae3dc (diff) | |
automatic import of python-aio-geojson-geonetnz-volcanoopeneuler20.03
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | python-aio-geojson-geonetnz-volcano.spec | 387 | ||||
| -rw-r--r-- | sources | 1 |
3 files changed, 389 insertions, 0 deletions
@@ -0,0 +1 @@ +/aio_geojson_geonetnz_volcano-0.8.tar.gz diff --git a/python-aio-geojson-geonetnz-volcano.spec b/python-aio-geojson-geonetnz-volcano.spec new file mode 100644 index 0000000..8fef0e6 --- /dev/null +++ b/python-aio-geojson-geonetnz-volcano.spec @@ -0,0 +1,387 @@ +%global _empty_manifest_terminate_build 0 +Name: python-aio-geojson-geonetnz-volcano +Version: 0.8 +Release: 1 +Summary: An async GeoJSON client library for GeoNet NZ Volcanic Alert Level feed. +License: Apache-2.0 +URL: https://github.com/exxamalte/python-aio-geojson-geonetnz-volcano +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/9b/b1/d4001c20b07d4ffe080c767a2e79053f314d9de2b032f16da1bfcf60d9ea/aio_geojson_geonetnz_volcano-0.8.tar.gz +BuildArch: noarch + +Requires: python3-aio-geojson-client +Requires: python3-aiohttp +Requires: python3-pytz + +%description +# python-aio-geojson-geonetnz-volcano + +[](https://github.com/exxamalte/python-aio-geojson-geonetnz-volcano/actions?workflow=CI) +[](https://codecov.io/gh/exxamalte/python-aio-geojson-geonetnz-volcano) +[](https://pypi.python.org/pypi/aio-geojson-geonetnz-volcano) +[](https://pypi.python.org/pypi/aio-geojson-geonetnz-volcano) + +This library for convenient async access to +[GeoNet NZ Volcanic Alert Level](https://api.geonet.org.nz/#val) feed. + + +## Installation +`pip install aio-geojson-geonetnz-volcano` + +## Usage +See below for examples of how this library can be used. After instantiating a +particular class - feed or feed manager - and supply the required parameters, +you can call `update` to retrieve the feed data. The return value +will be a tuple of a status code and the actual data in the form of a list of +feed entries specific to the selected feed. + +Status Codes +* _OK_: Update went fine and data was retrieved. The library may still + return empty data, for example because no entries fulfilled the filter + criteria. +* _OK_NO_DATA_: Update went fine but no data was retrieved, for example + because the server indicated that there was not update since the last request. +* _ERROR_: Something went wrong during the update + +**Parameters** + +| Parameter | Description | +|--------------------|-------------------------------------------| +| `home_coordinates` | Coordinates (tuple of latitude/longitude) | + +**Supported Filters** + +| Filter | | Description | +|--------|-----------------|-------------| +| Radius | `filter_radius` | Radius in kilometers around the home coordinates in which events from feed are included. | + +**Example** +```python +import asyncio +from aiohttp import ClientSession +from aio_geojson_geonetnz_volcano import GeonetnzVolcanoFeed +async def main() -> None: + async with ClientSession() as websession: + # Home Coordinates: Latitude: -41.2, Longitude: 174.7 + # Filter radius: 200 km + feed = GeonetnzVolcanoFeed(websession, + (-41.2, 174.7), + filter_radius=200) + status, entries = await feed.update() + print(status) + print(entries) +asyncio.get_event_loop().run_until_complete(main()) +``` + +## Feed entry properties +Each feed entry is populated with the following properties: + +| Name | Description | Feed attribute | +|------------------|-------------------------------------------------------|----------------| +| geometry | All geometry details of this entry. | `geometry` | +| coordinates | Best coordinates (latitude, longitude) of this entry. | `geometry` | +| external_id | The unique public identifier for this volcano. | `volcanoID` | +| title | Volcano title. | `volcanoTitle` | +| attribution | Attribution of the feed. | n/a | +| distance_to_home | Distance in km of this entry to the home coordinates. | n/a | +| alert_level | Volcanic alert level (0-5). | `level` | +| activity | Volcanic activity. | `activity` | +| hazards | Most likely hazards. | `hazards` | + + +## Feed Manager + +The Feed Manager helps managing feed updates over time, by notifying the +consumer of the feed about new feed entries, updates and removed entries +compared to the last feed update. + +* If the current feed update is the first one, then all feed entries will be + reported as new. The feed manager will keep track of all feed entries' + external IDs that it has successfully processed. +* If the current feed update is not the first one, then the feed manager will + produce three sets: + * Feed entries that were not in the previous feed update but are in the + current feed update will be reported as new. + * Feed entries that were in the previous feed update and are still in the + current feed update will be reported as to be updated. + * Feed entries that were in the previous feed update but are not in the + current feed update will be reported to be removed. +* If the current update fails, then all feed entries processed in the previous + feed update will be reported to be removed. + +After a successful update from the feed, the feed manager provides two +different dates: + +* `last_update` will be the timestamp of the last update from the feed + irrespective of whether it was successful or not. +* `last_update_successful` will be the timestamp of the last successful update + from the feed. This date may be useful if the consumer of this library wants + to treat intermittent errors from feed updates differently. +* `last_timestamp` is not available for this feed. + + +%package -n python3-aio-geojson-geonetnz-volcano +Summary: An async GeoJSON client library for GeoNet NZ Volcanic Alert Level feed. +Provides: python-aio-geojson-geonetnz-volcano +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-aio-geojson-geonetnz-volcano +# python-aio-geojson-geonetnz-volcano + +[](https://github.com/exxamalte/python-aio-geojson-geonetnz-volcano/actions?workflow=CI) +[](https://codecov.io/gh/exxamalte/python-aio-geojson-geonetnz-volcano) +[](https://pypi.python.org/pypi/aio-geojson-geonetnz-volcano) +[](https://pypi.python.org/pypi/aio-geojson-geonetnz-volcano) + +This library for convenient async access to +[GeoNet NZ Volcanic Alert Level](https://api.geonet.org.nz/#val) feed. + + +## Installation +`pip install aio-geojson-geonetnz-volcano` + +## Usage +See below for examples of how this library can be used. After instantiating a +particular class - feed or feed manager - and supply the required parameters, +you can call `update` to retrieve the feed data. The return value +will be a tuple of a status code and the actual data in the form of a list of +feed entries specific to the selected feed. + +Status Codes +* _OK_: Update went fine and data was retrieved. The library may still + return empty data, for example because no entries fulfilled the filter + criteria. +* _OK_NO_DATA_: Update went fine but no data was retrieved, for example + because the server indicated that there was not update since the last request. +* _ERROR_: Something went wrong during the update + +**Parameters** + +| Parameter | Description | +|--------------------|-------------------------------------------| +| `home_coordinates` | Coordinates (tuple of latitude/longitude) | + +**Supported Filters** + +| Filter | | Description | +|--------|-----------------|-------------| +| Radius | `filter_radius` | Radius in kilometers around the home coordinates in which events from feed are included. | + +**Example** +```python +import asyncio +from aiohttp import ClientSession +from aio_geojson_geonetnz_volcano import GeonetnzVolcanoFeed +async def main() -> None: + async with ClientSession() as websession: + # Home Coordinates: Latitude: -41.2, Longitude: 174.7 + # Filter radius: 200 km + feed = GeonetnzVolcanoFeed(websession, + (-41.2, 174.7), + filter_radius=200) + status, entries = await feed.update() + print(status) + print(entries) +asyncio.get_event_loop().run_until_complete(main()) +``` + +## Feed entry properties +Each feed entry is populated with the following properties: + +| Name | Description | Feed attribute | +|------------------|-------------------------------------------------------|----------------| +| geometry | All geometry details of this entry. | `geometry` | +| coordinates | Best coordinates (latitude, longitude) of this entry. | `geometry` | +| external_id | The unique public identifier for this volcano. | `volcanoID` | +| title | Volcano title. | `volcanoTitle` | +| attribution | Attribution of the feed. | n/a | +| distance_to_home | Distance in km of this entry to the home coordinates. | n/a | +| alert_level | Volcanic alert level (0-5). | `level` | +| activity | Volcanic activity. | `activity` | +| hazards | Most likely hazards. | `hazards` | + + +## Feed Manager + +The Feed Manager helps managing feed updates over time, by notifying the +consumer of the feed about new feed entries, updates and removed entries +compared to the last feed update. + +* If the current feed update is the first one, then all feed entries will be + reported as new. The feed manager will keep track of all feed entries' + external IDs that it has successfully processed. +* If the current feed update is not the first one, then the feed manager will + produce three sets: + * Feed entries that were not in the previous feed update but are in the + current feed update will be reported as new. + * Feed entries that were in the previous feed update and are still in the + current feed update will be reported as to be updated. + * Feed entries that were in the previous feed update but are not in the + current feed update will be reported to be removed. +* If the current update fails, then all feed entries processed in the previous + feed update will be reported to be removed. + +After a successful update from the feed, the feed manager provides two +different dates: + +* `last_update` will be the timestamp of the last update from the feed + irrespective of whether it was successful or not. +* `last_update_successful` will be the timestamp of the last successful update + from the feed. This date may be useful if the consumer of this library wants + to treat intermittent errors from feed updates differently. +* `last_timestamp` is not available for this feed. + + +%package help +Summary: Development documents and examples for aio-geojson-geonetnz-volcano +Provides: python3-aio-geojson-geonetnz-volcano-doc +%description help +# python-aio-geojson-geonetnz-volcano + +[](https://github.com/exxamalte/python-aio-geojson-geonetnz-volcano/actions?workflow=CI) +[](https://codecov.io/gh/exxamalte/python-aio-geojson-geonetnz-volcano) +[](https://pypi.python.org/pypi/aio-geojson-geonetnz-volcano) +[](https://pypi.python.org/pypi/aio-geojson-geonetnz-volcano) + +This library for convenient async access to +[GeoNet NZ Volcanic Alert Level](https://api.geonet.org.nz/#val) feed. + + +## Installation +`pip install aio-geojson-geonetnz-volcano` + +## Usage +See below for examples of how this library can be used. After instantiating a +particular class - feed or feed manager - and supply the required parameters, +you can call `update` to retrieve the feed data. The return value +will be a tuple of a status code and the actual data in the form of a list of +feed entries specific to the selected feed. + +Status Codes +* _OK_: Update went fine and data was retrieved. The library may still + return empty data, for example because no entries fulfilled the filter + criteria. +* _OK_NO_DATA_: Update went fine but no data was retrieved, for example + because the server indicated that there was not update since the last request. +* _ERROR_: Something went wrong during the update + +**Parameters** + +| Parameter | Description | +|--------------------|-------------------------------------------| +| `home_coordinates` | Coordinates (tuple of latitude/longitude) | + +**Supported Filters** + +| Filter | | Description | +|--------|-----------------|-------------| +| Radius | `filter_radius` | Radius in kilometers around the home coordinates in which events from feed are included. | + +**Example** +```python +import asyncio +from aiohttp import ClientSession +from aio_geojson_geonetnz_volcano import GeonetnzVolcanoFeed +async def main() -> None: + async with ClientSession() as websession: + # Home Coordinates: Latitude: -41.2, Longitude: 174.7 + # Filter radius: 200 km + feed = GeonetnzVolcanoFeed(websession, + (-41.2, 174.7), + filter_radius=200) + status, entries = await feed.update() + print(status) + print(entries) +asyncio.get_event_loop().run_until_complete(main()) +``` + +## Feed entry properties +Each feed entry is populated with the following properties: + +| Name | Description | Feed attribute | +|------------------|-------------------------------------------------------|----------------| +| geometry | All geometry details of this entry. | `geometry` | +| coordinates | Best coordinates (latitude, longitude) of this entry. | `geometry` | +| external_id | The unique public identifier for this volcano. | `volcanoID` | +| title | Volcano title. | `volcanoTitle` | +| attribution | Attribution of the feed. | n/a | +| distance_to_home | Distance in km of this entry to the home coordinates. | n/a | +| alert_level | Volcanic alert level (0-5). | `level` | +| activity | Volcanic activity. | `activity` | +| hazards | Most likely hazards. | `hazards` | + + +## Feed Manager + +The Feed Manager helps managing feed updates over time, by notifying the +consumer of the feed about new feed entries, updates and removed entries +compared to the last feed update. + +* If the current feed update is the first one, then all feed entries will be + reported as new. The feed manager will keep track of all feed entries' + external IDs that it has successfully processed. +* If the current feed update is not the first one, then the feed manager will + produce three sets: + * Feed entries that were not in the previous feed update but are in the + current feed update will be reported as new. + * Feed entries that were in the previous feed update and are still in the + current feed update will be reported as to be updated. + * Feed entries that were in the previous feed update but are not in the + current feed update will be reported to be removed. +* If the current update fails, then all feed entries processed in the previous + feed update will be reported to be removed. + +After a successful update from the feed, the feed manager provides two +different dates: + +* `last_update` will be the timestamp of the last update from the feed + irrespective of whether it was successful or not. +* `last_update_successful` will be the timestamp of the last successful update + from the feed. This date may be useful if the consumer of this library wants + to treat intermittent errors from feed updates differently. +* `last_timestamp` is not available for this feed. + + +%prep +%autosetup -n aio-geojson-geonetnz-volcano-0.8 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-aio-geojson-geonetnz-volcano -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Fri May 05 2023 Python_Bot <Python_Bot@openeuler.org> - 0.8-1 +- Package Spec generated @@ -0,0 +1 @@ +25e96f3967d4de2f7132e7f6ac50f8ff aio_geojson_geonetnz_volcano-0.8.tar.gz |