geolens (Python SDK)
Auto-generated Python SDK for the GeoLens API.
Apache-2.0 licensed. Typed attrs-based dataclasses + httpx async-ready client + Bearer-token + API-key auth helpers.
See docs.getgeolens.com for installation, regeneration, and version-pin policy.
Quickstart
from geolens import GeolensClient
client = GeolensClient(base_url="https://geolens.example.com/api", bearer_token="...")
# The deployed API is served under /api, so include that suffix in base_url.
# See docs.getgeolens.com for endpoint usage examples.
Requests never time out unless you set one. Extra keyword arguments go to the
generated client, so GeolensClient(base_url, bearer_token="...", timeout=httpx.Timeout(30.0))
bounds every call.
Errors
A documented error status (401, 403, 404, 422, 429 and so on) does not raise.
sync() and asyncio() return a ProblemDetail with status, title and
detail, and sync_detailed() returns it as .parsed next to the raw
status_code:
from geolens.api.datasets import get_single_dataset_datasets_dataset_id_get as get_dataset
from geolens.models.problem_detail import ProblemDetail
result = get_dataset.sync(dataset_id, client=client.client)
if isinstance(result, ProblemDetail):
print(result.status, result.title, result.detail)
Transport failures such as httpx.ConnectError do raise. A status the API
doesn't document raises geolens.errors.UnexpectedStatus only when the client
is built with raise_on_unexpected_status=True.
Downloading a COG
With a remote source behind a raster dataset, the COG download answers 302
with the file's URL. With S3 it may do the same when the server has presigned
downloads enabled, and streams the file otherwise. cog_download fetches that
URL without sending your GeoLens credentials to the storage host, and returns
the file on every storage backend. A further redirect from the storage host is
followed only on that same host. The file is streamed into a temporary file
that moves to disk past a few MiB, so a large COG isn't held in memory:
import shutil
from geolens import cog_download
cog = cog_download.sync(dataset_id, client=client.client) # or: await cog_download.asyncio(...)
with cog.payload as source, open("dataset.cog.tif", "wb") as target:
shutil.copyfileobj(source, target)
Metadata
Release files for geolens 1.32.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| geolens-1.32.0.tar.gz | 472.3 kB | Without provenance | Details for geolens-1.32.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| geolens-1.32.0-py3-none-any.whl | Python 3 | none | any | Details for geolens-1.32.0-py3-none-any.whl |
Total release size: 1.9 MB
Release files / geolens-1.32.0.tar.gz
| Download URL | geolens-1.32.0.tar.gz |
|---|---|
| Size | 472.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1968cf28e29d1228b8db545bb77e43de0b07687a19c5a085e4def34002b23ef5
|
|
BLAKE2b-256 checksum How to use checksums |
2f2591d9d13f1cff4aa477cea503399b679e5804fe63866e350fdf429a8e8004
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / geolens-1.32.0-py3-none-any.whl
| Download URL | geolens-1.32.0-py3-none-any.whl |
|---|---|
| Size | 1.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e03ca02e4a7358cb6f53fc27e75b9d090de8ea8428e382e413b104517f41f39e
|
|
BLAKE2b-256 checksum How to use checksums |
c584ca81315de5458d058f23e179896d1bba6d9c34f5491614a285097e7068eb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for geolens 1.32.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.