aboutsummaryrefslogtreecommitdiff
path: root/docs/gettingstarted.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/gettingstarted.rst')
-rw-r--r--docs/gettingstarted.rst42
1 files changed, 42 insertions, 0 deletions
diff --git a/docs/gettingstarted.rst b/docs/gettingstarted.rst
new file mode 100644
index 0000000..e45ff38
--- /dev/null
+++ b/docs/gettingstarted.rst
@@ -0,0 +1,42 @@
+Getting Started
+---------------
+
+Installation
+++++++++++++
+
+.. code-block::
+
+ $ pip3 install minishell-test
+ $ pip3 install --user minishell-test # if you don't have root access
+
+Compatibility
++++++++++++++
+
+Your executable **must** support the ``-c`` option which allow to pass command as string.
+
+.. code-block::
+
+ $ bash -c 'echo bonjour je suis | cat -e'
+ bonjour je suis$
+ $ ./minishell -c 'echo bonjour je suis | cat -e'
+ bonjour je suis$
+
+
+.. note::
+ With this setup ``argv[2]`` is what you would usually get in ``line`` from ``get_next_line``.
+
+Usage
++++++
+
+Run all the predefined tests:
+
+.. code-block::
+
+ $ cd <MINISHELL>
+ $ minishell_test
+
+.. warning::
+ If you get ``command not found``, do either of those things:
+
+ * ``~/.local/bin`` to your ``PATH`` environment variable.
+ * run ``$ python3 -m minishell_test`` instead of ``$ minishell_test``