mirror of https://github.com/ipfs/kubo.git synced 2026-02-22 02:47:48 +08:00

History

Christian Couder b01e535115 t0110: cleanup using expr License: MIT Signed-off-by: Christian Couder <chriscool@tuxfamily.org>		2015-03-04 21:02:32 +01:00
..
lib	sharness/testlib: seed RANDOM	2015-03-04 08:17:55 -08:00
.gitignore	moved sharness tests to a subdir.	2015-01-07 07:10:17 -08:00
bin	moved sharness tests to a subdir.	2015-01-07 07:10:17 -08:00
Makefile	specify new dep in sharenss Makefile	2015-03-04 15:06:26 +01:00
README.md	Replace fsh with test_fsh in sharness tests	2015-02-04 21:53:19 +01:00
t0010-basic-commands.sh	Replace fsh with test_fsh in sharness tests	2015-02-04 21:53:19 +01:00
t0020-init.sh	Replace fsh with test_fsh in sharness tests	2015-02-04 21:53:19 +01:00
t0021-config.sh	sharness/t0021-config.sh test config setting	2015-02-01 20:15:51 -08:00
t0030-mount.sh	Replace fsh with test_fsh in sharness tests	2015-02-04 21:53:19 +01:00
t0040-add-and-cat.sh	test/sharness/t004-add-cat: quote hashes	2015-03-04 07:34:05 -08:00
t0045-ls.sh	sharness: don't be to smart about creating testData	2015-03-01 14:03:51 +01:00
t0050-block.sh	moved sharness tests to a subdir.	2015-01-07 07:10:17 -08:00
t0060-daemon.sh	Replace fsh with test_fsh in sharness tests	2015-02-04 21:53:19 +01:00
t0070-user-config.sh	fix(fsrepo): use "please run ipfs init" message	2015-01-13 03:09:32 -08:00
t0080-repo.sh	test/sharness: improve t0080	2015-02-02 01:24:33 +01:00
t0090-get.sh	Replace fsh with test_fsh in sharness tests	2015-02-04 21:53:19 +01:00
t0100-name.sh	address concerns from PR	2015-01-28 19:36:30 +00:00
t0110-gateway.sh	t0110: cleanup using expr	2015-03-04 21:02:32 +01:00
t0111-gateway-writable.sh	tests/sharness: t0111-gateway-writable	2015-03-04 08:17:54 -08:00
t0120-bootstrap.sh	sharness/t0120-bootstrap: test the bootstrap cmd	2015-02-01 06:07:28 -08:00

README.md

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

Sharness

When running "make" in this directory for the first time, 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

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 ".go-ipfs/ has been created" '
  test -d ".go-ipfs" &&
  test -f ".go-ipfs/config" &&
  test -d ".go-ipfs/datastore" ||
  test_fsh ls -al .go-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