mirror of
https://github.com/ipfs/kubo.git
synced 2026-02-21 18:37:45 +08:00
Changed so only explicit ipfs cli commands are lowercased
License: MIT Signed-off-by: Richard Littauer <richard.littauer@gmail.com>
This commit is contained in:
parent
9aaa743a51
commit
9843e86258
@ -1,4 +1,4 @@
|
||||
// package blocks contains the lowest level of ipfs data structures,
|
||||
// package blocks contains the lowest level of IPFS data structures,
|
||||
// the raw block with a checksum.
|
||||
package blocks
|
||||
|
||||
|
||||
@ -54,7 +54,7 @@ const (
|
||||
|
||||
var daemonCmd = &cmds.Command{
|
||||
Helptext: cmds.HelpText{
|
||||
Tagline: "Run a network-connected ipfs node.",
|
||||
Tagline: "Run a network-connected IPFS node.",
|
||||
ShortDescription: `
|
||||
'ipfs daemon' runs a persistent ipfs daemon that can serve commands
|
||||
over the network. Most applications that use IPFS will do so by
|
||||
@ -147,9 +147,9 @@ Headers.
|
||||
Options: []cmds.Option{
|
||||
cmds.BoolOption(initOptionKwd, "Initialize ipfs with default settings if not already initialized").Default(false),
|
||||
cmds.StringOption(routingOptionKwd, "Overrides the routing option").Default("dht"),
|
||||
cmds.BoolOption(mountKwd, "Mounts ipfs to the filesystem").Default(false),
|
||||
cmds.BoolOption(mountKwd, "Mounts IPFS to the filesystem").Default(false),
|
||||
cmds.BoolOption(writableKwd, "Enable writing objects (with POST, PUT and DELETE)").Default(false),
|
||||
cmds.StringOption(ipfsMountKwd, "Path to the mountpoint for ipfs (if using --mount). Defaults to config setting."),
|
||||
cmds.StringOption(ipfsMountKwd, "Path to the mountpoint for IPFS (if using --mount). Defaults to config setting."),
|
||||
cmds.StringOption(ipnsMountKwd, "Path to the mountpoint for IPNS (if using --mount). Defaults to config setting."),
|
||||
cmds.BoolOption(unrestrictedApiAccessKwd, "Allow API access to unlisted hashes").Default(false),
|
||||
cmds.BoolOption(unencryptTransportKwd, "Disable transport encryption (for debugging protocols)").Default(false),
|
||||
|
||||
@ -112,7 +112,7 @@ func initWithDefaults(out io.Writer, repoRoot string) error {
|
||||
}
|
||||
|
||||
func doInit(out io.Writer, repoRoot string, empty bool, nBitsForKeypair int, conf *config.Config) error {
|
||||
if _, err := fmt.Fprintf(out, "initializing ipfs node at %s\n", repoRoot); err != nil {
|
||||
if _, err := fmt.Fprintf(out, "initializing IPFS node at %s\n", repoRoot); err != nil {
|
||||
return err
|
||||
}
|
||||
|
||||
|
||||
@ -381,7 +381,7 @@ func commandDetails(path []string, root *cmds.Command) (*cmdDetails, error) {
|
||||
}
|
||||
|
||||
// commandShouldRunOnDaemon determines, from commmand details, whether a
|
||||
// command ought to be executed on an IPFS daemon.
|
||||
// command ought to be executed on an ipfs daemon.
|
||||
//
|
||||
// It returns a client if the command should be executed on a daemon and nil if
|
||||
// it should be executed on a client. It returns an error if the command must
|
||||
|
||||
@ -13,7 +13,7 @@ import (
|
||||
|
||||
var ActiveReqsCmd = &cmds.Command{
|
||||
Helptext: cmds.HelpText{
|
||||
Tagline: "List commands run on this ipfs node.",
|
||||
Tagline: "List commands run on this IPFS node.",
|
||||
ShortDescription: `
|
||||
Lists running and recently run commands.
|
||||
`,
|
||||
|
||||
@ -44,7 +44,7 @@ multihash.
|
||||
|
||||
var blockStatCmd = &cmds.Command{
|
||||
Helptext: cmds.HelpText{
|
||||
Tagline: "Print information of a raw ipfs block.",
|
||||
Tagline: "Print information of a raw IPFS block.",
|
||||
ShortDescription: `
|
||||
'ipfs block stat' is a plumbing command for retrieving information
|
||||
on raw IPFS blocks. It outputs the following to stdout:
|
||||
@ -81,7 +81,7 @@ on raw IPFS blocks. It outputs the following to stdout:
|
||||
|
||||
var blockGetCmd = &cmds.Command{
|
||||
Helptext: cmds.HelpText{
|
||||
Tagline: "Get a raw ipfs block.",
|
||||
Tagline: "Get a raw IPFS block.",
|
||||
ShortDescription: `
|
||||
'ipfs block get' is a plumbing command for retrieving raw IPFS blocks.
|
||||
It outputs to stdout, and <key> is a base58 encoded multihash.
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
// Package commands implements the IPFS command interface
|
||||
// Package commands implements the ipfs command interface
|
||||
//
|
||||
// Using github.com/ipfs/go-ipfs/commands to define the command line and HTTP
|
||||
// APIs. This is the interface available to folks using IPFS from outside of
|
||||
|
||||
@ -34,7 +34,7 @@ repository.`,
|
||||
LongDescription: `
|
||||
'ipfs config' controls configuration variables. It works
|
||||
much like 'git config'. The configuration values are stored in a config
|
||||
file inside your ipfs repository.
|
||||
file inside your IPFS repository.
|
||||
|
||||
Examples:
|
||||
|
||||
|
||||
@ -15,9 +15,9 @@ import (
|
||||
|
||||
var MountCmd = &cmds.Command{
|
||||
Helptext: cmds.HelpText{
|
||||
Tagline: "Mounts ipfs to the filesystem (read-only).",
|
||||
Tagline: "Mounts IPFS to the filesystem (read-only).",
|
||||
ShortDescription: `
|
||||
Mount ipfs at a read-only mountpoint on the OS (default: /ipfs and /ipns).
|
||||
Mount IPFS at a read-only mountpoint on the OS (default: /ipfs and /ipns).
|
||||
All IPFS objects will be accessible under that directory. Note that the
|
||||
root will not be listable, as it is virtual. Access known paths directly.
|
||||
|
||||
@ -29,7 +29,7 @@ You may have to create /ipfs and /ipns before using 'ipfs mount':
|
||||
> ipfs mount
|
||||
`,
|
||||
LongDescription: `
|
||||
Mount ipfs at a read-only mountpoint on the OS. The default, /ipfs and /ipns,
|
||||
Mount IPFS at a read-only mountpoint on the OS. The default, /ipfs and /ipns,
|
||||
are set in the configutation file, but can be overriden by the options.
|
||||
All IPFS objects will be accessible under this directory. Note that the
|
||||
root will not be listable, as it is virtual. Access known paths directly.
|
||||
@ -71,7 +71,7 @@ baz
|
||||
`,
|
||||
},
|
||||
Options: []cmds.Option{
|
||||
cmds.StringOption("ipfs-path", "f", "The path where ipfs should be mounted."),
|
||||
cmds.StringOption("ipfs-path", "f", "The path where IPFS should be mounted."),
|
||||
cmds.StringOption("ipns-path", "n", "The path where IPNS should be mounted."),
|
||||
},
|
||||
Run: func(req cmds.Request, res cmds.Response) {
|
||||
|
||||
@ -24,7 +24,7 @@ type RepoVersion struct {
|
||||
|
||||
var RepoCmd = &cmds.Command{
|
||||
Helptext: cmds.HelpText{
|
||||
Tagline: "Manipulate the ipfs repo.",
|
||||
Tagline: "Manipulate the IPFS repo.",
|
||||
ShortDescription: `
|
||||
'ipfs repo' is a plumbing command used to manipulate the repo.
|
||||
`,
|
||||
|
||||
@ -24,7 +24,7 @@ var Root = &cmds.Command{
|
||||
Subcommands: `
|
||||
BASIC COMMANDS
|
||||
init Initialize ipfs local configuration
|
||||
add <path> Add a file to ipfs
|
||||
add <path> Add a file to IPFS
|
||||
cat <ref> Show IPFS object data
|
||||
get <ref> Download IPFS objects
|
||||
ls <ref> List links from an object
|
||||
@ -37,7 +37,7 @@ DATA STRUCTURE COMMANDS
|
||||
|
||||
ADVANCED COMMANDS
|
||||
daemon Start a long-running daemon process
|
||||
mount Mount an ipfs read-only mountpoint
|
||||
mount Mount an IPFS read-only mountpoint
|
||||
resolve Resolve any type of name
|
||||
name Publish or resolve IPNS names
|
||||
dns Resolve DNS links
|
||||
@ -45,7 +45,7 @@ ADVANCED COMMANDS
|
||||
repo Manipulate the IPFS repository
|
||||
|
||||
NETWORK COMMANDS
|
||||
id Show info about ipfs peers
|
||||
id Show info about IPFS peers
|
||||
bootstrap Add or remove bootstrap peers
|
||||
swarm Manage connections to the p2p network
|
||||
dht Query the DHT for values or peers
|
||||
|
||||
@ -18,12 +18,12 @@ import (
|
||||
|
||||
var StatsCmd = &cmds.Command{
|
||||
Helptext: cmds.HelpText{
|
||||
Tagline: "Query ipfs statistics.",
|
||||
Tagline: "Query IPFS statistics.",
|
||||
ShortDescription: `'ipfs stats' is a set of commands to help look at statistics
|
||||
for your ipfs node.
|
||||
for your IPFS node.
|
||||
`,
|
||||
LongDescription: `'ipfs stats' is a set of commands to help look at statistics
|
||||
for your ipfs node.`,
|
||||
for your IPFS node.`,
|
||||
},
|
||||
|
||||
Subcommands: map[string]*cmds.Command{
|
||||
|
||||
@ -209,7 +209,7 @@ var swarmConnectCmd = &cmds.Command{
|
||||
ShortDescription: `
|
||||
'ipfs swarm connect' opens a new direct connection to a peer address.
|
||||
|
||||
The address format is an ipfs multiaddr:
|
||||
The address format is an IPFS multiaddr:
|
||||
|
||||
ipfs swarm connect /ip4/104.131.131.82/tcp/4001/ipfs/QmaCpDMGvV2BGHeYERUEnRQAwe3N8SzbUtfsmvsqQLuvuJ
|
||||
`,
|
||||
@ -274,7 +274,7 @@ var swarmDisconnectCmd = &cmds.Command{
|
||||
Tagline: "Close connection to a given address.",
|
||||
ShortDescription: `
|
||||
'ipfs swarm disconnect' closes a connection to a peer address. The address
|
||||
format is an ipfs multiaddr:
|
||||
format is an IPFS multiaddr:
|
||||
|
||||
ipfs swarm disconnect /ip4/104.131.131.82/tcp/4001/ipfs/QmaCpDMGvV2BGHeYERUEnRQAwe3N8SzbUtfsmvsqQLuvuJ
|
||||
|
||||
|
||||
@ -11,7 +11,7 @@ func TestParseTourTemplate(t *testing.T) {
|
||||
topic := &tour.Topic{
|
||||
ID: "42",
|
||||
Content: tour.Content{
|
||||
Title: "IPFS CLI test files",
|
||||
Title: "ipfs CLI test files",
|
||||
Text: `
|
||||
Welcome to the ipfs test files
|
||||
This is where we test our beautiful command line interfaces
|
||||
|
||||
@ -445,10 +445,10 @@ func (n *IpfsNode) loadID() error {
|
||||
|
||||
cid := cfg.Identity.PeerID
|
||||
if cid == "" {
|
||||
return errors.New("Identity was not set in config (was ipfs init run?)")
|
||||
return errors.New("identity was not set in config (was 'ipfs init' run?)")
|
||||
}
|
||||
if len(cid) == 0 {
|
||||
return errors.New("No peer ID in config! (was ipfs init run?)")
|
||||
return errors.New("no peer ID in config! (was 'ipfs init' run?)")
|
||||
}
|
||||
|
||||
n.Identity = peer.ID(b58.Decode(cid))
|
||||
|
||||
@ -357,7 +357,7 @@ func (i *gatewayHandler) putHandler(w http.ResponseWriter, r *http.Request) {
|
||||
|
||||
rootPath, err := path.ParsePath(r.URL.Path)
|
||||
if err != nil {
|
||||
webError(w, "putHandler: ipfs path not valid", err, http.StatusBadRequest)
|
||||
webError(w, "putHandler: IPFS path not valid", err, http.StatusBadRequest)
|
||||
return
|
||||
}
|
||||
|
||||
|
||||
@ -53,7 +53,7 @@ func Resolve(ctx context.Context, nsys namesys.NameSystem, r *path.Resolver, p p
|
||||
}
|
||||
}
|
||||
|
||||
// ok, we have an ipfs path now (or what we'll treat as one)
|
||||
// ok, we have an IPFS path now (or what we'll treat as one)
|
||||
return r.ResolvePath(ctx, p)
|
||||
}
|
||||
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
// package bitswap implements the IPFS Exchange interface with the BitSwap
|
||||
// package bitswap implements the IPFS exchange interface with the BitSwap
|
||||
// bilateral exchange protocol.
|
||||
package bitswap
|
||||
|
||||
@ -68,7 +68,7 @@ func New(parent context.Context, p peer.ID, network bsnet.BitSwapNetwork,
|
||||
|
||||
// important to use provided parent context (since it may include important
|
||||
// loggable data). It's probably not a good idea to allow bitswap to be
|
||||
// coupled to the concerns of the IPFS daemon in this way.
|
||||
// coupled to the concerns of the ipfs daemon in this way.
|
||||
//
|
||||
// FIXME(btc) Now that bitswap manages itself using a process, it probably
|
||||
// shouldn't accept a context anymore. Clients should probably use Close()
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
// package exchange defines the IPFS Exchange interface
|
||||
// package exchange defines the IPFS exchange interface
|
||||
package exchange
|
||||
|
||||
import (
|
||||
|
||||
@ -8,7 +8,7 @@ import (
|
||||
mount "github.com/ipfs/go-ipfs/fuse/mount"
|
||||
)
|
||||
|
||||
// Mount mounts ipfs at a given location, and returns a mount.Mount instance.
|
||||
// Mount mounts IPFS at a given location, and returns a mount.Mount instance.
|
||||
func Mount(ipfs *core.IpfsNode, mountpoint string) (mount.Mount, error) {
|
||||
cfg, err := ipfs.Repo.Config()
|
||||
if err != nil {
|
||||
|
||||
@ -25,7 +25,7 @@ import (
|
||||
|
||||
var log = logging.Logger("fuse/ipfs")
|
||||
|
||||
// FileSystem is the readonly Ipfs Fuse Filesystem.
|
||||
// FileSystem is the readonly IPFS Fuse Filesystem.
|
||||
type FileSystem struct {
|
||||
Ipfs *core.IpfsNode
|
||||
}
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
// package importer implements utilities used to create ipfs DAGs from files
|
||||
// package importer implements utilities used to create IPFS DAGs from files
|
||||
// and readers
|
||||
package importer
|
||||
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
// package merkledag implements the ipfs Merkle DAG datastructures.
|
||||
// package merkledag implements the IPFS Merkle DAG datastructures.
|
||||
package merkledag
|
||||
|
||||
import (
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
// package mfs implements an in memory model of a mutable ipfs filesystem.
|
||||
// package mfs implements an in memory model of a mutable IPFS filesystem.
|
||||
//
|
||||
// It consists of four main structs:
|
||||
// 1) The Filesystem
|
||||
|
||||
@ -14,11 +14,11 @@ import (
|
||||
// mpns (a multi-protocol NameSystem) implements generic IPFS naming.
|
||||
//
|
||||
// Uses several Resolvers:
|
||||
// (a) ipfs routing naming: SFS-like PKI names.
|
||||
// (a) IPFS routing naming: SFS-like PKI names.
|
||||
// (b) dns domains: resolves using links in DNS TXT records
|
||||
// (c) proquints: interprets string as the raw byte data.
|
||||
//
|
||||
// It can only publish to: (a) ipfs routing naming.
|
||||
// It can only publish to: (a) IPFS routing naming.
|
||||
//
|
||||
type mpns struct {
|
||||
resolvers map[string]resolver
|
||||
|
||||
@ -9,7 +9,7 @@ import (
|
||||
)
|
||||
|
||||
// ErrBadPath is returned when a given path is incorrectly formatted
|
||||
var ErrBadPath = errors.New("invalid ipfs ref path")
|
||||
var ErrBadPath = errors.New("invalid 'ipfs ref' path")
|
||||
|
||||
// TODO: debate making this a private struct wrapped in a public interface
|
||||
// would allow us to control creation, and cache segments.
|
||||
|
||||
@ -8,7 +8,7 @@ import (
|
||||
)
|
||||
|
||||
// DefaultBootstrapAddresses are the hardcoded bootstrap addresses
|
||||
// for ipfs. they are nodes run by the ipfs team. docs on these later.
|
||||
// for IPFS. they are nodes run by the IPFS team. docs on these later.
|
||||
// As with all p2p networks, bootstrap is an important security concern.
|
||||
//
|
||||
// NOTE: This is here -- and not inside cmd/ipfs/init.go -- because of an
|
||||
|
||||
@ -15,7 +15,7 @@ import (
|
||||
|
||||
var log = logging.Logger("config")
|
||||
|
||||
// Config is used to load IPFS config files.
|
||||
// Config is used to load ipfs config files.
|
||||
type Config struct {
|
||||
Identity Identity // local node's peer identity
|
||||
Datastore Datastore // local node's storage
|
||||
|
||||
@ -1,6 +1,6 @@
|
||||
package config
|
||||
|
||||
// Tour stores the ipfs tour read-list and resume point
|
||||
// Tour stores the 'ipfs tour' read-list and resume point
|
||||
type Tour struct {
|
||||
Last string // last tour topic read
|
||||
// Done []string // all topics done so far
|
||||
|
||||
@ -55,7 +55,7 @@ type NoRepoError struct {
|
||||
var _ error = NoRepoError{}
|
||||
|
||||
func (err NoRepoError) Error() string {
|
||||
return fmt.Sprintf("no ipfs repo found in %s.\nplease run: ipfs init", err.Path)
|
||||
return fmt.Sprintf("no IPFS repo found in %s.\nplease run: 'ipfs init'", err.Path)
|
||||
}
|
||||
|
||||
const apiFile = "api"
|
||||
|
||||
@ -204,7 +204,7 @@ func (tr *tarReader) Read(b []byte) (int, error) {
|
||||
|
||||
func ExportTar(ctx context.Context, root *dag.ProtoNode, ds dag.DAGService) (io.Reader, error) {
|
||||
if string(root.Data()) != "ipfs/tar" {
|
||||
return nil, errors.New("not an ipfs tarchive")
|
||||
return nil, errors.New("not an IPFS tarchive")
|
||||
}
|
||||
return &tarReader{
|
||||
links: root.Links(),
|
||||
|
||||
@ -45,8 +45,8 @@ test_expect_success "ipfs cat fails" '
|
||||
'
|
||||
|
||||
test_expect_success "ipfs cat no repo message looks good" '
|
||||
echo "Error: no ipfs repo found in $IPFS_PATH." > cat_fail_exp &&
|
||||
echo "please run: ipfs init" >> cat_fail_exp &&
|
||||
echo "Error: no IPFS repo found in $IPFS_PATH." > cat_fail_exp &&
|
||||
echo "please run: 'ipfs init'" >> cat_fail_exp &&
|
||||
test_path_cmp cat_fail_exp cat_fail_out
|
||||
'
|
||||
|
||||
@ -80,7 +80,7 @@ test_expect_success "ipfs peer id looks good" '
|
||||
|
||||
test_expect_success "ipfs init output looks good" '
|
||||
STARTFILE="ipfs cat /ipfs/$HASH_WELCOME_DOCS/readme" &&
|
||||
echo "initializing ipfs node at $IPFS_PATH" >expected &&
|
||||
echo "initializing IPFS node at $IPFS_PATH" >expected &&
|
||||
echo "generating $BITS-bit RSA keypair...done" >>expected &&
|
||||
echo "peer identity: $PEERID" >>expected &&
|
||||
echo "to get started, enter:" >>expected &&
|
||||
@ -107,7 +107,7 @@ test_expect_success "ipfs peer id looks good" '
|
||||
'
|
||||
|
||||
test_expect_success "'ipfs init --empty-repo' output looks good" '
|
||||
echo "initializing ipfs node at $IPFS_PATH" >expected &&
|
||||
echo "initializing IPFS node at $IPFS_PATH" >expected &&
|
||||
echo "generating $BITS-bit RSA keypair...done" >>expected &&
|
||||
echo "peer identity: $PEERID" >>expected &&
|
||||
test_cmp expected actual_init
|
||||
|
||||
@ -107,7 +107,7 @@ test_get_cmd() {
|
||||
'
|
||||
|
||||
test_expect_success "ipfs get ../.. should fail" '
|
||||
echo "Error: invalid ipfs ref path" >expected &&
|
||||
echo "Error: invalid 'ipfs ref' path" >expected &&
|
||||
test_must_fail ipfs get ../.. 2>actual &&
|
||||
test_cmp expected actual
|
||||
'
|
||||
|
||||
8
thirdparty/ipfsaddr/ipfsaddr.go
vendored
8
thirdparty/ipfsaddr/ipfsaddr.go
vendored
@ -12,8 +12,8 @@ import (
|
||||
|
||||
var log = logging.Logger("ipfsaddr")
|
||||
|
||||
// ErrInvalidAddr signals an address is not a valid ipfs address.
|
||||
var ErrInvalidAddr = errors.New("invalid ipfs address")
|
||||
// ErrInvalidAddr signals an address is not a valid IPFS address.
|
||||
var ErrInvalidAddr = errors.New("invalid IPFS address")
|
||||
|
||||
type IPFSAddr interface {
|
||||
ID() peer.ID
|
||||
@ -83,7 +83,7 @@ func ParseMultiaddr(m ma.Multiaddr) (a IPFSAddr, err error) {
|
||||
return nil, ErrInvalidAddr
|
||||
}
|
||||
|
||||
// make sure it's an ipfs addr
|
||||
// make sure it's an IPFS addr
|
||||
parts := ma.Split(m)
|
||||
if len(parts) < 1 {
|
||||
return nil, ErrInvalidAddr
|
||||
@ -93,7 +93,7 @@ func ParseMultiaddr(m ma.Multiaddr) (a IPFSAddr, err error) {
|
||||
return nil, ErrInvalidAddr
|
||||
}
|
||||
|
||||
// make sure ipfs id parses as a peer.ID
|
||||
// make sure 'ipfs id' parses as a peer.ID
|
||||
peerIdParts := path.SplitList(ipfspart.String())
|
||||
peerIdStr := peerIdParts[len(peerIdParts)-1]
|
||||
id, err := peer.IDB58Decode(peerIdStr)
|
||||
|
||||
@ -182,11 +182,11 @@ var NodeBasicsInit = Content{
|
||||
|
||||
// TODO touch on PKI
|
||||
//
|
||||
// This is somewhat relevant at ipfs init since the generated key pair is the
|
||||
// This is somewhat relevant at 'ipfs init' since the generated key pair is the
|
||||
// basis for the node's identity in the network. A cursory nod may be
|
||||
// sufficient at that stage, and goes a long way in explaining init's raison
|
||||
// d'être.
|
||||
// NB: user is introduced to ipfs init before ipfs add.
|
||||
// NB: user is introduced to 'ipfs init' before 'ipfs add'.
|
||||
Text: `
|
||||
`,
|
||||
}
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
// Package format implements a data format for files in the ipfs filesystem It
|
||||
// Package format implements a data format for files in the IPFS filesystem It
|
||||
// is not the only format in ipfs, but it is the one that the filesystem
|
||||
// assumes
|
||||
package unixfs
|
||||
|
||||
Loading…
Reference in New Issue
Block a user