2018-08-06 10:44:44 +00:00
|
|
|
package api
|
2018-07-04 16:30:24 +00:00
|
|
|
|
|
|
|
import (
|
|
|
|
"errors"
|
2018-07-24 13:22:29 +00:00
|
|
|
"fmt"
|
2018-07-04 16:30:24 +00:00
|
|
|
"net/url"
|
|
|
|
"strconv"
|
|
|
|
)
|
|
|
|
|
2018-07-24 12:21:29 +00:00
|
|
|
// DefaultShardSize is the shard size for params objects created with DefaultParams().
|
2018-08-13 09:56:16 +00:00
|
|
|
var DefaultShardSize = uint64(100 * 1024 * 1024) // 100 MB
|
2018-07-23 09:14:43 +00:00
|
|
|
|
2018-08-06 20:49:28 +00:00
|
|
|
// AddedOutput carries information for displaying the standard ipfs output
|
|
|
|
// indicating a node of a file has been added.
|
|
|
|
type AddedOutput struct {
|
|
|
|
Error
|
|
|
|
Name string
|
|
|
|
Hash string `json:",omitempty"`
|
|
|
|
Bytes int64 `json:",omitempty"`
|
|
|
|
Size string `json:",omitempty"`
|
|
|
|
}
|
|
|
|
|
2018-08-06 12:31:45 +00:00
|
|
|
// AddParams contains all of the configurable parameters needed to specify the
|
2018-07-04 16:30:24 +00:00
|
|
|
// importing process of a file being added to an ipfs-cluster
|
2018-08-06 10:44:44 +00:00
|
|
|
type AddParams struct {
|
|
|
|
PinOptions
|
2018-07-04 16:30:24 +00:00
|
|
|
|
2018-08-19 17:39:08 +00:00
|
|
|
Recursive bool
|
2018-07-04 16:30:24 +00:00
|
|
|
Layout string
|
|
|
|
Chunker string
|
|
|
|
RawLeaves bool
|
|
|
|
Hidden bool
|
2018-08-08 19:11:26 +00:00
|
|
|
Wrap bool
|
2018-07-04 16:30:24 +00:00
|
|
|
Shard bool
|
2018-08-16 15:40:32 +00:00
|
|
|
Progress bool
|
2018-07-04 16:30:24 +00:00
|
|
|
}
|
|
|
|
|
2018-08-06 10:44:44 +00:00
|
|
|
// DefaultAddParams returns a AddParams object with standard defaults
|
|
|
|
func DefaultAddParams() *AddParams {
|
|
|
|
return &AddParams{
|
2018-08-19 17:39:08 +00:00
|
|
|
Recursive: false,
|
2018-07-04 16:30:24 +00:00
|
|
|
Layout: "", // corresponds to balanced layout
|
2018-08-06 10:44:44 +00:00
|
|
|
Chunker: "size-262144",
|
2018-07-04 16:30:24 +00:00
|
|
|
RawLeaves: false,
|
|
|
|
Hidden: false,
|
2018-08-08 19:11:26 +00:00
|
|
|
Wrap: false,
|
2018-07-04 16:30:24 +00:00
|
|
|
Shard: false,
|
2018-08-16 15:40:32 +00:00
|
|
|
Progress: false,
|
2018-08-06 10:44:44 +00:00
|
|
|
PinOptions: PinOptions{
|
2018-07-19 14:27:23 +00:00
|
|
|
ReplicationFactorMin: 0,
|
|
|
|
ReplicationFactorMax: 0,
|
2018-07-04 16:30:24 +00:00
|
|
|
Name: "",
|
2018-07-23 13:56:46 +00:00
|
|
|
ShardSize: DefaultShardSize,
|
2018-07-04 16:30:24 +00:00
|
|
|
},
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2018-07-24 13:22:29 +00:00
|
|
|
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
|
|
|
|
}
|
|
|
|
|
2018-08-06 10:44:44 +00:00
|
|
|
// AddParamsFromQuery parses the AddParams object from
|
2018-07-04 16:30:24 +00:00
|
|
|
// a URL.Query().
|
2018-08-06 10:44:44 +00:00
|
|
|
func AddParamsFromQuery(query url.Values) (*AddParams, error) {
|
|
|
|
params := DefaultAddParams()
|
2018-07-19 14:27:23 +00:00
|
|
|
|
2018-07-04 16:30:24 +00:00
|
|
|
layout := query.Get("layout")
|
|
|
|
switch layout {
|
2018-08-09 11:22:47 +00:00
|
|
|
case "trickle", "balanced", "":
|
2018-07-20 11:56:59 +00:00
|
|
|
// nothing
|
2018-07-04 16:30:24 +00:00
|
|
|
default:
|
|
|
|
return nil, errors.New("parameter trickle invalid")
|
|
|
|
}
|
2018-07-19 14:27:23 +00:00
|
|
|
params.Layout = layout
|
2018-07-04 16:30:24 +00:00
|
|
|
|
|
|
|
chunker := query.Get("chunker")
|
2018-07-19 14:27:23 +00:00
|
|
|
params.Chunker = chunker
|
2018-07-04 16:30:24 +00:00
|
|
|
name := query.Get("name")
|
2018-07-19 14:27:23 +00:00
|
|
|
params.Name = name
|
|
|
|
|
2018-08-19 17:39:08 +00:00
|
|
|
err := parseBoolParam(query, "recursive", ¶ms.Recursive)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
|
|
|
err = parseBoolParam(query, "raw-leaves", ¶ms.RawLeaves)
|
2018-07-24 13:22:29 +00:00
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
2018-07-04 16:30:24 +00:00
|
|
|
}
|
2018-07-24 13:22:29 +00:00
|
|
|
err = parseBoolParam(query, "hidden", ¶ms.Hidden)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
2018-07-04 16:30:24 +00:00
|
|
|
}
|
2018-08-08 19:11:26 +00:00
|
|
|
err = parseBoolParam(query, "wrap-with-directory", ¶ms.Wrap)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
2018-07-24 13:22:29 +00:00
|
|
|
err = parseBoolParam(query, "shard", ¶ms.Shard)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
2018-07-04 16:30:24 +00:00
|
|
|
}
|
2018-08-16 15:40:32 +00:00
|
|
|
|
|
|
|
err = parseBoolParam(query, "progress", ¶ms.Progress)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
2018-08-08 19:11:26 +00:00
|
|
|
err = parseIntParam(query, "replication-min", ¶ms.ReplicationFactorMin)
|
2018-07-24 13:22:29 +00:00
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
2018-07-04 16:30:24 +00:00
|
|
|
}
|
2018-08-08 19:11:26 +00:00
|
|
|
err = parseIntParam(query, "replication-max", ¶ms.ReplicationFactorMax)
|
2018-07-24 13:22:29 +00:00
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
2018-07-04 16:30:24 +00:00
|
|
|
}
|
|
|
|
|
2018-08-08 19:11:26 +00:00
|
|
|
if v := query.Get("shard-size"); v != "" {
|
2018-07-19 14:27:23 +00:00
|
|
|
shardSize, err := strconv.ParseUint(v, 10, 64)
|
|
|
|
if err != nil {
|
|
|
|
return nil, errors.New("parameter shard_size is invalid")
|
|
|
|
}
|
|
|
|
params.ShardSize = shardSize
|
2018-07-04 16:30:24 +00:00
|
|
|
}
|
2018-07-19 14:27:23 +00:00
|
|
|
|
2018-07-04 16:30:24 +00:00
|
|
|
return params, nil
|
|
|
|
}
|
2018-08-06 10:44:44 +00:00
|
|
|
|
|
|
|
// ToQueryString returns a url query string (key=value&key2=value2&...)
|
|
|
|
func (p *AddParams) ToQueryString() string {
|
2018-08-08 19:11:26 +00:00
|
|
|
fmtStr := "replication-min=%d&replication-max=%d&name=%s&"
|
2018-08-19 17:39:08 +00:00
|
|
|
fmtStr += "shard=%t&shard-size=%d&recursive=%t&"
|
2018-08-08 19:11:26 +00:00
|
|
|
fmtStr += "layout=%s&chunker=%s&raw-leaves=%t&hidden=%t&"
|
2018-08-16 15:40:32 +00:00
|
|
|
fmtStr += "wrap-with-directory=%t&progress=%t"
|
2018-08-06 10:44:44 +00:00
|
|
|
query := fmt.Sprintf(
|
|
|
|
fmtStr,
|
|
|
|
p.ReplicationFactorMin,
|
|
|
|
p.ReplicationFactorMax,
|
|
|
|
p.Name,
|
|
|
|
p.Shard,
|
|
|
|
p.ShardSize,
|
2018-08-19 17:39:08 +00:00
|
|
|
p.Recursive,
|
2018-08-06 10:44:44 +00:00
|
|
|
p.Layout,
|
|
|
|
p.Chunker,
|
|
|
|
p.RawLeaves,
|
|
|
|
p.Hidden,
|
2018-08-08 19:11:26 +00:00
|
|
|
p.Wrap,
|
2018-08-16 15:40:32 +00:00
|
|
|
p.Progress,
|
2018-08-06 10:44:44 +00:00
|
|
|
)
|
|
|
|
return query
|
|
|
|
}
|
|
|
|
|
2018-08-06 12:31:45 +00:00
|
|
|
// Equals checks if p equals p2.
|
2018-08-06 10:44:44 +00:00
|
|
|
func (p *AddParams) Equals(p2 *AddParams) bool {
|
|
|
|
return p.ReplicationFactorMin == p2.ReplicationFactorMin &&
|
|
|
|
p.ReplicationFactorMax == p2.ReplicationFactorMax &&
|
|
|
|
p.Name == p2.Name &&
|
2018-08-19 17:39:08 +00:00
|
|
|
p.Recursive == p2.Recursive &&
|
2018-08-06 10:44:44 +00:00
|
|
|
p.Shard == p2.Shard &&
|
|
|
|
p.ShardSize == p2.ShardSize &&
|
|
|
|
p.Layout == p2.Layout &&
|
|
|
|
p.Chunker == p2.Chunker &&
|
|
|
|
p.RawLeaves == p2.RawLeaves &&
|
2018-08-08 19:11:26 +00:00
|
|
|
p.Hidden == p2.Hidden &&
|
|
|
|
p.Wrap == p2.Wrap
|
2018-08-06 10:44:44 +00:00
|
|
|
}
|