url

Documentation

Overview

Package url abstracts local and remote file URLs.

Index

• type Option
  • func WithRaw(mode bool) Option
• type URL
  • func New(s string, opts ...Option) (*URL, error)
  • func (u *URL) Absolute() string
  • func (u *URL) Base() string
  • func (u *URL) Clone() *URL
  • func (u *URL) Dir() string
  • func (u *URL) EscapedPath() string
  • func (u *URL) IsBucket() bool
  • func (u *URL) IsPrefix() bool
  • func (u *URL) IsRemote() bool
  • func (u *URL) IsWildcard() bool
  • func (u *URL) Join(s string) *URL
  • func (u *URL) MarshalJSON() ([]byte, error)
  • func (u *URL) Match(key string) bool
  • func (u *URL) Relative() string
  • func (u *URL) SetRelative(base string)
  • func (u *URL) String() string

Types

type Option

type Option func(u *URL)

func WithRaw

func WithRaw(mode bool) Option

type URL

type URL struct {
	Type      urlType
	Scheme    string
	Bucket    string
	Path      string
	Delimiter string
	Prefix    string
	// contains filtered or unexported fields
}

URL is the canonical representation of an object, either on local or remote storage.

func New

func New(s string, opts ...Option) (*URL, error)

New creates a new URL from given path string.

func (*URL) Absolute

func (u *URL) Absolute() string

Absolute returns the absolute URL format of the object.

func (*URL) Base

func (u *URL) Base() string

Base returns the last element of object path.

func (*URL) Clone

func (u *URL) Clone() *URL

Clone creates a copy of the receiver.

func (*URL) Dir

func (u *URL) Dir() string

Dir returns all but the last element of path, typically the path's directory.

func (*URL) EscapedPath

func (u *URL) EscapedPath() string

func (*URL) IsBucket

func (u *URL) IsBucket() bool

IsBucket returns true if the object url contains only bucket name

func (*URL) IsPrefix

func (u *URL) IsPrefix() bool

IsPrefix reports whether the remote object is an S3 prefix, and does not look like an object.

func (*URL) IsRemote

func (u *URL) IsRemote() bool

IsRemote reports whether the object is stored on a remote storage system.

func (*URL) IsWildcard

func (u *URL) IsWildcard() bool

IsWildcard reports whether if a string contains any wildcard chars.

func (*URL) Join

func (u *URL) Join(s string) *URL

Join joins string and returns new URL.

func (*URL) MarshalJSON

func (u *URL) MarshalJSON() ([]byte, error)

MarshalJSON is the json.Marshaler implementation of URL.

func (*URL) Match

func (u *URL) Match(key string) bool

Match reports whether if given key matches with the object.

func (*URL) Relative

func (u *URL) Relative() string

Relative returns a URI reference based on the calculated prefix.

func (*URL) SetRelative

func (u *URL) SetRelative(base string)

SetRelative explicitly sets the relative path of u against given base value.

func (*URL) String

func (u *URL) String() string

String is the fmt.Stringer implementation of URL.