A python script that provides a cli interface to codewars.com. Because noone should have to write code in a browser. Currently focuses only on JavaScript katas.
- Python 3
- Mocha (optional: for running the tests locally)
For basic information on how to use the program run:
$ codewars.py -h
Create a file that contains your personal api key. You can find this
key in ‘Account settings’ on codewars. By default, codewars-client
looks for a file called api_key.txt
in the current directory.
Basic process comes down to:
- Get new kata with:
$ codewars.py next
- Write code and tests
- Attempt solution with:
$ codewars.py submit
- If it passes, finalize with:
$ codewars.py finalize
One of the nice things about codewars is that it encourages TDD. It does this by providing some tests to start out with (called ‘example fixtures’ by codewars) and by providing the user with an easy way to run them in the browser. Ofcourse we’re not using the browser so that’s a problem. In order to run the tests codewars-cli provides some help to run the tests locally with Mocha. It adds a preamble to the tests and it converts codewars’ Test.* calls to Nodejs Assert.* calls. This translation does not provide perfectly equivalent tests, but it should be good enough for this purpose.
The only other thing that needs to be done is exporting the necessary functions in the solutions file. This can easily be done by appending:
module.exports.some_function = some_function
to the solution file.
Tests can then be run with:
$ mocha tests.js removeValue ✓ should remove integers ✓ should remove all integers ✓ should return false when no integer can be removed ✓ should remove strings ✓ should return false when no string can be removed ✓ should not confuse strings with integers ✓ should return false when the array is empty 7 passing (17ms)