doc: Adding part 4 of the getting started tutorial: integration commands

This new section talks about how integration commands work
and shows them at work.

1 files changed, 36 insertions, 0 deletions

diff --git a/tests/examples/integration-commands.py b/tests/examples/integration-commands.py
new file mode 100644
index 000000000..32ef763eb
--- /dev/null
+++ b/tests/examples/integration-commands.py
@@ -0,0 +1,36 @@
+import os
+import pytest
+
+from tests.testutils import cli_integration as cli
+from tests.testutils.integration import assert_contains
+from tests.testutils.site import IS_LINUX
+
+
+pytestmark = pytest.mark.integration
+DATA_DIR = os.path.join(
+    os.path.dirname(os.path.realpath(__file__)), '..', '..', 'doc', 'examples', 'integration-commands'
+)
+
+
+@pytest.mark.skipif(not IS_LINUX, reason='Only available on linux')
+@pytest.mark.datafiles(DATA_DIR)
+def test_integration_commands_build(cli, tmpdir, datafiles):
+    project = os.path.join(datafiles.dirname, datafiles.basename)
+    checkout = os.path.join(cli.directory, 'checkout')
+
+    result = cli.run(project=project, args=['build', 'hello.bst'])
+    assert result.exit_code == 0
+
+
+# Test running the executable
+@pytest.mark.skipif(not IS_LINUX, reason='Only available on linux')
+@pytest.mark.datafiles(DATA_DIR)
+def test_integration_commands_run(cli, tmpdir, datafiles):
+    project = os.path.join(datafiles.dirname, datafiles.basename)
+
+    result = cli.run(project=project, args=['build', 'hello.bst'])
+    assert result.exit_code == 0
+
+    result = cli.run(project=project, args=['shell', 'hello.bst', '--', 'hello', 'pony'])
+    assert result.exit_code == 0
+    assert result.output == 'Hello pony\n'