Skip to content
Sharness tests to test IPFS implementations
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
dependencies/ma-pipe-unidir
lib
t0024-files Add all the tests and their data May 28, 2018
t0051-object-data
t0053-dag-data
t0060-data
t0110-gateway-data
t0280-plugin-git-data
.gitignore
LICENSE
Makefile
README.md Add all the tests and their data May 28, 2018
package.json Add package.json to be a gx package Jun 5, 2018
t0000-sharness.sh Add t0000-sharness.sh May 28, 2018
t0010-basic-commands.sh
t0015-basic-sh-functions.sh
t0018-indent.sh
t0020-init.sh
t0021-config.sh
t0022-init-default.sh
t0023-shutdown.sh
t0024-datastore-config.sh
t0025-datastores.sh
t0030-mount.sh
t0031-mount-publish.sh
t0040-add-and-cat.sh
t0041-ping.sh
t0042-add-skip.sh Add all the tests and their data May 28, 2018
t0043-add-w.sh
t0044-add-symlink.sh
t0045-ls.sh
t0050-block.sh
t0051-object.sh
t0052-object-diff.sh
t0053-dag.sh
t0060-daemon.sh
t0061-daemon-opts.sh
t0062-daemon-api.sh
t0063-daemon-init.sh
t0063-external.sh
t0065-active-requests.sh
t0066-migration.sh Add all the tests and their data May 28, 2018
t0070-user-config.sh
t0080-repo.sh
t0081-repo-pinning.sh
t0082-repo-gc-auto.sh
t0083-repo-fsck.sh
t0084-repo-read-rehash.sh
t0085-pins.sh
t0086-repo-verify.sh
t0087-repo-robust-gc.sh
t0088-repo-stat-symlink.sh
t0090-get.sh Add all the tests and their data May 28, 2018
t0100-name.sh
t0101-iptb-name.sh
t0110-gateway.sh
t0111-gateway-writeable.sh Add all the tests and their data May 28, 2018
t0112-gateway-cors.sh
t0120-bootstrap.sh
t0121-bootstrap-iptb.sh
t0125-twonode.sh
t0130-multinode.sh
t0131-multinode-client-routing.sh
t0140-swarm.sh
t0141-addfilter.sh
t0150-clisuggest.sh
t0151-sysdiag.sh Add all the tests and their data May 28, 2018
t0160-resolve.sh
t0165-keystore.sh
t0170-dht.sh
t0175-reprovider.sh
t0180-p2p.sh
t0180-pubsub.sh
t0181-private-network.sh
t0182-circuit-relay.sh
t0183-namesys-pubsub.sh
t0200-unixfs-ls.sh
t0210-tar.sh
t0220-bitswap.sh
t0230-channel-streaming-http-content-type.sh
t0231-channel-streaming.sh
t0235-cli-request.sh
t0240-republisher.sh
t0250-files-api.sh
t0251-files-flushing.sh
t0252-files-gc.sh
t0260-sharding-flag.sh
t0270-filestore.sh
t0271-filestore-utils.sh
t0280-plugin-git.sh
t0300-docker-image.sh Add all the tests and their data May 28, 2018
t0301-docker-migrate.sh
t0400-api-security.sh
t0410-api-add.sh
t0500-issues-and-regressions-offline.sh
t0600-issues-and-regressions-online.sh
x0601-pin-fail-test.sh

README.md

ipfs-sharness-tests

IPFS whole tests using the Sharness framework

Running all the tests

Just use make in this directory to run all the tests. Run with TEST_VERBOSE=1 to get helpful verbose output.

TEST_VERBOSE=1 make

The usual ipfs env flags also apply:

# the output will make your eyes bleed
IPFS_LOGGING=debug TEST_VERBOSE=1 make

Running just one test

You can run only one test script by launching it like a regular shell script:

$ ./t0010-basic-commands.sh

Debugging one test

You can use the -v option to make it verbose and the -i option to make it stop as soon as one test fails. For example:

$ ./t0010-basic-commands.sh -v -i

Sharness

When running sharness tests from main Makefile or when test_sharness_deps target is run dependencies for sharness will be downloaded from its github repo and installed in a "lib/sharness" directory.

Please do not change anything in the "lib/sharness" directory.

If you really need some changes in sharness, please fork it from its cannonical repo and send pull requests there.

Writing Tests

Please have a look at existing tests and try to follow their example.

When possible and not too inefficient, that means most of the time, an ipfs command should not be on the left side of a pipe, because if the ipfs command fails (exit non zero), the pipe will mask this failure. For example after false | true, echo $? prints 0 (despite false failing).

It should be possible to put most of the code inside test_expect_success, or sometimes test_expect_failure, blocks, and to chain all the commands inside those blocks with &&, or || for diagnostic commands.

Diagnostics

Make your test case output helpful for when running sharness verbosely. This means cating certain files, or running diagnostic commands. For example:

test_expect_success ".ipfs/ has been created" '
  test -d ".ipfs" &&
  test -f ".ipfs/config" &&
  test -d ".ipfs/datastore" &&
  test -d ".ipfs/blocks" ||
  test_fsh ls -al .ipfs
'

The || ... is a diagnostic run when the preceding command fails. test_fsh is a shell function that echoes the args, runs the cmd, and then also fails, making sure the test case fails. (wouldnt want the diagnostic accidentally returning true and making it seem like the test case succeeded!).

Testing commands on daemon or mounted

Use the provided functions in lib/test-lib.sh to run the daemon or mount:

To init, run daemon, and mount in one go:

test_launch_ipfs_daemon_and_mount

test_expect_success "'ipfs add --help' succeeds" '
  ipfs add --help >actual
'

# other tests here...

# dont forget to kill the daemon!!
test_kill_ipfs_daemon

To init, run daemon, and then mount separately:

test_init_ipfs

# tests inited but not running here

test_launch_ipfs_daemon

# tests running but not mounted here

test_mount_ipfs

# tests mounted here

# dont forget to kill the daemon!!
test_kill_ipfs_daemon
You can’t perform that action at this time.