Add Installation and Usage sections

README.rst

@@ -3,3 +3,52 @@ nerone
 
 `nerone` creates PyInstaller one-file executables with only dependencies for
 the scripts in arguments.
+
+The name is a pun related to how one-file executables work: when they are
+started a temporary folder in the appropriate temp-folder location for the OS
+is created and PyInstaller bootloader uncompresses the support files and writes
+copies into the temporary folder.
+
+The temporary folder is deleted after the code execution: this inspired the
+name of the project.
+
+See `PyInstaller documentation`_ for details.
+
+.. _PyInstaller documentation: https://pyinstaller.readthedocs.io/en/stable/operating-mode.html#how-the-one-file-program-works
+
+Installation
+------------
+
+.. code-block:: bash
+
+   % pip install git+https://github.com/eriol/nerone
+
+Usage
+-----
+
+Suppose to have the following script named `test.py`:
+
+.. code-block:: python
+
+   import sys
+
+   import requests
+
+
+   if __name__ == '__main__':
+       print requests.head(sys.argv[2]).headers
+
+To create a one-file executable with all the dependencies (in this case only
+`requests`) you can just call `nerone` passing the script:
+
+.. code-block:: bash
+
+   % nerone test.py
+
+Inside `dist` directory you will find the one-file executable witch embed the
+dependencies for `test.py`.
+
+.. code-block:: bash
+
+   % ./dist/test test.py https://mornie.org
+   {'Content-Encoding': 'gzip', 'Server': 'nginx/1.6.2', ...}