jsonreference

README

jsonreference

---

An implementation of JSON Reference for golang.

Status

API is stable.

Import this library in your project

go get github.com/go-openapi/jsonreference

Dependencies

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

Basic usage

Change log

See https://github.com/go-openapi/jsonreference/releases

References

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

Licensing

This library ships under the SPDX-License-Identifier: Apache-2.0.

See the license NOTICE, which recalls the licensing terms of all the pieces of software on top of which it has been built.

Other documentation

• All-time contributors
• Contributing guidelines
• Maintainers documentation
• Code style

Cutting a new release

Maintainers can cut a new release by either:

• running this workflow
• or pushing a semver tag
  • signed tags are preferred
  • The tag message is prepended to release notes

Documentation

Index

• Variables
• 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

Variables

var ErrChildURL = errors.New("child url is nil")

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.