EarthScope SDK Changelog - EarthScope SDK

v1.9.0¶

Release date: 2026-09-15

!57 - new: stream file-backed upload parts from disk instead of buffering them in memory
!56 - docs: add a few “rules” for well-behaved clients to the S3 direct access tutorial
!55 - fix: auto-raise multipart part size for dropoff uploads over ~100 GiB
!54 - fix: unblock dropoff multipart producers on permanent part failure
!53 - docs: rework S3 direct access docs for unified ODP + repository TVM
!43 - new: dropoff file collect/validate helpers for directory uploads

v1.8.0¶

Release date: 2026-08-25

Important

Direct S3 access for miniSEED is changing:

Prefer the s3-miniseed-v2 role on AWS credentials methods.

# Open Data Program list/read + repository list
client.user.get_boto3_session(role="s3-miniseed-v2")

# Open Data Program list/read + repository list + permanent network read
client.user.get_boto3_session(role="s3-miniseed-v2", network="FDSN:UO")

# Open Data Program list/read + repository list + temporary network read
client.user.get_boto3_session(role="s3-miniseed-v2", network="FDSN:1E", year=2024)

The s3-miniseed role and its access point are deprecated and planned for removal in 2027.

Networks published via the AWS Open Data Program (AK, II, IU, N4, PB, TA, UU, UW) must be read from s3://earthscope-geophysical-data
Calling AWS credential methods without role= still defaults to s3-miniseed but emits a DeprecationWarning; an explicit role= argument will be required in earthscope-sdk v2.
Temporary AWS credentials are no longer written to disk under the profile directory; only an in-memory cache remains.

See https://docs.earthscope.org/sdk/s3-direct-access-tutorial for more details.

!52 - fix: keep role as keyword-only on AWS credential helpers
!51 - new: support per-role token vending machine (TVM) query params and document ODP vs s3-miniseed-v2 direct S3 access
!50 - docs: add StationXML (and MiniSEED/assembled) references in dropoff docs

v1.7.2¶

Release date: 2026-08-17

!49 - fix: bootstrap access token before dropoff uploads for refresh-token-only auth (sync and async)

v1.7.1¶

Release date: 2026-08-11

!48 - fix: keep category/euid prefix when dropoff keys have a leading slash

v1.7.0¶

Release date: 2026-08-10

~~!47 - fix: bootstrap access token in get_user_id() for refresh-token-only auth~~
- superseded by !49 in v1.7.2
!45 - new: soft migrate to optional dependencies for dropoff category validators
!44 - chore: bump pymseed>=0.9.3
!40 - new: support for stationxml dropoff

v1.6.1¶

Release date: 2026-07-09

!39 - fix: handle list[str] scope settings

v1.6.0¶

Release date: 2026-07-08

!38 - new: GNSS instantaneous positions functionality
!37 - new: add get_boto3_session() helper to sync client
!36 - chore: pull up mystmd to avoid flicker
!35 - fix: direct access tutorial config

v1.5.0¶

Release date: 2026-06-03

!34 - fix: docs link changes
!33 - new: support for assembled dropoff
!32 - docs: add upgrade instructions

v1.4.1¶

Release date: 2026-05-03

Important

Secrets on AwsTemporaryCredentials are now wrapped to prevent inadvertent leaks.

Serializing AwsTemporaryCredentials (e.g. creds.model_dump(), str()) will now redact these fields. Use .get_secret_value() to access the raw secret.

creds: AwsTemporaryCredentials = ...

# before (<=1.4.0)
access_key = creds.aws_secret_access_key
session_token = creds.aws_session_token

# after (>=1.4.1)
access_key = creds.aws_secret_access_key.get_secret_value()
session_token = creds.aws_session_token.get_secret_value()

!31 - fix: use SecretStr for AWS creds secret fields
!30 - fix: use rotating AWS creds for uploads

v1.4.0¶

Release date: 2026-04-24

!29 - new: add changelog to docs
!28 - fix: unbound upload spec queue to let validation run ahead of producers
!27 - fix: don’t block event loop for sync generators
!26 - fix: join dropoff path components with posixpath
!25 - new: simple constructor for named profiles
!24 - new: support multiple reference points for gnss_ephemeris_positions
!22 - chore: update pymseed version dependency
!21 - chore: drop support for python 3.9
!20 - new: add structured_messages fields to DropoffObject

v1.3.1¶

Release date: 2026-03-16

!19 - new: add dropoff summary SDK method
!18 - chore: update pymseed validation logic to version 0.6.0
!17 - new: added dropoff list filter fields
!16 - new: add CRC64NVME integrity checks to S3 multipart uploads

v1.3.0¶

Release date: 2026-01-21

!15 - new support for EarthScope Dropoff system

v1.2.0¶

Release date: 2025-12-13

!14 - fix docs cross-reference target
!13 - fix ReadTheDocs build errors
!11 - new datasource discovery and data access methods

v1.1.1¶

Release date: 2025-12-03

!12 - fix FileNotFoundError when saving temp AWS creds
!10 - fix repository URL in docs

v1.1.0¶

Release date: 2025-06-25

!9 - new http.extra_headers setting to inject arbitrary HTTP headers into all requests

v1.0.0¶

Release date: 2025-06-18

Initial Release: Complete rewrite and modernization of the EarthScope SDK
Dual Client Support: Both synchronous (EarthScopeClient) and asynchronous (AsyncEarthScopeClient) clients
Context Manager Support: Clients can be used as context managers for automatic resource cleanup
Comprehensive Authentication: Multiple authentication flows including device code flow and client credentials flow
Flexible Configuration: Multi-level configuration system with environment variables, dotenv files, and config files
Type Safety: Full type hints and Pydantic models for data validation of API response bodies
HTTP Client: Modern HTTP client with retry logic and connection pooling

Changed¶

Architecture: Complete architectural redesign for better maintainability and extensibility
Package Structure: Reorganized package structure for better module organization
Dependencies: Updated to modern Python dependencies (httpx, pydantic-settings, stamina)
Python Support: Minimum Python version raised to 3.9
Build System: Migrated to modern Python packaging with pyproject.toml

Removed¶

Legacy Code: Removed deprecated APIs and old implementation patterns
Outdated Dependencies: Removed legacy dependency management

Fixed¶

Authentication Flow: Improved OAuth2 authentication flow reliability
Error Handling: Better handling of HTTP errors and service responses
Configuration Loading: Fixed configuration loading precedence and fallback behavior