kytheuri

Documentation

Overview

Package kytheuri provides a type to represent Kythe URIs. This package supports parsing a Kythe URI from a string, and converting back and forth between a Kythe URI and a Kythe VName protobuf message.

Index

• Constants
• func Equal(u1, u2 string) bool
• func Fix(s string) (string, error)
• func ToString(v *spb.VName) string
• func ToVName(s string) (*spb.VName, error)
• type URI
  • func FromVName(v *spb.VName) *URI
  • func MustParse(s string) *URI
  • func Parse(s string) (*URI, error)
  • func (u *URI) Equal(v *URI) bool
  • func (u *URI) String() string
  • func (u *URI) VName() *spb.VName

Constants

const Scheme = "kythe"

Scheme is the URI scheme label for Kythe.

Functions

func Equal

func Equal(u1, u2 string) bool

Equal reports whether the two Kythe URI strings are equal in canonical form. If either URI is invalid, Equal returns false.

func Fix

func Fix(s string) (string, error)

Fix returns the canonical form of the given Kythe URI, if possible.

func ToString

func ToString(v *spb.VName) string

ToString renders the given VName into the standard string uri format.

func ToVName

func ToVName(s string) (*spb.VName, error)

ToVName parses the given string as a URI and returns an equivalent VName.

Types

type URI

type URI struct {
	Signature string
	Corpus    string
	Root      string
	Path      string
	Language  string
}

A URI represents a parsed Kythe URI. A zero-valued URI is ready for use, representing the empty URI.

func FromVName

func FromVName(v *spb.VName) *URI

FromVName returns a Kythe URI for the given Kythe VName protobuf message.

func MustParse

func MustParse(s string) *URI

MustParse returns the URI from parsing s, or panics in case of error.

func Parse

func Parse(s string) (*URI, error)

Parse parses a Kythe URI from s, if possible. If s omits a scheme label, the "kythe" scheme is assumed.

func (*URI) Equal

func (u *URI) Equal(v *URI) bool

Equal reports whether u is equal to v.

func (*URI) String

func (u *URI) String() string

String renders the Kythe URI into the standard URI string format.

The resulting string is in canonical ordering, so if the URI was created by parsing a string, this may return a different string from that. However, parsing this string will always give back the same URI. If u == nil, it is treated as an empty URI.

func (*URI) VName

func (u *URI) VName() *spb.VName

VName converts the URI to an equivalent Kythe VName protobuf message.