{ "info": { "author": "Python Team at FOSSEE, IIT Bombay", "author_email": "python@fossee.in", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Web Environment", "Framework :: Django", "Intended Audience :: Developers", "Intended Audience :: Education", "Intended Audience :: End Users/Desktop", "License :: OSI Approved :: BSD License", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.5", "Topic :: Internet :: WWW/HTTP :: Dynamic Content" ], "description": "Yaksh\n=====\n\n|Build Status| |Documentation Status|\n\nTo get an overview of the Yaksh interface please refer to the user documentation at `Yaksh Docs `_\n\n\nThis is a Quickstart guide to help users setup a trial instance. If you wish to deploy Yaksh in a production environment here is a `Production Deployment Guide `_\n\nIntroduction\n^^^^^^^^^^^^\n\nThis project provides an \"exam\" app that lets users take an online\nprogramming quiz.\n\nFeatures\n^^^^^^^^\n\n- Define fairly complicated programming problems and have users solve\n the problem.\n- Immediate verification of code solution.\n- Supports pretty much arbitrary coding questions in Python, C, C++ and\n simple Bash and uses \"test cases\" to test the implementations of the\n students.\n- Supports simple multiple choice questions and File uploads.\n- Since it runs on your Python, you could technically test any Python\n based library.\n- Scales to over 500+ simultaneous users.\n- Distributed under the BSD license.\n\nQuick Start\n===========\n\nPre-Requisites\n^^^^^^^^^^^^^^\n\n1. Ensure you have Python available.\n2. Ensure `pip `__ is\n installed.\n\nInstallation\n^^^^^^^^^^^^\n\n1. Install yaksh\n\n - Clone the repository\n\n ::\n\n $ git clone https://github.com/FOSSEE/online_test.git\n\n - Go to the online\\_test directory\n\n ::\n\n $ cd ./online_test\n\n - Install the dependencies\n\n - For Python 2 use:\n\n ::\n\n $ pip install -r ./requirements/requirements-py2.txt\n\n - For Python 3 (recommended) use:\n\n ::\n\n $ pip install -r ./requirements/requirements-py3.txt\n\nShort instructions\n^^^^^^^^^^^^^^^^^^\n\n1. Start up the code server that executes the user code safely:\n\n - To run the code server in a sandboxed docker environment, run the\n command:\n\n ::\n\n $ invoke start\n\n - Make sure that you have Docker installed on your system\n beforehand. `Docker\n Installation `__\n\n - To run the code server without docker, locally use:\n\n ::\n\n $ invoke start --unsafe\n\n - Note this command will run the yaksh code server locally on your\n machine and is susceptible to malicious code. You will have to\n install the code server requirements in sudo mode.\n\n2. On another terminal, run the application using the following command:\n\n ::\n\n $ invoke serve\n\n - *Note:* The serve command will run the django application server\n on the 8000 port and hence this port will be unavailable to other\n processes.\n\n3. Open your browser and open the URL ``http://localhost:8000/exam``\n\n4. Login as a teacher to edit the quiz or as a student to take the quiz\n Credentials:\n\n - Student - Username: student \\| Password: student\n - Teacher - Username: teacher \\| Password: teacher\n\n5. User can also login to the Default Django admin using;\n\n - Admin - Username: admin \\| Password: admin\n\nHistory\n=======\n\nAt FOSSEE, Nishanth had implemented a nice django based app to test for\nmultiple-choice questions. Prabhu Ramachandran was inspired by a\nprogramming contest that he saw at PyCon APAC 2011. Chris Boesch, who\nadministered the contest, used a nice web application\n`Singpath `__ that he had built on top of GAE that\nbasically checked your Python code, live. This made it fun and\ninteresting.\n\nPrabhu wanted an implementation that was not tied to GAE and hence wrote\nthe initial cut of what is now 'Yaksh'. The idea being that anyone can\nuse this to test students programming skills and not have to worry about\ngrading their answers manually and instead do so on their machines.\n\nThe application has since been refactored and maintained by FOSSEE\nDevelopers.\n\nContact\n=======\n\nFor further information and support you can contact\n\nPython Team at FOSSEE: pythonsupport@fossee.in\n\nLicense\n=======\n\nThis is distributed under the terms of the BSD license. Copyright\ninformation is at the bottom of this file.\n\nAuthors\n=======\n\n`FOSSEE Developers `_\n\nCopyright (c) 2011-2017 `FOSSEE `_\n\n\n.. |Build Status| image:: https://travis-ci.org/FOSSEE/online_test.svg?branch=master\n :target: https://travis-ci.org/FOSSEE/online_test\n.. |Documentation Status| image:: https://readthedocs.org/projects/yaksh/badge/?version=latest\n :target: http://yaksh.readthedocs.io/en/latest/?badge=latest", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://pypi.python.org/pypi/yaksh/", "keywords": "", "license": "BSD License", "maintainer": "", "maintainer_email": "", "name": "yaksh", "package_url": "https://pypi.org/project/yaksh/", "platform": "", "project_url": "https://pypi.org/project/yaksh/", "project_urls": { "Homepage": "https://pypi.python.org/pypi/yaksh/" }, "release_url": "https://pypi.org/project/yaksh/0.7.0/", "requires_dist": null, "requires_python": "", "summary": "A django app to conduct online programming tests.", "version": "0.7.0" }, "last_serial": 3335298, "releases": { "0.1.1": [ { "comment_text": "", "digests": { "md5": "adfa4dc5c77f54a1078691b93e3d9ec7", "sha256": "144ad160af09fe817b6eec7d852badb37372a8bb26a665d3679e0a88b0d750e0" }, "downloads": -1, "filename": "yaksh-0.1.1.tar.gz", "has_sig": false, "md5_digest": "adfa4dc5c77f54a1078691b93e3d9ec7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 126574, "upload_time": "2015-10-13T11:19:44", "url": "https://files.pythonhosted.org/packages/96/f8/7ac007cff558832c245963f00e6d2aa1d8ded42772403b671727edb864f4/yaksh-0.1.1.tar.gz" } ], "0.5.0": [ { "comment_text": "", "digests": { "md5": "2caa1ab72b728483cbdb2b78f3aeff2d", "sha256": "31fcedc76c27d22f8d13978f67ecf3739c3b82e80cf4bfab2348eccae22cf06a" }, "downloads": -1, "filename": "yaksh-0.5.0.tar.gz", "has_sig": false, "md5_digest": "2caa1ab72b728483cbdb2b78f3aeff2d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1156180, "upload_time": "2017-03-22T13:10:47", "url": "https://files.pythonhosted.org/packages/30/f9/a802e3ddeca85080490cd3b5298fd22e4498b3b81c8f2cc8e61bde0c3b4d/yaksh-0.5.0.tar.gz" } ], "0.6.0": [ { "comment_text": "", "digests": { "md5": "258d98168a0cd89df7a49e5d0df03b54", "sha256": "2751fb47a20a23bf100140ab2f407f690685cda9300647f5050bec2d107bdfe9" }, "downloads": -1, "filename": "yaksh-0.6.0.tar.gz", "has_sig": false, "md5_digest": "258d98168a0cd89df7a49e5d0df03b54", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1164589, "upload_time": "2017-10-09T10:15:38", "url": "https://files.pythonhosted.org/packages/f5/e1/493aa2f606023cf0af5e63b80b0642c92144c318ef11fcb4e52ab0295ab8/yaksh-0.6.0.tar.gz" } ], "0.7.0": [ { "comment_text": "", "digests": { "md5": "43464bcd340dd67734d1550b83a2a085", "sha256": "ff5884872a0efc595daf2b291025f516efc46b13a5c05f19616057f87b6f3610" }, "downloads": -1, "filename": "yaksh-0.7.0.tar.gz", "has_sig": false, "md5_digest": "43464bcd340dd67734d1550b83a2a085", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1552965, "upload_time": "2017-11-15T14:01:53", "url": "https://files.pythonhosted.org/packages/2a/47/10d652ccf64b72f91955e8d6e6f9456c9dc925fe996571a504b05d129444/yaksh-0.7.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "43464bcd340dd67734d1550b83a2a085", "sha256": "ff5884872a0efc595daf2b291025f516efc46b13a5c05f19616057f87b6f3610" }, "downloads": -1, "filename": "yaksh-0.7.0.tar.gz", "has_sig": false, "md5_digest": "43464bcd340dd67734d1550b83a2a085", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1552965, "upload_time": "2017-11-15T14:01:53", "url": "https://files.pythonhosted.org/packages/2a/47/10d652ccf64b72f91955e8d6e6f9456c9dc925fe996571a504b05d129444/yaksh-0.7.0.tar.gz" } ] }