feat(python): use environment parameter for multi-url environments in dynamic snippets

[devin-ai-integration]

Description

Link to Devin run: https://app.devin.ai/sessions/46b6a813ed6c410b81d73d9e41784274

Requested by: Deep Singhvi ([email protected]) (@dsinghvi)

Updates the Python dynamic snippets generator to use the environment parameter with the default environment enum value instead of base_url when an API has multi-url environments defined.

Before:

client = Phonic(
    base_url="https://api.phonic.co/v1",
    api_key="YOUR_TOKEN_HERE"
)

After:

client = Phonic(
    environment=PhonicEnvironment.DEFAULT,
    api_key="YOUR_TOKEN_HERE"
)

Changes Made

• Added hasMultipleBaseUrlEnvironments() helper method to detect when an API has multi-url environments from the IR
• Added getDefaultEnvironmentId() helper method to retrieve the default environment ID from the IR
• Modified getConstructorEnvironmentArgs() to use environment parameter name when baseUrl is provided AND the API has multi-url environments AND the default environment can be resolved to a valid enum reference
• Modified getEnvironmentValue() to return the default environment enum reference instead of a base_url string when the above conditions are met
• Implemented safe fallback logic: if defaultEnvironment cannot be resolved to a valid enum reference at any step, the code falls back to using the base_url parameter to avoid generating invalid snippets

Testing

⚠️ CRITICAL: This change has NOT been tested with actual multi-url environment fixtures

The logic appears correct based on code review and local lint checks pass, but this PR should not be merged without validation against actual API definitions.

Human Review Checklist

MUST DO before merge:

• Run seed tests with multi-url environment fixture: pnpm seed:local test --generator python-sdk --fixture multi-url-environment
• Verify the generated snippets use environment= parameter correctly
• Verify IR structure assumptions are correct (check that this.ir.environments.environments.type === "multipleBaseUrls" correctly identifies multi-url environments)

Edge cases to test:

• Multi-url environment with no default defined (should fall back to base_url)
• Invalid environment ID that cannot be resolved (should fall back to base_url)
• Single-url environments still work: pnpm seed:local test --generator python-sdk --fixture single-url-environment-default
• APIs without environments still work correctly

Code review focus areas:

• Verify the nested conditional logic in getConstructorEnvironmentArgs() (lines 144-156) correctly handles all cases
• Verify the fallback behavior in getEnvironmentValue() (lines 182-191) is intentional and appropriate
• Consider whether we should log/warn when falling back to base_url instead of silently falling back

Risk Assessment

HIGH RISK: Core functionality is untested against real fixtures. The nested conditional logic could fail silently and fall back to base_url, masking issues. Recommend thorough testing with actual multi-url environment API definitions before merge.

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring