Change Log

2.1.0 - 2026-08-23

Changed

  • Predicate caching for keyword validation now works when using AsyncSpaceTrackClient with trio. Previously, the on-disk cache was skipped because the file locking implementation only supported asyncio. (#160)

  • AsyncSpaceTrackClient no longer performs blocking cache file reads and writes on the event loop; they now run in a worker thread. (#160)

  • Rate limit waits now guarantee that the callback has finished before the request is retried, in all clients. As a result, an exception raised by the callback now propagates instead of being silently discarded: directly in SpaceTrackClient, and as an ExceptionGroup on asyncio, matching the existing trio behaviour. (#160)

  • When the Space-Track session expires (after two hours without requests), the client now logs in again and retries the request transparently instead of failing every subsequent request. (#164)

  • Sets and frozensets are now accepted as predicate values and joined with commas like sequences. Bytes-like values now raise TypeError instead of being sent as comma-separated integers. (#169)

Fixed

  • AsyncSpaceTrackClient now accepts a plain function as the rate limit callback, as shown in the documentation, in addition to a coroutine function. (#160)

  • Concurrent first requests on a fresh client now share a single login request instead of each sending their own. (#161)

  • Model definition requests are now rate limited like all other requests. (#163)

  • Requests sent after a rate limit wait are now counted against the rate limit. Previously they were not, so sustained use could exceed Space-Track’s limits and trigger server-side rate limit errors. (#163)

  • SpaceTrackClient.close() and AsyncSpaceTrackClient.close() now close the underlying HTTPX client even if logging out fails. (#166)

  • Setting base_url now resets the authentication state and the cached predicates, which are specific to the previous host. (#166)

  • Fixed a ReferenceError when chaining a request off a temporary client, e.g. SpaceTrackClient(...).basicspacedata.gp(...). (#167)

  • get_predicates() now returns the known predicates for request classes without a model definition on Space-Track (such as fileshare/download and publicfiles/dirs) instead of failing. The returned Predicate objects have a type_ of None, since no model definition exists to provide it. (#168)

  • parse_types=True now works together with metadata=True in generic_request() and the request class methods; previously the metadata-wrapped response made it fail after the request had succeeded. (#170)

  • Fixed a TypeError when passing positional arguments to request class methods such as client.gp_history(...). The request class was bound as a keyword argument internally, so any positional argument clashed with it. (#171)

  • Error responses whose JSON error value is not a string no longer raise TypeError instead of httpx2.HTTPStatusError. (#172)

2.0.0 - 2026-08-10

Added

  • Support for Python 3.14 (#137)

  • Support for Python 3.15 (#154)

Changed

  • Replace HTTPX with the maintained HTTPX2 fork. Users that provide a custom httpx_client must now pass an httpx2.Client or httpx2.AsyncClient, and exception handling should catch exceptions from httpx2 instead of httpx. (#152)

Removed

  • Support for Python 3.9 (#137)

  • The tle, tle_latest, tle_publish, and omm request classes have been removed because they no longer exist on Space-Track. (#138)

1.4.0 - 2025-02-21

Added

Changed

  • Space-Track prefers that users log out of sessions explicitly. The existing SpaceTrackClient.close method will call the new SpaceTrackClient.logout method if necessary.

    For this reason, using the client as a context manager is now recommended:

    with SpaceTrackClient(...) as st:
    st.gp(...)

  • The Space-Track API used to validate keyword arguments is now cached on disk so that it is not queried more than once per day. Due to lack of support for trio in the package used to manage the cache, keyword validation will typically be skipped when using AsyncSpaceTrackClient with trio rather than asyncio.

  • Improved Rate Limiting documentation to emphasise that the library cannot handle all of Space-Track’s usage guidelines for you.

  • Default timeouts increased to 30 seconds to better handle current Space-Track performance.

Deprecated

Removed

  • Support for Python 3.8

1.3.1 - 2024-08-01

Fixed

  • The ‘mediumtext’ predicate type is now understood.

1.3.0 - 2024-05-07

Added

  • Timezone-aware datetimes are supported in request predicates.

1.2.0 - 2023-11-25

Added

Fixed

  • Since version 1.0, the value passed to SpaceTrackClient.callback, if set, is from time.monotonic() but the documentation was not updated to reflect this.

1.1.0 - 2023-10-15

Added

  • dirs and download request classes for the publicfiles request controller.

  • Support for Python 3.12

Removed

  • Support for Python 3.7

1.0.1 - 2023-05-23

Fixed

  • requests which should have been streamed (e.g. iter_content=True) were not.

  • requests which need to follow redirects work again.

1.0.0 - 2023-05-22

Added

Changed

Removed

  • The async extra no longer exists because the AsyncSpaceTrackClient is available by default.

  • Support for Python 3.6

Fixed

  • The modeldef for the fileshare/download class was deprecated by Space-Track, so the client no longer uses this API.

0.16.0 - 2021-01-03

Added

  • Support for the car, folder, and satellite classes.

  • A rush storage backend can be provided to a new rush_store argument to coordinate rate limiting across multiple instances.

  • rush_key_prefix to optionally prefix keys used in the rush storage backend.

Fixed

  • When parse_types is used, dates are parsed using an ISO 8601 parser, which fixes the parsing of date formats returned by newer request classes (e.g. gp).

0.15.0 - 2020-09-25

Added

  • Support for the cdm_public and gp_history classes.

0.14.0 - 2020-06-21

Added

  • Support for Space-Track’s per-hour rate limit in addition to the per-minute limit.

Changed

  • The per-minute rate limit was increased to 30 as documented by Space-Track.

  • Require aiohttp 3 for the async extra.

  • AsyncSpaceTrackClient is now an asynchronous context manager. Use async with instead of with.

Removed

  • Support for Python 2.7, 3.4, and 3.5.

0.13.7 - 2020-06-20

Added

  • Support for the general perturbations (gp) class.

0.13.6 - 2020-03-20

Fixed

  • Regression in 0.13 that prevented spephemeris/download from working by trying to load a model definition which it doesn’t have.

0.13.5 - 2020-03-18

Fixed

  • The ‘text’ predicate type is now understood.

  • Unknown predicate types issue a warning instead of raising an exception.

0.13.4 - 2019-12-24

Added

  • SpaceTrackClient gained a base_url parameter to allow the use of an alternate Space-Track server.

0.13.3 - 2019-03-11

Fixed

  • The deprecation warning about importing Sequence or Mapping from collections instead of collections.abc.

0.13.2 - 2018-12-31

Fixed

  • The async extra installs aiohttp 2 because spacetrack is not yet aiohttp 3 compatible.

  • Deprecation warnings about invalid escape sequences.

0.13.1 - 2018-01-18

Fixed

  • spacetrack can be installed with setuptools v38.0+, which requires install_requires in setup.py to be ordered.

0.13.0 - 2017-06-17

Added

  • parse_types flag to optionally parse types as described by the modeldef API.

  • Compatibility with maneuver and maneuver_history request classes for expandedspacedata request controller.

  • Compatibility with upload and delete request classes for fileshare request controller.

Fixed

  • Predicates with the enum type are parsed correctly. Previously, single-valued enums had None as a second value, and enums with more than two values only had the first and last value due to the regex match not capturing repeated groups. The values aren’t used by spacetrack, so the bug went unnoticed.

  • Exception on Python 3.5+ in threads without an asyncio event loop (even using the normal SpaceTrackClient). Fixed by requiring ratelimiter >= 1.2.0

Changed

  • Require aiohttp >= 2.0 for the async extra.

0.12.0 - 2016-06-28

Added

  • Request controller can be passed explicitly to methods that take a request class, because some request classes are present in more than one controller.

  • Request controller proxy attribute, e.g. SpaceTrackClient.fileshare.file(), which is equivalent to SpaceTrackClient.generic_request('file', controller='fileshare').

  • dir(SpaceTrackClient(...)) now includes the request controllers and request classes so it’s easier to see what can be called.

Fixed

  • /modeldef API not queried if no predicates are passed. This allows spephemeris/download to be used, which doesn’t have a model definition.

Changed

  • Calling request class methods uses first request controller that matches. The order is stored in the keys of the SpaceTrackClient.request_controllers ordered dict, currently basicspacedata, expandedspacedata, fileshare, spephemeris. Any new request controllers will be added to the end, to preserve lookup order. New request classes that would change the order will accompany a major version bump.

  • AsyncSpaceTrackClient uses requests’ CA file for same experience with both clients.

0.11.1 - 2016-03-01

Fixed

  • Bump ratelimiter version to improve rate limiting for AsyncSpaceTrackClient

Changed

  • Documentation included in source distribution.

0.11.0 - 2016-02-21

Added

  • Some unit tests added for AsyncSpaceTrackClient.

Fixed

  • \r\n to \n newline conversion for async chunk iterator.

Changed

  • AsyncSpaceTrackClient can no longer be imported from the top level spacetrack module, since this would cause an error if optional dependency aiohttp was not installed. It must be imported from spacetrack.aio.

0.10.0 - 2016-02-04

Fixed

  • Compatibility with file and download request classes for fileshare request controller. upload request class removed, unable to test.

  • Rate limit violation HTTP status code 500 handled during predicate information request.

Changed

  • iter_lines=True now raises ValueError if receiving binary data (currently only possible with download request class).

  • Removed internal method _get_predicate_fields, set comprehension used inline instead.

  • Predicate class now has a default attribute.

0.9.0 - 2016-01-28

First release.