test url sourcd

Author: chfw

.moban.d/cli-feature.rst.jj2

@@ -11,3 +11,36 @@ Hightlighted features:
 #. Merge files in various excel file formats into one
 #. Split a multi-sheet excel file into single sheet files
 #. Find difference in data between two excel files
+
+Usage
+================================================================================
+
+Here is an example usage:
+
+.. code-block:: bash
+
+    $ pyexcel view https://github.com/pyexcel/pyexcel-cli/blob/master/tests/fixtures/multiple-sheets.xls
+	Sheet 1:
+    +---+---+---+
+    | 1 | 2 | 3 |
+    +---+---+---+
+    | 4 | 5 | 6 |
+    +---+---+---+
+    | 7 | 8 | 9 |
+    +---+---+---+
+    Sheet 2:
+    +---+---+---+
+    | X | Y | Z |
+    +---+---+---+
+    | 1 | 2 | 3 |
+    +---+---+---+
+    | 4 | 5 | 6 |
+    +---+---+---+
+    Sheet 3:
+    +---+---+---+
+    | O | P | Q |
+    +---+---+---+
+    | 3 | 2 | 1 |
+    +---+---+---+
+    | 4 | 3 | 2 |
+    +---+---+---+

README.rst

@@ -26,6 +26,39 @@ Hightlighted features:
 #. Split a multi-sheet excel file into single sheet files
 #. Find difference in data between two excel files
 
+Usage
+================================================================================
+
+Here is an example usage:
+
+.. code-block:: bash
+
+    $ pyexcel view https://github.com/pyexcel/pyexcel-cli/blob/master/tests/fixtures/multiple-sheets.xls
+	Sheet 1:
+    +---+---+---+
+    | 1 | 2 | 3 |
+    +---+---+---+
+    | 4 | 5 | 6 |
+    +---+---+---+
+    | 7 | 8 | 9 |
+    +---+---+---+
+    Sheet 2:
+    +---+---+---+
+    | X | Y | Z |
+    +---+---+---+
+    | 1 | 2 | 3 |
+    +---+---+---+
+    | 4 | 5 | 6 |
+    +---+---+---+
+    Sheet 3:
+    +---+---+---+
+    | O | P | Q |
+    +---+---+---+
+    | 3 | 2 | 1 |
+    +---+---+---+
+    | 4 | 3 | 2 |
+    +---+---+---+
+
 .. _file-format-list:
 
 .. table:: A list of file formats supported by external plugins

docs/source/index.rst

@@ -25,6 +25,39 @@ Hightlighted features:
 #. Split a multi-sheet excel file into single sheet files
 #. Find difference in data between two excel files
 
+Usage
+================================================================================
+
+Here is an example usage:
+
+.. code-block:: bash
+
+    $ pyexcel view https://github.com/pyexcel/pyexcel-cli/blob/master/tests/fixtures/multiple-sheets.xls
+	Sheet 1:
+    +---+---+---+
+    | 1 | 2 | 3 |
+    +---+---+---+
+    | 4 | 5 | 6 |
+    +---+---+---+
+    | 7 | 8 | 9 |
+    +---+---+---+
+    Sheet 2:
+    +---+---+---+
+    | X | Y | Z |
+    +---+---+---+
+    | 1 | 2 | 3 |
+    +---+---+---+
+    | 4 | 5 | 6 |
+    +---+---+---+
+    Sheet 3:
+    +---+---+---+
+    | O | P | Q |
+    +---+---+---+
+    | 3 | 2 | 1 |
+    +---+---+---+
+    | 4 | 3 | 2 |
+    +---+---+---+
+
 Installation
 ================================================================================
 

tests/test_view.py

@@ -2,6 +2,7 @@
 from nose.tools import eq_
 from pyexcel_cli.view import view
 from click.testing import CliRunner
+from textwrap import dedent
 
 
 def test_stdin_option():
@@ -23,3 +24,37 @@ def test_stdout_option():
                                   test_fixture])
     eq_(result.exit_code, 0)
     eq_(result.output, '1,2,3\n')
+
+
+def test_url_option():
+    runner = CliRunner()
+    test_fixture = "https://github.com/pyexcel/pyexcel-cli/raw/master/tests/fixtures/multiple-sheets.xls"  # noqa
+    result = runner.invoke(view, [test_fixture])
+    expected = dedent("""
+    Sheet 1:
+    +---+---+---+
+    | 1 | 2 | 3 |
+    +---+---+---+
+    | 4 | 5 | 6 |
+    +---+---+---+
+    | 7 | 8 | 9 |
+    +---+---+---+
+    Sheet 2:
+    +---+---+---+
+    | X | Y | Z |
+    +---+---+---+
+    | 1 | 2 | 3 |
+    +---+---+---+
+    | 4 | 5 | 6 |
+    +---+---+---+
+    Sheet 3:
+    +---+---+---+
+    | O | P | Q |
+    +---+---+---+
+    | 3 | 2 | 1 |
+    +---+---+---+
+    | 4 | 3 | 2 |
+    +---+---+---+
+    """).strip('\n')
+    eq_(result.exit_code, 0)
+    eq_(result.output, expected)