coreapi unixfs: unixfs.Get

License: MIT
Signed-off-by: Łukasz Magiera <magik6k@gmail.com>

unixfs.go

@@ -13,8 +13,16 @@ import (
 // NOTE: This API is heavily WIP, things are guaranteed to break frequently
 type UnixfsAPI interface {
 	// Add imports the data from the reader into merkledag file
+	//
+	// TODO: a long useful comment on how to use this for many different scenarios
 	Add(context.Context, files.File, ...options.UnixfsAddOption) (ResolvedPath, error)
 
+	// Get returns a read-only handle to a file tree referenced by a path
+	//
+	// Note that some implementations of this API may apply the specified context
+	// to operations performed on the returned file
+	Get(context.Context, Path) (files.File, error)
+
 	// Cat returns a reader for the file
 	Cat(context.Context, Path) (Reader, error)