summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorprathamesh2017-11-10 11:18:58 +0530
committerprathamesh2017-11-10 11:18:58 +0530
commit886f544ac44d831c7844ca42edb4cb97bc3b6313 (patch)
tree87e2dff0a1efa36501c4c72969db5a8be6bad975 /README.md
parent2eeddaf3bc2eaf9af3fe3e08caec12ff8bc9071a (diff)
parentcfcb2ed39c724639fe17338e29e327d08ae641b2 (diff)
downloadonline_test-886f544ac44d831c7844ca42edb4cb97bc3b6313.tar.gz
online_test-886f544ac44d831c7844ca42edb4cb97bc3b6313.tar.bz2
online_test-886f544ac44d831c7844ca42edb4cb97bc3b6313.zip
Merge branch 'master' of https://github.com/FOSSEE/online_test into upload_users_csv
Diffstat (limited to 'README.md')
-rw-r--r--README.md58
1 files changed, 27 insertions, 31 deletions
diff --git a/README.md b/README.md
index caae485..a0faab2 100644
--- a/README.md
+++ b/README.md
@@ -37,56 +37,52 @@ Quick Start
#### Installation
1. Install yaksh
- - For latest stable release
+ - Clone the repository
- $ pip install yaksh
+ $ git clone https://github.com/FOSSEE/online_test.git
- - For the development version
+ - Go to the online_test directory
- $ pip install git+https://github.com/FOSSEE/online_test.git
+ $ cd ./online_test
-#### Short instructions
+ - Install the dependencies
+
+ - For Python 2 use:
+
+ $ pip install -r ./requirements/requirements-py2.txt
-To see a quick demo after installing yaksh do the following:
+ - For Python 3 (recommended) use:
- $ yaksh create_demo yaksh_demo
- $ yaksh run yaksh_demo
+ $ pip install -r ./requirements/requirements-py3.txt
+
+#### Short instructions
-On another terminal start up the code server that executes the user code safely:
+1. To run the application do the following:
- $ sudo yaksh run_code_server
+ $ invoke serve
-Now point your browser to ```http://localhost:8000/exam```.
+ - *Note:* The serve command will run the django application server on the 8000 port
+ and hence this port will be unavailable to other processes.
-#### More detailed instructions
+1. On another terminal start up the code server that executes the user code safely:
-1. On the terminal run:
+ - To run the code server in a sandboxed docker environment, run the command:
- $ yaksh create_demo [project_path]
+ $ invoke start
- - `project_path` is the desired directory of the django project the
- basename of which is also the Django project name. This can be a
- relative directory.
+ - Make sure that you have Docker installed on your system beforehand.
+ [Docker Installation](https://docs.docker.com/engine/installation/#desktop)
- - In case a `project_path` is not specified, the project is created
- in a `yaksh_demo` subdirectory of the current directory.
-1. The script does the following;
- 1. Creates a new django project with name as the basename of the specified
- `project_path`
- 1. Creates a new demo database.
- 1. Creates two users, teacher and student.
- 1. Loads demo questions.
- 1. Loads demo quiz.
+ - To run the code server without docker, locally use:
-1. To run the server, run:
+ $ invoke start --unsafe
- $ yaksh run relpath/or/abspath/to/demo
+ - Note this command will run the yaksh code server locally on your machine
+ and is susceptible to malicious code. You will have to install the code
+ server requirements in sudo mode.
-1. In a new terminal run the following command which executes user submitted
- code safely:
- $ sudo yaksh run_code_server
1. Open your browser and open the URL ```http://localhost:8000/exam```