uri

class tinychain.uri.URI(subject, *path)

Bases: object

An absolute or relative link to a State.

Examples:

URI("https://example.com/myservice/value_name")
URI("$other_state/method_name")
URI("/state/scalar/value/none")

append(suffix)

Construct a new URI beginning with this URI and ending with the given suffix.

Example:

value = OpRef.Get(URI("http://example.com/myapp").append("value/name"))

extend(*segments)

host()

Return the host segment of this URI, if present.

id()

Return the ID segment of this URI, if present.

is_id()

Return True if this URI is a simple ID, like $foo.

static join(segments)

Join the given segments together to make a new URI.

path()

Return the path segment of this URI, if present.

port()

Return the port of this URI, if present.

protocol()

Return the protocol of this URI (e.g. “http”), if present.

split()

Split this URI into its individual segments.

The host (if absolute) or ID (if relative) is treated as the first segment, if present.

startswith(prefix)

Return True if this URI starts with the given prefix.

tinychain.uri.validate(name, state=None)

Return the given name as allowed for use as a path segment in a URI, or raise a KeyError.