759dd4802d
This adds a new allocations field to add response objects which provides the cluster peers to which the content has been allocated. In the case of sharded dags, it provides peers for the current shard.
262 lines
6.4 KiB
Go
262 lines
6.4 KiB
Go
package api
|
|
|
|
import (
|
|
"errors"
|
|
"fmt"
|
|
"net/url"
|
|
"strconv"
|
|
|
|
cid "github.com/ipfs/go-cid"
|
|
peer "github.com/libp2p/go-libp2p-core/peer"
|
|
)
|
|
|
|
// DefaultShardSize is the shard size for params objects created with DefaultParams().
|
|
var DefaultShardSize = uint64(100 * 1024 * 1024) // 100 MB
|
|
|
|
// AddedOutput carries information for displaying the standard ipfs output
|
|
// indicating a node of a file has been added.
|
|
type AddedOutput struct {
|
|
Name string `json:"name" codec:"n,omitempty"`
|
|
Cid cid.Cid `json:"cid" codec:"c"`
|
|
Bytes uint64 `json:"bytes,omitempty" codec:"b,omitempty"`
|
|
Size uint64 `json:"size,omitempty" codec:"s,omitempty"`
|
|
Allocations []peer.ID `json:"allocations,omitempty" codec:"a,omitempty"`
|
|
}
|
|
|
|
// IPFSAddParams groups options specific to the ipfs-adder, which builds
|
|
// UnixFS dags with the input files. This struct is embedded in AddParams.
|
|
type IPFSAddParams struct {
|
|
Layout string
|
|
Chunker string
|
|
RawLeaves bool
|
|
Progress bool
|
|
CidVersion int
|
|
HashFun string
|
|
NoCopy bool
|
|
}
|
|
|
|
// AddParams contains all of the configurable parameters needed to specify the
|
|
// importing process of a file being added to an ipfs-cluster
|
|
type AddParams struct {
|
|
PinOptions
|
|
|
|
Local bool
|
|
Recursive bool
|
|
Hidden bool
|
|
Wrap bool
|
|
Shard bool
|
|
StreamChannels bool
|
|
Format string // selects with adder
|
|
NoPin bool
|
|
|
|
IPFSAddParams
|
|
}
|
|
|
|
// DefaultAddParams returns a AddParams object with standard defaults
|
|
func DefaultAddParams() AddParams {
|
|
return AddParams{
|
|
Local: false,
|
|
Recursive: false,
|
|
|
|
Hidden: false,
|
|
Wrap: false,
|
|
Shard: false,
|
|
|
|
StreamChannels: true,
|
|
|
|
Format: "unixfs",
|
|
NoPin: false,
|
|
PinOptions: PinOptions{
|
|
ReplicationFactorMin: 0,
|
|
ReplicationFactorMax: 0,
|
|
Name: "",
|
|
Mode: PinModeRecursive,
|
|
ShardSize: DefaultShardSize,
|
|
Metadata: make(map[string]string),
|
|
Origins: nil,
|
|
},
|
|
IPFSAddParams: IPFSAddParams{
|
|
Layout: "", // corresponds to balanced layout
|
|
Chunker: "size-262144",
|
|
RawLeaves: false,
|
|
Progress: false,
|
|
CidVersion: 0,
|
|
HashFun: "sha2-256",
|
|
NoCopy: false,
|
|
},
|
|
}
|
|
}
|
|
|
|
func parseBoolParam(q url.Values, name string, dest *bool) error {
|
|
if v := q.Get(name); v != "" {
|
|
b, err := strconv.ParseBool(v)
|
|
if err != nil {
|
|
return fmt.Errorf("parameter %s invalid", name)
|
|
}
|
|
*dest = b
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func parseIntParam(q url.Values, name string, dest *int) error {
|
|
if v := q.Get(name); v != "" {
|
|
i, err := strconv.Atoi(v)
|
|
if err != nil {
|
|
return fmt.Errorf("parameter %s invalid", name)
|
|
}
|
|
*dest = i
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// AddParamsFromQuery parses the AddParams object from
|
|
// a URL.Query().
|
|
func AddParamsFromQuery(query url.Values) (AddParams, error) {
|
|
params := DefaultAddParams()
|
|
|
|
opts := &PinOptions{}
|
|
err := opts.FromQuery(query)
|
|
if err != nil {
|
|
return params, err
|
|
}
|
|
params.PinOptions = *opts
|
|
params.PinUpdate = cid.Undef // hardcode as does not make sense for adding
|
|
|
|
layout := query.Get("layout")
|
|
switch layout {
|
|
case "trickle", "balanced", "":
|
|
// nothing
|
|
default:
|
|
return params, errors.New("layout parameter is invalid")
|
|
}
|
|
params.Layout = layout
|
|
|
|
chunker := query.Get("chunker")
|
|
if chunker != "" {
|
|
params.Chunker = chunker
|
|
}
|
|
|
|
hashF := query.Get("hash")
|
|
if hashF != "" {
|
|
params.HashFun = hashF
|
|
}
|
|
|
|
format := query.Get("format")
|
|
switch format {
|
|
case "car", "unixfs", "":
|
|
default:
|
|
return params, errors.New("format parameter is invalid")
|
|
}
|
|
params.Format = format
|
|
|
|
err = parseBoolParam(query, "local", ¶ms.Local)
|
|
if err != nil {
|
|
return params, err
|
|
}
|
|
|
|
err = parseBoolParam(query, "recursive", ¶ms.Recursive)
|
|
if err != nil {
|
|
return params, err
|
|
}
|
|
|
|
err = parseBoolParam(query, "hidden", ¶ms.Hidden)
|
|
if err != nil {
|
|
return params, err
|
|
}
|
|
err = parseBoolParam(query, "wrap-with-directory", ¶ms.Wrap)
|
|
if err != nil {
|
|
return params, err
|
|
}
|
|
err = parseBoolParam(query, "shard", ¶ms.Shard)
|
|
if err != nil {
|
|
return params, err
|
|
}
|
|
|
|
err = parseBoolParam(query, "progress", ¶ms.Progress)
|
|
if err != nil {
|
|
return params, err
|
|
}
|
|
|
|
err = parseIntParam(query, "cid-version", ¶ms.CidVersion)
|
|
if err != nil {
|
|
return params, err
|
|
}
|
|
|
|
// This mimics go-ipfs behaviour.
|
|
if params.CidVersion > 0 {
|
|
params.RawLeaves = true
|
|
}
|
|
|
|
// If the raw-leaves param is empty, the default RawLeaves value will
|
|
// take place (which may be true or false depending on
|
|
// CidVersion). Otherwise, it will be explicitly set.
|
|
err = parseBoolParam(query, "raw-leaves", ¶ms.RawLeaves)
|
|
if err != nil {
|
|
return params, err
|
|
}
|
|
|
|
err = parseBoolParam(query, "stream-channels", ¶ms.StreamChannels)
|
|
if err != nil {
|
|
return params, err
|
|
}
|
|
|
|
err = parseBoolParam(query, "nocopy", ¶ms.NoCopy)
|
|
if err != nil {
|
|
return params, err
|
|
}
|
|
|
|
err = parseBoolParam(query, "no-pin", ¶ms.NoPin)
|
|
if err != nil {
|
|
return params, err
|
|
}
|
|
|
|
return params, nil
|
|
}
|
|
|
|
// ToQueryString returns a url query string (key=value&key2=value2&...)
|
|
func (p AddParams) ToQueryString() (string, error) {
|
|
pinOptsQuery, err := p.PinOptions.ToQuery()
|
|
if err != nil {
|
|
return "", err
|
|
}
|
|
query, err := url.ParseQuery(pinOptsQuery)
|
|
if err != nil {
|
|
return "", err
|
|
}
|
|
query.Set("shard", fmt.Sprintf("%t", p.Shard))
|
|
query.Set("local", fmt.Sprintf("%t", p.Local))
|
|
query.Set("recursive", fmt.Sprintf("%t", p.Recursive))
|
|
query.Set("layout", p.Layout)
|
|
query.Set("chunker", p.Chunker)
|
|
query.Set("raw-leaves", fmt.Sprintf("%t", p.RawLeaves))
|
|
query.Set("hidden", fmt.Sprintf("%t", p.Hidden))
|
|
query.Set("wrap-with-directory", fmt.Sprintf("%t", p.Wrap))
|
|
query.Set("progress", fmt.Sprintf("%t", p.Progress))
|
|
query.Set("cid-version", fmt.Sprintf("%d", p.CidVersion))
|
|
query.Set("hash", p.HashFun)
|
|
query.Set("stream-channels", fmt.Sprintf("%t", p.StreamChannels))
|
|
query.Set("nocopy", fmt.Sprintf("%t", p.NoCopy))
|
|
query.Set("format", p.Format)
|
|
query.Set("no-pin", fmt.Sprintf("%t", p.NoPin))
|
|
return query.Encode(), nil
|
|
}
|
|
|
|
// Equals checks if p equals p2.
|
|
func (p AddParams) Equals(p2 AddParams) bool {
|
|
return p.PinOptions.Equals(&p2.PinOptions) &&
|
|
p.Local == p2.Local &&
|
|
p.Recursive == p2.Recursive &&
|
|
p.Shard == p2.Shard &&
|
|
p.Layout == p2.Layout &&
|
|
p.Chunker == p2.Chunker &&
|
|
p.RawLeaves == p2.RawLeaves &&
|
|
p.Hidden == p2.Hidden &&
|
|
p.Wrap == p2.Wrap &&
|
|
p.CidVersion == p2.CidVersion &&
|
|
p.HashFun == p2.HashFun &&
|
|
p.StreamChannels == p2.StreamChannels &&
|
|
p.NoCopy == p2.NoCopy &&
|
|
p.Format == p2.Format &&
|
|
p.NoPin == p2.NoPin
|
|
}
|