westyx-nexus-sdk and westyx-nexus-openfeature, newest first. Both release from
one tag and share one version number. Where a release broke something, its Migrating section
shows the change to make. The repository’s
CHANGELOG.md carries the
same releases in full detail.
v0.19.1 - 2026-11-19
- OpenFeature
423 service_lockedhold: uses a timed suppression window (default 5 minutes) matchingenvironment_disabled, soevaluate-abrecovers automatically once the lockdown is lifted. - Stream observer on
423: callson_fallback(FALLBACK_REASON_SERVICE_LOCKED)followed byon_disconnected(NexusServiceLockedError("stream"))in both sync and async clients.
v0.19.0 (2026-11-19)
- HTTP 423
service_locked: addsNexusServiceLockedErrorandFALLBACK_REASON_SERVICE_LOCKED; stops SSE reconnects immediately and halts background sync retries until an explicitsync()succeeds. - OpenFeature provider: suppresses repeated
evaluate-abrequests while the service is locked down, serving the cached snapshot asSTALE.
v0.18.1 - 2026-11-12
- The OpenFeature provider stops asking a switched-off environment. While the environment is switched off in the console, a targeted evaluation serves the snapshot as
STALEand the provider sends noevaluate_abrequest - for any user - for theaddon_suppressionwindow, with one warning; any success clears it.westyx-nexus-openfeaturerequireswestyx-nexus-sdk>=0.18.0.
v0.18.0 - 2026-11-12
- A switched-off environment is reported by name.
403 {"error":"environment_disabled"}raisesNexusEnvironmentDisabledError. The cache keeps serving; the background refresh and the stream wait five minutes between attempts (on_fallback("environment-disabled")), and the first successful sync clears it. Both clients. - Every API error carries its status and code. A response no more specific exception describes
raises
NexusApiErrorwithstatus_code,codeandoperation; the message never carries the response body. A429on the sync path isNexusRateLimitedError, and a quarantine429on any path isNexusQuarantinedError. - The SDK logs through the
westyx_nexuslogger by default - silent until your application configures logging, visible as soon as it does.NexusLoggergainswarning; a logger without it still works. - The startup summary:
nexus: client loadednames the configs, secrets and flags the first sync delivered - never a value.WESTYX_NEXUS_LOG_STARTUP=1also writes it to standard error. sync_errorslists the resources the server did not deliver, each logged once as a warning;log_sync_errors=Falsekeeps the list without the log lines.- Concurrent
sync()calls onNexusClientapply one at a time, so an older response never replaces a newer one. - The stream recovers on its own from every refusal. A
401or a switched-off environment retries on thesse_reconnect_cooldownschedule; a successful connection starts the failure count and the backoff over, and so does the cooldown. - A WIF refresh that fails while the session is still valid no longer fails the request; an
expired session with no
api_keyraisesNexusSessionExpiredErrorwith the refresh error as its__cause__, and a credential that is gone raisesNexusWIFNotConfiguredErrorat once. - Python 3.15 is supported and tested.
Migrating to v0.18.0
- Code that matched the message of an unmapped status (
unexpected status 500) readserr.status_codeinstead. - With no
logger=, SDK records now reach thewestyx_nexuslogger; to keep them out of a root logger configured atINFO, setlogging.getLogger("westyx_nexus").setLevel(logging.WARNING). - A custom
NexusLoggermay addwarning; without it, warnings arrive atinfo.
v0.17.0 - 2026-09-30
- The endpoint can come from the environment.
NexusConfig.base_urlis optional; when it isNoneor empty,create()readsWESTYX_SERVICE_ENDPOINT(SERVICE_ENDPOINT_ENV), whichwestyx dev runsets for the script’s service - so neither the endpoint nor a key has to be in your code.base_urlwins when both are set, abase_urlthat is not astrraisesTypeError, and an error about a value from the variable names the variable. - The Flask and Django adapters support Workload Identity Federation.
NEXUS_BASE_URLandNEXUS_API_KEYare optional, a newNEXUS_WIFsetting configures WIF, and with neither a key norNEXUS_WIFthe adapter uses WIF with the default provider - sowestyx dev runstarts a Flask or Django application with no Nexus settings. NexusSessionExpiredErroris raised when a WIF session is rejected and noapi_keyis configured to fall back on; a developer session keeps itswestyx dev setupmessage.
v0.16.0 - 2026-08-27
- A custom
loggerwhose method raises no longer fails an SDK operation. Every internal log call is contained, so a logging sink that raises - a full disk, a down syslog target - is dropped and the read, refresh, orcreate()(sync and async) that logged continues. The stream observer already had this guarantee; it now covers the logger too. The WIF credential source is deliberately not contained - it is on the auth path and still surfaces its error.
v0.15.0 - 2026-08-21
- The async client has the write API.
AsyncNexusClientgainsset_secret,delete_secretanddelete_secret_version, mirroringNexusClient; both route every write status through one shared path so they cannot drift. - The public-key guard reads the backend’s
key_type, not just the key prefix - a key the server reports as public is refused secrets even without thewxp_prefix, because either signal is enough. follow_redirectsis off on every HTTP client and the SSE line reader is bounded, so a credential-bearing request never follows a server-chosen redirect and a server that never emits a newline cannot make the client buffer without limit.- The async client keeps blocking file I/O off the event loop - file-secret writes and cleanup run in a worker thread.
- Thread safety and the free-threaded (no-GIL) position are documented.
- Changed: minimum
httpxis now>=0.26(0.25 does not import on Python 3.14).
v0.14.0 - 2026-08-10
- The WIF provider set is a type.
WIFProvideris aStrEnumunioned with the equivalentLiteral, so the enum member and the plain string both type-check and a value outside the set does not. Members are strings, so nothing changes at runtime; an invalid one raisesValueErroratWIFConfig(...). exchange_payloadbuilds the whole token-exchange body from anExchangeContext, so a credential that is not an OIDC token can be expressed - and theaws_iamshape is reachable withoutbotocoreif you sign the request yourself.- A
developerprovider. Afterwestyx dev setup,WIFConfig(enabled=True)authenticates a developer machine against a WIF-enforced service with the session the CLI already obtained - no token exchange, nothing to install. It is the last providerautoconsiders. - The API key and the session token stay out of
__repr__, which is what a traceback rendered with frame locals prints. - Breaking:
WIFConfigis keyword-only, andprovider="aws_iam"withtoken_sourceis refused.
v0.13.0 - 2026-08-06
- File-type secrets live in a per-client private directory, created
0700lazily on the first file-type secret; every file inside is created0600withO_EXCL, so the mode is a guarantee regardless of what already occupies the path. A process-levelatexithook removes the files even when the process exits withoutclose(). See File-type secret security. - A 402 Payment Required throttles the background refresh to one attempt every five minutes instead of ending it, and any successful sync - a
304 Not Modifiedincluded - clearsbilling_overdue. Settling the invoice restores service without a restart. - The SSE stream has an idle deadline - new
stream_idle_timeoutoption, default 90 s, sized against the server’s 30 s keepalives. A connection reaped by a load balancer surfaces as a transport error and reconnects instead of blocking forever. See SSE live updates. - Breaking:
ttl_seconds(andstream_idle_timeout) are validated atcreate()- zero, negatives andboolraiseValueErrornaming the option instead of silently becoming the default.
v0.12.0 - 2026-08-03
- Per-user flag targeting through the OpenFeature provider. With a targeting key in the evaluation context, a boolean flag is resolved through the AB Testing add-on, so its rollout percentage and cohort rules apply to that identity. One request serves every flag the snapshot knows for that identity, results are memoised, and concurrent evaluations for one identity coalesce into a single request. Without a targeting key nothing changes.
find_flag(key)on both clients returns the flag’sis_activestate orNonewhen the flag is not in the cache at all - the distinctionget_flagcannot express, and the one an OpenFeature provider needs in order to answerFLAG_NOT_FOUND.NexusProviderOptionstunes the targeting TTL, the memoised-identity cap and the add-on suppression window; a value that cannot work is rejected at construction, naming the option.- Breaking:
evaluate_abrefuses a non-string attribute value withTypeErrornaming the attribute, the provider no longer coerces numbers, and an unknown flag resolves asFLAG_NOT_FOUND.
v0.11.0 - 2026-07-27
A correctness and type-safety release. Nothing in the public API breaks.- Ships
py.typed(PEP 561) for both packages. Without the marker, type checkers ignore an installed package’s annotations entirely - every SDK call resolved toAnyin your project, however well annotated the SDK was. The SDK is now clean under bothmypy --strictandpyright. See Type checking. - SSE reconnect fixes. A misconfigured
sse_reconnect_cooldownused to kill the stream worker: the handler meant to fall back to the default schedule called a logger method that does not exist, and raised. The value is validated atcreate()now and rejected with a message naming the bad input. Separately,AsyncNexusClientignoredsse_reconnect_cooldownentirely and ended its stream permanently after three transient transport errors - it now reconnects on the configured schedule, matchingNexusClient. See SSE live updates. - The SSE client now has a connect timeout. Lifting the read deadline on a long-lived stream is right; lifting the connect deadline with it was not, and a connect to a black-holed endpoint hung indefinitely with no error and no reconnect.
- File-type secrets are written
0600, applied at creation rather than by a chmod afterwards, and opened withO_NOFOLLOW. Each client materialises to its own paths, so two clients holding the same secret never share a file. See File-type secret security. - A faulting stream observer is reported. Your observer still cannot break the SDK, but a callback that raises is logged with the hook name and the original exception instead of vanishing.
- No
assertin shipped code -python -Ostrips them, and the session-refresh precondition guard went with them. - CI gates on
ruff,mypy,pyrightandbandit, and the suite runs on Python 3.11 through 3.14 - every version this package advertises.
v0.10.0 - 2026-07-05
- Version alignment across the Westyx Nexus SDK suite.
v0.9.0 - 2026-07-03
aws_iamWIF provider (AWS IAM Caller Identity) - authenticates non-EKS AWS compute (ECS/Fargate, Lambda, plain EC2) that has IAM credentials but no OIDC token. The SDK SigV4-signs an STSGetCallerIdentityrequest (never sent to AWS) and posts it to/v1/auth/token-exchange; Nexus replays it against a pinned STS endpoint to prove your IAM role. The signedX-Nexus-Server-IDis your service’s own base-URL host - a captured request is valid for that one service only, and there is nothing to configure. Requires the optionalbotocoredependency (pip install 'westyx-nexus-sdk[aws-iam]'). See Workload identity.- Azure Workload Identity (AKS) - the
azureprovider now prefers the projected federated token file ($AZURE_FEDERATED_TOKEN_FILE) before falling back to IMDS; auto-detection probes the file too. - Probe-based auto-detection - auto-detect now stats the Kubernetes / AWS-IRSA / Azure token files and live-probes the GCP and Azure metadata servers (~1 s timeout), instead of keying on environment variables absent on real cloud nodes.
- Security hardening - both clients reject plain-http
base_urls (loopback excepted); the Azure IMDS path refuses the generic default audience (must beapi://<client-id>); the async client no longer blocks the event loop on metadata calls; thehttpx.Clientleak is fixed; metadata/exchange reads are bounded.
v0.8.0 - 2026-06-16
- OpenFeature provider - new
westyx-nexus-openfeaturesub-package shipsNexusProvider, anAbstractProviderfor the OpenFeature Python SDK. Wraps an existingNexusClient; booleans viaget_flag, string/integer/float/object viaget_config. See OpenFeature provider.
v0.5.1 - 2026-06-03
- Requires Python 3.11+ - Python 3.10 is EOL; minimum is now 3.11.
- Security improvements - exception messages contain only status codes; file-type secret paths are fully hashed; WIF tokens stripped of whitespace on all providers.
- WIF reliability - session refreshes before each SSE reconnect; expired sessions no longer cause permanent TTL-polling fallback.
- CI - tests run on merge requests; publish restricted to
main-branch tags.
v0.5.0 - 2026-06-01
- Write API -
set_secret,delete_secret,delete_secret_versionfor programmatic secret management. secret keys only; public keys raiseNexusPublicKeyErrorimmediately without a network call. NexusRateLimitedError- new error for HTTP 429 on write endpoints.
v0.4.0 - 2026-05-28
- Path prefix change - all API paths are now
/v1/(previously/api/v1/). Updatebase_urlto use<slug>.westyx.dev. NexusQuarantinedError- new typed error raised on429with quarantine body. Both sync and stream paths detect this.on_quarantined(reason, expires_at)observer callback -StreamObservergains a sixth callback; fires on quarantine events from both the stream and sync paths.- Quarantine backoff - stream sleeps until
expires_atbefore reconnecting; background sync is paused during the quarantine window. - Removed
ConfigEntry.is_public- the field is no longer populated.
