René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Add static code for supporting universe domain (to be used in both GAPICs and Apiary)","articleBody":"Universes other than the default `\"googleapis.com\"` need to be supported in both GAPICs and Apiary. The following code was added to GAPICs but can be moved to `python-api-core`:\r\n\r\n```python3\r\ndef _get_universe_domain(\r\n    client_universe_domain: Optional[str], universe_domain_env: Optional[str]\r\n) -\u003e str:  # temp disable Optional\r\n    \"\"\"Return the universe domain used by the client.\r\n\r\n    Args:\r\n        client_universe_domain (Optional[str]): The universe domain configured via the client options.\r\n        universe_domain_env (Optional[str]): The universe domain configured via the \"GOOGLE_CLOUD_UNIVERSE_DOMAIN\" environment variable.\r\n\r\n    Returns:\r\n        str: The universe domain to be used by the client.\r\n\r\n    Raises:\r\n        ValueError: If the universe domain is an empty string.\r\n    \"\"\"\r\n    universe_domain = _DEFAULT_UNIVERSE\r\n    if client_universe_domain is not None:\r\n        universe_domain = client_universe_domain\r\n    elif universe_domain_env is not None:\r\n        universe_domain = universe_domain_env\r\n    if len(universe_domain.strip()) == 0:\r\n        raise _Empty_Universe_Error\r\n    return universe_domain\r\n\r\n\r\ndef _compare_universes(\r\n    client_universe: str, credentials: Union[ga_credentials, oauth2_credentials]\r\n) -\u003e bool:\r\n    \"\"\"Returns True iff the universe domains used by the client and credentials match.\r\n\r\n    Args:\r\n        client_universe (str): The universe domain configured via the client options.\r\n        credentials Union[google.auth.credentials.Credentials, oauth2client.client.Credentials]: The credentials being used in the client.\r\n\r\n    Returns:\r\n        bool: True iff client_universe matches the universe in credentials.\r\n\r\n    Raises:\r\n        ValueError: when client_universe does not match the universe in credentials.\r\n    \"\"\"\r\n    credentials_universe = getattr(credentials, \"universe_domain\", _DEFAULT_UNIVERSE)\r\n\r\n    if client_universe != credentials_universe:\r\n        raise _UniverseMismatchError(client_universe, credentials_universe)\r\n    return True\r\n\r\n```","author":{"url":"https://github.com/ohmayr","@type":"Person","name":"ohmayr"},"datePublished":"2024-02-27T18:23:13.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/624/python-api-core/issues/624"}