pin.go 6.76 KB
Newer Older
Łukasz Magiera's avatar
Łukasz Magiera committed
1 2
package options

Michael Muré's avatar
Michael Muré committed
3 4
import "fmt"

Łukasz Magiera's avatar
Łukasz Magiera committed
5 6 7 8
type PinAddSettings struct {
	Recursive bool
}

Michael Muré's avatar
Michael Muré committed
9 10 11 12
type TypeSettings struct {
	Type string
}

Łukasz Magiera's avatar
Łukasz Magiera committed
13 14 15 16
type PinLsSettings struct {
	Type string
}

Michael Muré's avatar
Michael Muré committed
17 18 19 20
type PinIsPinnedSettings struct {
	WithType string
}

Overbool's avatar
Overbool committed
21 22 23 24 25
// PinRmSettings represents the settings of pin rm command
type PinRmSettings struct {
	Recursive bool
}

Łukasz Magiera's avatar
Łukasz Magiera committed
26 27 28 29
type PinUpdateSettings struct {
	Unpin bool
}

Michael Muré's avatar
Michael Muré committed
30
// PinAddOption pin add option func
Łukasz Magiera's avatar
Łukasz Magiera committed
31
type PinAddOption func(*PinAddSettings) error
Overbool's avatar
Overbool committed
32

Michael Muré's avatar
Michael Muré committed
33 34 35 36 37 38
// PinLsOption pin ls option func
type PinLsOption func(*PinLsSettings) error

// PinIsPinnedOption pin isPinned option func
type PinIsPinnedOption func(*PinIsPinnedSettings) error

Overbool's avatar
Overbool committed
39 40 41
// PinRmOption pin rm option func
type PinRmOption func(*PinRmSettings) error

Michael Muré's avatar
Michael Muré committed
42
// PinUpdateOption pin update option func
Łukasz Magiera's avatar
Łukasz Magiera committed
43
type PinUpdateOption func(*PinUpdateSettings) error
Łukasz Magiera's avatar
Łukasz Magiera committed
44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59

func PinAddOptions(opts ...PinAddOption) (*PinAddSettings, error) {
	options := &PinAddSettings{
		Recursive: true,
	}

	for _, opt := range opts {
		err := opt(options)
		if err != nil {
			return nil, err
		}
	}

	return options, nil
}

Michael Muré's avatar
Michael Muré committed
60 61 62
func PinLsOptions(opts ...PinLsOption) (*PinLsSettings, error) {
	options := &PinLsSettings{
		Type: "all",
Overbool's avatar
Overbool committed
63 64 65
	}

	for _, opt := range opts {
Michael Muré's avatar
Michael Muré committed
66 67
		err := opt(options)
		if err != nil {
Overbool's avatar
Overbool committed
68 69 70 71 72 73 74
			return nil, err
		}
	}

	return options, nil
}

Michael Muré's avatar
Michael Muré committed
75 76 77
func PinIsPinnedOptions(opts ...PinIsPinnedOption) (*PinIsPinnedSettings, error) {
	options := &PinIsPinnedSettings{
		WithType: "all",
Łukasz Magiera's avatar
Łukasz Magiera committed
78 79 80 81 82 83 84 85 86 87 88 89
	}

	for _, opt := range opts {
		err := opt(options)
		if err != nil {
			return nil, err
		}
	}

	return options, nil
}

Michael Muré's avatar
Michael Muré committed
90 91 92 93 94 95 96 97 98 99 100 101 102 103 104
// PinRmOptions pin rm options
func PinRmOptions(opts ...PinRmOption) (*PinRmSettings, error) {
	options := &PinRmSettings{
		Recursive: true,
	}

	for _, opt := range opts {
		if err := opt(options); err != nil {
			return nil, err
		}
	}

	return options, nil
}

Łukasz Magiera's avatar
Łukasz Magiera committed
105 106 107 108 109 110 111 112 113 114 115 116 117 118 119
func PinUpdateOptions(opts ...PinUpdateOption) (*PinUpdateSettings, error) {
	options := &PinUpdateSettings{
		Unpin: true,
	}

	for _, opt := range opts {
		err := opt(options)
		if err != nil {
			return nil, err
		}
	}

	return options, nil
}

120
type pinOpts struct {
Michael Muré's avatar
Michael Muré committed
121 122
	Ls       pinLsOpts
	IsPinned pinIsPinnedOpts
123
}
Łukasz Magiera's avatar
Łukasz Magiera committed
124

125 126
var Pin pinOpts

Michael Muré's avatar
Michael Muré committed
127 128
type pinLsOpts struct{}

129 130
// All is an option for Pin.Ls which will make it return all pins. It is
// the default
Michael Muré's avatar
Michael Muré committed
131 132
func (pinLsOpts) All() PinLsOption {
	return Pin.Ls.pinType("all")
133 134 135 136
}

// Recursive is an option for Pin.Ls which will make it only return recursive
// pins
Michael Muré's avatar
Michael Muré committed
137 138
func (pinLsOpts) Recursive() PinLsOption {
	return Pin.Ls.pinType("recursive")
139 140 141 142
}

// Direct is an option for Pin.Ls which will make it only return direct (non
// recursive) pins
Michael Muré's avatar
Michael Muré committed
143 144
func (pinLsOpts) Direct() PinLsOption {
	return Pin.Ls.pinType("direct")
145 146 147 148
}

// Indirect is an option for Pin.Ls which will make it only return indirect pins
// (objects referenced by other recursively pinned objects)
Michael Muré's avatar
Michael Muré committed
149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244
func (pinLsOpts) Indirect() PinLsOption {
	return Pin.Ls.pinType("indirect")
}

// Type is an option for Pin.Ls which will make it only return pins of the given
// type.
//
// Supported values:
// * "direct" - directly pinned objects
// * "recursive" - roots of recursive pins
// * "indirect" - indirectly pinned objects (referenced by recursively pinned
//    objects)
// * "all" - all pinned objects (default)
func (pinLsOpts) Type(typeStr string) (PinLsOption, error) {
	switch typeStr {
	case "all", "direct", "indirect", "recursive":
		return Pin.Ls.pinType(typeStr), nil
	default:
		return nil, fmt.Errorf("invalid type '%s', must be one of {direct, indirect, recursive, all}", typeStr)
	}
}

// pinType is an option for Pin.Ls which allows to specify which pin types should
// be returned
//
// Supported values:
// * "direct" - directly pinned objects
// * "recursive" - roots of recursive pins
// * "indirect" - indirectly pinned objects (referenced by recursively pinned
//    objects)
// * "all" - all pinned objects (default)
func (pinLsOpts) pinType(t string) PinLsOption {
	return func(settings *PinLsSettings) error {
		settings.Type = t
		return nil
	}
}

type pinIsPinnedOpts struct{}

// All is an option for Pin.IsPinned which will make it search in all type of pins.
// It is the default
func (pinIsPinnedOpts) All() PinIsPinnedOption {
	return Pin.IsPinned.pinType("all")
}

// Recursive is an option for Pin.IsPinned which will make it only search in
// recursive pins
func (pinIsPinnedOpts) Recursive() PinIsPinnedOption {
	return Pin.IsPinned.pinType("recursive")
}

// Direct is an option for Pin.IsPinned which will make it only search in direct
// (non recursive) pins
func (pinIsPinnedOpts) Direct() PinIsPinnedOption {
	return Pin.IsPinned.pinType("direct")
}

// Indirect is an option for Pin.IsPinned which will make it only search indirect
// pins (objects referenced by other recursively pinned objects)
func (pinIsPinnedOpts) Indirect() PinIsPinnedOption {
	return Pin.IsPinned.pinType("indirect")
}

// Type is an option for Pin.IsPinned which will make it only search pins of the given
// type.
//
// Supported values:
// * "direct" - directly pinned objects
// * "recursive" - roots of recursive pins
// * "indirect" - indirectly pinned objects (referenced by recursively pinned
//    objects)
// * "all" - all pinned objects (default)
func (pinIsPinnedOpts) Type(typeStr string) (PinIsPinnedOption, error) {
	switch typeStr {
	case "all", "direct", "indirect", "recursive":
		return Pin.IsPinned.pinType(typeStr), nil
	default:
		return nil, fmt.Errorf("invalid type '%s', must be one of {direct, indirect, recursive, all}", typeStr)
	}
}

// pinType is an option for Pin.IsPinned which allows to specify which pin type the given
// pin is expected to be, speeding up the research.
//
// Supported values:
// * "direct" - directly pinned objects
// * "recursive" - roots of recursive pins
// * "indirect" - indirectly pinned objects (referenced by recursively pinned
//    objects)
// * "all" - all pinned objects (default)
func (pinIsPinnedOpts) pinType(t string) PinIsPinnedOption {
	return func(settings *PinIsPinnedSettings) error {
		settings.WithType = t
		return nil
	}
245 246
}

247 248
// Recursive is an option for Pin.Add which specifies whether to pin an entire
// object tree or just one object. Default: true
Łukasz Magiera's avatar
Łukasz Magiera committed
249
func (pinOpts) Recursive(recursive bool) PinAddOption {
Łukasz Magiera's avatar
Łukasz Magiera committed
250
	return func(settings *PinAddSettings) error {
Łukasz Magiera's avatar
Łukasz Magiera committed
251
		settings.Recursive = recursive
Łukasz Magiera's avatar
Łukasz Magiera committed
252 253 254 255
		return nil
	}
}

256 257 258
// RmRecursive is an option for Pin.Rm which specifies whether to recursively
// unpin the object linked to by the specified object(s). This does not remove
// indirect pins referenced by other recursive pins.
Overbool's avatar
Overbool committed
259 260 261 262 263 264 265
func (pinOpts) RmRecursive(recursive bool) PinRmOption {
	return func(settings *PinRmSettings) error {
		settings.Recursive = recursive
		return nil
	}
}

266 267
// Unpin is an option for Pin.Update which specifies whether to remove the old pin.
// Default is true.
268
func (pinOpts) Unpin(unpin bool) PinUpdateOption {
Łukasz Magiera's avatar
Łukasz Magiera committed
269 270 271 272 273
	return func(settings *PinUpdateSettings) error {
		settings.Unpin = unpin
		return nil
	}
}