bufpath

type ExternalPathResolver interface {
	// RelPathToExternalPath takes a path relative to the asset and converts it
	// to a path that is external to the asset.
	//
	// This path is not necessarily a file path, and should only be used to
	// uniquely identify this file as compared to other assets, and for display
	// to users.
	//
	// The input path will be normalized and validated.
	// The output path will be unnormalized, if it is a file path.
	//
	// Example:
	//   Directory: /foo/bar
	//   RelPath: baz/bat.proto
	//   ExternalPath: /foo/bar/baz/bat.proto
	//
	// Example:
	//   Directory: .
	//   RelPath: baz/bat.proto
	//   ExternalPath: baz/bat.proto
	RelPathToExternalPath(relPath string) (string, error)
}

type PathResolver interface {
	RelPathResolver
	ExternalPathResolver
}

type RelPathResolver interface {
	// ExternalPathToRelPath takes a path external to the asset and converts it to
	// a path that is relative to the asset.
	//
	// The returned path will be normalized and validated.
	//
	// Example:
	//   Directory: /foo/bar
	//   ExternalPath: /foo/bar/baz/bat.proto
	//   RelPath: baz/bat.proto
	ExternalPathToRelPath(externalPath string) (string, error)
}