isogeo-pysdk 3.0.0

Python package to make it easy to use Isogeo REST API

Isogeo API Python SDK

A Python package to use Isogeo REST API.

Requirements

Isogeo API requires oAuth2 authentication. To obtain credentials, send us your request by email [e-mail].

Based on the well known requests package.

Documentation

• Package manual and autogenerated modules doc
• Isogeo API
• Contribution guidelines

Usage in a nutshell

pip install --user isogeo-pysdk
# using pipenv
pipenv install isogeo-pysdk

Quickstart

from isogeo_pysdk import Isogeo

# authenticate your client application
isogeo = Isogeo(client_id=app_id,
                client_secret=app_secret)

# get the token
isogeo.connect()

# search within catalogs shared to the application
search = isogeo.search()

# print some statements
print("Search __dict__ keys: ", search.keys())  # search response basic structure
print("Search query parameters: ", search.get('query'))  # search response query passed
print("Total count of metadatas shared: ", search.get("total"))  # total of available resources
print("Count of resources got by request: {}\n".format(len(search.get("results"))))  # total of resources returned by search request

# close the session when you finish
isogeo.close()

Samples are available in the source repository <https://github.com/isogeo/isogeo-api-py-minsdk/tree/master/isogeo_pysdk/samples>_.

Tests

Tests are performed for each published commit:

• by Azure Pipelines

pip install --upgrade -r tests/requirements_test.txt
python -m unittest discover

Or using the included Powershell script:

.\tool_test_coverage.ps1

Coverage

Test coverage is published on codecov.io.

Build

To package and upload:

.\tool_build_upload.ps1

To build docs:

.\tool_docs_build.ps1