Repository navigation
Python SDK generator: support baseUrlEnvVar (x-fern-base-url-env / base-url-env) #18351
Description
Component
CLI
Priority
P2 - Medium (Would be helpful)
SDK Language(s)
Python
Feature Description
-
Feature: The Python SDK generator should honor environments.baseUrlEnvVar. The CLI added it in feat(cli): add base-url-env for SDK base URL environment variable #17705 (x-fern-base-url-env in OpenAPI, base-url-env in api.yml), and the TypeScript generator already supports it (feat(typescript): read SDK base URL from configured environment variable #17736).
-
Why: Users could then write Client() instead of Client(base_url=os.environ["MY_API_BASE_URL"]), the same way the API key already defaults from MY_API_KEY. Right now the IR carries the field and Python drops it. With CLI 5.159.3 and fern-python-sdk 5.41.2, fern ir shows "baseUrlEnvVar": "MY_API_BASE_URL", but the generated SDK is byte-for-byte identical to the output without the extension.
-
How: In _get_base_url (base_client.py), resolve the URL in the order feat(cli): add base-url-env for SDK base URL environment variable #17705 describes: an explicit base_url passed to the client wins, then os.getenv() if it's set, then the default environment.
Side note: #17705 says base-url-env is also accepted under api.environments in generators.yml, but CLI 5.159.3's fern check rejects it there with Unexpected key "base-url-env".
Any alternatives?
Overriding init in a hand-written client subclass to default base_url from the env var. It works, but every Fern Python user has to reimplement it.
Are you interested in contributing this feature?
No
Activity