mirror of
https://github.com/ipfs/kubo.git
synced 2025-05-18 15:36:16 +08:00

With verbose flag: * remove EnableStdin() flags on all StringArg, * remove all unneeded parsing code for StringArg, and print an * informative message if `ipfs` begins reading from a CharDevice, * remove broken go tests for EnableStdin cli parsing, and add some * trivial test cases for reading FileArg from stdin, * add a panic to prevent EnableStdin from being set on * StringArg in the future. Resolves: #2877, #2870 License: MIT Signed-off-by: Thomas Gardner <tmg@fastmail.com>
127 lines
3.2 KiB
Go
127 lines
3.2 KiB
Go
package commands
|
|
|
|
import (
|
|
"io"
|
|
"strings"
|
|
|
|
cmds "github.com/ipfs/go-ipfs/commands"
|
|
"github.com/ipfs/go-ipfs/core"
|
|
ns "github.com/ipfs/go-ipfs/namesys"
|
|
path "github.com/ipfs/go-ipfs/path"
|
|
u "gx/ipfs/QmZNVWh8LLjAavuQ2JXuFmuYH3C11xo988vSgp7UQrTRj1/go-ipfs-util"
|
|
)
|
|
|
|
type ResolvedPath struct {
|
|
Path path.Path
|
|
}
|
|
|
|
var ResolveCmd = &cmds.Command{
|
|
Helptext: cmds.HelpText{
|
|
Tagline: "Resolve the value of names to IPFS.",
|
|
ShortDescription: `
|
|
There are a number of mutable name protocols that can link among
|
|
themselves and into IPNS. This command accepts any of these
|
|
identifiers and resolves them to the referenced item.
|
|
`,
|
|
LongDescription: `
|
|
There are a number of mutable name protocols that can link among
|
|
themselves and into IPNS. For example IPNS references can (currently)
|
|
point at an IPFS object, and DNS links can point at other DNS links, IPNS
|
|
entries, or IPFS objects. This command accepts any of these
|
|
identifiers and resolves them to the referenced item.
|
|
|
|
EXAMPLES
|
|
|
|
Resolve the value of your identity:
|
|
|
|
$ ipfs resolve /ipns/QmatmE9msSfkKxoffpHwNLNKgwZG8eT9Bud6YoPab52vpy
|
|
/ipfs/Qmcqtw8FfrVSBaRmbWwHxt3AuySBhJLcvmFYi3Lbc4xnwj
|
|
|
|
Resolve the value of another name:
|
|
|
|
$ ipfs resolve /ipns/QmbCMUZw6JFeZ7Wp9jkzbye3Fzp2GGcPgC3nmeUjfVF87n
|
|
/ipns/QmatmE9msSfkKxoffpHwNLNKgwZG8eT9Bud6YoPab52vpy
|
|
|
|
Resolve the value of another name recursively:
|
|
|
|
$ ipfs resolve -r /ipns/QmbCMUZw6JFeZ7Wp9jkzbye3Fzp2GGcPgC3nmeUjfVF87n
|
|
/ipfs/Qmcqtw8FfrVSBaRmbWwHxt3AuySBhJLcvmFYi3Lbc4xnwj
|
|
|
|
Resolve the value of an IPFS DAG path:
|
|
|
|
$ ipfs resolve /ipfs/QmeZy1fGbwgVSrqbfh9fKQrAWgeyRnj7h8fsHS1oy3k99x/beep/boop
|
|
/ipfs/QmYRMjyvAiHKN9UTi8Bzt1HUspmSRD8T8DwxfSMzLgBon1
|
|
|
|
`,
|
|
},
|
|
|
|
Arguments: []cmds.Argument{
|
|
cmds.StringArg("name", true, false, "The name to resolve."),
|
|
},
|
|
Options: []cmds.Option{
|
|
cmds.BoolOption("recursive", "r", "Resolve until the result is an IPFS name.").Default(false),
|
|
},
|
|
Run: func(req cmds.Request, res cmds.Response) {
|
|
|
|
n, err := req.InvocContext().GetNode()
|
|
if err != nil {
|
|
res.SetError(err, cmds.ErrNormal)
|
|
return
|
|
}
|
|
|
|
if !n.OnlineMode() {
|
|
err := n.SetupOfflineRouting()
|
|
if err != nil {
|
|
res.SetError(err, cmds.ErrNormal)
|
|
return
|
|
}
|
|
}
|
|
|
|
name := req.Arguments()[0]
|
|
recursive, _, _ := req.Option("recursive").Bool()
|
|
|
|
// the case when ipns is resolved step by step
|
|
if strings.HasPrefix(name, "/ipns/") && !recursive {
|
|
p, err := n.Namesys.ResolveN(req.Context(), name, 1)
|
|
// ErrResolveRecursion is fine
|
|
if err != nil && err != ns.ErrResolveRecursion {
|
|
res.SetError(err, cmds.ErrNormal)
|
|
return
|
|
}
|
|
res.SetOutput(&ResolvedPath{p})
|
|
return
|
|
}
|
|
|
|
// else, ipfs path or ipns with recursive flag
|
|
p, err := path.ParsePath(name)
|
|
if err != nil {
|
|
res.SetError(err, cmds.ErrNormal)
|
|
return
|
|
}
|
|
|
|
node, err := core.Resolve(req.Context(), n, p)
|
|
if err != nil {
|
|
res.SetError(err, cmds.ErrNormal)
|
|
return
|
|
}
|
|
|
|
key, err := node.Key()
|
|
if err != nil {
|
|
res.SetError(err, cmds.ErrNormal)
|
|
return
|
|
}
|
|
|
|
res.SetOutput(&ResolvedPath{path.FromKey(key)})
|
|
},
|
|
Marshalers: cmds.MarshalerMap{
|
|
cmds.Text: func(res cmds.Response) (io.Reader, error) {
|
|
output, ok := res.Output().(*ResolvedPath)
|
|
if !ok {
|
|
return nil, u.ErrCast()
|
|
}
|
|
return strings.NewReader(output.Path.String() + "\n"), nil
|
|
},
|
|
},
|
|
Type: ResolvedPath{},
|
|
}
|