gc: address CR comments

License: MIT
Signed-off-by: Kevin Atkinson <[email protected]>

Author: kevina

core/commands/repo.go

@@ -40,6 +40,7 @@ var RepoCmd = &cmds.Command{
 	},
 }
 
+// GcResult is the result returned by "repo gc" command
 type GcResult struct {
 	Key   *cid.Cid
 	Error string `json:",omitempty"`

core/corerepo/gc.go

@@ -91,6 +91,7 @@ func GarbageCollect(n *core.IpfsNode, ctx context.Context) error {
 	return CollectResult(ctx, rmed, nil)
 }
 
+// ColoredSet computes the set of nodes in the graph that are pinned by the pins in the given pinner
 func CollectResult(ctx context.Context, gcOut <-chan gc.Result, cb func(*cid.Cid)) error {
 	var errors []error
 loop:
@@ -125,6 +126,7 @@ func NewMultiError(errs ...error) *MultiError {
 	return &MultiError{errs[:len(errs)-1], errs[len(errs)-1]}
 }
 
+// MultiError contains the results of multiple errors.
 type MultiError struct {
 	Errors  []error
 	Summary error

pin/gc/gc.go

@@ -66,7 +66,7 @@ func GC(ctx context.Context, bs bstore.GCBlockstore, ls dag.LinkService, pn pin.
 					err := bs.DeleteBlock(k)
 					if err != nil {
 						errors = true
-						output <- Result{Error: &CouldNotDeleteBlockError{k, err}}
+						output <- Result{Error: &CannotDeleteBlockError{k, err}}
 						//log.Errorf("Error removing key from blockstore: %s", err)
 						// continue as error is non-fatal
 						continue loop
@@ -82,7 +82,7 @@ func GC(ctx context.Context, bs bstore.GCBlockstore, ls dag.LinkService, pn pin.
 			}
 		}
 		if errors {
-			output <- Result{Error: ErrCouldNotDeleteSomeBlocks}
+			output <- Result{Error: ErrCannotDeleteSomeBlocks}
 		}
 	}()
 
@@ -112,7 +112,7 @@ func ColoredSet(ctx context.Context, pn pin.Pinner, ls dag.LinkService, bestEffo
 		links, err := ls.GetLinks(ctx, cid)
 		if err != nil {
 			errors = true
-			output <- Result{Error: &CouldNotFetchLinksError{cid, err}}
+			output <- Result{Error: &CannotFetchLinksError{cid, err}}
 		}
 		return links, nil
 	}
@@ -126,7 +126,7 @@ func ColoredSet(ctx context.Context, pn pin.Pinner, ls dag.LinkService, bestEffo
 		links, err := ls.GetLinks(ctx, cid)
 		if err != nil && err != dag.ErrNotFound {
 			errors = true
-			output <- Result{Error: &CouldNotFetchLinksError{cid, err}}
+			output <- Result{Error: &CannotFetchLinksError{cid, err}}
 		}
 		return links, nil
 	}
@@ -147,30 +147,30 @@ func ColoredSet(ctx context.Context, pn pin.Pinner, ls dag.LinkService, bestEffo
 	}
 
 	if errors {
-		return nil, ErrCouldNotFetchAllLinks
-	} else {
-		return gcs, nil
+		return nil, ErrCannotFetchAllLinks
 	}
+
+	return gcs, nil
 }
 
-var ErrCouldNotFetchAllLinks = errors.New("garbage collection aborted: could not retrieve some links")
+var ErrCannotFetchAllLinks = errors.New("garbage collection aborted: could not retrieve some links")
 
-var ErrCouldNotDeleteSomeBlocks = errors.New("garbage collection incomplete: could not delete some blocks")
+var ErrCannotDeleteSomeBlocks = errors.New("garbage collection incomplete: could not delete some blocks")
 
-type CouldNotFetchLinksError struct {
+type CannotFetchLinksError struct {
 	Key *cid.Cid
 	Err error
 }
 
-func (e *CouldNotFetchLinksError) Error() string {
+func (e *CannotFetchLinksError) Error() string {
 	return fmt.Sprintf("could not retrieve links for %s: %s", e.Key, e.Err)
 }
 
-type CouldNotDeleteBlockError struct {
+type CannotDeleteBlockError struct {
 	Key *cid.Cid
 	Err error
 }
 
-func (e *CouldNotDeleteBlockError) Error() string {
+func (e *CannotDeleteBlockError) Error() string {
 	return fmt.Sprintf("could not remove %s: %s", e.Key, e.Err)
 }