NodeJS Client Library for Codeforces API

codeforces-api-node is a simple NodeJS library for Codeforces Api with streaming support.

Install

$ npm install codeforces-api

Usage

codeforces-api-node supports both ES5 and ES6.

Basic

//ES5
var Codeforces = require('codeforces-api');

//ES2015
import Codeforces from 'codeforces-api';

//set API keys for authentication
Codeforces.setApis('your_codeforces_api_key', 'your_codeforces_api_secret');


Codeforces.method( parameters , callback );

Usage

Codeforces.user.rating({ handle: 'user_handle' } , function (err, data) {

    if (err) {
        //handle error and return
    }

    //use data
});

Methods & Parameters

Full description of the API can be found on : Official API Doc

| Method | Parameters | Description | | ----------------------- | ------------------------------------------------------------ |:-------------------------------------------------------------------:| | blogEntry.comments | *blogEntryId | More | | blogEntry.view | *blogEntryId | More | | contest.hacks | contestId | More | | contest.list | gym | More | | contest.ratingChanges | *contestId | More | | contest.standings | *contestId , from , count , handles , room , showUnofficial | More | | contest.status | *contestId , handle , from , count | More | | problemset.problems | tags | More | | problemset.recentStatus | *count | More | | recentActions | *maxCount | More | | user.blogEntries | *handle | More | | user.friends | onlyOnline | More | | user.info | *handles | More | | user.ratedList | activeOnly | More | | user.rating | *handle | More | | user.status | *handle , from , count | More |

*required parameters

Note

handles and tags can be multiple.There are two different ways to set:

1. Semicilon-separated string:

tags: 'greedy;dp;graphs'

2. As array:

tags: ['greedy','dp','graphs']

Authorization

Although most of the method of the API supports anonymously request, codeforces-api-node does not allow anonymous request yet.To access API data, must set API and SECRET key before calling methods.To generate API and SECRET KEY visit: API Settings

Return Data

All data return in JSON format.For full description of data format visit: Return Objects

Streaming

This feature and example from npm request package. For more have a look : Request Package Doc

You can stream responses to a file stream.When json data is huge, you may need this feature.

Codeforces.user.ratedList( parameters, callback )
               .pipe( fs.createWriteStream('./rateedList.json') );

//version >= 1.0.2 (with or without callback)
Codeforces.user.ratedList( parameters )
               .pipe( fs.createWriteStream('./ratedList.json') );

Also emits response events.

Codeforces.user.ratedList( parameters, function(err, data){

    if(err){ //request error  }

    //data also available here

}).on('data', function(data) {
    // decompressed data as it is received
    console.log('decoded chunk: ' + data)
})
.on('response', function(response) {

    // unmodified http.IncomingMessage object
    response.on('data', function(data) {
        // compressed data as it is received
        console.log('received ' + data.length + ' bytes of compressed data')
    });

}).pipe( fs.createWriteStream('./ratedList.json') );

Contributing

Everyone wellcome!

• Create an issue > Fork > Create own branch > Commit changes > Push the branch > Creat pull request

Test

Before running test, must set API and SECRET key in environment variable.Keys are:

CFK = API Key
CFS = API Secret

After setting keys, simply run

npm test

License

MIT © Ahmed Dinar