jsonreference

README

gojsonreference

An implementation of JSON Reference - Go language

Status

Feature complete. Stable API

Dependencies

• https://github.com/go-openapi/jsonpointer

References

• http://tools.ietf.org/html/draft-ietf-appsawg-json-pointer-07
• http://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03

Documentation

Index

• type Ref
  • func MustCreateRef(ref string) Ref
  • func New(jsonReferenceString string) (Ref, error)
  • func (r *Ref) GetPointer() *jsonpointer.Pointer
  • func (r *Ref) GetURL() *url.URL
  • func (r *Ref) Inherits(child Ref) (*Ref, error)
  • func (r *Ref) IsCanonical() bool
  • func (r *Ref) IsRoot() bool
  • func (r *Ref) String() string

Types

type Ref

type Ref struct {
	HasFullURL      bool
	HasURLPathOnly  bool
	HasFragmentOnly bool
	HasFileScheme   bool
	HasFullFilePath bool
	// contains filtered or unexported fields
}

Ref represents a json reference object

func MustCreateRef

func MustCreateRef(ref string) Ref

MustCreateRef parses the ref string and panics when it's invalid. Use the New method for a version that returns an error

func New

func New(jsonReferenceString string) (Ref, error)

New creates a new reference for the given string

func (*Ref) GetPointer

func (r *Ref) GetPointer() *jsonpointer.Pointer

GetPointer gets the json pointer for this reference

func (*Ref) GetURL

func (r *Ref) GetURL() *url.URL

GetURL gets the URL for this reference

func (*Ref) Inherits

func (r *Ref) Inherits(child Ref) (*Ref, error)

Inherits creates a new reference from a parent and a child If the child cannot inherit from the parent, an error is returned

func (*Ref) IsCanonical

func (r *Ref) IsCanonical() bool

IsCanonical returns true when this pointer starts with http(s):// or file://

func (*Ref) IsRoot

func (r *Ref) IsRoot() bool

IsRoot returns true if this reference is a root document

func (*Ref) String

func (r *Ref) String() string

String returns the best version of the url for this reference