Skip to content

PB-1750: Add instructions for using custom environments#216

Merged
cariad merged 6 commits intomainfrom
PB-1750-cariad-add-docs-about-custom-sdk-env-back-into-sdk-project
Mar 25, 2026
Merged

PB-1750: Add instructions for using custom environments#216
cariad merged 6 commits intomainfrom
PB-1750-cariad-add-docs-about-custom-sdk-env-back-into-sdk-project

Conversation

@cariad
Copy link
Copy Markdown
Contributor

@cariad cariad commented Mar 18, 2026

Add instructions for using custom environments

Description

The Client class defaults to using the production environment, but also supports a range of named environments and entirely custom configurations for ad-hoc environments. However, the documentation doesn't reveal how to take advantage of those.

This change updates README.md to include instructions on using custom environments.

Resolves PB-1750.

Docstring & Example Checklist

  • I have added or updated docstrings for all public classes, methods, and functions
  • I have included doctest-style examples in docstrings where appropriate
  • All examples use correct Python prompt formatting (>>>, ... for continuation lines)
  • All code, class, and method names in docstrings are wrapped in backticks (e.g. `Add`)

This comment was marked as outdated.

@cariad cariad marked this pull request as ready for review March 18, 2026 16:11
Comment thread README.md
| `resource_api` | Starts with `https://`, does not end with `/` | `https://m90q55iux6.execute-api.eu-west-2.amazonaws.com` |

**Note:** Every password is tied to a specific environment. A password for the production environment, for example, won't grant access to the development environment. Ensure you set the correct `UE_PASSWORD` value for the environment you configure.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we should also include this line somewhere in this section as a reminder:

Note
If you are switching between different environments, you need to delete your ~/.ue_auth file before trying to change between the environments.

It is something that is coming up a lot, and it will be useful to make it clear in the documentation that when people are switching between environments, they shouldn't forget this step.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

Copy link
Copy Markdown
Contributor

@eirinikouvara eirinikouvara left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ooh, I really like the clarification for Windows too :)

@cariad cariad merged commit c94d96f into main Mar 25, 2026
18 checks passed
@cariad cariad deleted the PB-1750-cariad-add-docs-about-custom-sdk-env-back-into-sdk-project branch March 25, 2026 13:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants