/koans

A Platform for Programming Exercises in Typescript and Javascript

Primary LanguageTypeScript

Build Status

A Platform for Programming Exercises in Typescript and Javascript

https://ilovecode.herokuapp.com/

Features

  • Creation of exercise series with template code and assertions
  • Support for Typescript and Javascript
  • Automatic verification of user solution and instant feedback
  • Exercise search
  • Authentication

Technology Stack

Installation

1. Clone the repository

git clone https://github.com/judithgull/koans.git

2. MongoDB

Install

See: https://docs.mongodb.org/manual/installation/

Create Data directory

mkdir -p /data/db

Ensure that the user account running mongod has read and write permissions for the directory.

Test, if db is running:

mongod
Setup

Add text index (for search) and sample data:

Start mongodb, if not already started:

mongod

In a different terminal: Move to the project home (location of the cloned repo):

cd <path_to_cloned_project>/koans

Import sample data:

mongoimport --db koans --collection topics app-node/sample-data/topics.bson

Add textindex for search:

mongo --eval "db.getSiblingDB('koans').topics.createIndex({title: 'text', 'items.title': 'text','items.description': 'text'})"

3. Nodejs

Install Node.js (This will also install npm).

4. Dependencies

Move to the project home (location of the cloned repo):

cd <path_to_cloned_project>/koans

Run npm install to install all dependencies. (npm, patched libraries)

5. Run

Make sure mongodb is running:

mongod

Run npm start to start application (in a different terminal)

Open browser with [http://localhost:3000] (http://localhost:3000)

Development

1. Webstorm

  1. Use the latest Webstorm 11.0 or higher
  2. Make sure the appropriate typescript compiler is used >= 1.6.2: Preferences/Languages & Frameworks/Typescript
  • Compiler version (2.5 (bundeled)
  • Use tsconfig.json

Maintenance tasks

MongoDB

Drop

Only if you need to drop the db for any reason use:

Make sure db is started:

mongod

(in a different terminal)

mongo koans --eval "db.dropDatabase()"