Code Monkey home page Code Monkey logo

hh-stats's Introduction

Build Status

HeadHunter salary statistics

A tiny library to agregate vacancy information from HeadHunter API.

Key feachures are:

  • Search vacancies with given keywords
  • Calculate total found items, min, max and average salary for given filters
  • Support keyword synonyms (eg. 'javascript' and 'js')
  • Support filters for area, experience and any custom filter supported by API

Installation

npm install --save hh-stats

Usage

Library is written in TypeScipt so typings are supported. It's isomorphic so you can use it both from Node.js and browser. To use it in browser bundler which understands CommonJS modules (like Webpack) is required.

Dependencies

There is no dependencies but it assumes that promises and fetch API are available. To use it in environment that has no Promise or fetch various polyfills could be used.

For promises and fetch API one could use es6-promise polyfill and isomorphic-fetch packages:

npm install --save isomorphic-fetch es6-promise

Example

// polyfills to bring Promise and fetch to our environment
require('es6-promise').polyfill();
let { fetch } = require('isomorphic-fetch');

let { HeadHunterApi, DictCurrencyConverter, RequestParam } = require('hh-stats');

// create an instance of API client
// first parameter is User-Agent to be used in requests
// second parameter is timeout in ms
const api = new HeadHunterApi('My API client', 1500);

// alternatively you could set them later via fields
api.timeout = 25000;
api.userAgent = 'My API client';

let converter;
// salaries are in different currencies so we need currency rates first
api.getCurrencies().then(cur => {
    // create instance of currency converter
    converter = new DictCurrencyConverter(cur);
    // query vacancy statistics both for 'javascript' and 'js' (keyword synonyms)
    return api.getVacancy(converter, ['javascript', 'js'], null, null);
}).then(stat => {
    console.log(`Found ${stat.amount} vacancies`);
    console.log(`${stat.used} used to calculate salary`);
    console.log(`Max salary is ${stat.maxSalary} RUR`);
    console.log(`Average salary is ${stat.avgSalary} RUR`);
    console.log(`Min salary is ${stat.minSalary} RUR`);
    
    // salary calculates in RUR (Russian Rubles) by default
    // you could easially convert it from currencies using converter
    let avgSalaryUSD = converter.convert(stat.avgSalary, 'RUR', 'USD');
    console.log(`Average salary in USD is ${avgSalaryUSD}`);
});

hh-stats's People

Contributors

bocharovf avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.