interface-ipfs-core

2019-08-15 admin

interface-ipfs-core是什么

什么是interface-ipfs-core,A test suite and interface you can use to implement a IPFS core interface.

interface-ipfs-core使用教程帮助文档

interface-ipfs-core

standard-readme compliant

A test suite and interface you can use to implement an IPFS core interface.

Lead Maintainer

Alan Shaw.

Table of Contents

  • Background
    • Modules that implement the interface
    • Badge
  • Install
  • Usage
    • JavaScript
    • Go
  • API
  • Contribute
    • Want to hack on IPFS?
  • License

Background

The primary goal of this module is to define and ensure that both IPFS core implementations and their respective HTTP client libraries offer the same interface, so that developers can quickly change between a local and a remote node without having to change their applications. In addition to the definition of the expected interface, this module offers a suite of tests that can be run in order to check if the interface is used as described.

The API is presented with both Node.js and Go primitives. However, there are no actual limitations keeping it from being extended for any other language, pushing forward cross compatibility and interoperability through different stacks.

Modules that implement the interface

Send in a PR if you find or write one!

Badge

Include this badge in your readme if you make a new module that implements interface-ipfs-core API.

[![IPFS Core API Compatible](https://cdn.rawgit.com/ipfs/interface-ipfs-core/master/img/badge.svg)](https://github.com/ipfs/interface-ipfs-core)

Install

In JavaScript land:

npm install interface-ipfs-core

If you want to run these tests against a go-ipfs daemon, checkout ipfs-http-client and run test tests:

git clone https://github.com/ipfs/js-ipfs-http-client
npm install
npm test

Usage

Install interface-ipfs-core as one of the dependencies of your project and as a test file. Then, using mocha (for Node.js) or a test runner with compatible API, do:

const tests = require('interface-ipfs-core')

// Create common setup and teardown
const createCommon = () => ({
  // Do some setup common to all tests
  setup (cb) {
    // Must call back with an "IPFS factory", an object with a `spawnNode` method
    cb(null, {
      // Use ipfsd-ctl or other to spawn an IPFS node for testing
      spawnNode (cb) { /* ... */ }
    })
  },
  // Dispose of nodes created by the IPFS factory and any other teardown
  teardown (cb) {
    cb()
  }
})

tests.block(createCommon)
tests.config(createCommon)
tests.dag(createCommon)
// ...etc. (see src/index.js)

Running tests by command

tests.repo.version(createCommon)

Skipping tests

tests.repo.gc(createCommon, { skip: true }) // pass an options object to skip these tests

// OR, at the subsystem level

// skips ALL the repo.gc tests
tests.repo(createCommon, { skip: ['gc'] })
// skips ALL the object.patch.addLink tests
tests.object(createCommon, { skip: ['patch.addLink'] })
Skipping specific tests
tests.repo.gc(createCommon, { skip: ['should do a thing'] }) // named test(s) to skip

// OR, at the subsystem level

tests.repo(createCommon, { skip: ['should do a thing'] })

Running only some tests

tests.repo.gc(createCommon, { only: true }) // pass an options object to run only these tests

// OR, at the subsystem level

// runs only ALL the repo.gc tests
tests.repo(createCommon, { only: ['gc'] })
// runs only ALL the object.patch.addLink tests
tests.object(createCommon, { only: ['patch.addLink'] })
Running only specific tests
tests.repo.gc(createCommon, { only: ['should do a thing'] }) // only run these named test(s)

// OR, at the subsystem level

tests.repo(createCommon, { only: ['should do a thing'] })

API

In order to be considered “valid”, an IPFS core implementation must expose the API described in /SPEC. You can also use this loose spec as documentation for consuming the core APIs. Here is an outline of the contents of that directory:

Contribute

Feel free to join in. All welcome. Open an issue!

This repository falls under the IPFS Code of Conduct.

Want to hack on IPFS?

License

Copyright © Protocol Labs, Inc. under the MIT License. See LICENSE.md for details.

本站文章除注明转载外,均为本站原创或编译。欢迎任何形式的转载,但请务必注明出处。

转载请注明:文章转载自 JavaScript中文网 [https://www.javascriptcn.com]

本文地址:https://www.javascriptcn.com/read-72583.html

文章标题:interface-ipfs-core

回到顶部