mirror of
https://github.com/ipfs/kubo.git
synced 2026-02-21 18:37:45 +08:00
55 lines
1.4 KiB
Go
55 lines
1.4 KiB
Go
package iface
|
|
|
|
import (
|
|
"context"
|
|
|
|
options "github.com/ipfs/go-ipfs/core/coreapi/interface/options"
|
|
)
|
|
|
|
// Pin holds information about pinned resource
|
|
type Pin interface {
|
|
// Path to the pinned object
|
|
Path() ResolvedPath
|
|
|
|
// Type of the pin
|
|
Type() string
|
|
}
|
|
|
|
// PinStatus holds information about pin health
|
|
type PinStatus interface {
|
|
// Ok indicates whether the pin has been verified to be correct
|
|
Ok() bool
|
|
|
|
// BadNodes returns any bad (usually missing) nodes from the pin
|
|
BadNodes() []BadPinNode
|
|
}
|
|
|
|
// BadPinNode is a node that has been marked as bad by Pin.Verify
|
|
type BadPinNode interface {
|
|
// Path is the path of the node
|
|
Path() ResolvedPath
|
|
|
|
// Err is the reason why the node has been marked as bad
|
|
Err() error
|
|
}
|
|
|
|
// PinAPI specifies the interface to pining
|
|
type PinAPI interface {
|
|
// Add creates new pin, be default recursive - pinning the whole referenced
|
|
// tree
|
|
Add(context.Context, Path, ...options.PinAddOption) error
|
|
|
|
// Ls returns list of pinned objects on this node
|
|
Ls(context.Context, ...options.PinLsOption) ([]Pin, error)
|
|
|
|
// Rm removes pin for object specified by the path
|
|
Rm(context.Context, Path, ...options.PinRmOption) error
|
|
|
|
// Update changes one pin to another, skipping checks for matching paths in
|
|
// the old tree
|
|
Update(ctx context.Context, from Path, to Path, opts ...options.PinUpdateOption) error
|
|
|
|
// Verify verifies the integrity of pinned objects
|
|
Verify(context.Context) (<-chan PinStatus, error)
|
|
}
|