mirror of
https://github.com/ipfs/kubo.git
synced 2025-06-28 17:03:58 +08:00
Merge pull request #5108 from Mr0grog/docs/add-coreapi-overview
Add package overview comments to coreapi
This commit is contained in:
@ -1,3 +1,16 @@
|
||||
/*
|
||||
Package coreapi provides direct access to the core commands in IPFS. If you are
|
||||
embedding IPFS directly in your Go program, this package is the public
|
||||
interface you should use to read and write files or otherwise control IPFS.
|
||||
|
||||
If you are running IPFS as a separate process, you should use `go-ipfs-api` to
|
||||
work with it via HTTP. As we finalize the interfaces here, `go-ipfs-api` will
|
||||
transparently adopt them so you can use the same code with either package.
|
||||
|
||||
**NOTE: this package is experimental.** `go-ipfs` has mainly been developed
|
||||
as a standalone application and library-style use of this package is still new.
|
||||
Interfaces here aren't yet completely stable.
|
||||
*/
|
||||
package coreapi
|
||||
|
||||
import (
|
||||
@ -49,7 +62,7 @@ func (api *CoreAPI) Key() coreiface.KeyAPI {
|
||||
return (*KeyAPI)(api)
|
||||
}
|
||||
|
||||
//Object returns the ObjectAPI interface implementation backed by the go-ipfs node
|
||||
// Object returns the ObjectAPI interface implementation backed by the go-ipfs node
|
||||
func (api *CoreAPI) Object() coreiface.ObjectAPI {
|
||||
return (*ObjectAPI)(api)
|
||||
}
|
||||
|
Reference in New Issue
Block a user