Skip to content

jaas666/compilerd

 
 

Repository files navigation

Kalvium Kalvium


Table of contents :

  1. About The Project
  2. Quick Usage
  3. Contribution
  4. License

About The Project :

Compilerd is a online code judge for evaluating code submissions passed to it. It compiles and executes code in several languages and returns the result and various other properties in the response. The judge supports several languages including C++, Python, C, JavaScript (Node.js) and Java. This is a service that is build using nodejs and express in the backend. It is fully customizable and can be adjusted as per requirement. Also, it has been tried and tested on Google Cloud Run and it just works seamlessly.

Quick Usage :

We will run the project locally and try to make a request to see a sample use case :

  • Clone the repo : git clone <web-url>
  • Change directory to the project's root folder.
  • Install dependencies : npm install
  • Build docker image : docker build -t <tag> .
  • Run the docker container with the built image : docker run -p 3000:3000 <tag>
  • Now we have the service running on localhost http://localhost:3000/
  • Open postman and try to make a POST request on http://localhost:3000/api/execute/ with given payload :
        {
            "language" : "nodejs", 
            "script" : "console.log('hello world')"
        } 
  • You should see something like this in the response :
        {
            "output": "hello world\n",
            "execute_time": null,
            "status_code": 200,
            "memory": null,
            "cpu_time": null,
            "output_files": [],
            "compile_message": "",
            "error": 0
        }

Contribution :

Prerequisites:

For local development we should have the following dependencies set up locally in our system

  • Nodejs : nodejs
  • Npm : this comes automatically with nodejs installation
  • Docker : docker
  • Postman or alternative : Postman
  • Git : Git

Setting up :

  • Fork the repository using Github UI.
  • Clone locally from the forked repo.

Making changes:

  • Make sure to create a new branch on top of the main branch : git checkout -b <name>
  • After making changes we can commit them using git commit -am <commit-name>

Running tests :

  • It is important to make sure that changes are not breaking, hence they should be tested aginst provided suite of test cases in repo.
  • Run the server in a docker container by using below commands :
    • docker build -t <tag-name> .
    • docker run -p 3000:3000 <tag-name>
  • Execute the test script by running command node ./tests/test.js
  • Summary can be seen on the console when all the tests have finished.

Guidelines :

  • Provide Detailed Pull Requests
    • Clearly describe the problem you're solving or the feature you're adding
    • Provide context, background, and any relevant information
  • Adhere to the project's coding standards and style guides
  • Update documentation as needed for your changes
    • Ensure that your code is well-documented and easy for others to understand
  • Ensure that your contributions are well-tested
  • Maintain consistency with the existing codebase

License :

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 95.5%
  • Dockerfile 4.1%
  • Shell 0.4%