| """Module for URI Template expansion.""" | |
| from __future__ import annotations | |
| from .expansions import ExpansionFailedError | |
| from .uritemplate import ExpansionInvalidError, ExpansionReservedError, URITemplate | |
| from .variable import Variable, VariableInvalidError | |
| __all__ = ( | |
| 'URITemplate', | |
| 'Variable', | |
| 'ExpansionInvalidError', | |
| 'ExpansionReservedError', | |
| 'VariableInvalidError', | |
| 'ExpansionFailedError', | |
| ) | |
| def expand(template: str, **kwargs) -> (str | None): | |
| try: | |
| templ = URITemplate(template) | |
| return templ.expand(**kwargs) | |
| except Exception: | |
| return None | |
| def partial(template: str, **kwargs) -> (str | None): | |
| try: | |
| templ = URITemplate(template) | |
| return str(templ.partial(**kwargs)) | |
| except Exception: | |
| return None | |
| def validate(template: str) -> bool: | |
| try: | |
| URITemplate(template) | |
| return True | |
| except Exception: | |
| return False | |