2017-06-26 23:46:34 +02:00
|
|
|
// Copyright 2016-2017, Pulumi Corporation. All rights reserved.
|
2017-03-03 02:10:10 +01:00
|
|
|
|
|
|
|
package resource
|
|
|
|
|
|
|
|
import (
|
|
|
|
"strings"
|
|
|
|
|
2017-08-02 18:25:22 +02:00
|
|
|
"github.com/pulumi/pulumi-fabric/pkg/tokens"
|
|
|
|
"github.com/pulumi/pulumi-fabric/pkg/util/contract"
|
2017-03-03 02:10:10 +01:00
|
|
|
)
|
|
|
|
|
2017-05-18 20:38:28 +02:00
|
|
|
// URN is a friendly, but unique, URN for a resource, most often auto-assigned by Lumi. These are
|
2017-03-03 02:10:10 +01:00
|
|
|
// used as unique IDs for objects, and help us to perform graph diffing and resolution of resource objects.
|
|
|
|
//
|
|
|
|
// In theory, we could support manually assigned URIs in the future. For the time being, however, we have opted to
|
|
|
|
// simplify developers' lives by mostly automating the generation of them algorithmically. The one caveat where it
|
|
|
|
// isn't truly automatic is that a developer -- or resource provider -- must provide a semi-unique name part.
|
|
|
|
//
|
|
|
|
// Each resource URN is of the form:
|
|
|
|
//
|
2017-08-30 03:24:12 +02:00
|
|
|
// urn:lumi:<Namespace>::<PkgToken>::<Type>::<Name>
|
2017-03-03 02:10:10 +01:00
|
|
|
//
|
|
|
|
// wherein each element is the following:
|
|
|
|
//
|
2017-08-30 03:24:12 +02:00
|
|
|
// <Namespace> The namespace being deployed into
|
|
|
|
// <AllocPkg> The package in which the object was allocated
|
|
|
|
// <Type> The object type's full type token
|
|
|
|
// <Name> The human-friendly name identifier assigned by the developer or provider
|
2017-03-03 02:10:10 +01:00
|
|
|
//
|
|
|
|
// In the future, we may add elements to the URN; it is more important that it is unique than it is human-typable.
|
|
|
|
type URN string
|
|
|
|
|
|
|
|
const (
|
|
|
|
URNPrefix = "urn:" + URNNamespaceID + ":" // the standard URN prefix
|
2017-05-18 20:38:28 +02:00
|
|
|
URNNamespaceID = "lumi" // the URN namespace
|
2017-03-03 02:10:10 +01:00
|
|
|
URNNameDelimiter = "::" // the delimiter between URN name elements
|
|
|
|
)
|
|
|
|
|
|
|
|
// NewURN creates a unique resource URN for the given resource object.
|
2017-08-30 03:24:12 +02:00
|
|
|
func NewURN(ns tokens.QName, alloc tokens.PackageName, t tokens.Type, name tokens.QName) URN {
|
2017-06-16 18:46:09 +02:00
|
|
|
return URN(
|
2017-03-03 02:10:10 +01:00
|
|
|
URNPrefix +
|
|
|
|
string(ns) +
|
|
|
|
URNNameDelimiter + string(alloc) +
|
|
|
|
URNNameDelimiter + string(t) +
|
|
|
|
URNNameDelimiter + string(name),
|
|
|
|
)
|
|
|
|
}
|
|
|
|
|
2017-06-16 18:46:09 +02:00
|
|
|
// URNName returns the URN name part of a URN (i.e., strips off the prefix).
|
|
|
|
func (urn URN) URNName() string {
|
|
|
|
s := string(urn)
|
|
|
|
contract.Assert(strings.HasPrefix(s, URNPrefix))
|
|
|
|
return s[len(URNPrefix):]
|
|
|
|
}
|
2017-03-03 02:10:10 +01:00
|
|
|
|
2017-06-16 18:46:09 +02:00
|
|
|
// Namespace returns the resource namespace part of a URN.
|
|
|
|
func (urn URN) Namespace() tokens.QName {
|
|
|
|
return tokens.QName(strings.Split(urn.URNName(), URNNameDelimiter)[0])
|
2017-03-03 02:10:10 +01:00
|
|
|
}
|
|
|
|
|
2017-06-16 18:46:09 +02:00
|
|
|
// Alloc returns the resource allocation context part of a URN.
|
2017-08-30 03:24:12 +02:00
|
|
|
func (urn URN) Alloc() tokens.PackageName {
|
|
|
|
return tokens.PackageName(strings.Split(urn.URNName(), URNNameDelimiter)[1])
|
2017-03-03 02:10:10 +01:00
|
|
|
}
|
|
|
|
|
2017-06-16 18:46:09 +02:00
|
|
|
// Type returns the resource type part of a URN.
|
|
|
|
func (urn URN) Type() tokens.Type {
|
|
|
|
return tokens.Type(strings.Split(urn.URNName(), URNNameDelimiter)[2])
|
2017-03-03 02:10:10 +01:00
|
|
|
}
|
|
|
|
|
2017-06-16 18:46:09 +02:00
|
|
|
// Name returns the resource name part of a URN.
|
|
|
|
func (urn URN) Name() tokens.QName {
|
|
|
|
return tokens.QName(strings.Split(urn.URNName(), URNNameDelimiter)[3])
|
2017-03-03 02:10:10 +01:00
|
|
|
}
|