Add support to invoke args as string

click/testing.py

@@ -3,8 +3,9 @@
 import shutil
 import tempfile
 import contextlib
+import shlex
 
-from ._compat import iteritems, PY2
+from ._compat import iteritems, PY2, string_types
 
 
 # If someone wants to vendor click, we want to ensure the
@@ -260,7 +261,7 @@ def invoke(self, cli, args=None, input=None, env=None,
            The ``color`` parameter was added.
 
         :param cli: the command to invoke
-        :param args: the arguments to invoke
+        :param args: the arguments to invoke. May be an iterable or string.
         :param input: the input data for `sys.stdin`.
         :param env: the environment overrides.
         :param catch_exceptions: Whether to catch any other exceptions than
@@ -274,6 +275,9 @@ def invoke(self, cli, args=None, input=None, env=None,
             exception = None
             exit_code = 0
 
+            if isinstance(args, string_types):
+                args = shlex.split(args)
+
             try:
                 cli.main(args=args or (),
                          prog_name=self.get_default_prog_name(cli), **extra)

tests/test_testing.py

@@ -202,3 +202,23 @@ def cli_env():
     assert result.output == 'ENV=some_value\n'
 
     assert os.environ == env_orig
+
+
+@pytest.mark.parametrize('args, expected_output', [
+    (None, 'bar\n'),
+    ([], 'bar\n'),
+    ('', 'bar\n'),
+    (['--foo', 'one two'], 'one two\n'),
+    ('--foo "one two"', 'one two\n'),
+])
+def test_args(args, expected_output):
+
+    @click.command()
+    @click.option('--foo', default='bar')
+    def cli_args(foo):
+        click.echo(foo)
+
+    runner = CliRunner()
+    result = runner.invoke(cli_args, args=args)
+    assert result.exit_code == 0
+    assert result.output == expected_output